晶体简介
## 概述
MACD 背离是技术分析中最经典的趋势反转信号之一。本晶体封装了完整的 A 股 MACD 背离检测与回测工作流，适用于日线、60 分钟等多周期分析。
## 功能
- 自动获取指定股票或指数的历史行情数据
- 计算 MACD 指标（EMA12/26/9），识别顶背离与底背离信号
- 生成每次信号的入场、止损、目标位
- 输出胜率、最大回撤、夏普比率等核心统计指标
- 以 Markdown 表格格式呈现逐笔交易记录
## 适用场景
- 策略研究员快速验证 MACD 背离在特定品种上的有效性
- 量化初学者学习完整的回测流程
- 交易员在关键时点做技术形态复盘
Constraints
56total
10fatal
10 must-not-violate
Evidence Quality
Confidence89%
Medium confidence — review before critical use
10 条不可违反的约束
FATALRCfinance-C-407可自动验证
WHEN实现任何数据 Schema 类时
ACTION继承 Mixin 基类，包含 id(String, primary_key)、entity_id(String)、timestamp(DateTime) 三列
CONSEQUENCE缺少这三列会导致 register_schema、get_data、df_to_db 等全局函数无法正确索引和查询，运行时触发 AttributeError 或 KeyError
FATALRCfinance-C-410可自动验证
WHEN构建 entity_id 时
ACTION使用 {entity_type}_{exchange}_{code} 三段式下划线分隔格式
CONSEQUENCEdecode_entity_id() 使用 split('_') 解析三部分，格式不符会导致 IndexError 或解析出错误的实体类型
FATALRCfinance-C-411可自动验证
WHEN实现自定义 StorageBackend 子类时
ACTION实现 get_engine(storage_id, data_path) 和 get_session_factory(storage_id, data_path) 两个抽象方法
CONSEQUENCEStorageBackend 是全仓库唯一的 ABC，未实现抽象方法会在实例化时抛出 TypeError
常见问题
社区驱动
此晶体源于 1 个社区需求，共 1 人想要
讨论 (1)
@Alice·6 天前
这个晶体在茅台（600519）的日线上测试效果非常好，底背离信号准确率很高，推荐大家也试试白酒板块。
更新历史
v2.1.02026-04-10·贡献者： @doramagic-team
Initial release.