CZSC：缠中说禅技术分析工具完全指南

一、项目概述

1.1 什么是 CZSC

CZSC（缠中说禅技术分析工具）是一个基于缠论理论的量化交易技术分析工具，源于缠中说禅博客。核心功能包括分型、笔的自动识别，以及信号-事件-交易的量化交易逻辑体系。

1.2 关键数据

1.3 项目定位

二、缠论基础

2.1 缠论核心概念

2.2 缠论核心理念

缠论强调"不测而测"——所有预测的基础是分类，把所有可能的情况进行完全分类。一旦发生哪种情况就如何操作，把操作同样分段化。然后，把所有情况交给市场本身，让市场自己去当下选择。

三、核心功能

3.1 自动识别

3.2 信号函数体系

3.3 多级别联立决策

四、技术架构

4.1 核心模块

4.2 项目结构

czsc/
├── analyze.py      # 分型、笔自动识别
├── objects.py     # 信号-事件-交易逻辑
├── signals/        # 信号函数
├── docs/          # 文档
├── examples/      # 示例
└── test/         # 测试

五、安装配置

5.1 系统要求

5.2 安装方式

从 GitHub 安装最新版：

pip install git@github.com:waditu/czsc.git -U

从 GitHub 指定分支安装：

pip install git+https://github.com/waditu/czsc.git@V0.9.46 -U

从 PyPI 安装：

pip install czsc -U -i https://pypi.python.org/simple

六、使用案例

6.1 期货交易

使用 tqsdk 进行期货交易，参考项目文档。

6.2 CTA 择时策略

CTA择时：缠论30分钟笔非多即空策略示例，展示如何利用缠论进行量化择时。

6.3 策略研究

使用 CTA 研究 UI 页面进行策略研究。

七、注意事项

7.1 版本兼容性

7.2 开发状态

7.3 免责声明

八、相关资源

8.1 项目文档

8.2 缠论原文

8.3 相关项目

九、常见问题

Q1: Python 版本要求是多少？

Python 版本必须 >= 3.8。

Q2: 如何报告 Bug？

可以先阅读《如何有效地报告 Bug》，然后在 GitHub Issues 中报告。

Q3: 0.10.X 和 0.9.X 版本有什么区别？

0.10.X 版本开始，逐步用 rs-czsc 替换一些 Python 对象、函数的实现。有需要了解对象或函数的具体执行逻辑的，可以查看 0.9.X 版本。

十、项目信息

相关链接

💻 GitHub：waditu/czsc

📦 PyPI：czsc

📖 API 文档：czsc.readthedocs.io

📺 B站视频教程：243682308