chan.py（缠论分析框架）

一句话

国内影响力最大的缠论 Python 开源实现框架——把「缠论」这套股票技术分析理论变成电脑能自动计算的代码。

基本信息（2026-09-16 核实）

仓库：Vespa314/chan.py
数据：2,159 Star / 807 Fork；2021-12 创建，最近更新 2026-06；Python，MIT 协议
定位：开发者框架（需要写 Python 调用），不是现成软件

先说缠论是什么

「缠论」= 网名缠中说禅写的《教你炒股票 108 课》，国内影响力最大的本土技术分析理论体系。核心思路：把杂乱的 K 线拆解成一套固定构件——分型 → 笔 → 线段 → 中枢 → 走势类型，再据此定义三类买卖点。

这个框架能算什么

自动拆解 K 线：输入原始 K 线，自动算出分型、笔、线段、中枢、买卖点，不用人手画
多级别联立：日线、30 分钟、5 分钟等多个周期一起分析（缠论的「区间套」思路）
可视化：直接画出带缠论标注的图
数据源可换：A 股、港美股、加密货币等多种数据接入
策略开发 + 回测：可以挂自己的策略跑回测，对接交易系统
带机器学习：内置 Automl，用机器学习筛选形态参数

和我的关系

Butler 的技能清单里本来就有 stock-analysis、trading-agents、finance 一组——若想给股票分析加「缠论视角」，这个是现成引擎
但它是给会写 Python 的人用的框架：正确打开方式是让 AI（如 Butler 或股票分析技能）写代码调用它，输出缠论结构分析，而不是人手敲
⚠️ 两句实话：①缠论只是技术分析理论之一，不是稳赚公式，笔/线段的划分标准各家实现还有分歧；②任何量化框架的输出都只是参考，不构成投资建议

Project One 接入评估（9-16）

Project One（~/Documents/Project One/daily_stock_analysis）是一个 AI 股票分析系统：FastAPI 后端 + 飞书/钉钉/Discord 机器人 + 十几个行情数据源（akshare/tushare/efinance 等）+ LLM 分析 + 回测引擎 + 多策略观点合成机制（SkillAgent → 聚合 → 共识 → 决策信号）。

chan.py 的接入方式：作为一个新「策略技能」接入

写一个数据适配器：把系统 data_provider 拉的 K 线转成 chan.py 的输入格式
写一个 SkillAgent 模块：调 chan.py 算出分型/笔/线段/中枢/买卖点 → 映射成系统规范信号（buy/sell/hold + 置信度 + 理由，如「日线三买，中枢上沿确认」）
系统现有机制自动接管：多策略聚合、共识度、冲突检测、DecisionAgent 收敛、机器人推送

最妙的一点：系统自带「策略成绩单」机制（skill opinion outcomes）——每个策略的信号会按 1/3/5/10 天窗口自动统计命中率（样本 ≥30 才出统计）。这就是对「缠论有没有用」最科学的检验：不用信不信，看数据说话。

工作量：一个数据适配器 + 一个策略模块，coding agent 可代写；先回测验证再上信号
注意：上游是开源项目，建议以外接依赖方式接入而非改核心，方便跟随上游更新

2026-10-02 核实

原仓库仍是 GitHub 的 Vespa314/chan.py，最近更新 2026-09-24，仍活跃
⚠️ 必须区分原仓库与镜像：CSDN / gitcode 上的推广文多指向 gitcode.com/gh_mirrors/ch/chan.py，那是镜像不是上游，不能拿它当更新依据
公开版约 5300 行（完整版约 22000 行，README 对应完整版）；最低 Python 3.11
交易系统目前仅接 Futu
同类项目 chanlun-pro（yijixiuxin）更新至 2026-09-29，另有多份缠论 Agent Skill 版本

AI 知识库

探索

chan.py（缠论开源实现框架）