CZSC vs EasyClaw
自建缠论算法库，还是走 EasyClaw 技能路线
结论先说：两者不是替代关系，也不在同一层级。czsc 是要自己准备 Python 环境（必要时还要 Rust 工具链）的缠论算法库，覆盖结构识别、信号体系与回测链路；EasyClaw 是本机技能路线，把数据、指标、形态与图表变成一句话任务。本文用已核验证据说明各自边界，帮你判断该把力气花在哪一边。
逐维度对照
证据来源：官方 README、API 手册与变更记录，以及本机 EasyClaw 技能目录中已读取的技能文档（2026-09-16）。
| 维度 | czsc 自建算法库 | EasyClaw 技能路线 | 结论 |
|---|---|---|---|
| 核心定位 | 缠中说禅技术分析工具：结构识别 + 信号体系 + 交易框架 | AI 助手软件，通过技能承接数据、指标、形态、选股与图表任务 | 不是一个层级：一边是被调用的算法库，一边是调用技能完成任务的软件 |
| 是否有缠论结构 | 有：分型、笔、中枢由代码自动识别 | 无：技能做指标与形态层，不提供缠论结构识别 | 这是两条路线最本质的分界 |
| 使用方式 | 写代码调用，接口层次分明（结构 → 信号 → 事件 → 持仓） | 自然语言提问，按任务给结果 | 要进工程就写代码，只要结论就提问 |
| 环境成本 | Python 3.10 及以上（推荐装预编译轮子）；源码构建需 Rust 工具链 | 安装软件；部分技能另有 Token 或 Key 前提 | 自建路线前置更重 |
| 数据来源 | 官方四条连接器：天勤、Tushare、CCXT、本地缓存 | 数据类技能按文档提供多市场数据 | 两边都要准备各自凭据，部分前置可复用 |
| 回测与验证 | 信号与持仓同源，权重交外部回测包回测 | 研究回测类技能做向量化研究；图表类技能负责出图 | 自建侧口径连续，技能侧入口更轻 |
| 可视化产出 | 交互式图表 + 自包含 HTML（多周期联立与信号叠加） | 出版级图表图片 | 要叠加缠论结构只有自建侧能做 |
| 市场覆盖 | 连接器面向期货、A 股与数字货币 | 按技能文档覆盖股票、期货、期权、基金、外汇、债券、指数与加密数据，技术分析类存在市场限制 | 覆盖范围不同，按你要研究的具体市场核对 |
已核验的 EasyClaw 量化相关技能
以下技能在本机目录中存在，且已读取其技能文档（2026-09-16）。列出的是文档声明的能力与前提，不是运行成功记录。
| 技能 | 文档声明的能力 | 前置条件 | 已知限制 | 与本库的关系 |
|---|---|---|---|---|
| stock-technical-mastery | A 股 K 线形态识别、MACD/RSI/布林带等指标计算、量价关系、Wyckoff 与风险管理报告 | 数据源为新浪财经与 Baostock | 不支持基本面分析，不覆盖港股、美股、期货与外汇 | 做指标与形态层，不提供缠论结构识别 |
| quant-analyst | 构建金融模型、回测交易策略、风险指标、组合优化与统计套利 | 需先澄清执行环境、数据来源与目标市场 | 文档明确不适用于一般金融问答与非量化任务 | 可做研究阶段验证，不含信号-事件-交易体系 |
| tushare-finance | 通过 Tushare Pro 获取中国金融市场数据，覆盖 A 股、港股、美股、基金、期货与债券，支持 220+ 接口 | 需 Tushare Token | 接口额度与权限按数据源规则 | 与本库的 Tushare 连接器同源，但只负责取数 |
| akshare-finance | 封装公开财经数据：股票、期货、期权、基金、外汇、债券、指数与加密货币 | 需 akshare 1.18 及以上 | 数据来自公开财经网站，时效与口径由来源决定 | 扩大取数覆盖面，与结构识别无关 |
| tongdaxin | 通达信官方 MCP：行情、K 线、基本面、财务、代码、条件选股、指标、公告、研报与宏观 | 需授权 APIKEY | 不承诺收益、不给确定性买卖指令 | 补足选股与资讯环节 |
| chart-image | 由数据生成出版级图表图片（折线、柱状、面积、点、蜡烛图、饼、热力图等） | 纯 Node.js 环境 | 仅负责出图 | 替代静态出图场景；无法承载缠论结构叠加 |
| futuapi | 富途 OpenAPI 行情与交易助手：行情、K 线、报价、快照、买卖盘、逐笔与分时，含模拟与实盘下单 | 需 OpenD 运行且版本匹配 | 默认使用模拟环境；实盘解锁需在图形界面手动操作；期货走独立接口且不覆盖国内期货柜台直连 | 覆盖部分交易执行，与本库的功能范围不重叠 |
| mx-stock-simulator | 股票模拟组合：持仓、买卖、撤单、委托与资金查询 | 需平台 API Key | 模拟环境，非柜台实盘 | 可用于策略思路的模拟验证 |
能力边界：谁强在哪、谁都不做什么
把「不能做」的部分写清楚，比罗列功能更有用。
| 能力类别 | 自建算法库侧 | EasyClaw 技能侧 | 谁都不提供 |
|---|---|---|---|
| 缠论结构识别 | 分型、笔、中枢的自动识别与参数控制 | 不提供 | 不提供缠论理论原文讲解与买卖点结论 |
| 信号与事件 | 信号函数体系与 all/any/not 组合 | 不提供 | 不承诺任何信号的有效性或胜率 |
| 多周期联立 | K 线合成与多级别联立交易器 | 针对单一标的输出结论 | 不提供跨品种套利的具体方案 |
| 技术指标与形态 | 指标算子主要供内部信号使用，顶层只保留少量别名 | 指标计算、K 线形态识别、量价分析与 Wyckoff 方法 | 不移交指标参数的推荐取值 |
| 取数 | 四条官方连接器，需各自凭据 | 按技能文档提供多市场数据 | 不代替数据源完成授权与开通 |
| 回测与报告 | 持仓权重回测（引擎来自外部包）与自包含 HTML | 研究回测类技能与图表类技能 | 不提供收益预期或资金曲线预测 |
| 执行与实盘 | 本库侧重研究与回测链路，实盘执行不在其范围内 | 交易类技能覆盖部分市场（如美股、港股、A 股与部分期货主连） | 不代替券商或期货公司完成开户与资质 |
前置条件对照
选路线时最容易低估的是「你需要先具备什么」。下表把两边的门槛并列。
| 前置项 | 自建算法库侧 | EasyClaw 技能侧 | 注意点 |
|---|---|---|---|
| 运行环境 | Python 3.10 及以上（推荐装预编译轮子）；源码构建另需 Rust 工具链与构建工具 | 安装 EasyClaw 即可 | 自建侧源码构建还会遇到解释器版本与构建脚本的匹配问题 |
| 数据凭据 | 按所选连接器准备：Tushare Token、天勤账号或交易所密钥 | 部分技能需要 Token 或 Key | 这类前置两边可以复用同一份凭据 |
| 数据口径约定 | 需自己定：复权方式、是否含集合竞价、停牌日如何补 | 按技能文档约定 | 自建侧这是必做项，官方不做统一约定 |
| 结构参数 | 需自己定成笔长度等参数，并固定来源 | 不适用 | 参数变化等于换了一套结构，需重新验证 |
| 异常处理 | 需处理缺失值与时区问题（相关调用会显式报错） | 由技能内部处理 | 自建侧的「失败即报错」是有意设计，不是缺陷 |
| 运维投入 | 需要维护环境、依赖版本与数据管线 | 无运行时运维 | 这是自建路线的主要隐性成本 |
适用人群对照
按你的真实目标与约束对号入座。两条路线也可以先后组合使用。
| 你的目标 | 建议路线 | 理由 | 下一步 |
|---|---|---|---|
| 策略条件依赖缠论结构 | 自建算法库 | 分型、笔、中枢的自动识别只有这条路提供 | 看缠论结构 |
| 要做多周期联立的择时 | 自建算法库 | K 线合成与多级别交易器是为这条链路准备的 | 看多级别联立 |
| 要跑批量品种研究 | 自建算法库 | 研究入口支持多品种批量回放 | 看权重回测 |
| 只想先看指标、形态与选股 | 技能路线 | 免编译、按任务提问，不需要搭环境 | 看对比（本页） |
| 要把结论做成图表发给同事 | 技能路线或自建侧出图 | 通用图表用技能更快；要叠加缠论结构必须自建 | 看可视化输出 |
| 没有 Python 环境也不想装 | 技能路线 | 技能路线的全部前置就是安装软件 | 看对比（本页） |
| 想先研究、确认可行后再自建 | 先技能后自建 | 研究阶段与工程阶段的工具需求不同 | 先看技能能力，需要时回看安装 |
常见问题
涉及本库的表述以官方仓库与 API 手册为准；涉及 EasyClaw 的表述以本机技能文档为准，均不构成投资建议。
czsc 和 EasyClaw 是同一个东西吗？
不是。czsc 是缠中说禅技术分析工具，是一套以代码调用的算法库与交易框架，覆盖结构识别、信号体系与回测链路；EasyClaw 是提供多种技能（数据、指标、形态、选股、图表等）的 AI 助手软件。两者之间没有已证实的安装或集成关系。
我该选哪一条？
看你的策略是否需要缠论结构。如果需要分型、笔、中枢参与条件判断，或者要做多周期联立与批量研究，只能走自建路线；如果只是要看指标、形态、选股或把结论画成图，技能路线更直接。很多团队的实际做法是先用技能做研究，确认可行后再搭自建链路。
EasyClaw 能替代缠论结构识别吗？
不能。本机技术分析类技能做的是指标计算与 K 线形态识别（例如均线、MACD、布林带、量价关系与 Wyckoff 方法），输出的是指标结论与报告，不提供缠论分型、笔、中枢的自动识别，也不提供信号-事件-交易体系。这是能力层级上的差别，不是覆盖范围的问题。
反过来，czsc 能替代那些技能吗？
也不能。技能路线提供的是免编译、按任务提问的数据获取、指标分析、选股与图表能力；自建算法库需要你自己准备 Python 环境、数据凭据与结构参数。如果目标只是快速拿到研究结论或做条件选股，自建链路并不比技能更省事。
两边能不能配合使用？
从能力上看可以先后使用，但要说清一件事：目前没有任何已证实的集成关系，本库不会自动调用 EasyClaw 的技能，技能也不会驱动本库的算法。你可以用技能路线做前期研究、用自建路线做工程实现，中间的数据与结论需要自己衔接，不要预期存在开箱即用的通道。
EasyClaw 技能有前提条件吗？
有，而且逐个技能不同。数据类技能多数需要 Token 或 Key（例如 Tushare 需要 Token）；技术分析类技能有市场限制（例如不覆盖港股、美股、期货与外汇）；选择类与交易类技能需要相应的授权或客户端运行环境。本文只列文档声明的条件，具体以各技能自身文档为准，本文不复述任何凭据。
本文的数据来源是什么？
关于本库的表述来自官方仓库 README、公开 API 手册、包与工作区配置、变更记录；关于 EasyClaw 的表述来自本机技能目录中已读取的技能文档。所有引用均在 2026-09-16 核验。涉及第三方数据源与市场覆盖的内容会随版本变化，最终请以官方来源与你自己的验证为准。