📦 Czsc Chan TheoryCZSC — CZSC缠论CZSC
v0.3.0缠论技术分析工具，支持 K 线生成、笔线段识别、分型信号提取与 A 股回测可视化。触发场景：(1) 用户要分析 A 股 K 线数据；(2) 用户要计算缠中说禅的分型和买卖信号；(3) 用户要对历史行情进行回测和因子研究。
0· 7·0 当前·0 累计
by 下载技能包
最后更新
2026/4/22
安全扫描
OpenClaw
可疑
medium confidence该技能似乎实现了与其描述一致的 A 股回测流程，但存在包装/安装声明与实际安装脚本的小幅不一致、额外的存储/连接依赖，以及缺乏来源信息，安装前需谨慎。
评估建议
安装/使用该技能前需考虑：
- 来源：技能未提供主页，且“来源：未知”。优先选择有明确仓库/主页的包。向发布者索要源码或先验证仓库再信任。
- 安装不一致：SKILL.md 宣称用 uv 包管理器且需 Python 3.12+，但 scripts/install.sh 实际用 pip，且未安装 zvt/czsc。需手动安装 zvt 等域包。勿直接在系统 Python 运行 install.sh；请用隔离的 virtualenv/venv 或容器。
- 外部连接器：install.sh 会安装 redis、clickhouse_connect、oss2，用于连接外部存储/数据仓库。若不用这些后端，可在安装步骤移除；若用，请验证连接端点与凭据合法且权限最小。
- 数据提供商与凭据：技能支持 eastmoney、joinquant 等数据商；joinquant 及部分券商需凭据，技能不会自动索取。仅向可信代码提供 API 密钥，并审查密钥使用/存储位置。
- 文件与文档：技能含大量参考文件及大体积 seed.yaml。执行协议要求代理重读 seed.yaml 等本地文档；...详细分析 ▾
ℹ 用途与能力
名称/描述（CZSC + 基于 ZVT 的 A 股回测）与文件及引用（大量 ZVT 相关约束、记录器、回测组件）一致。
轻微不符：SKILL.md 元数据声称“需 Python 3.12+ 并使用 uv 包管理器”，但提供的 install.sh 使用 pip，且未安装 zvt 或 czsc 包。
包含 OSS/ClickHouse/Redis 客户端包作为可选存储后端合理，但需由用户说明用途（它们用于连接外部存储）。
ℹ 指令范围
运行时指令聚焦于数据收集、因子计算与回测（包括调用 zvt 并检查 ~/.zvt 的前置条件检查）。它们要求运行 scripts/install.sh 并启动 zvt recorders 以获取外部市场数据——这是该领域所预期的。SKILL.md/seed.yaml 要求智能体重新读取 seed.yaml 及大量本地参考文档；这虽与领域相关，但扩大了技能的本地读取范围（读取其自身参考文件）。
ℹ 安装机制
无正式注册安装规范，但提供了安装脚本（scripts/install.sh），通过 pip 从 PyPI 安装 pandas、numpy、pyarrow、requests、loguru、dill、pytz、redis、clickhouse_connect、oss2 等包，属常见低至中等风险做法。关注点：(1) 安装脚本未安装 zvt/czsc，但前置条件要求 zvt；(2) 元数据提到另一包管理器 uv，与脚本所用不符；(3) 部分包（clickhouse_connect、oss2、redis）支持外部存储连接，若未使用对应后端可能多余。
✓ 凭证需求
技能未声明所需的环境变量或凭据。SKILL.md 中确实提到了 ZVT_HOME 和数据提供商选项（eastmoney、joinquant、akshare）；joinquant 需要账户凭据，但技能并未请求。提供的文件中未发现隐藏的秘密泄露指标。
✓ 持久化与权限
技能并非始终启用，可由用户调用；允许自主调用（默认），但本身并不被视为可疑。该技能不会请求持久的 agent 级权限，也不会修改其他技能的配置。seed.yaml 要求主机每次运行时重新读取（对此类工件属正常），但会增加 agent 查询的本地元数据量。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv0.3.02026/4/22
Doramagic crystal portfolio v0.3.0。完整5层bp-009标准。github.com/tangweigang-jpg/doramagic-skills
● 无害
安装命令
点击复制官方npx clawhub@latest install czsc-chan-theory
镜像加速npx clawhub@latest install czsc-chan-theory --registry https://cn.longxiaskill.com
技能文档
用 ZVT 在 A 股做量化策略，一条龙：取数→回测，一句话搞定。告诉我需求，我直接写代码，无需翻文档。
（提示：ZVT 原生支持 A 股、港股、加密币；美股 stockus_nasdaq_AAPL 仅半支持，别当真。）
Pipeline
data_collection -> data_storage -> factor_computation -> target_selection -> trading_execution -> visualization 十大用例
Sphinx 文档配置（UC-101）
为 czsc 项目配置 Sphinx 文档构建器，确保 Python 路径与 Rust 版本优先。
触发：documentation, sphinx, configuration CZSC 性能基准（UC-102）
用不同 K 线数量测试 CZSC 初始化速度与内存占用。
触发：benchmark, performance, speed 波动率分级信号（UC-104）
按近期 K 线价格区间将波动率分低/中/高三档，用于信号生成。
触发：volatility, classification, signal 其余 7 条见 references/USE_CASES.md。
安装
``bash
# 首次使用前一次搞定
bash scripts/install.sh
`
触发条件：用户意图匹配 intent_router.uc_entries[].positive_terms 且使用动作动词（run/execute/跑/执行/backtest/fetch/collect）。 我会问你
- 市场：A 股（默认）、港股还是加密币？（美股 ZVT 支持残缺）
- 数据源：东方财富（免费免账号）、聚宽（账号+付费）、baostock（免费历史全）、akshare、qmt（券商）？
- 策略类型：MACD 金叉、均线交叉、放量突破、基本面筛选还是自定义因子？
- 回测区间：start_timestamp 与 end_timestamp
- 标的：个股（stock_sh_600000）或指数成分（SZ1000）？
语义锁（致命）
| ID | 规则 | 违规处理 |
|---|---|---|
| SL-01 | 每交易周期必须先卖后买 | halt |
| SL-02 | 交易信号必须下一根 K 线执行（禁止未来函数） | 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。
高频反模式（25 条）
- AP-ZVT-183：除权因子 inf/NaN 直接乘导致复权静默失败
- AP-ZVT-179：第三方接口超限异常被吞，数据静默缺失
- AP-ZVT-183B：HFQ/QFK 线表混用致因子漂移
全部见 references/ANTI_PATTERNS.md。
证据质量提示
[QUALITY NOTICE] 本 crystal 源自 blueprint finance-bp-091，证据验证率 60.4%，审计失败 13 项。关键决策请对照源文件（LATEST.yaml / LATEST.jsonl）。
参考文件
| 文件 | 内容 | 何时加载 |
|---|---|---|
| references/seed.yaml | V6+ 权威源 | 行为/决策争议时 |
| references/ANTI_PATTERNS.md | 25 条反模式 | 编码前 |
| references/WISDOM.md | 跨项目精华 | 架构决策时 |
| references/CONSTRAINTS.md | 领域+致命约束 | 规则冲突时 |
| references/USE_CASES.md | 全量用例 | 需示例时 |
| references/LOCKS.md | 语义锁及提示 | 生成交易代码前 |
| references/COMPONENTS.md | AST 组件地图 | 查 API 时 | ---
Compiled by Doramagic crystal-compilation-v6.1 from finance-bp-091` blueprint at 2026-04-22T13:00:38.716020+00:00.
非技术概览见 human_summary.md。