📦 Advanced Financial MlCrystal — 高级金融 MLCrystal
v0.2.0技能编译自 finance-bp-115（回测、多市场因子研究）。触发器：documentation、sphinx。
0· 2·0 当前·0 累计
by 下载技能包
最后更新
2026/4/22
安全扫描
OpenClaw
可疑
medium confidence该技能声称是基于 ZVT 的高级金融 ML/回测 crystal，但其运行时说明与安装产物不一致（缺少 ZVT 安装、未声明环境使用、全局 pip 安装器），安装前请审查并在隔离环境中运行。
评估建议
该技能看似是一个合法的回测/因子研究包，但卫生状况不一致，运行前需处理：
1) 切勿直接在系统 Python 运行 scripts/install.sh——先创建隔离的 virtualenv 或容器，因该脚本会全局安装包。
2) 技能可能需 ZVT 及数据商凭证（eastmoney/jqdata/akshare/qmt），尽管未声明；在受控环境验证并仅提供必要凭证。
3) SKILL.md/seed.yaml 会重读本地文件与 ZVT_HOME（~/.zvt）；确认读写目录安全且可写。
4) 若用于交易决策，请重视“证据质量提示”（验证比例低），手动核查关键约束（seed.yaml / references/LOCKS.md）后再执行实盘/回测。
5) 如决定安装，在隔离 VM/容器或 venv 内运行安装脚本，检查最终包列表（若用 ZVT 可手动 pip install zvt），确认技能将调用的数据商接口前，勿提供生产凭证。...详细分析 ▾
⚠ 用途与能力
该技能明确聚焦 ZVT（SKILL.md 及多处引用提及 zvt、A 股、recorders 与 domain preconditions），但代码包未安装或声明 zvt 及其他领域包（如 akshare/jqdatasdk）。SKILL.md 甚至写明“需 Python 3.12+ 及 uv 包管理器”，而提供的安装脚本仅 pip 安装通用 ML/数值包，未满足所述平台与依赖预期。这种不匹配（声称基于 ZVT 的流水线却未提供 ZVT 或声明相关环境变量/凭据）与其宣称目的严重不符，可能导致代理在运行时尝试检查或指示用户执行将失败或需额外凭据的命令。
⚠ 指令范围
运行时指令要求执行 scripts/install.sh，并引用前置条件，这些条件会读取本地文件与环境变量（如 ZVT_HOME）并运行 Python 检查。SKILL.md 与 seed.yaml 指示智能体在做出行为决策时重新读取 seed.yaml 及众多引用文件。SKILL.md 的前置条件引用了环境变量（ZVT_HOME）以及在 ~/.zvt 下创建/检查文件的命令，尽管该技能的 manifest 未声明任何必需的环境变量或配置路径。这是范围蔓延：指令访问了 manifest 中未声明的系统状态与环境变量，并可能提示用户运行需要外部凭据的记录器或网络数据获取操作。
⚠ 安装机制
唯一的安装产物是 scripts/install.sh，它会执行多条 “python3 -m pip install …” 命令来安装标准 PyPI 包（numpy、pandas、scikit-learn 等）。使用 pip 本身合理，但脚本直接装到全局环境（未创建 virtualenv/venv），可能破坏用户系统 Python 环境。安装源为 PyPI（无未知 URL），供应链风险中低，但全局安装做法风险高且对一项 skill 而言过度；至少应提供或推荐使用隔离环境。
⚠ 凭证需求
技能清单未声明任何必需的环境变量或主凭证，但 SKILL.md 和 references/LOCKS.md 的前提条件引用了 ZVT_HOME 以及测试/修改 ~/.zvt 的命令，且面向用户的提示询问使用哪个数据提供商（eastmoney、joinquant、akshare、qmt）——其中一些需要凭证。因此，该技能会访问或期望未预先声明的环境变量和凭证。这种不匹配风险过高，可能导致意外的凭证提示或凭证意外使用/泄露。
ℹ 持久化与权限
该技能未请求 'always: true'，可由用户调用，并允许正常自主调用。没有明确行为会修改其他技能或系统级代理设置。然而，seed.yaml 强制执行运行时协议（代理必须重新读取 seed.yaml 并遵循 execution_protocol 步骤），这为该技能赋予了一种略带规定性的运行时契约；结合其他问题（未声明的环境使用、全局安装），这增加了在隔离环境中运行该技能的重要性。自主调用本身是默认行为，单独不会被标记。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv0.2.02026/4/22
Doramagic crystal portfolio v0.2.0。完整5层 bp-009 标准。github.com/tangweigang-jpg/doramagic-skills
● Pending
安装命令
点击复制官方npx clawhub@latest install advanced-financial-ml
镜像加速npx clawhub@latest install advanced-financial-ml --registry https://cn.longxiaskill.com
技能文档
用 ZVT 在 A 股做量化策略——从取数到回测一条龙。告诉我需求，代码我来写，无需翻文档。（提示：ZVT 原生支持 A 股、港股、加密货币；美股 stockus_nasdaq_AAPL 半成品，别当真。）
流程
data_collection -> data_storage -> factor_computation -> target_selection -> trading_execution -> visualization 核心用例（1 项）
Sphinx 文档配置（UC-101）
如何用 Sphinx autodoc 及扩展生成项目 API 文档
触发词：documentation, sphinx, autodoc 安装
``bash
# 首次使用前一次性配置
bash scripts/install.sh
`
执行触发：当用户意图匹配 intent_router.uc_entries[].positive_terms 且使用动作动词（run/execute/跑/执行/backtest/fetch/collect） 我会问你
- 目标市场：A 股（默认）、港股还是加密货币？（美股在 ZVT 里半成品）
- 数据源：eastmoney（免费免登录）、joinquant（需账号付费）、baostock（免费历史好）、akshare、qmt（券商）？
- 策略类型：MACD 金叉、均线交叉、放量突破、基本面筛选还是自定义因子？
- 回测区间：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 由 blueprint finance-bp-115 编译，证据验证率 43.7%，审计失败 34 项。关键决策请对照源文件（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 组件地图（按 module）| 查 API | ---
由 Doramagic crystal-compilation-v6.1 于 2026-04-22T13:00:55.567727+00:00 自 blueprint finance-bp-115` 编译。
非技术概览见 human_summary.md。