前言¶

在 Cursor、Claude Code 等環境裏做 A 股短線或量化相關對話時，常見問題是：模型能講概念，卻缺少統一的「查數—畫圖—對比」路徑。自己拼腳本要處理代碼解析、分鐘週期寫法、指數與個股接口差異；多隻股票還要對齊行情字段和走勢歸一化。SkillHub 上的 同花順（座標 @user_6b3ace61/straightflush，當前版本 1.0.0）把能力寫進 SKILL.md：底層走 thsdk，由 Agent 按場景選用分鐘 K 線、板塊成分、盤口大單、競價異動與批量對比等流程。下面介紹它是什麼、能做什麼、如何安裝與典型觸發方式。

這是什麼¶

同花順 是 SkillHub community 來源、分類爲 professional（子類「金融分析」）的 Agent Skill，發佈者爲 user_6b3ace61。頁面標籤標明 requires_api_key=false，即 Skill 本身不要求單獨配置 API Key。

一句話定位：基於 thsdk 的高級股票分析 Skill——把行情、K 線、板塊、盤口、大單、競價、分時及多股對比等操作收斂到同一套調用約定裏，並寫明何時必須啓用本 Skill（見官方簡介中的關鍵詞列表）。

官方入口：

• API 頁：https://api.skillhub.cn/user_6b3ace61/straightflush
• SkillHub 詳情：https://www.skillhub.cn/skills/user_6b3ace61/straightflush

核心功能¶

以下能力與官方簡介及 Skill 包內 SKILL.md 一致，按數據類型歸納。

行情與 K 線¶

• 分鐘 K 線：週期包括 1m / 5m / 15m / 30m / 60m / 120m（Skill 強調須寫 "5m" 等形式，不能寫 "5min"）。
• 日 K 及更長週期：day / week / month 等；支持按條數或時間範圍拉取，可選前復權等參數。
• 日內分時、歷史某日分時：如 intraday_data、min_snapshot。
• 港股、美股、外匯、期貨：對應 market_data_hk / market_data_us / market_data_forex / market_data_future 等（以 Skill 場景表爲準）。

板塊、指數與成分¶

• 主要指數、申萬行業、概念板塊相關列表與行情。
• 板塊成分股、行業排名類需求：通過 ths_industry、ths_concept、market_data_block、block_constituents、market_data_index 等組合完成；指數需用 market_data_index，不能誤用個股行情接口。

短線與資金面¶

• 盤口深度：五檔及買賣盤詳情（如 depth、order_book_bid / order_book_ask）。
• 大單流向：big_order_flow。
• 集合競價異動：如 call_auction_anomaly("USHA") 等掃描方式。

多股批量分析¶

• 多隻股票 表格對比、歸一化走勢圖、相關性熱力圖；Skill 內提供 examples/03_multi_stock_compare.py 等示例腳本說明批量 search_symbols、market_data_cn 與 klines 的配合方式。

資訊與其它¶

• 資訊 / 快訊：news()。
• 問財 NLP 選股與條件查詢：wencai_nlp(...)（示例見 examples/05_wencai_nlp.py）。
• IPO、權息等輔助接口在場景速查表中列出。

Skill 還約定：用戶意圖模糊時先澄清（例如「分析一下某股」需確認要看實時、分鐘 K、日 K 還是多股對比）；意圖明確時直接執行。

安裝與啓用¶

安裝分兩層：Skill 包（給 Agent 讀規則）與 Python 依賴 thsdk（真正取數）。

1. 安裝 SkillHub CLI（若尚未安裝）¶

按 SkillHub 官方安裝文檔檢查或安裝 CLI：

command -v skillhub && skillhub --version

未安裝時可執行（完整安裝或僅 CLI，以 https://skillhub.cn/install/skillhub.md 爲準）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 安裝同花順 Skill¶

搜索確認座標後安裝。官方搜索結果顯示的安裝命令爲：

skillhub search straightflush
skillhub install straightflush --namespace user_6b3ace61 --dir <當前 Agent 的 skills 目錄>

--dir 必須指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不被加載。SkillHub 文檔中的常見路徑包括：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下 .agents/skills/

安裝完成後需按你所用客戶端的要求 重新加載或重啓 Agent，使新 Skill 生效。

3. 安裝 thsdk¶

Skill 包內要求 Python 側依賴：

pip install --upgrade thsdk

系統要求（來自 Skill 文檔）：Python 3.9+；支持 Linux（x86_64 / arm64）、macOS、Windows。連接示例爲遊客模式，無需在 Skill 層配置賬戶：

from thsdk import THS

with THS() as ths:
    ...

典型用法¶

啓用 Skill 後，用自然語言觸發即可；下列表述與官方簡介中的 必須使用此 skill 條件一致，Agent 應優先走本 Skill 而非泛化回答。

單股分鐘走勢

拉一下寧德時代最近一個交易日的 5 分鐘 K 線，並標一下成交量異動。

對應能力：klines(code, interval="5m", count=...)，代碼需先 search_symbols 得到 THSCODE（如 USZA300033）。

板塊與成分

看下申萬行業裏漲幅靠前的幾個行業，並列出其中一個概念板塊的成分股行情。

多股對比

對比貴州茅臺、五糧液、瀘州老窖、山西汾酒近 30 日前復權走勢，給表格、歸一化圖和相關性。

Skill 倉庫內 examples/03_multi_stock_compare.py 描述了批量解析、按市場分組查行情與作圖的步驟，可作爲 Agent 或人工復現的參考。

盤口與競價

看下某隻滬市股票的五檔盤口和大單流向；再掃一下集合競價異動。

跨市場或資訊

查一下某港股代碼的實時行情；順便拉幾條相關快訊。

查任何中文名或縮寫前，Skill 要求先 search_symbols 解析爲完整 THSCODE，並遵守「單條 / 多條 A 股」的選碼規則；常用指數代碼（如 USHI000001 上證指數）可直接使用。

適用場景與注意¶

適合誰

• 需要在對話裏同時看 2 只以上 股票、做 漲幅對比 或 相關性 分析的用戶。
• 關注 短線交易、盤中 分鐘 K 線、日內走勢、盤口、大單、競價異動 的場景。
• 做 量化研究 或板塊輪動，需要行業、概念、成分股與指數行情聯動時。
• 話題涉及 港股、美股、外匯、期貨、資訊、快訊 且希望走統一 thsdk 接口時。

限制與注意

1. 名稱與數據源：Skill 展示名爲「同花順」，實現依賴社區發佈的 Skill 文檔與 thsdk（PyPI：thsdk），使用前請自行確認數據許可、延遲與合規要求。
2. 網絡與環境：取數依賴本機可訪問 thsdk 所用服務；沙箱或離線環境需自行驗證。
3. 安裝路徑：skillhub install 務必帶 --dir，並與 Cursor / Claude Code / Codex 等實際 skills 目錄一致。
4. 接口細節：指數與個股、不同 MarketStr 前綴的接口不可混用；分鐘週期字符串格式錯誤會導致調用失敗（見 Skill 內 K 線章節）。
5. 社區 Skill：來源爲 community，發佈者 user_6b3ace61；SkillHub 頁面展示下載量等統計會隨時間變化，以詳情頁爲準。

結尾¶

同花順 Skill 把 thsdk 上的分鐘 K 線、板塊指數、盤口大單、競價異動、分時與多股批量對比寫進 Agent 可執行的規範裏，並明確一批應強制啓用該 Skill 的對話關鍵詞。若你已在用 Cursor 或 Claude Code 做 A 股相關分析，可按上文安裝 Skill 與 thsdk，從分鐘走勢或多股對比類問題開始驗證。

官方地址：https://api.skillhub.cn/user_6b3ace61/straightflush（SkillHub 頁面：https://www.skillhub.cn/skills/user_6b3ace61/straightflush）。