前言¶
做量化腳本、復盤或研報草稿時，常見路徑是翻 pytdx 文檔、對照通達信協議字段，再在對話裏讓模型「猜」接口名和參數。模型容易混用舊示例、漏掉分頁或市場代碼，返工多在聯調階段。下面介紹 SkillHub 上的「通達信股票專業數據源」，它把 pytdx 的接口說明與使用指引打包成 Agent Skill，在用戶明確提出行情、K 線、分時、成交明細、財務或板塊等需求時，引導按同一套參考作答。
這是什麼¶
「通達信股票專業數據源」是社區發佈（community）的 Skill，座標爲 @user_8c7f0f65/tdx-pro，當前版本 5.0.1，分類爲 professional。發佈者爲 SkillHub 用戶 user_8c7f0f65；頁面標註作者爲股票愛好者。Skill 不要求配置 API Key（requires_api_key=false）。
定位可以概括爲：圍繞開源庫 pytdx（通達信協議客戶端）提供完整 API 接口參考與使用指導，解決「在對話式開發裏如何穩定、按文檔取數」的問題，而不是替代券商終端或官方行情授權。
官方入口：
- API 座標頁：https://api.skillhub.cn/user_8c7f0f65/tdx-pro
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_8c7f0f65/tdx-pro
核心功能¶
依據 SkillHub 簡介，已寫明的能力範圍包括：
- A 股行情與期貨行情查詢相關接口說明與用法。
- K 線數據、分時數據、成交明細等時序與逐筆類數據的獲取指引。
- 財務數據與板塊信息類接口的參考與使用說明。
- 整體以 pytdx 庫的 API 爲軸，供 Agent 在用戶提問時對照調用路徑與參數，而非零散記憶片段。
公開頁面上未單獨列出子命令清單；具體接口名與示例以安裝後的 Skill 內容（通常爲 SKILL.md 及附帶參考）爲準。
安裝與啓用¶
SkillHub 推薦通過 skillhub CLI 安裝，且必須指定當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。
1、檢查 CLI
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝或僅 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
將 @user_8c7f0f65/tdx-pro 裝到當前環境對應的 skills 目錄。例如 Cursor 常用路徑爲 ~/.cursor/skills/，Claude Code 爲 ~/.claude/skills/，Codex 爲 ~/.codex/skills/ 或項目下的 .agents/skills/（以你實際使用的客戶端爲準）：
skillhub install @user_8c7f0f65/tdx-pro --dir ~/.cursor/skills/
也可在對話中讓 AI 按官方安裝說明操作，SkillHub 頁面給出的提示爲：根據 https://skillhub.cn/install/skillhub.md 安裝 @user_8c7f0f65/tdx-pro。
3、運行依賴
Skill 指導的是 pytdx 的用法；在本地或沙箱中真正拉數時，仍需自行安裝 Python 環境與 pytdx，並保證能連通達信行情服務器（網絡與合規由使用方負責）。Skill 本身不替代行情源授權。
典型用法¶
公開資料未附帶完整可複製的一鍵腳本；典型工作流如下，與 Skill 簡介一致：
- 在已啓用該 Skill 的 Agent 中，用自然語言說明標的與市場類型（例如 A 股代碼、期貨合約）、數據類型（K 線週期、分時、成交明細、財務字段、板塊成分等）。
- Agent 依據 Skill 內的 pytdx API 參考選擇接口、參數與分頁方式，並提示本地安裝 pytdx 與連接行情服務的步驟（具體以 Skill 正文爲準）。
- 將生成的調用代碼在本地執行、校驗返回字段；若協議或服務器列表變更，以 pytdx 項目與 Skill 更新版本爲準。
適合把「查文檔 + 寫樣板代碼」合併成一次對話，由 Skill 約束回答結構與接口名稱。
適用場景與注意¶
適合誰
- 已用或打算用 pytdx 做研究、腳本、教學演示的開發者。
- 在 Cursor、Claude Code、Codex 等支持 Skills 的客戶端裏，希望模型按統一參考回答通達信相關取數問題的人。
限制與注意
- 數據來自通達信協議與公開服務器生態，不保證與商業終端延遲、權限、歷史完整性一致；實盤與合規決策需自行覈實。
- Skill 爲社區來源（
community），維護節奏取決於發佈者；版本以 SkillHub 爲準（當前 5.0.1）。 - 無需 API Key 指 Skill 安裝與元數據層面；行情連接仍受網絡與 pytdx 環境影響。
- SkillHub 統計（截至頁面展示）：評分 100000，下載 38257，安裝 188；數字會隨平臺更新變化。
結尾¶
若你經常在 Agent 裏問 A 股、期貨的 K 線、分時、成交明細、財務或板塊數據，「通達信股票專業數據源」把 pytdx 的接口參考與使用指導固化成 Skill，能減少接口名與參數上的漂移。安裝與詳情見：https://www.skillhub.cn/skills/user_8c7f0f65/tdx-pro ，座標頁：https://api.skillhub.cn/user_8c7f0f65/tdx-pro 。
