WeStock Data

安装

本技能依赖 westock CLI，使用前必须先安装。

# 安装脚本已随技能包提供，可先审阅 scripts/ 目录下的文件再执行
# macOS / Linux
bash scripts/setup.sh

# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File scripts/setup.ps1

# 跨平台（Node ≥ 18）
node scripts/setup.cjs

安装后执行 westock --help 验证；刚安装完命令找不到时，先 source 对应 shell profile（如 ~/.zshrc）使 PATH 生效，再用 westock 调用。

westock: command not found 时：重跑 bash scripts/setup.sh（幂等，会覆盖安装）。不要用 export PATH、猜路径或 find / 找二进制。重装后仍找不到则如实告知，不要反复重装。

安全说明：安装脚本自动执行 SHA256 校验（校验值随包内 scripts/ 或与官方源一同分发），无需手动验证。

调用方式：westock <子命令> [参数]

• 统一 Go CLI；渠道发布包内二进制通常为 westock
• 无脚本入口，只能通过 westock 命令调用
• 需网络

westock search 宁德时代
westock kline sh600519 --period day --limit 20
westock kline sh600036,sh601318,sz300750 --period day --limit 20    # 批量

并发：无依赖的多个查询（如 kline + report + fund flow）应在同一轮工具调用中并行发出，不要串行等结果。

参考文档（仅不确定时查阅，禁止每次任务都读）

• routing-guide.md — 场景路由、与其它 Skill 边界
• commands.md — 完整命令语法
• scenarios-guide.md — 分析场景模板
• ai_usage_guide.md — 返回字段说明

核心铁律

1. 禁止绕过——命中能力域的查询只走本 Skill，不用 web_search/HTTP/训练数据替代。
2. 未知代码先 westock search——用户只给名称时，先拿代码再查。
3. 货币单位随市场（港元/美元），禁用人民币符号。
4. K 线有延迟——kline 非实时，展示须标数据日期，勿称「现价」「实时涨跌」。
5. 多股批量——支持批量的命令一次逗号传多 code，禁止同轮里一部分批量、一部分拆开。单代码例外见下方「批量例外」。
6. 代码必带市场前缀（sh/sz/bj·hk·us·fu·fx·pt），禁止裸数字 300685、Wind 格式 601988.SH、港股漏前缀 00700。
7. 探索纪律——SKILL.md/commands.md 已覆盖的命令勿再 --help（每任务至多 1 次），优先查本文速查表而非反复试探。

命令选型速查

「查这类数据该用哪条命令」——选对命令与参数，勿用别的命令硬凑或手算：

参数命名约定

本 CLI 参数名与取值都用简短写法（如 --limit 20、--period day、--type sector），不要自创长参数或复数形式；不确定某参数/取值，回 commands.md 该命令小节核对，不要猜。

常见参数速查：

• 代码 → 一律带市场前缀（见核心铁律「代码必带市场前缀」）。

输出与解析纪律

• 默认输出已是结构化 Markdown 表格（含关键字段），直接读取分析，禁止用脚本/正则/Python 去解析命令的文本输出。
• 禁止终端截断：不要用 | grep / | head / | tail / | sed 过滤输出，也不要用 && / ; 拼接多条命令；条数、分页、筛选只用该子命令自己的参数（不同命令支持的 flag 不同，禁止跨命令套用）。
• 返回字段含义见 ai_usage_guide.md，不确定字段含义再查阅，不要靠反复试错猜。

search 规则

默认仅搜股票（westock search <关键词> = --type stock，只调 1 次接口）。不会自动查 ETF/板块/指数/期货/外汇。--type 支持逗号分隔多个类型同时搜（如 --type etf,index,sector），一条命令按类型分组返回，优于依次盲试。

空结果时：读 CLI 返回的提示，按用户原意最多再试 1 种 --type，不要对同一关键词依次扫 etf→bond→index→sector。仍无结果则告知用户，不要死磕。

禁止：对同一关键词连续换 3+ 种 --type 盲试（如需多类型，用 --type a,b,c 一次搞定）。

批量查询

多标的对比：代码用逗号写在同一条命令里（如 westock finance sh600519,sz000651），不要一股一条命令。

# 分析 sh600519 + sz000651 → 下面各 1 次（共 5 次），不是 10+ 次
westock kline sh600519,sz000651 --period day --limit 60
westock finance sh600519,sz000651 --limit 4
westock technical sh600519,sz000651
westock fund flow sh600519,sz000651
westock report list sh600519,sz000651 --limit 5

批量例外（不支持逗号多代码，须分开调；可同一轮并行发出）：

无依赖的多种查询（上列各条）同一轮并行发出。完整限制见 routing-guide.md §六/§九。

高频命令速查

# 搜索
westock search 宁德时代
westock search 半导体 --type sector

# K 线 / 财务 / 技术
westock kline sh600519 --period day --limit 20
westock finance sh600519,sz000651 --limit 1          # 多股三大表
westock technical sh600519

# 研报 / 公告
westock report list sh600519 --limit 5
westock notice list sh600519 --limit 10

# 板块 / 指数 / 宏观
westock sector constituent pt01801080          # 成份股
westock sector valuation pt01801080            # 估值 PE/PB/PS + 历史百分位
westock sector finance pt01801780               # 申万行业财报 TTM 聚合（仅申万行业，聚源概念不支持）
westock index constituent sh000300
westock macro indicator cn_core --date 2026-03-01

# 资金 / 北向
westock fund flow sh600519
westock fund north-holding sh600519
westock fund south-holding hk00700
westock fund north-holding pt01801080             # 仅申万行业，聚源概念板块不支持

# ETF
westock etf profile sh510300

完整语法见 commands.md。

异常与空结果

1. command not found：重跑 bash scripts/setup.sh 后重试。
2. 命令失败（其他）：如实转述，禁止编造数据。
3. 空结果：说明「暂无数据」；区分代码不支持 vs 时点无披露（必要时先 westock search）。
4. 能力不支持：如实告知（如美股无 westock fund flow），见 routing-guide.md §六。
5. 禁止：失败后改用 web_search 或凭训练数据补数。

重要声明

本技能仅提供客观市场数据查询，不构成投资建议。数据可能有延迟，以交易所官方为准。投资有风险，决策需谨慎。

数据来源：腾讯自选股数据接口