前言¶
做 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
