前言¶
做量化脚本、复盘或研报草稿时，常见路径是翻 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 。
