📦 Vectorbt Vectorized基于 — Vectorbt 向量化

v0.3.3

VectorBT 框架的向量化回测与因子研究工具,支持多市场数据批量回测、策略参数优化和统计套利分析。 触发场景: (1) 用户要回测 MACD 金叉死叉策略在加密货币上的表现; (2) 用户要对交易策略做多参数网格优化; (3) 用户要做多币种或跨市场的统计套利研究。

0· 51·0 当前·0 累计
tangweigang-jpg 头像by @tangweigang-jpg (Tang Weigang)
下载技能包
最后更新
2026/4/23
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
可疑
medium confidence
该技能的用途(vectorized backtesting)与其文档一致,但运行时指令提到了 Python 包、前置命令和内部执行协议,这些在注册元数据中并未声明——这种不一致以及对运行系统命令/安装步骤的隐含要求令人担忧,使用前需澄清。
评估建议
该技能似乎是用于向量化回测(vectorbt/ZVT)的本地“水晶”级详细实现,仅提供指令(注册表无代码文件)。安装或运行前:1)向作者/供应商索要简明运行时清单:Python 版本、pip 包(精确名称/版本)及是否需联网/pip;2)确认是否会运行 pip install 或创建/修改本地目录(SKILL.md 提到 ZVT_HOME 与 pip install 前置条件);3)首次在沙箱(容器/一次性 VM)运行,避免包安装和文件系统变更影响主工作站;4)确认来源/许可证(来源未知,许可证标为 Proprietary);5)若在共享系统运行,需明确许可网络安装,并确保技能不使用机密或外部 webhook。若作者提供清晰的最小依赖列表及可信安装源(PyPI 包名或 GitHub 发布),风险可降低。...
详细分析 ▾
用途与能力
名称/描述与回测/因子研究工具(vectorbt/ZVT)相符。然而,SKILL.md 明确要求“Python 3.12+ 及 uv 包管理器”,并提及 zvt/vectorbt 行为,而注册元数据中未列出所需二进制文件、环境变量或主凭证。该技能可能需要 Python 及特定库,但未声明。
指令范围
运行时指令(seed.yaml 与 SKILL.md)要求智能体重新读取 seed.yaml,执行前置检查(python3 -c 'import zvt' 及其他 python 命令),并遵循可能触发安装或验证步骤的执行协议。这些步骤包括运行系统 Python 命令,并可能调用 pip 安装包(前置条件含 'on_fail: Run: python3 -m pip install zvt')。因此,该 skill 期望智能体执行会影响宿主机环境与网络的命令,但 skill 并未明确披露或限制这些行为。
安装机制
没有 install spec(仅指令),从而将供应链风险降至最低,但 seed.yaml 的 execution_protocol 引用了 install_recipes[],而 SKILL.md 声明了兼容性要求(Python 3.12+、uv)。由于清单中缺少安装说明,尚不清楚如何获取或验证所需依赖项——这是一个需要澄清的遗漏,而非关于恶意安装 URL 的直接危险信号。
凭证需求
该 skill 未在 manifest 中请求 API key、config 路径或凭据。但前置条件与执行协议引用了 ZVT_HOME,并在缺失 zvt 时运行 pip install。这意味着 skill 会使用或创建本地目录,并可能执行网络安装;manifest 本应声明这些运行时需求及所需环境变量(如 ZVT_HOME)。
持久化与权限
always:false 且 user-invocable:true(默认)——该 skill 不请求强制全局常驻,也没有显式指令去修改其他 skill 或全局 agent 配置。seed.yaml 确实指示 agent 重新读取并优先将 seed.yaml 视为权威,但这仅作用于该 skill 自身的文件范围内。
安全有层次,运行前请审查代码。

运行时依赖

无特殊依赖

版本

latestv0.3.32026/4/23

v0.3.3:注入双语元数据。H1 显示 VectorBT 向量回测;标语替换为技能专属中文钩子;标签升级为 1-4 级。

无害

安装命令

点击复制
官方npx clawhub@latest install vectorbt-vectorized
镜像加速npx clawhub@latest install vectorbt-vectorized --registry https://cn.longxiaskill.com

技能文档

基于 VectorBT 框架的向量化回测与因子研究工具,支持多市场数据批量回测、策略参数优化和统计套利分析。

Pipeline

data_collection -> data_storage -> factor_computation -> target_selection -> trading_execution -> visualization

核心用例(共 23 条)

自动生成 API 文档 (UC-101)

自动从 Python 源码生成 Markdown 格式 API 文档,保持文档实时一致。 触发词:api, documentation, generate

更新 MkDocs 导航 (UC-102)

根据 docs 目录实际 API 文档文件自动更新 mkdocs.yml 导航结构。 触发词:navigation, mkdocs, api

比特币日频 MACD 策略 (UC-103)

在比特币上执行日频 MACD 金叉死叉策略,依据动量生成买卖信号。 触发词:bitcoin, BTC, MACD

全部 23 条用例见 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 交叉、放量突破、基本面筛选,还是自定义因子?
  • 回测时段:start_timestamp 与 end_timestamp
  • 标的 ID:具体个股(stock_sh_600000)或指数成分(SZ1000)?

语义锁(致命)

| ID | 规则 | 违规处理 | |---|---|---| | SL-01 | 每个交易周期必须先卖后买 | 停机 | | SL-02 | 交易信号必须采用下一根 K 线执行(禁止前视) | 停机 | | 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 由蓝图 finance-bp-092 编译。证据验证率 38.1%,审计失败 27 项。生成结果可能存在未捕获需求缺口,关键决策请对照源文件(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 时 |

--- 由 Doramagic crystal-compilation-v6.1 于 2026-04-22T13:00:39.474430+00:00 自蓝图 finance-bp-092 编译。 非技术概览见 human_summary.md

数据来源ClawHub ↗ · 中文优化:龙虾技能库