Menu
柚子 AI 的接口调用能力：行情查询、模拟交易、总结上报。 覆盖盯盘、下单、复盘上报全链路。当用户提到大盘、板块、个股、热点、涨停、连板、 情绪、买卖、持仓、委托、撤单、自选股、总结上报等任何与盯盘交易接口调用相关的操作时， 使用此 skill。本地状态读写（交易日志 / 自选池 / 复盘总结 / 动态策略）见 journal skill。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | mock |
| description | 柚子 AI 的接口调用能力：行情查询、模拟交易、总结上报。 覆盖盯盘、下单、复盘上报全链路。当用户提到大盘、板块、个股、热点、涨停、连板、 情绪、买卖、持仓、委托、撤单、自选股、总结上报等任何与盯盘交易接口调用相关的操作时， 使用此 skill。本地状态读写（交易日志 / 自选池 / 复盘总结 / 动态策略）见 journal skill。 |
| compatibility | [] |
柚子 AI agent 的接口调用层入口（行情 / 交易 / 总结上报）。所有接口已封装为 Python SDK。本地状态读写（交易日志 / 自选池 / 复盘总结 / 动态策略）见 skills/journal/SKILL.md。
agent 调用 SDK 的唯一方式是
cli.py（见下方「CLI 调用方式」），禁止编写临时 .py 脚本去 import skills.mock——曾因临时脚本写到项目工作目录之外触发external_directory权限拦截，导致整轮盯盘中断。import形式仅供人类开发者在 REPL / 测试中使用。
函数签名、入参、返回字段的权威定义在各 .py 的 docstring，本文件只做索引。 字段表、枚举值、默认值、信封格式——请直接读对应函数的 docstring。
工作区根 = 项目根目录（脚本所在的最外层目录，下载解压即得、可任意重命名）。
skills/mock/cli.py 是通用方法调用器：一行命令调用 market / trading / report 任意方法，结果以 JSON 输出到 stdout。agent 盯盘、下单、复盘所需的接口调用都走它（本地状态读写见下方 journal skill 说明）。
python skills/mock/cli.py <module>.<method> [位置参数...] [--key value ...]
python skills/mock/cli.py --list # 列出全部可用方法
python skills/mock/cli.py --help # 打印用法
盯盘高频调用：
| 用途 | 命令 |
|---|---|
| 大盘汇总 | cli.py market.get_summary |
| LLM 盘面分析（决策核心） | cli.py market.get_intraday_analysis |
| 账号资金 | cli.py trading.get_account |
| 当前持仓 | cli.py trading.get_positions |
| 持仓分时（涨跌 + 主力，§0.6 加速止盈必需） | cli.py market.get_stock_minute_trendline 300083 |
| 个股详情（hot_categories / up_reason 板块归属、turn_z 换手） | cli.py market.get_stock_info 300083 |
| 严重异动禁买名单 | cli.py market.get_key_watch_stocks |
| 策略选股（创业板强趋势） | cli.py market.get_strategy_trend_stocks 6 |
| 策略选股（创业+科创大趋势） | cli.py market.get_strategy_trend_stocks 10 |
| 策略选股（沪深主板） | cli.py market.get_strategy_trend_stocks 7 |
| 策略选股（大幅回撤） | cli.py market.get_strategy_trend_stocks 21 |
| 本地状态读写（交易日志 / 自选池 / 复盘 / 策略） | 见 skills/journal/SKILL.md，走 skills/journal/cli.py |
| 盯盘 / 复盘总结上报 | cli.py report.submit_summary watch "..." |
下单与记录（写操作，参数在调用前校验，未知参数不会误下单）：
python skills/mock/cli.py trading.buy --stock_code 603019 --price 45.0 --volume 100
python skills/mock/cli.py trading.sell --stock_code 603019 --price 46.0 --volume 100
python skills/journal/cli.py append_trade_action buy 603019 中科曙光 45.0 100 "主线龙头符合买点"
参数与输出约定：
stock_code（str）的 "603019" 保持字符串，strategy_id（int）的 "6" 转 int；具名参数支持 --key value 与 --key=value{code,message,data} 契约）；返回 None 时输出 {"ok": true}{code, error, method, ...}）+ 退出码非零。code: 400 参数错、404 方法不存在、500 执行异常.env（STOCK_SECRET_KEY）由 _http.py 基于 __file__ 自动加载，与 cwd 无关；secret_key 一般不传from skills.mock.market import get_summary, get_stock_info, get_hot_spot_list
from skills.mock.trading import get_account, get_positions, buy, sell, cancel
from skills.journal.journal import read_trade_log, append_trade_action, read_dynamic_strategy
secret_key 认证，无需手动传 account_id。secret_key，默认读 .env 中的 STOCK_SECRET_KEY。secret_key="..." 覆盖（仅 trading 写操作常用）。大部分接口返回信封格式：
{"code": 200, "message": "success", "data": <业务数据>}
code: 200 成功，400 参数错误，404 不存在，500 服务器错误get_summary、get_indicator_trendline、get_stock_info、get_daily_k_data）直接返回业务数据，无信封包装skills.mock.market大盘、板块、个股、热点、事件驱动、主题等行情数据，38 个 GET 接口 + 1 个 POST 选股接口。
签名读法（以 cli 调用为准）：
market.py 函数定义，位置参数顺序 = 签名顺序--key 均可）--key valueOptional[X] = None 也算有默认值，不算必填| 函数 | 用途 | 必填 |
|---|---|---|
get_summary() | 大盘汇总（含 stage 字段，用于状态行展示；盯盘/复盘由外部调度器告知） | — |
get_zt_timeline() | 今日涨停时间轴（盯盘页右上半区时间轴展示，含涨跌停类型 / 板块归属 / 涨停原因） | — |
get_indicator_trendline(code: str) | 指标分时趋势线（平均股价/主力净额/大盘情绪温度等） | code |
get_daily_indicators_history(days: int = 30) | 历史指标矩阵（复盘用） | — |
示例：
cli.py market.get_indicator_trendline temperature
cli.py market.get_daily_indicators_history --days 60
| 函数 | 用途 | 必填 |
|---|---|---|
get_hot_spot_list(sort_by="dr_count", sort_order="desc", limit=20) | 热点分类列表 | — |
get_hot_spot_components(name, sort_by="zdf", sort_order="desc") | 热点成分股（核心股） | name |
get_hot_spot_eliminated(name) | 热点被淘汰股（跟风股） | name |
get_hot_spot_trendline(name) | 热点主力资金分时趋势线 | name |
get_hot_spot_daily_stats(date=None) | 某日热点统计（复盘用） | — |
get_hot_spot_daily_stats_batch(name, days=10) | 多日热点统计 | name |
get_top_hot_spots(date=None, limit=10) | 某日排名前 N 热点 | — |
get_hot_spot_components_by_date(name, date) | 热点成分股历史快照 | name, date |
示例：
cli.py market.get_hot_spot_components 算力芯片 # 位置参数
cli.py market.get_hot_spot_components 算力芯片 --sort_by main_amount # 位置+具名混用
cli.py market.get_top_hot_spots --date 2026-07-04 --limit 20
| 函数 | 用途 | 必填 |
|---|---|---|
get_stock_info(stock_code) | 个股详情（市值/换手/热点标签/涨停原因） | stock_code |
get_daily_k_data(code, days=30) | 日 K 线 | code |
get_stock_trendline(code) | 个股当日分时 | code |
get_stock_minute_trendline(code) | 个股分时多轴（涨跌幅 + 主力） | code |
get_stock_trendline_history(code, date) | 个股历史分时（复盘用） | code, date |
get_stock_daily_history(code, days=5) | 个股近 N 日 daily_stock 全量数据（复盘用） | code |
get_batch_stock_zdf(codes) | 批量实时涨跌幅（逗号分隔代码） | codes |
示例：
cli.py market.get_stock_info 300083
cli.py market.get_stock_trendline 300083
cli.py market.get_stock_trendline_history 300083 2026-07-04
cli.py market.get_batch_stock_zdf --codes 300083,300750,002415
| 函数 | 用途 | 必填 |
|---|---|---|
get_amount_top() | 成交额前 30 | — |
get_large_cap_stocks() | 大市值高涨幅（涨/跌各 20） | — |
get_main_outflow_top() | 主力净流出前 20 | — |
get_main_inflow_top() | 主力净流入前 20 | — |
get_hourly_hot_top(sort_by="rank") | 小时热度榜前 30 | — |
get_consecutive_board_ladder(end_date=None) | 近四日连板天梯 | — |
get_hot_spot_zt_stocks() | 近三天热点涨停股汇总 | — |
get_hot_spot_rotation(days=5, top_n=9) | 热点轮动 | — |
get_lianban_stocks(date=None, limit=200) | 连板股列表 | — |
get_key_watch_stocks() | 严重异动禁买名单 | — |
示例：
cli.py market.get_key_watch_stocks
cli.py market.get_lianban_stocks --limit 50
| 函数 | 用途 | 必填 |
|---|---|---|
get_strategy_trend_stocks(strategy_id, mode="", limit=30) | 策略选股（需登录；仅公开策略有数据。盘中：1 今日大面 / 6 创业板强趋势 / 7 主板趋势 / 9 成交额巨大 / 10 创业科创趋势 / 21 大幅回撤 / 22 百日新高 / 23 今日强势回撤；盘后：2 昨日大面 / 8 涨幅巨大 / 24 最近多板 / 25 近期烂板 / 26 昨日烂板 / 27 昨日断板 / 28 昨日涨停 / 29 昨日强势回撤） | strategy_id |
示例：
cli.py market.get_strategy_trend_stocks 6 # 今日创业板强趋势
cli.py market.get_strategy_trend_stocks 10 --limit 50 # 今日创业科创趋势
cli.py market.get_strategy_trend_stocks 7 # 今日主板趋势
cli.py market.get_strategy_trend_stocks 21 --limit 30 # 近期大幅回撤
cli.py market.get_strategy_trend_stocks 22 # 近期百日新高
cli.py market.get_strategy_trend_stocks 28 # 昨日涨停
| 函数 | 用途 | 必填 |
|---|---|---|
get_intraday_analysis() | 最新盘中 LLM 盘面分析（agent 唯一权威源，含 position_limit / sentiment_label / action_advice / risk_warnings 等完整 schema，见 market.py get_intraday_analysis docstring） | — |
示例：
cli.py market.get_intraday_analysis
| 函数 | 用途 | 必填 |
|---|---|---|
get_jtcsm_events(days=1, limit=30) | "今天炒什么"事件列表 | — |
get_jtcsm_event_stocks(event_id, date) | 事件关联个股当日行情 | event_id, date |
get_stock_jtcsm_directions(code, days=5) | 个股近期命中的"今天炒什么"概念 | code |
get_jtcsm_direction_stocks(event_id, exclude_code="") | 概念标签下其他个股（实时行情） | event_id |
示例：
cli.py market.get_jtcsm_events --days 1 --limit 30
cli.py market.get_jtcsm_event_stocks evt_20260704_xxx 2026-07-04
| 函数 | 用途 | 必填 |
|---|---|---|
get_stock_theme_tags(code) | 个股命中的"主题"标签 | code |
get_theme_stocks(theme_code, level2_code="", limit=15) | 某主题下关联个股（实时行情） | theme_code |
get_hot_theme_list(limit=20, level_only=True, sort_field="dr_count", keyword="", sort_order="") | 主题看板列表（按大肉/涨停/主力等排序） | — |
get_theme_stock_list(code, field="zdf", sort="desc", limit=15, keyword="") | 主题看板个股（含分时曲线） | code |
get_theme_detail(code) | 主题详情弹窗（分时曲线 + 近 10 日收盘 + 二级子主题） | code |
示例：
cli.py market.get_hot_theme_list --sort_field amount_main --limit 30
cli.py market.get_theme_stocks theme_001 --level2_code lvl2_001 --limit 20
cli.py market.get_theme_stock_list theme_001 --field amount_main --sort desc
cli.py market.get_theme_detail theme_001
| 函数 | 用途 | 必填 |
|---|---|---|
nl_pick(query) | 自然语言选股（LLM 解析 → DSL → basic/ma/window/concept 四组交集，POST） | query |
示例：
cli.py market.nl_pick "20日涨幅>10%且换手率>3%的创业板股"
cli.py market.nl_pick "【AI】，非ST，多头排列，按涨跌幅排序"
cli.py market.nl_pick "【算力】【光模块】，创业板"
概念关键词用
【】全角方括号包裹，本地正则提取不经 LLM，在主题 / 热点 / 今日炒什么 三个维度合并 LIKE 搜索；多个【】之间为 AND 关系。限流、DSL 原语与错误信封 code → 见 market.pynl_pickdocstring。
skills.mock.trading账号、持仓、委托、买卖、撤单、自选管理、历史成交、主题/事件关注管理，26 个接口。写操作需登录态（cookie 自动携带）。
签名读法：同行情接口。「必填」列只列无默认值的参数。所有写操作（buy/sell/cancel/add_favorite/...）的 secret_key 都有默认（读 .env 的 STOCK_SECRET_KEY），一般不传；需要切换账号时用具名参数 --secret_key ... 覆盖。
| 函数 | 用途 | 必填 |
|---|---|---|
get_account() | 账号资金（余额/可用/市值/盈亏） | — |
get_positions() | 当前持仓列表 | — |
get_orders(secret_key=None, start_time=None, end_time=None) | 当日委托列表（时间戳为 Unix 秒，secret_key 在 SDK 签名首位，强烈建议用具名参数） | — |
get_trade_history(limit=100) | 历史成交记录 | — |
get_match_logs(stock_code="", order_no="", log_date=0) | 委托撮合日志（log_date 当天 0 点 Unix 秒） | — |
get_profit_curve() | 账号收益率曲线（近 1 年） | — |
get_stock_price(stock_code) | 实时价格（下单前确认） | stock_code |
示例：
cli.py trading.get_account
cli.py trading.get_positions
cli.py trading.get_orders
cli.py trading.get_orders --start_time 1720166400 --end_time 1720252799
cli.py trading.get_stock_price 603019
| 函数 | 用途 | 必填 | 位置参数顺序 |
|---|---|---|---|
buy(stock_code="", price=0, volume=0, secret_key=None) | 买入下单（数量须 100 整数倍） | stock_code, price, volume | 1.stock_code 2.price 3.volume |
sell(stock_code="", price=0, volume=0, secret_key=None) | 卖出下单（≤ available_volume，T+1） | stock_code, price, volume | 1.stock_code 2.price 3.volume |
cancel(order_no="", secret_key=None) | 撤单（仅待报/已报可撤） | order_no | 1.order_no |
示例：
# 位置参数（顺序：代码 → 价格 → 数量）
cli.py trading.buy 603019 45.0 100
cli.py trading.sell 603019 46.0 100
# 具名参数（顺序无关）
cli.py trading.buy --stock_code 603019 --price 45.0 --volume 100
cli.py trading.cancel --order_no O20260706143012345678
buy / sell 内部会按
BUY_PRICE_PREMIUM（默认 0.6%）小幅上浮委托价以提升撮合优先级。
| 函数 | 用途 | 必填 |
|---|---|---|
add_favorite(stock_code, stock_name="", add_price=0, remark="") | 添加自选股 | stock_code |
remove_favorite(stock_code) | 移除自选股 | stock_code |
get_favorite_list() | 自选股列表（含实时行情） | — |
check_favorite(stock_code) | 是否已在自选 | stock_code |
search_stocks(keyword) | 模糊搜索股票（代码/名称） | keyword |
示例：
cli.py trading.add_favorite 603019 --stock_name 中科曙光 --add_price 45.0 --remark 主线龙头
cli.py trading.search_stocks 曙光
| 函数 | 用途 | 必填 |
|---|---|---|
add_favorite_theme(theme_code, theme_name="") | 关注主题 | theme_code |
remove_favorite_theme(theme_code) | 取消关注主题 | theme_code |
get_favorite_theme_list() | 关注主题列表 | — |
check_favorite_theme(theme_code) | 主题是否已关注 | theme_code |
get_favorite_theme_stocks(field="zdf", sort="desc") | 各关注主题成分股聚合 | — |
get_favorite_theme_block_stocks(theme_code, field="zdf", sort="desc") | 单个关注主题成分股 | theme_code |
示例：
cli.py trading.add_favorite_theme theme_001 --theme_name 算力
cli.py trading.get_favorite_theme_stocks --field amount_main --sort desc
cli.py trading.get_favorite_theme_block_stocks theme_001 --field zdf --sort desc
| 函数 | 用途 | 必填 |
|---|---|---|
add_favorite_jtcsm(event_id, event_name="", trade_date="") | 关注事件（trade_date 必填 YYYY-MM-DD） | event_id, trade_date |
remove_favorite_jtcsm(event_id) | 取消关注事件 | event_id |
get_favorite_jtcsm_list() | 关注事件列表 | — |
check_favorite_jtcsm(event_id) | 事件是否已关注 | event_id |
get_favorite_jtcsm_stocks(field="zdf", sort="desc") | 各关注事件成分股聚合 | — |
get_favorite_jtcsm_block_stocks(event_id, field="zdf", sort="desc") | 单个关注事件成分股 | event_id |
示例：
cli.py trading.add_favorite_jtcsm evt_20260704_xxx --event_name 算力 --trade_date 2026-07-04
cli.py trading.get_favorite_jtcsm_block_stocks evt_20260704_xxx --field amount_main --sort desc
委托状态枚举、返回结构、T+1 与涨跌停约束 → 见 trading.py docstring。
skills.mock.report把盯盘 / 复盘总结上报到后台（写入 mock_log 表），属于接口调用层（依赖 _http）。
本地状态读写（交易日志 / 自选池 / 复盘总结 / 动态策略）已拆分到独立 skill skills.journal，
走 python skills/journal/cli.py <method>（见 skills/journal/SKILL.md）。
| 函数 | 用途 | 必填 |
|---|---|---|
submit_summary(log_type, content, date=None, secret_key=None) | 上报盯盘 / 复盘总结到后台（写入 mock_log 表），失败不影响主流程 | log_type, content |
示例：
# 盯盘总结（log_type=watch）
cli.py report.submit_summary watch "情绪偏激进，活跃 AI 算力，仓位 65%，买入工业富联"
# 复盘总结（log_type=review）
cli.py report.submit_summary review "今日盈亏 +1.2%，主线 AI 算力，反思止损执行到位"
cli.py report.submit_summary watch "..." --date 2026-07-09
log_type仅支持watch（盯盘）/review（复盘）。上报为「尽力而为」：网络 / 服务异常时返回错误信封但不抛异常，不影响已产出的总结内容与下一轮盯盘。
# 阶段检测（当前要做盯盘还是复盘由外部调度器告知，此处只取大盘汇总）
from skills.mock.market import get_summary
summary = get_summary() # 含 stage 等大盘汇总字段，用于状态行展示
# 买入流程：查价 → 查资金 → 下单 → 查委托
from skills.mock.trading import get_stock_price, get_account, buy, get_orders
get_stock_price("603019")
buy(stock_code="603019", price=45.0, volume=100)
get_orders()
# 卖出流程：查持仓（确认 available_volume）→ 查价 → 下单
from skills.mock.trading import get_positions, sell
pos = get_positions()["data"]
sell(stock_code="603019", price=46.0, volume=100)
# 记录一笔操作 + 读策略（本地状态读写走 journal skill）
from skills.journal.journal import append_trade_action, read_dynamic_strategy
append_trade_action("buy", "603019", "中科曙光", 45.0, 100, "主线龙头，符合买点")
read_dynamic_strategy()
import 自检（cwd = 项目根目录，供人类开发者用）：
python -c "from skills.mock.market import get_summary, get_hot_theme_list, get_theme_stock_list, nl_pick; from skills.mock.trading import buy, get_profit_curve, add_favorite_theme, add_favorite_jtcsm; from skills.journal.journal import read_trade_log; print('ok')"
CLI runner 自检（agent 实际使用的入口）：
python skills/mock/cli.py --list # 列出全部可用方法（验证 import 链）
python skills/mock/cli.py market.get_summary # 端到端：真实请求 + JSON 输出