核心用法
chan-theory-analysis 是一款基于缠中说禅（缠论）的技术分析工具，专为量化交易者设计。核心功能包括：
1. 走势结构分析：自动识别分型、笔分段、走势中枢，区分盘整与趋势
2. 背驰判断：结合 MACD 指标判断价格与动能背离
3. 买卖点识别：输出三类买卖点信号（第1类趋势背驰点、第2类次级别回抽、第3类次级别离开后不回抽）
4. 井论扩展：针对非标准趋势，通过大井/小井辅助定位买卖时机
支持 A 股、港股、美股及加密货币市场，通过 yfinance 获取实时数据，命令行直接调用。
显著优点
- 理论完整：严格遵循缠论原始框架，非简化指标
- 跨市场覆盖：股票、加密货币多资产类别支持
- 零配置启动：单条命令即可运行，依赖清晰（numpy + yfinance）
- 结构化输出：可视化笔分析、关键位置百分比等直观反馈
潜在局限
- 学习门槛高：缠论本身概念复杂，用户需具备理论基础才能正确解读信号
- 单一数据源：依赖 yfinance，数据质量和延迟未明确说明
- 无回测框架：仅提供分析输出，未集成策略验证与绩效评估
- 信号频率未明：未说明适用于日线/小时线/分钟线何种周期
适合人群
- 已学习缠论、寻求自动化工具辅助的手工交易者
- 量化研究者，需将缠论逻辑嵌入自有策略框架
- 多市场配置型投资者，需统一技术分析语言
常规风险
1. 理论风险：缠论为市场解读框架，非预测模型，胜率未经验证
2. 第1类买卖点高风险：文档明确标注"高风险"，趋势背驰后可能延续原趋势
3. 数据风险：yfinance 为非官方数据源，存在数据缺失或延迟可能
4. 过度拟合风险：复杂结构识别在小样本周期易产生假信号
> ⚠️ 工具明确提示"缠论学习曲线较陡，仅供分析参考"，用户应避免直接用于实盘决策。