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 可代写；先回测验证再上信号
- 注意：上游是开源项目，建议以外接依赖方式接入而非改核心，方便跟随上游更新
相关笔记
- 缠论 · Butler · AI 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 版本
相关日记
- 2026-09-16 - 首次了解
- 2026-10-02 - 核实：补 Python 3.11 要求、仅接 Futu、强调原仓库与镜像之分