CZSC：缠中说禅技术分析工具完全指南
posts posts 2026-04-08T11:00:00+08:00CZSC 缠中说禅技术分析工具完全指南，涵盖缠论核心概念、分型笔识别、信号-事件-交易体系，从安装配置到量化策略开发的全方位讲解。技术笔记CZSC, 缠论, 量化交易, 缠中说禅, 技术分析, Python目标读者：量化交易开发者、缠论学习者、Python 量化研究者 核心问题：如何使用 CZSC 实现缠论技术分析？ 难度：⭐⭐⭐（中级） 预计阅读时间：30 分钟
§0 三分钟速览
如果你现在只想快速判断这个项目值不值得深入，先记住下面 4 点：
- CZSC 是一个基于缠论理论的 Python 量化交易技术分析工具，核心是分型、笔的自动识别，以及信号-事件-交易的量化交易逻辑体系。
- 它更适合被理解为研究型技术分析框架，而不是开箱即用的实盘策略系统。
- 当前版本（v0.10.x）正在逐步用 rs-czsc 替换 Python 实现，高频迭代中 API 会有变动。
- 0.9.x 版本可查看具体对象或函数的具体执行逻辑，适合学习；0.10.x 版本适合追求性能的场景。
如果你带着不同目标阅读，可以直接按下面的顺序跳读：
| 你的目标 | 建议优先阅读 |
|---|---|
| 先判断项目边界是否靠谱 | §1、§2、§7 |
| 想快速上手体验 | §4、§5 |
| 想从架构和源码切入 | §3、§6、§8 |
| 想评估是否适合二次开发 | §3、§6、§7、§8 |
§1 阅读目标
读完本文后，你应该能够：
- 准确理解缠论的核心概念：分型、笔、线段、中枢、走势类型。
- 理解 CZSC 如何将这些概念转化为可计算的量化信号。
- 完成 CZSC 的安装与基础配置。
- 掌握 signals_all、signals_any、signals_not 等信号函数的使用方法。
- 看懂 CzscTrader 多级别联立决策的核心逻辑。
- 判断这个项目是否适合你的研究和交易场景。
§2 项目概述
2.1 什么是 CZSC
CZSC（缠中说禅技术分析工具）是一个基于缠论理论的量化交易技术分析工具，源于缠中说禅博客。核心功能包括分型、笔的自动识别，以及信号-事件-交易的量化交易逻辑体系。
缠论的核心思想是"不测而测"——所有预测的基础是分类，把所有可能的情况进行完全分类。一旦发生哪种情况就如何操作，把操作同样分段化。然后，把所有情况交给市场本身，让市场自己去当下选择。
2.2 关键数据
| 指标 | 数值 |
|---|---|
| GitHub Stars | 4,871 |
| GitHub Forks | 1,439 |
| 语言 | Python 100% |
| 最新版本 | v0.10.12（2026-03-09） |
| 提交数 | 1,538 |
| 贡献者 | 7 |
| 协议 | Apache-2.0 |
2.3 项目定位
| 定位 | 说明 |
|---|---|
| 缠论实现 | 基于缠中说禅博客的理论实现 |
| 分型笔识别 | 自动识别分型和笔等基础结构 |
| 量化交易 | 信号-事件-交易逻辑体系 |
| 多级别联立 | 支持多级别联合决策分析 |
2.4 这篇文章适合谁读
| 读者类型 | 是否适合 | 原因 |
|---|---|---|
| 缠论学习者 | 适合 | 先理解理论再看代码实现 |
| 量化开发者 | 适合 | 有完整的技术分析和交易逻辑 |
| Python 开发者 | 适合 | 纯 Python 实现，代码可读性强 |
| 寻找稳定实盘系统的人 | 不适合 | 项目仍在高频迭代中 |
§3 先建立边界：哪些是事实，哪些需要谨慎
3.1 当前可确认的已实现能力
| 能力 | 当前状态 | 说明 |
|---|---|---|
| 分型识别 | ✅ 已实现 | 顶分型和底分型的自动识别 |
| 笔识别 | ✅ 已实现 | 基于分型构建笔 |
| 走势划分 | ✅ 已实现 | 上涨、下跌、盘整的自动划分 |
| 信号函数体系 | ✅ 已实现 | signals_all/any/not |
| CzscTrader | ✅ 已实现 | 多级别联立决策分析交易 |
| CTA 择时策略 | ✅ 已实现 | 缠论 30 分钟笔策略示例 |
3.2 需要特别注意的事项
| 注意事项 | 说明 |
|---|---|
| API 变动 | 开发仍在高频次迭代中，API 会有比较大变动 |
| 谨慎升级 | 已经在使用某个版本的用户，请谨慎更新 |
| 源码能力 | 暂时不准备写文档，没有能力看懂源码的不建议使用 |
| 版本选择 | 0.10.x 追求性能，0.9.x 追求可读性 |
3.3 为什么这个边界必须写清楚
CZSC 是一个个人开发者维护的开源项目，不同版本有不同的特点：
- 0.10.x 版本：逐步用 rs-czsc 替换 Python 实现，性能更好但可读性降低
- 0.9.x 版本：纯 Python 实现，可查看具体对象或函数的具体执行逻辑
用户应该根据自己的需求选择合适的版本，而不是盲目追新。
§4 缠论基础
4.1 缠论核心概念
| 概念 | 说明 | CZSC 实现 |
|---|---|---|
| 分型 | 顶分型和底分型，价格走势的基本单元 | Biz.ts() |
| 笔 | 由分型构成的向上或向下段 | Biz.bs() |
| 线段 | 由笔构成的更大结构 | Line() |
| 中枢 | 多空双方博弈的核心区间 | Zhongshu() |
| 走势类型 | 上涨、下跌、盘整 | Trend() |
4.2 缠论核心理念
缠论强调"不测而测"——所有预测的基础是分类，把所有可能的情况进行完全分类。一旦发生哪种情况就如何操作，把操作同样分段化。然后，把所有情况交给市场本身，让市场自己去当下选择。
这意味着：
- 不去预测市场，而是对所有可能的走势进行分类
- 每种分类都有对应的操作策略
- 让市场自己选择走哪条路
§5 核心功能详解
5.1 自动识别功能
| 功能 | 说明 |
|---|---|
| 分型识别 | 自动识别顶分型和底分型 |
| 笔识别 | 自动识别笔的构成 |
| 走势划分 | 自动划分上涨、下跌、盘整 |
5.2 信号函数体系
CZSC 的信号函数体系是其量化交易逻辑的核心：
| 组件 | 说明 |
|---|---|
| 信号-事件-交易 | 量化交易逻辑体系 |
| signals_all | 多个信号同时满足 |
| signals_any | 任意一个信号满足 |
| signals_not | 信号取反 |
5.3 多级别联立决策
| 功能 | 说明 |
|---|---|
| CzscTrader | 多级别联立决策分析交易 |
| 信号组合 | 通过 signals_all/any/not 实现信号逻辑组合 |
§6 技术架构
6.1 核心模块
| 模块 | 文件 | 说明 |
|---|---|---|
| 分析模块 | czsc/analyze.py | 分型、笔的自动识别定义和实现 |
| 对象模块 | czsc/objects.py | 信号-事件-交易逻辑体系定义和实现 |
| 信号函数 | czsc/signals/ | 各种信号函数 |
| 交易器 | CzscTrader | 多级别联立决策分析交易 |
6.2 项目结构
czsc/
├── analyze.py # 分型、笔自动识别
├── objects.py # 信号-事件-交易逻辑
├── signals/ # 信号函数
├── docs/ # 文档
├── examples/ # 示例
└── test/ # 测试6.3 版本差异
| 版本 | 特点 | 适用场景 |
|---|---|---|
| 0.10.x | rs-czsc 替换部分 Python 实现 | 追求性能 |
| 0.9.x | 纯 Python，可查看具体逻辑 | 学习源码 |
§7 安装配置
7.1 系统要求
| 要求 | 规格 |
|---|---|
| Python | >= 3.8 |
| 操作系统 | Windows/macOS/Linux |
7.2 安装方式
从 PyPI 安装（稳定版本）：
pip install czsc -U -i https://pypi.python.org/simple从 GitHub 安装最新版：
pip install git@github.com:waditu/czsc.git -U从 GitHub 指定版本安装：
pip install git+https://github.com/waditu/czsc.git@V0.9.46 -U建议：如果想学习源码，建议安装 0.9.x 版本；如果是追求性能，可以使用 0.10.x 版本。
§8 使用案例
8.1 期货交易
使用 tqsdk 进行期货交易，参考项目文档。
8.2 CTA 择时策略
CTA择时：缠论30分钟笔非多即空策略示例，展示如何利用缠论进行量化择时。
8.3 策略研究
使用 CTA 研究 UI 页面进行策略研究。
§9 相关资源
9.1 项目文档
| 资源 | 链接 |
|---|---|
| API 文档 | czsc.readthedocs.io |
| 项目文档 | 飞书知识库 |
| 投研数据共享 | 飞书知识库 |
| 信号函数编写规范 | 飞书知识库 |
| 源码阅读指南 | docs/源码阅读指南.md |
9.2 缠论原文
| 资源 | 链接 |
|---|---|
| 缠中说禅博客 | blog.sina.com.cn/chzhshch |
| 备份网址1 | fxgan.com |
| 备份网址2 | chzhshch.blog |
9.3 相关项目
| 项目 | 说明 |
|---|---|
| czsc_skills | 缠论相关技能库 |
§10 常见问题
Q1: Python 版本要求是多少？
Python 版本必须 >= 3.8。
Q2: 如何选择版本？
| 需求 | 推荐版本 |
|---|---|
| 学习源码 | 0.9.x |
| 追求性能 | 0.10.x |
| 生产使用 | 谨慎评估，可能需要锁定版本 |
Q3: 0.10.X 和 0.9.X 版本有什么区别？
0.10.X 版本开始，逐步用 rs-czsc 替换一些 Python 对象、函数的实现。有需要了解对象或函数的具体执行逻辑的，可以查看 0.9.X 版本。
Q4: 如何报告 Bug？
可以先阅读《如何有效地报告 Bug》，然后在 GitHub Issues 中报告。
§11 总结
如果要用一句话概括 CZSC，我会这样定义：
它是一个基于缠论理论的 Python 量化交易技术分析工具，通过分型、笔的自动识别和信号函数体系，实现"不测而测"的量化交易逻辑。
它的优势在于：
- 有完整的缠论理论实现
- 有信号-事件-交易的量化逻辑
- 有多级别联立决策能力
- 有活跃的社区支持
它的边界也同样明确：
- 项目仍在高频迭代中
- API 会有较大变动
- 不适合追求稳定性的生产环境
- 需要具备一定的缠论和 Python 基础
对缠论学习者来说，正确姿势是先理解理论，再看代码实现；对量化开发者来说，正确姿势是先确定版本（0.9.x 或 0.10.x），再深入研究具体模块。
相关链接
💻 GitHub：waditu/czsc
📦 PyPI：czsc
📖 API 文档：czsc.readthedocs.io
📺 B站视频教程：243682308
文档元信息
- 难度：⭐⭐⭐
- 类型：技术笔记 / 项目解读
- 更新日期：2026-04-08
- 依据来源：GitHub 仓库 README、API 文档与公开源码结构