📦 Tqsdk Futures ApiTqSdk — Tqsdk 期货 API TqSdk
v0.3.3是中国期货市场实时行情获取与策略回测框架，支持期权定价模型构建与波动率因子分析，适用于网格交易、目标仓位管理等量化场景。 触发场景： (1) 用户需获取期货实时行情并连接模拟账户； (2) 用户需用 CSI 300 时变波动率扩展 Black-Scholes 期权定价模型； (3) 用户需基于对手价和...
0· 55·0 当前·0 累计
by 下载技能包
最后更新
2026/4/23
安全扫描
OpenClaw
可疑
medium confidence该技能仅为指令型金融/回测工具
评估建议
这是一条仅含指令的金融/回测技能，其预期运行环境为 Python（SKILL.md 要求 Python 3.12+ 及 uv），并依赖现有工具包（zvt、tqsdk、joinquant 等记录器），尽管已发布的 manifest 未列出任何必需二进制文件、环境变量或安装步骤。安装或调用前，请：
1. 要求作者明确并发布确切的运行时需求（Python 版本、pip/uv 命令、所需包及其安装源）。
2. 在技能明确请求并说明用途前，切勿提供任何券商/API 凭证（joinquant、qmt、broker tokens）。
3. 先在沙箱/容器或临时环境中运行——它可能会执行 pip install 并创建/修改 ~/.zvt 等数据目录。
4. 自行检查 seed.yaml 及其引用的前置/安装步骤；要求提供正式的安装规范或白名单命令。
5. 若允许自动调用，先限制其权限，直到依赖/安装缺口补齐。
如需，我可为你整理一份发给技能作者的具体问题清单，或一份最小安全沙箱运行方案。...详细分析 ▾
⚠ 用途与能力
SKILL.md 与参考文件描述了一个基于 Python 的回测/行情数据管道（TqSdk / ZVT / ZVT 相关工具），明确要求 Python 3.12+ 与 'uv' 包管理器；然而已发布的技能元数据未声明任何必需二进制文件、安装步骤及环境变量。名称暗示 TqSdk 期货 API，但内容混杂 TqSdk、ZVT、qlib 等框架——这种混合对金融蓝图合理，但清单遗漏了运行时指令似乎需要的依赖。
⚠ 指令范围
SKILL.md / seed.yaml 会指示智能体重新读取 seed.yaml，运行执行 Python 命令的预条件，检查/安装 zvt，并 touch ZVT_HOME（~/.zvt）。这些运行时指令可执行 shell/python 命令并创建文件。虽然这对回测助手是预期行为，但该技能未在清单中声明这些操作，赋予智能体极大自由（重载源文件、运行预条件命令、执行 seed.yaml 引用的安装器）。
ℹ 安装机制
注册表中不存在 install spec（仅含指令），本身风险较低。然而 seed.yaml/execution_protocol 引用了 install recipes 和 'install_trigger' 语义，但清单中并未提供任何 install recipes——这是不一致的（要么是发布包缺少安装步骤，要么是 seed.yaml 作为衍生文件被包含，却未附带实际的安装机制）。
⚠ 凭证需求
该技能引用了外部数据提供商和经纪商（eastmoney、joinquant、akshare、qmt），通常需要 API 密钥/账户，前置条件涉及 ZVT_HOME 和运行 python pip install。然而 .env 文件为空，未声明任何主凭证，因此技能可能在运行时提示或尝试使用凭证，而未预先声明。
ℹ 持久化与权限
always:false 且允许模型调用（正常）。SKILL.md 指示在工具专属数据目录（ZVT_HOME）下写入/创建文件，并在前置条件失败时运行安装程序；这对工具而言属正常行为，但未声明安装步骤/权限，导致其持久化意图不明确。未检测到 'always:true' 权限。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv0.3.32026/4/23
v0.3.3：注入双语元数据；H1 显示 TqSdk 期货接口；副标题替换为技能专属中文钩子；标签升级为 Level 1-4。
● 无害
安装命令
点击复制官方npx clawhub@latest install tqsdk-futures-api
镜像加速npx clawhub@latest install tqsdk-futures-api --registry https://cn.longxiaskill.com
技能文档
我帮你用 ZVT 在 A 股做量化策略——从取数到回测一条龙。告诉我需求，我直接写代码，你无需翻文档。
（提示：ZVT 原生支持 A 股、港股、加密货币；美股 stockus_nasdaq_AAPL 功能残缺，别用于正式研究。）
Pipeline
data_collection -> data_storage -> factor_computation -> target_selection -> trading_execution -> visualization Top Use Cases（共 2 个）
Basic Quote Retrieval Demo（UC-101）
演示 TqSdk 基础用法：连接模拟账户并获取期货合约实时行情
触发词：demo、quote、price Time-Dependent Volatility BS Pricing Model（UC-102）
分析 CSI 300 指数时变波动率，扩展标准 Black-Scholes 期权定价模型以提高精度
触发词：volatility、BS pricing、option Install
``bash
# 首次使用前一次性安装
bash scripts/install.sh
`
执行触发：当用户意图匹配 intent_router.uc_entries[].positive_terms 且使用动作动词（run/execute/跑/执行/backtest/fetch/collect） 我会问你
- 目标市场：A 股（默认）、港股还是加密货币？（美股在 ZVT 里残缺——stockus_nasdaq_AAPL 覆盖很薄）
- 数据源/提供商：eastmoney（免费免账号）、joinquant（账号+付费）、baostock（免费历史好）、akshare、qmt（券商）？
- 策略类型：MACD 金叉、MA 交叉、放量突破、基本面筛选，还是自定义因子？
- 回测区间：start_timestamp 与 end_timestamp
- 标的 ID：具体股票（stock_sh_600000）或指数成分（SZ1000）？
语义锁（致命）
| ID | 规则 | 违规处理 |
|---|---|---|
| SL-01 | 每交易周期必须先卖后买 | halt |
| SL-02 | 交易信号必须 next-bar 执行（禁止未来函数） | halt |
| SL-03 | 实体 ID 必须符合 entity_type_exchange_code 格式 | halt |
| SL-04 | DataFrame 索引必须是 MultiIndex(entity_id, timestamp) | halt |
| SL-05 | TradingSignal 只能三选一：position_pct、order_money、order_amount | halt |
| SL-06 | filter_result 语义：True=买入，False=卖出，None/NaN=无操作 | halt |
| SL-07 | Transformer 必须在 Accumulator 之前运行 | halt |
| SL-08 | MACD 参数锁定：fast=12，slow=26，signal=9 | halt |
完整锁定义：references/LOCKS.md 高频反模式（共 25 条）
AP-ZVT-183：除权因子为 inf/NaN 时直接乘导致复权静默失败AP-ZVT-179：第三方接口超限后异常被吞，数据静默缺失AP-ZVT-183B：HFQ 与 QFQ K 线表混用导致因子漂移
全部 25 条：references/ANTI_PATTERNS.md 证据质量提示
[QUALITY NOTICE] 本 crystal 编译自 blueprint finance-bp-069，证据验证率 44.6%，审计失败 9 项。关键决策请对照源文件（LATEST.yaml / LATEST.jsonl）。
参考文件
| 文件 | 内容 | 何时加载 |
|---|---|---|
| references/seed.yaml | V6+ 全量权威源 | 行为/决策争议时必读 |
| references/ANTI_PATTERNS.md | 25 条跨项目反模式 | 开始实现前 |
| references/WISDOM.md | 跨项目精华借鉴 | 架构决策时 |
| references/CONSTRAINTS.md | domain + fatal 约束 | 规则冲突时 |
| references/USE_CASES.md | 全量 KUC- 业务场景 | 需要完整示例时 |
| references/LOCKS.md | SL- + 前置条件 + 提示 | 生成回测/交易代码前 |
| references/COMPONENTS.md | AST 组件地图（按 module）| 查 API 时 | ---
Compiled by Doramagic crystal-compilation-v6.1 from finance-bp-069` blueprint at 2026-04-22T13:00:23.700958+00:00.
非技术概览见 human_summary.md。