waditu/czsc

czsc 是一个专注缠论技术分析的量化研究库。它把 K 线转换成分型、笔、中枢等结构，再在这些结构之上构建信号、事件和持仓逻辑，用于回测和策略研究。适合已经了解缠论、或希望把缠论规则写成代码的人，而不是想直接获取买卖建议的普通投资者。

工作流程上改变什么

典型流程是：把 DataFrame 转成标准 K 线，运行 CZSC 得到结构对象，配置信号函数，然后跑权重回测或策略研究。BarGenerator 可以把低周期 K 线合成为多个周期，CzscTrader 支持多级别联立决策。回测结果可以通过独立的 wbt 包生成自包含的离线 HTML 报告，缠论结构也可以导出为可交互图表。

各组件如何配合

从 1.0 起，缠论核心算法用 Rust 实现，通过 PyO3 扩展 czsc._native 暴露给 Python。README 说明信号函数在 Rust 侧实现，数量为 220+，分在 Python 端的 7 个子模块里，可用 signals_all/signals_any/signals_not 做逻辑组合。数据连接器提供天勤（期货）、Tushare（A 股）和 CCXT（数字货币交易所）三种来源，另有本地缓存数据入口。权重回测、模拟数据和 HTML 回测报告来自独立的 wbt 项目，README 称其为硬依赖；可选的 wmr 用于持仓权重落库，talib-rs 仅在测试中用于 TA 算子的数值一致性校验。首页还推广了一个独立的大模型辅助策略研究平台，属于产品宣传，不是这个库本身的组成部分。

要求与注意事项

• 需要 Python 3.10 或更高版本。推荐从 PyPI 安装；从源码构建需要 Rust 工具链和 maturin，如果默认 Python 低于 3.10，构建会提前报错退出。
• 1.0.x 与 0.9.x 明确不兼容，旧代码需要按新 API 迁移；旧的 Python 实现只保留在 0.9.69 标签中。
• 最小笔长度、最大笔数量、日志详细程度等行为参数通过环境变量控制。
• README 声明项目开源仅用于技术交流，它不是交易建议系统，文档也没有给出信号函数的收益或准确率验证结果。

HotRepo 点评

该仓库仅在 2026-10-31 被记录到一次日榜，当天 6,518 stars，增加 30。现有榜单记录太少，不足以判断任何趋势。

项目源码与说明