📦 Vnpy Futures Trading — Vnpy期货交易
v0.3.3触发场景： 1. 用户要做中国期货程序化自动交易； 2. 用户要下载CSI300成分股历史数据用于回测； 3. 用户要用Alpha101因子库做...
0· 50·0 当前·0 累计
by 下载技能包
最后更新
2026/4/23
安全扫描
OpenClaw
可疑
medium confidence该技能的功能（中国期货回测/交易与因子研究）与文档一致，但遗漏了真实数据提供商和交易网关应有的运行时凭证与环境访问声明，并指示代理检查/创建本地配置目录——这一缺口值得警惕。
评估建议
本技能看似是一份完整的交易/回测蓝图，但安装/使用前请注意：
- 了解凭证需求：SKILL.md 提及付费数据商（RQData、XTQuant、joinquant）及券商网关（CTP），但未声明所需 API key/token。切勿在未完全信任的情况下将券商或数据商凭证粘贴进 agent 或 skill。
- 建议手动配置：若需实盘数据下载或交易，请在本地准备凭证，仅传递给你可控的工具。考虑在隔离环境（virtualenv、容器、沙盒）运行，避免 pip install 或文件写入污染全局 Python 环境（种子文件提到 pip install 及潜在全局安装）。
- 确认数据存储位置：技能依赖 ZVT_HOME（默认 ~/.zvt）并会尝试创建/写入。若需限制磁盘暴露，请将 ZVT_HOME 设为专用可写文件夹或你控制的挂载卷。
- 自主运行前请澄清：向技能作者（或注册中心）索要 agent 将访问的外部端点清单、将请求的环境变量/密钥清单，以及是否会自动执行 pip install / 修改系统包。
- 仅需代码生成（无需实时连接）时，请约束 agent：指示...详细分析 ▾
ℹ 用途与能力
SKILL.md、用例列表和参考文件始终将本技能描述为一个用于期货回测/因子研究的工具包（VeighNa/vnpy + ZVT 风格流水线）。这一用途解释了为何提及数据提供商（RQData、XTQuant、eastmoney、joinquant、akshare）和交易网关（CTP）。然而，技能并未声明任何必需的环境变量或凭证，而实际使用（下载付费数据或连接 CTP）通常需要 API 密钥/账户凭证。未声明凭证是一个明显遗漏，但若技能仅生成代码/指令而非建立真实连接，则可能是故意为之。
ℹ 指令范围
运行时指令聚焦于数据收集、pipeline 与回测，并包含运行 Python 检查的前置条件，引用 ZVT_HOME 及本地数据目录（如创建 ~/.zvt）。SKILL.md 中并无读取任意用户文件或外泄数据的指令，但 seed.yaml/execution_protocol 文本及前置条件要求智能体运行命令并验证导入（如 pip install zvt、运行 Python 检查），这意味着可访问文件系统与环境。指令范围限于所述目的，但赋予智能体安装包及创建/使用本地目录的广泛权限。
✓ 安装机制
没有安装规范，也没有可执行的代码文件；包元数据中自动安装的风险较低。然而，SKILL.md 和 seed.yaml 会指示智能体运行前置检查，这些检查可能提示用户（或允许情况下的智能体）执行 pip install 命令——该技能本身并未附带打包的安装配方或外部下载 URL。
⚠ 凭证需求
该 skill 未声明任何必需的环境变量或凭据，但其文档中的流程却需要访问第三方数据服务（RQData、XTQuant、joinquant）及交易网关（CTP），这些通常需要 API 密钥/账户。引用与前置条件显式引用并测试 ZVT_HOME，并尝试在 ~/.zvt 写入测试。这种不匹配（未声明凭据却期望提供商/券商凭据及文件系统写入）构成比例性问题：若代理被授予环境访问权限，它可能读取或创建文件，后续还可能被要求接受凭据，而这些凭据不会出现在 skill 元数据中。
✓ 持久化与权限
该 skill 未设置 always:true，也未申请系统级持久权限。它会创建/使用本地数据目录（~/.zvt），并可能运行 Python 命令来安装或检查包，但在提供的制品中不会修改其他 skill 或系统级 agent 配置。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv0.3.32026/4/23
v0.3.3：注入双语元数据；H1 显示 VnPy 期货交易；标语替换为技能专属中文钩子；标签升级为 Level 1-4。
● 无害
安装命令
点击复制官方npx clawhub@latest install vnpy-futures-trading
镜像加速npx clawhub@latest install vnpy-futures-trading --registry https://cn.longxiaskill.com
技能文档
VeighNa（原vnpy）支持中国期货自动交易执行，集成日盘/夜盘交易时段管理，并提供CSI300成分股数据下载及Alpha101/LightGBM等因子研究工作流。
流程
data_collection -> data_storage -> factor_computation -> target_selection -> trading_execution -> visualization 核心用例（共 21 项）
通过 RQData 下载 CSI300 指数数据 (UC-101)
从 RQData 下载 CSI300 成分股历史数据，用于 alpha 因子研究与回测
触发词：download index constituents, RQData, CSI300 data 通过 XTQuant 下载 CSI300 指数数据 (UC-102)
从 XTQuant 下载 CSI300 成分股历史数据，用于 alpha 因子研究
触发词：download index constituents, XTQuant, CSI300 data CTA 策略回测示例 (UC-110)
对期货合约进行 ATR RSI 策略回测，评估绩效并优化参数
触发词：backtesting, ATR RSI strategy, futures trading 全部 21 个用例见 references/USE_CASES.md。 执行触发：当用户意图匹配 intent_router.uc_entries[].positive_terms 且使用动作动词（run/execute/跑/执行/backtest/fetch/collect）时。
我会问你
- 目标市场：A股（默认）、港股还是加密币？（ZVT 中的美股半成品——stockus_nasdaq_AAPL 存在但覆盖少）
- 数据源/提供商：东方财富（免费免账号）、聚宽（需账号付费）、baostock（免费历史好）、akshare、qmt（券商）？
- 策略类型：MACD 金叉、MA 交叉、放量突破、基本面筛选还是自定义因子？
- 时间区间：回测起止 timestamp
- 标的 ID：具体股票（stock_sh_600000）还是指数成分（SZ1000）？
语义锁（致命）
| ID | 规则 | 违规处理 | |---|---|---| |SL-01 | 每交易周期先卖后买 | 停止 |
| SL-02 | 交易信号必须 next-bar 执行（禁止前视） | 停止 |
| SL-03 | 实体 ID 须符合 entity_type_exchange_code 格式 | 停止 |
| SL-04 | DataFrame 索引须为 MultiIndex(entity_id, timestamp) | 停止 |
| SL-05 | TradingSignal 只能有 position_pct、order_money、order_amount 之一 | 停止 |
| SL-06 | filter_result 语义：True=买入，False=卖出，None/NaN=无操作 | 停止 |
| SL-07 | Transformer 必须在 Accumulator 之前运行 | 停止 |
| SL-08 | MACD 参数锁定：fast=12, slow=26, signal=9 | 停止 | 完整锁定义：references/LOCKS.md
高频反模式（共 25 条）
AP-ZVT-183：除权因子为 inf/NaN 时直接乘法致复权静默失败AP-ZVT-179：第三方接口超限后异常被吞，数据静默缺失AP-ZVT-183B：误用 HFQ/QFQ K 线致因子漂移
全部 25 条：references/ANTI_PATTERNS.md
证据质量提示
[质量提示] 本 crystal 源自 blueprint finance-bp-081，证据验证率 31.4%，审计失败 23 项。关键决策请对照源文件（LATEST.yaml / LATEST.jsonl）。
参考文件
| 文件 | 内容 | 何时加载 | |---|---|---| | references/seed.yaml | V6+ 全量权威源 | 行为/决策争议时必读 | | references/ANTI_PATTERNS.md | 25 条跨项目反模式 | 开始实现前 | | references/WISDOM.md | 跨项目精华 | 架构决策时 | | references/CONSTRAINTS.md | 领域+致命约束 | 规则冲突时 | | references/USE_CASES.md | 全量 KUC- 场景 | 需要完整示例时 | | references/LOCKS.md | SL- + 前置条件 + 提示 | 生成回测/交易代码前 | | references/COMPONENTS.md | AST 组件地图（按模块）| 查 API 时 |---
由 Doramagic crystal-compilation-v6.1 于 2026-04-22T13:00:31.772009+00:00 自 finance-bp-081 蓝图编译。
非技术概览见 human_summary.md。