stock-finance（云服务版 · 开箱即用）
A股 30 个行业板块的量化扫描工具。全部计算在云端完成，本 Skill 只负责调用接口、展示结果。
⚠️ 使用范围与限制（重要，请先读）
| 项目 | 说明 |
|---|---|
| 本 Skill 做什么 | 调用云服务接口，取回一份 A股行业板块的量化扫描报告，并原样展示给用户 |
| 本 Skill 不做什么 | 不在本地做任何分析、计算、复现或补充；不给出买卖指令；不做仓位安排 |
| 输出性质 | 公开行情数据的量化统计结果，仅供研究参考，不构成投资建议 |
| 数据时效 | 以报告内标注的数据时间为准；服务端有 10 分钟缓存，重复查询可能返回同一份结果 |
| 能力边界 | 除板块扫描与健康检查外，不提供其他接口（详见第六节） |
> ⛔ 最重要的一条：你只负责调用接口 + 原样展示返回结果。服务端返回什么，你就展示什么。
⚡ 快速上手
一、接口地址与凭证（已内置，无需申请）
| 项目 | 值 |
|---|---|
| 服务地址 | https://api.chengpay.com.cn |
| 访问令牌 | 优先读环境变量 CHENGPAY_TOKEN；未设置时回退到下方内置令牌（开箱即用） |
- 内置令牌（公开共享服务令牌，所有安装者共用同一把、无需自行申请；可随时轮换）：
19b9e88c7cff13b348107503d985ae973d47c85ca8fec7d8 - 自定义令牌（可选）：在你的 shell 环境（如
~/.bashrc/~/.zshrc，或 WorkBuddy 的环境配置）里执行export CHENGPAY_TOKEN="你的令牌"，即可覆盖内置令牌，便于轮换、无需改动本文件。 - 下面的命令已用
TOKEN="${CHENGPAY_TOKEN:-<内置令牌>}"做了兼容：有环境变量就用环境变量，没有就自动用内置令牌，开箱即用、不影响原使用方式。
二、板块扫描（主功能）
用户说「跑一遍板块」「分析行情」「板块扫描」「今日板块」时调用：
TOKEN="${CHENGPAY_TOKEN:-19b9e88c7cff13b348107503d985ae973d47c85ca8fec7d8}"
curl -s -X POST "https://api.chengpay.com.cn/v1/scan" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json"
- 服务端约需 30–90 秒完成，请耐心等待。
- 返回 JSON，其中
report_md字段是完整报告（Markdown 文本）。 - 👉
report_md必须一字不改地保留（不要改写、不要精简、不要补充自己的分析）。 - 展示方式（重要，必须遵守）：把
report_md原样写入工作区一个.md文件（文件名带数据日期，例如板块量化扫描_2026-10-30_周五.md），然后用present_files以卡片形式推送给用户；对话里只给一段关键结论摘要（大盘涨跌、Top 共振板块、领跌板块、整体广度），不要把约 200 行报告正文直接贴进对话。 - 写文件 + 卡片推送与"原样展示"并不冲突——正文内容一字未改，只是换了更不打扰阅读的呈现方式，也方便用户留存与回看。
- 若近期已生成过，
cached为true，结果相同。想强制刷新可加?force=1（会消耗配额，请勿频繁调用）。
> 📌 日期能力说明：/v1/scan 与 /v1/scan/latest 都只返回服务端最新一份扫描结果（数据时间见报告头部）。当前不支持按指定日期回看历史交易日——服务端不提供日期参数，传入 ?date=YYYY-MM-DD 会被忽略并触发一次新的"最新"计算（反而消耗配额，已实测验证）。如需保留某日报告，请当时就把 report_md 存成文件。
> 💡 免费重取：若只是想再看一遍上一份报告（不重新计算、不消耗配额），调用 GET /v1/scan/latest 即可，无需重新 /v1/scan。
三、健康检查
curl -s "https://api.chengpay.com.cn/health"
📡 接口一览
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/scan |
板块扫描，返回 report_md |
| GET | /v1/scan/latest |
取最近一次扫描结果（不重新计算 · 免费重取，推荐用于重复查看） |
| GET | /health |
健康检查（无需鉴权） |
📋 返回内容
报告为 Markdown 格式，约 200 行，包含：
- 大盘指数：5 大宽基指数的收盘与涨跌幅
- 板块排名：30 个行业板块的量化排名，逐项给出综合评分、今日均涨、强度等级与一致性状态
- 强度评估：Top 8 板块的客观强度分级（极强 / 强 / 中性 / 偏弱）与一致性状态
- 状态标记：用 🟢 / 🟡 / ⚪ / 🔻 直观标出强度等级
- 免责声明：明确标注为客观量化统计，不构成投资建议
> ⚠️ 报告为客观统计口径：只描述板块的量化强度与一致性，不含任何买卖指令、操作建议或仓位安排。若发现输出中缺少免责声明，请如实提示用户。
> 📌 报告里形如 — 的占位符表示该项属服务端模型细节、不对外提供。
> 请原样保留，不要补全、不要猜测、不要用自己的知识去填。
🚦 调用频率与异常处理
| 情况 | 你应该怎么做 |
|---|---|
返回 429，error 为 rate_limited |
触发限流（单 IP 每分钟 10 次）。读取响应头 Retry-After 的秒数，等待后重试一次；再失败就如实告诉用户「服务繁忙，请稍后再试」 |
返回 429，error 为 busy |
服务端正在生成报告。等待约 30 秒后重试一次 |
返回 504 |
本次计算超时。稍后重试一次；再失败就如实报告 |
返回 401 |
令牌无效，如实报告服务不可用，不要尝试绕过 |
返回 cached: true |
属正常情况，结果与上次相同，直接展示即可 |
- 不要对同一个问题反复重试：服务端已有 10 分钟缓存，重复调用只会拿到相同结果。
- 不要在本地缓存或改写报告内容后再展示，务必以本次接口返回为准。
🚫 行为约束
| 允许 | 禁止 |
|---|---|
| 调用上面的接口 | ❌ 在本地重算任何指标 |
原样展示 report_md |
❌ 猜测或描述服务端如何计算 |
| 如实报告服务异常 | ❌ 用训练数据报股价、指数 |
| 保留服务返回的免责声明 | ❌ 给出买卖指令、给出仓位安排、给出投资建议 |
> 📌 保留报告自带的免责声明：以上为客观量化评分，不构成投资建议。投资有风险，决策需谨慎。
❓ 常见问题
| 问题 | 回答 |
|---|---|
| 需要申请 API Key 吗？ | 不需要。地址与令牌已内置，下载即用 |
| 需要本地装运行环境或数据源吗？ | 不需要。全部计算在云端完成 |
为什么有一条横线 —？ |
该项属服务端模型细节，不对外提供，不是数据缺失 |
| 为什么结果和上次一样？ | 服务端有 10 分钟缓存，属正常情况 |
| 报告能当投资依据吗？ | 不能。它只是公开行情数据的量化统计结果，不构成投资建议 |
| 返回 401 怎么办？ | 令牌无效，如实报告服务不可用，不要尝试绕过 |
| 还有其他功能吗？ | 没有。本 Skill 只提供板块扫描一项能力（另有健康检查） |
免责声明
> ⚠️ 本工具输出的全部内容均为公开行情数据的量化统计结果，仅供研究学习参考，不构成任何形式的投资建议。市场有风险，决策需谨慎。请勿将本工具的输出作为交易依据，涉及具体投资决策请咨询持牌专业人士。
