前言¶

用 TqSdk 写量化策略时，常见的问题是「会用 Python，但不知道怎么把 TqSdk 跑通」：wait_update 循环怎么挂、行情数据从哪取、历史数据怎么下载、账户类型选 TqKq 还是 TqSim、保证金率去哪查、TargetPosTask 怎么调仓。这类问题散落在文档各处，问 AI 时又容易被通用的量化知识带偏。下面介绍的这个 Skill，就是把 TqSdk 的官方工作流固化成可调用的 SKILL，让 AI 在处理 TqSdk 请求时按官方口径解释、实现和排错。

这是什么¶

Tqsdk-Skills（天勤量化官方SKILLS）是 TqSdk 的官方 skills 包，坐标 @user_bc4afc83/tqsdk-python，由 user_bc4afc83 发布维护。TqSdk 是天勤推出的量化交易框架，官方定位是「更适合 AI 的量化交易框架」，覆盖回测、实盘、模拟、数据下载和风控。这个 Skill 解决的问题，是让 AI 在接到 TqSdk 相关请求时，给出与官方文档一致的实现和排错建议，而不是凭通用经验回答。

核心能力¶

1、更新循环：wait_update 与 is_changing 的写法与常见陷阱。

2、行情与数据：实时行情、K 线、tick 获取，以及 DataDownloader 历史数据下载。

3、账户与模拟：TqAuth、TqAccount、TqKq、TqKqStock、TqSim、TqSimStock、TqMultiAccount、TqBacktest 等账户类型的选择与配置。

4、交易与持仓：资金、持仓、委托、成交字段的含义，下单、撤单，以及 TargetPosTask、TargetPosScheduler、Twap 等目标仓位工具。

5、保证金与风控：TqScenario 场景试算、实盘保证金率查询、保证金与风险度的 what-if 分析。

6、排错：常见 TqSdk 报错的定位思路。

安装与启用¶

该 Skill 在 SkillHub 上以社区形式发布，地址：

https://www.skillhub.cn/skills/user_bc4afc83/tqsdk-python

官方接口地址：

https://api.skillhub.cn/user_bc4afc83/tqsdk-python

已抓取资料中未给出具体的安装命令和客户端配置步骤（如 Cursor、Codex CLI、Claude Code 各自的安装方式），也未说明各平台是否有差异，因此这里不臆测命令。需要在本地启用时，建议打开上述 SkillHub 页面查看当前版本的安装说明，安装时留意版本号为 1.0.3。该 Skill 标记 requires_api_key=false，使用前不需要单独申请 API Key。

典型请求示例¶

已抓取资料未附可复现的代码样例，下面列出的是可以按官方文档展开的请求方向：

1、解释 wait_update 更新循环的结构，说明主循环里该轮询哪些对象。

2、给出下载历史 K 线数据的调用方式，包括合约代码和周期参数。

3、在 TqKq（快期模拟）与 TqSim（TqSdk 模拟账户）之间做选择，说明两者适用场景。

4、查询实盘账户的保证金率，并基于该数值做保证金或风险度试算。

5、用 TqScenario 做保证金场景试算，对比不同行情下的保证金占用。

6、用 TargetPosTask 实现目标仓位调仓，说明设置目标持仓后的信号更新机制。

7、排错：给出某个 TqSdk 报错信息，让 Skill 按官方口径定位原因。

适用场景与注意¶

适合使用 TqSdk 做策略开发、回测或模拟交易的开发者，以及需要 AI 帮忙写 TqSdk 代码、解释字段含义、排查报错的团队。它的价值在于回答有官方依据，适合「问 TqSdk 怎么写」这类具体问题。

限制方面要注意：资料中该 Skill 的来源标记为 community，不是官方包，选择时可结合更新频率自行判断；已抓取资料里的下载量与评分（下载 1696 次、评分 100000）反映的是抓取时点的页面数据。涉及实盘下单、保证金调整等操作时，最终以 TqSdk 官方文档为准，并在模拟账户上先验证。官方文档地址：

https://www.shinnytech.com/products/tqsdk

结语¶

Tqsdk-Skills 把 TqSdk 的更新循环、行情数据、账户类型、交易接口、目标仓位工具和保证金试算等主题收敛成一个官方口径的 SKILL。对于已经确定用 TqSdk 的开发者，它比通用量化问答更对路。SkillHub 页面：https://www.skillhub.cn/skills/user_bc4afc83/tqsdk-python