前言¶
做 A 股量化或复盘时，筹码分布（CYQ）是常用视角：获利盘多少、成本区在哪、筹码是否集中。主流行情软件里都有类似图表，但在 Cursor、Claude Code 等 Agent 对话里，模型往往只能泛泛解释概念，很难按指定股票跑出与软件接近的数值。
下面介绍 SkillHub 社区 Skill「股票筹码分布分析工具」（@user_b806c584/stock-cyq-analyzer，当前版本 1.1.0）。它把量价数据、三角分布模型和本地缓存封装成可执行流程，Agent 在用户提到筹码相关问题时按 SKILL 指引调用脚本，输出 JSON 指标和图表路径，而不是代替你下买卖结论。
这是什么¶
一句话定位： 面向 A 股的轻量化 CYQ（Chip Distribution）分析 Skill，基于量价数据计算获利盘比例、主力成本区、筹码集中度等指标，并生成可视化结果。
维护与来源： 发布坐标 @user_b806c584/stock-cyq-analyzer，来源为 SkillHub community，分类 data-analysis，标签标明 requires_api_key=false（无需单独配置 API Key）。SkillHub 页面显示作者为 Lenipapa，所属「科恩实验室」，约 5 个月前更新；页面展示下载量约 1.4 万次。
解决的问题： 在 Agent 会话中复现「像行情软件那样」的筹码分布计算；通过 akshare 拉取 A 股历史数据，并写入本地 .stock_cache，分析时优先读缓存，减少重复联网取数。
核心功能¶
以下能力均来自官方 SKILL.md 与包内说明，可与 SkillHub 检索摘要交叉核对。
算法与数据¶
- 典型价格：
(Open + High + Low + Close) / 4 - 分布假设： 三角分布（以低点、高点、典型价格为参数）
- 历史衰减： 按换手率线性衰减
(1 - turnover) - 价格步长： 0.1 元
- 默认回溯： 脚本注释中默认约 180 个交易日（以实际拉取数据长度为准）
数据侧通过 akshare 获取 A 股行情；Skill 简介写明支持 A 股股票，并自带历史数据缓存。
输出指标¶
| 指标 | 说明 |
|---|---|
| 获利盘比例 | 当前价以下筹码占比 |
| 平均成本 | 持仓者平均成本价 |
| 筹码峰值 | 筹码最密集的价格 |
| 90%筹码集中度 | 90% 筹码所在价格区间宽度 |
| 主力成本区 | 筹码最密集的 20% 价格区间 |
运行脚本后输出 标准 JSON，其中包含上述类指标及图表文件路径。官方描述称分析结果与主流股票软件「相差无几」，但未承诺与任一商用终端逐字段一致，使用时宜以同一数据源、同一复权方式自行对照。
Agent 何时启用、何时不用¶
Skill 在 frontmatter 中约定：
- Use when： 用户提到「筹码分布」「筹码分析」「CYQ」「获利盘」「主力成本」「筹码集中度」「90%成本」等。
- NOT for： 推荐买卖时机、预测股价走势、给出投资建议。
介绍文章同样遵守这一边界：本文只说明工具能力，不构成投资意见。
安装与启用¶
安装分两层：先把 Skill 装进当前 Agent 的 skills 目录，再在 Skill 包内安装 Python 依赖。
1. 安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 安装说明 检查 CLI：
command -v skillhub && skillhub --version
未安装时可执行完整安装或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 将 Skill 安装到当前 Agent 的 skills 目录¶
SkillHub 要求安装时必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认落在 ./skills/ 可能无法被识别。
官方页面提供的安装提示词为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_b806c584/stock-cyq-analyzer。
CLI 检索结果给出的等价命令为：
skillhub install stock-cyq-analyzer --namespace user_b806c584 --dir <skills 目录>
常见 Agent 的 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
将 <skills 目录> 替换为你当前环境对应路径即可。安装完成后按各自客户端说明刷新或重启 Agent，使新 Skill 被加载。
3. 安装 Python 依赖¶
进入已安装 Skill 目录后，首次运行分析前安装依赖（版本范围见包内 requirements.txt）：
pip3 install -r requirements.txt
主要依赖包括：numpy、pandas、matplotlib、akshare（均已在 requirements.txt 中限定最低版本）。
典型用法¶
Skill 文档给出的直接调用方式如下。先在终端进入 Skill 包内的 scripts 目录，再传入 6 位 A 股代码（示例为深市股票，不带交易所后缀）：
cd scripts
python3 cyq_analyzer.py <股票代码>
示例：
python3 cyq_analyzer.py 000547
这一步会拉取或读取缓存行情、计算 CYQ，并在标准输出打印 JSON（含指标与图表路径）。在 Agent 场景中，用户通常用自然语言描述股票与需求（例如「看一下 000547 的获利盘和 90% 成本集中情况」），由模型根据 SKILL.md 选择上述命令或等价路径执行。
图表渲染使用 matplotlib 非交互后端；若运行环境缺少中文字体，可能需要按服务器字体配置调整，否则图中文字可能显示异常——这一点需在实际部署机器上验证。
适用场景与注意¶
适合谁
- 需要在对话式开发环境里快速查看单只 A 股的筹码结构指标，而不是手抄行情软件截图。
- 希望用 akshare + 本地缓存 降低重复取数成本的研究或复盘流程。
- 已使用 SkillHub 管理 Skills，希望用统一 CLI 安装社区数据分析类能力。
限制与注意
- 非投顾工具： Skill 明确排除买卖建议、走势预测；输出应作为量价结构参考，不能替代合规研究流程。
- 数据与缓存： 行情来自 akshare，网络、接口变更或个股停牌会影响结果；缓存默认按脚本逻辑在约 1 天内复用（见
load_cached_data的max_age_days），需要最新数据时应了解如何刷新或删除.stock_cache下对应 pickle。 - 环境依赖： 需要可用的 Python 3 与上述 pip 包；Linux 环境下字体路径在脚本中写死为 Noto CJK 路径，与 macOS/Windows 默认环境可能不一致。
- 版本： 以 SkillHub 页面与安装包为准，当前公开版本为 1.1.0；升级时用
skillhub按你环境的更新流程处理即可。
结尾¶
「股票筹码分布分析工具」把 CYQ 三角分布计算、akshare 数据与本地缓存收敛进标准 SKILL 流程，让 Agent 在用户谈到筹码、获利盘、主力成本等关键词时，能落到可复现的脚本与 JSON 输出，而不是空泛描述。若你要自行安装或查看详情，可参考：
- Skill 包地址：https://api.skillhub.cn/user_b806c584/stock-cyq-analyzer
- SkillHub 页面：https://www.skillhub.cn/skills/user_b806c584/stock-cyq-analyzer
- 安装说明：https://skillhub.cn/install/skillhub.md
