严选股票

概述

Stock Thinking Select

安装

本技能依赖 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 调用。

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

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

• 统一 Go CLI；子命令列表见 westock help，单命令参数见 westock <子命令> --help
• 需网络

westock search 宁德时代
westock quote sh600519
westock quote sh600036,sh601318,sz300750    # 批量

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

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

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

核心铁律

1. 禁止绕过——命中本 Skill 能力域的查询，禁止用 web_search / HTTP 直连 / 训练数据替代。宏观数据（GDP/CPI/PMI/利率等）必须走 westock macro indicator，且短名禁止按自然语言猜——先 westock macro list [--region cn|us|hk|jp|eu] 查可用短名（如 us_inflation），再传给 indicator。
2. 未知代码先 westock search——用户只给名称时，先 westock search 拿代码再查行情。
3. 货币单位正确——港股港元/美元、美股美元、日股日元、韩股韩元；禁用人民币符号。
4. 筛股用 westock-screener——本 Skill 只做数据查询。
5. 多股批量——对比/分析 N 只股票时，凡支持批量的命令只调 1 次、代码用逗号分隔；禁止同一轮对比里「有的命令批量、有的按股拆开」。例外（必须单代码）见下方「批量例外」。
6. 代码必须带市场前缀——A股 sh/sz/bj、港股 hk、美股 us、日股 t、韩股 ks/kq、期货 fu/hf/r_hd、外汇 fx、板块 pt；禁止裸 6 位数字（300685）、禁止 Wind 格式（601988.SH）、禁止港股漏前缀（00700→hk00700）。
7. 探索纪律——SKILL.md / commands.md 已覆盖的命令禁止再调 --help；每个任务 --help 至多 1 次；不确定优先用本文「高频命令速查」与「参数命名约定」，而非反复 | grep 试探。
8. 指定日行情 → westock quote --date——查「某天/昨天/某历史日」的行情数据（涨跌幅、量比、收盘价等任意 quote 字段）一律用 westock quote <代码> --date YYYY-MM-DD，直接读返回字段（见 ai_usage_guide.md）；禁止用 westock kline 手算、禁止用无 --date 的实时 westock quote 取当天值答历史日。
9. 财报精确取值 → --fields——finance 默认输出核心字段窄表（--fields core，约 30 个核心指标）；需全字段时加 --fields all（100+ 列）。避免宽表列名相近看错列（如 OperatingRevenue ≠ OperatingProfit）；比率类指标（ROE / 毛利率等）直读报表返回值，禁止自行拼算。
10. 资金口径——A股/港股资金流向用 westock fund flow；港股/美股卖空、空头 用 westock fund short；港股南下持仓快照用 westock fund south-holding；个股龙虎榜用 westock fund lhb <代码>（仅沪深，支持 --date 指定日或 --start/--end 区间）；美股无 fund flow，卖空数据用 westock fund short。禁止用南下持仓替代卖空数据。
11. 复合分析靠编排原子命令——「事件后收益、多年 ROE 验证、板块/指数成份对比」等无单一命令，须编排多个原子命令：批量（逗号多 code）+ 并行（无依赖同轮发）+ 限量采样（--limit 20~30，基于 Top N 样本、非全量，交付须注明）。完整步骤见 [scenarios-guide §16](./references/scenarios-guide.md)。

参数命名约定

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

• 条数 → --limit（覆盖所有分页/条数场景）
• 周期 → --period day|week|month|season|year（日/周/月/季/年）
• 板块 → --type sector（概念/行业统一 sector，非 concept/industry/all）
• 代码 → 一律带市场前缀（见铁律 6）

输出与解析纪律

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

search 规则

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

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

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

批量查询

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

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

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

无依赖的多种查询（上列各条）同一轮并行发出。完整限制见 [routing-guide.md §六/§九](./references/routing-guide.md#六能力差异速查标的–维度)。

高频命令速查

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

# 行情 / K 线 / 财务 / 技术
westock quote sh600519
westock quote sh600519 --date 2026-07-03        # 指定历史日行情（涨跌幅/量比/收盘价等，见 ai_usage_guide）
westock kline sh600519 --period day --limit 20
westock finance sh600519,sz000651 --limit 1          # 多股三大表（默认 --fields core 核心窄表）
westock finance sh600519 --fields all                  # 全字段（100+ 列）
westock technical sh600519

# 新闻 / 研报 / 公告
westock news list sh600519 --limit 10
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
westock hot stock                               # 热搜股；另有 hot news/sector/etf

完整语法见 [commands.md](./references/commands.md)。

异常与空结果

1. 命令失败：如实转述，禁止编造数据。
2. 空结果：说明「暂无数据」；区分代码不支持 vs 时点无披露（必要时先 westock search）。
3. 能力不支持：如实告知（如美股无 westock fund flow），见 [routing-guide.md §六](./references/routing-guide.md#六能力差异速查标的–维度)。
4. 禁止：失败后改用 web_search 或凭训练数据补数。

Pay Skill 付费接入

⚠️ 本 Skill 已配置为 Pay Skill（已启用），支付能力由 weixinpay-pay（微信支付官方 skill）通过工程化支付完成，后端代理 stock-thinking-pay-proxy 仅负责生成支付凭据。

本 Skill 依赖 weixinpay-pay skill，命中付费能力域时，系统会自动检测 WeixinPay-Required 凭据并触发工程化支付（弹出微信支付卡片），智能体无需手动调用支付工具。

前置条件（已满足）

1. ✅ SkillHub 企业认证
2. ✅ 绑定微信商户号 1116625340（AppID wx91c0569b8ba0bc27 已授权）
3. ✅ 微信 Native 支付已开通
4. ✅ 后端代理已上云并验证（payproxy-299665-11-...sh.run.tcloudbase.com，公网 HTTPS）
5. ✅ .knot/metadata.json 的 pay_proxy_endpoint / developer_id / pub_key_id 已填真实值
6. ⚠️ 在 SkillHub 发布本 Skill 并设置定价（后台操作，按 pricing.amount=9 定价）

运行时付费闸门流程（Skill 命中付费能力域时执行）

本 Skill 是本地 CLI，命中付费能力域时必须走「付费闸门」——未付费不交付核心分析。

第 1 步：请求后端代理生成支付凭据

调用后端代理的 /skillpay/preorder 接口，获取 WeixinPay-Required 支付码（36 位 UUID）：

# 方式 A：直接 HTTP 调用代理（推荐）
curl -X POST https://payproxy-299665-11-1308070990.sh.run.tcloudbase.com/skillpay/preorder 
  -H "Content-Type: application/json" 
  -d '{"amount": 9, "description": "stock-thinking-select 单次调用", "out_trade_no": "<唯一单号>"}'

# 方式 B：使用内置脚本
python3 scripts/pay_gate.py request --amount 9 --description "stock-thinking-select 单次调用" --out-trade-no "<唯一单号>"

代理返回包含 WeixinPay-Required 字段的 JSON（示例）：

{
  "ok": true,
  "out_trade_no": "st_1724600000",
  "WeixinPay-Required": "ce3a3347-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "WeixinPay": {
    "WeixinPay-Required": "ce3a3347-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  }
}

第 2 步：系统自动触发工程化支付（无需智能体手动操作）

将上述返回原样回传给用户/系统。系统会自动检测 WeixinPay-Required 字段，触发 weixinpay-pay skill 的工程化支付流程，弹出微信支付卡片供用户扫码/确认付款。

重要：此步骤由系统 + weixinpay-pay 自动完成，智能体不得：

• 手动调用 mcp__weixinpay__weixinpay_retry_pay（仅用于取消后的重新支付场景）
• 向用户展示 WeixinPay-Required 的原始值（它是一次性支付凭证）
• 编造或臆测支付状态

第 3 步：支付完成后验付（确认款项到账再放行核心逻辑）

用户完成微信支付后，微信将回调通知推送到后端代理 /skillpay/notify（验签+解密+SQLite 落库）。智能体调用验付接口确认：

python3 scripts/pay_gate.py verify --out-trade-no "<第 1 步使用的同一单号>"
# 返回: {"paid": true, "transaction_id": "...", "amount": 9, "source": "local"}
#   paid=false 时：不要交付核心结果，提示用户先完成支付。

铁律：第 3 步 verify 返回 paid:true 之前，不得输出付费能力域的核心分析/数据结论。闸门失败或用户未付，返回「请先完成支付」并终止，严禁用 web_search/训练数据补足本应付费的内容。

单号复用：同一笔业务（同一用户、同一查询意图）必须用同一 out_trade_no，否则验付对不上。

安全约束

• private_key_pem 仅存于后端 stock-thinking-pay-proxy/config/keys/（权限 600），绝不进入本 Skill 文件、本地仓库或前端。
• 本 Skill 运行时只持有「代理公网地址」（来自 .knot/metadata.json 或环境变量 PAY_PROXY_ENDPOINT）。
• 后端已具备：Native 下单、X402 预下单、回调解密（APIv3 密钥）、回调验签（微信支付公钥）、订单 SQLite 持久化落库 + /skillpay/verify 验付（本地库优先、丢单兜底查微信）。
• 签名串格式（5 行，含末尾换行）：POSTn/palmpayminiapp/clawagentpay/preordern{timestamp}n{nonce_str}n{payment_required}n，由后端 pay_core.py + openssl 完成。
• 改完 .knot/metadata.json 或本目录任意文件后，必须用 compute_filehash.py 重算并写入 file_hash，否则 SkillHub 上传完整性校验失败。

当前状态速查

• pay_config.enabled = true（已启用付费）
• depends = ["weixinpay-pay"]（已声明依赖微信支付官方 skill）
• pay_proxy_endpoint = https://payproxy-299665-11-1308070990.sh.run.tcloudbase.com/skillpay/preorder（真实公网，已验证）
• 后端代理仓库：stock-thinking-pay-proxy/（零依赖，stdlib + openssl + pycryptodome）
• 详见文档：https://skillhub.cn/tutorials#agent-pay-upgrade

重要声明

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

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