📦 Akshare Financial DataCrystal — Akshare 金融数据 Crystal
v0.2.0技能来源：finance-bp-079（cn-astock 数据获取）。触发条件：documentation、sphinx。
0· 3·0 当前·0 累计
by 下载技能包
最后更新
2026/4/22
安全扫描
OpenClaw
可疑
medium confidence该技能似乎实现了其声称的功能（A 股数据获取 / ZVT pipeline），并使用了常规 Python 包，但运行时要求存在不一致，seed.yaml 中采用断言式执行协议，且安装脚本未限定作用域——安装前请审查。
评估建议
安装/使用前的高层建议：
- 检查 seed.yaml、LOCKS.md 与 LICENSE：seed.yaml 包含执行规则，要求 host/agent 在决策前重读——请确认你接受这些行为指引。LICENSE 文件被引用但未随包提供。
- 在隔离环境运行安装脚本：在 Python virtualenv（或容器）内执行 scripts/install.sh，避免全局 pip 安装及版本冲突。脚本未强制 Python 3.12 或 SKILL.md 宣称必需的 uv 包管理器——请确认 Python 版本并按需适配/安装 zvt 以获得完整功能。
- 确认 zvt 依赖与前置条件：技能假定 ZVT 可用（前置条件检查 zvt 与 ZVT_HOME）。若计划实盘交易或录制数据，先验证 zvt 安装及数据目录。
- 证据质量低：SKILL.md 含证据质量提示（验证率约 30.6%，审计失败计数）。请将生成代码/结果视为可能不完整，并在实盘/回测前对照源文件验证关键决策。
- 不索取凭据：技能不要求 API 密钥或密钥串。仍须避免在未审查将信号转为订单的代码前连接真实券...详细分析 ▾
ℹ 用途与能力
该技能的声明用途（akshare/ZVT 数据源与 A 股回测流水线）与所含文档及 Python 库一致。然而 SKILL.md 元数据声明“需 Python 3.12+ 并使用 uv 包管理器”，而提供的 install.sh 却调用系统 python3 与 pip，未检查或强制 Python 3.12 或 uv。此外，SKILL.md 提及 ZVT 集成（前置条件期望 zvt），但脚本并未安装 zvt——声明的运行环境与实际安装产物存在轻微不一致。
⚠ 指令范围
运行时指令要求执行 scripts/install.sh（合理），并多处引用内部文件（seed.yaml、LOCKS.md、anti-patterns）。seed.yaml 的 execution_protocol 规定主机/代理在“任何行为决策前必须重新读取 seed.yaml”，并强制按序读取大量内部规则——这是一条影响代理行为的强硬策略，超出普通“如何运行”文档范畴。技能前置条件还检测/期望 ~/.zvt（ZVT_HOME）存在且可写。指令未索取无关系统凭据，但 seed.yaml 中的强制语言比典型 SKILL.md 指导更宽泛，需审查以防意外代理行为。
ℹ 安装机制
没有平台安装清单，但 scripts/install.sh（已包含）会安装若干常用 PyPI 包（pandas、requests、beautifulsoup4、lxml、html5lib、openpyxl、xlrd、urllib3、tqdm、tabulate）。对数据获取类 skill 而言，用 pip 安装这些包是合理的。轻微风险：未固定确切版本，脚本使用系统 python3/pip（可能全局安装）。未发现来自不可信 URL 的下载或解压操作。
✓ 凭证需求
该技能不会请求环境变量、凭据或配置文件路径，仅检查/创建 ZVT 主目录（ZVT_HOME）并运行 zvt preconditions。这与本地数据/回测流程一致，不会索要任何密钥或与流程无关的服务密钥。
ℹ 持久化与权限
该 skill 并非“始终”启用，可由用户调用（默认）。它可自主调用（disable-model-invocation=false），这是平台默认设置，本身并非警示。seed.yaml 的 execution_protocol 与“必须重新读取 seed.yaml”规则值得关注，它们试图将首选的主机行为与 agent 决策时检查编码化；这使该 skill 对决策顺序有较强影响，但本身不修改其他 skill 或系统级配置。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
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 akshare-financial-data
镜像加速npx clawhub@latest install akshare-financial-data --registry https://cn.longxiaskill.com
技能文档
用 ZVT 帮你一条龙搞定 A 股量化策略——从取数到回测，一句话需求，代码我写，你不用翻文档。
（提示：ZVT 原生支持 A 股、港股、加密币；美股 stockus_nasdaq_AAPL 半成品，别当真。）
Pipeline
data_collection -> data_storage -> factor_computation -> target_selection -> trading_execution -> visualization 核心场景（共 1 个）
Akshare Sphinx 文档配置（UC-101）
一键配置 Sphinx 文档构建器，含中文支持（ctex）、Markdown 解析（recommonmark）及自动版本字符串。
触发词：documentation、sphinx、docs build 安装
``bash
# 首次使用前一次性安装
bash scripts/install.sh
`
执行触发：当用户意图匹配 intent_router.uc_entries[].positive_terms 且使用动作动词（run/execute/跑/执行/backtest/fetch/collect）时自动执行。 我会问你
- 目标市场：A 股（默认）、港股还是加密币？（美股 ZVT 支持残缺，stockus_nasdaq_AAPL 覆盖薄）
- 数据源：东方财富（免费无账号）、聚宽（账号+付费）、baostock（免费历史长）、akshare、qmt 券商？
- 策略类型：MACD 金叉、均线交叉、放量突破、基本面筛选还是自定义因子？
- 回测时段：start_timestamp 与 end_timestamp
- 标的代码：具体个股（stock_sh_600000）或指数成分（SZ1000）？
语义锁（致命）
| ID | 规则 | 违规处理 |
|---|---|---|
| SL-01 | 每交易周期必须先卖后买 | halt |
| SL-02 | 交易信号必须 next-bar 执行，禁止未来函数 | halt |
| SL-03 | Entity 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 高频反模式（共 14 条）
- AP-DATA-SOURCING-001：SEC API 请求缺失或无效 User-Agent
- AP-DATA-SOURCING-002：无视外部 API 限频导致 IP 被封
- AP-DATA-SOURCING-003：未设 HTTP 超时导致无限挂起
全部 14 条见 references/ANTI_PATTERNS.md 证据质量提示
【质量提示】本 crystal 编译自 blueprint finance-bp-079，证据验证率 30.6%，审计失败 41 项。关键决策请对照源文件（LATEST.yaml / LATEST.jsonl）。
参考文件
| 文件 | 内容 | 何时加载 |
|---|---|---|
| references/seed.yaml | V6+ 全量权威源 | 行为/决策争议时必读 |
| references/ANTI_PATTERNS.md | 14 条跨项目反模式 | 开始实现前 |
| references/WISDOM.md | 跨项目精华借鉴 | 架构决策时 |
| references/CONSTRAINTS.md | domain + 致命约束 | 规则冲突时 |
| 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-079` blueprint at 2026-04-22T13:00:30.352072+00:00.
非技术概览见 human_summary.md。