# 更新日志

TechKit 的所有重要变更都将记录在此文件中。

格式基于 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)，
本项目遵循 [语义化版本](https://semver.org/spec/v2.0.0.html)。

## [1.2.0] - 2024-12-06

### 新增

#### Python 绑定
- **完整的 Python 包**，集成 pybind11
  - 面向对象 API，包含 `SMA`、`RSI`、`MACD` 等类
  - 支持增量（`update()`）和批量（`calculate()`）两种模式
  - NumPy 集成，支持高效的数组操作
  - 通过 `techkit.talib_compat` 提供 TA-Lib 兼容 API
  - 类型提示，包含 `.pyi` 存根文件
  - 支持 Python 3.10、3.11、3.12、3.13

#### CI/CD
- **PyPI 发布工作流**（`.github/workflows/python-publish.yml`）
  - 自动构建 Linux、Windows、macOS 的 wheel 包
  - 多架构支持（x86_64、aarch64、arm64）
  - 生成源码分发包（sdist）
  - GitHub 发布时自动发布到 PyPI

#### 构建系统
- 集成 `setuptools_scm`，从 Git 标签自动管理版本
- 配置 `cibuildwheel`，支持跨平台 wheel 构建
- 更新 `MANIFEST.in`，确保正确的源码分发

### 变更
- 更新 `pyproject.toml`，包含完整的 PyPI 元数据
- 版本现在通过 `setuptools_scm` 从 Git 标签动态读取

---

## [1.1.0] - 2024-12-06

### 新增

#### 第二阶段：高级分析（31 个新指标）

**风险指标（7 个）**
- Sharpe Ratio - 风险调整后收益衡量
- Sortino Ratio - 基于下行偏差的风险调整后收益
- Maximum Drawdown - 峰值到谷值的回撤跟踪
- Drawdown Series - 运行回撤及持续时间
- Calmar Ratio - 收益与最大回撤的比率
- Value at Risk (VaR) - 基于历史百分位数的风险
- Conditional VaR (CVaR) - 期望损失

**波动率模型（4 个）**
- EWMA Volatility - 指数加权移动平均波动率（RiskMetrics）
- Realized Volatility - 平方收益的滚动求和
- Parkinson Volatility - 高低价区间估计器
- GARCH(1,1) - 广义自回归条件异方差

**结构分析（3 个）**
- ZigZag - 带偏差阈值的枢轴点检测
- Swing High/Low - 局部极值识别
- Pivot Points - 支撑/阻力位（5 种计算方法）

**谐波形态（6 个）**
- Gartley Pattern - 经典谐波，0.786 XAD 回撤
- Butterfly Pattern - 扩展形态，1.27-1.618 XAD
- Bat Pattern - 深度回撤，0.886 XAD
- Crab Pattern - 扩展形态，1.618 XAD
- Shark Pattern - 新兴形态，0.886-1.13 XAD
- Cypher Pattern - 独特结构，0.786 XAD

**图表形态（11 个）**
- Head and Shoulders / Inverse
- Double Top / Double Bottom
- Triple Top / Triple Bottom
- Symmetrical Triangle
- Ascending Triangle
- Descending Triangle
- Rising Wedge
- Falling Wedge

#### 文档
- 完整的 API 参考文档（23 个文件，8,925 行）
- 快速入门指南，包含 C 和 C++ 示例
- 实现说明，包含算法细节
- 示例代码文件

### 变更
- 版本更新至 1.1.0
- 改进 README，包含全面的功能概览
- 增强文档中的代码示例

### 验证
- 完成第二阶段验证套件
- 风险指标与 Python empyrical 验证
- 波动率模型与 Python arch 验证
- 形态识别通过视觉检查验证
- 2,000+ 测试断言

---

## [1.0.1] - 2024-12-06

### 变更
- 在发布工作流中禁用 macOS 构建，以降低 GitHub Actions 成本
- 禁用常规 CI 工作流（push/PR 触发）
- 发布现在仅构建 Windows x64 和 Linux x64

### 说明
- macOS 构建配置保留为注释，便于重新启用
- 与 v1.0.0 相比无代码变更

---

## [1.0.0] - 2024-12-06

### 新增
- 完整的 TA-Lib 函数覆盖（158/158 个函数）
- 全面的验证测试套件
- C ABI，支持跨语言兼容
- C++ RAII 包装器
- 所有指标的流式/增量计算
- 线程安全、零全局状态设计

### 指标
- **重叠研究**：SMA、EMA、WMA、DEMA、TEMA、KAMA、MAMA、T3、TRIMA、BBANDS、MIDPOINT、MIDPRICE、SAR、SAREXT、MAVP、HT_TRENDLINE
- **动量**：RSI、MACD、MACDEXT、MACDFIX、STOCH、STOCHF、STOCHRSI、ADX、ADXR、APO、PPO、MOM、ROC、ROCP、ROCR、ROCR100、TRIX、ULTOSC、WILLR、CCI、CMO、MFI、BOP、AROON、AROONOSC、DX、PLUS_DI、MINUS_DI、PLUS_DM、MINUS_DM
- **成交量**：OBV、AD、ADOSC
- **波动率**：ATR、NATR、TRANGE
- **周期**：HT_DCPERIOD、HT_DCPHASE、HT_PHASOR、HT_SINE、HT_TRENDLINE、HT_TRENDMODE
- **统计**：VAR、STDDEV、LINEARREG、LINEARREG_SLOPE、LINEARREG_INTERCEPT、LINEARREG_ANGLE、TSF、BETA、CORREL
- **价格变换**：AVGPRICE、MEDPRICE、TYPPRICE、WCLPRICE
- **形态识别**：全部 61 个蜡烛图形态
- **数学**：MIN、MAX、SUM、MINMAX、MIDPOINT、MIDPRICE

### 验证
- 与 TA-Lib 0.4.0 验证
- 跨多个数据集的 1873 个测试用例
- 1749 个测试通过（93.4% 通过率）
- 已知差异记录在 `doc/KNOWN_DIFFERENCES.md`

### 文档
- `doc/KNOWN_DIFFERENCES.md`：记录与 TA-Lib 的差异
- `doc/TALIB_FUNCTION_INVENTORY.md`：完整的函数映射
- 包含示例的全面 README

---

## [0.5.1] - 2024-12-06

### 文档
- **README.md**：重大重写，改进文档
  - 新增"为什么选择 TechKit？"章节，解释主要优势
  - 新增全面的 O(1) 增量计算示例
  - 新增零拷贝输入和线程安全演示
  - 新增流式优先架构代码示例
  - 重新组织指标分类，包含复杂度表
  - 增强 API 参考，包含全部 127 个指标
  - 更新性能特征章节
- **发布工作流**：增强 `.cursor/rules/release.mdc`，包含详细的标签消息指南
  - 新增 ASCII 艺术格式化模板
  - 新增 AI 助手工作流说明
  - 改进发布说明结构和示例
- **TA-Lib 函数清单**：新增 `doc/TALIB_FUNCTION_INVENTORY.md`
  - 完整的 158 个 TA-Lib 函数映射
  - 97.5% 覆盖率分析（154/158 个函数）
  - 详细的分类分解，包含实现状态

### 修复
- **BOP 指标**：小幅代码清理
- **ROC 变体**：小幅代码清理（ROCP、ROCR、ROCR100）

## [0.5.0] - 2024-12-06

### 新增
- **蜡烛图形态识别**：完全实现 61 个蜡烛图形态
  - 单根蜡烛形态（Doji、Hammer、Shooting Star 等）
  - 双根蜡烛形态（Engulfing、Harami、Piercing 等）
  - 三根蜡烛形态（Morning Star、Evening Star、Three White Soldiers 等）
  - 复杂形态（Rising/Falling Three Methods 等）
- CDL 形态识别验证框架，包含 TA-Lib 兼容性测试

### 修复
- MACDEXT：添加 EMA 对齐，以兼容 TA-Lib
- ATR/NATR/MFI/OBV：修正 lookback 和 warmup 计算

### 文档
- 全面的 README 更新
- MACDEXT/MACDFIX 验证失败分析报告

## [0.4.0] - 2024-12-01

### 新增
- TSF（时间序列预测）指标
- BETA（Beta 系数）指标
- CORREL（皮尔逊相关系数）指标
- MACDEXT（可配置 MA 类型的 MACD）
- MACDFIX（固定周期 MACD）
- 窗口函数：MIN、MAX、SUM、MIDPOINT、MIDPRICE、MINMAX
- ROC 变体：ROCP、ROCR、ROCR100
- BOP（力量平衡）指标
- 价格变换函数：AVGPRICE、MEDPRICE、TYPPRICE、WCLPRICE
- 第二阶段验证测试

## [0.3.1] - 2024-11-28

### 修复
- Bug 修复和稳定性改进

## [0.2.0] - 2024-11-25

### 新增
- 动量指标：RSI、MACD、Stochastic、CCI、ADX、MOM、ROC、WILLR
- 波动率指标：ATR、Bollinger Bands、NATR、TRANGE
- 方向性运动：DM、DI、DX、ADXR
- 成交量指标：OBV、AD、MFI
- 振荡器：APO、PPO、TRIX、ADOSC、StochF、StochRSI
- 独立指标：Aroon、CMO、ULTOSC、SAR
- 统计：VAR、STDDEV、Linear Regression

## [0.1.0] - 2024-11-20

### 新增
- 初始版本
- 核心基础设施，包含 C ABI
- 移动平均：SMA、EMA、WMA、DEMA、TEMA、KAMA、TRIMA、T3、MA
- 线程安全、零全局状态设计
- O(period) 内存占用，使用环形缓冲区
- 支持流式数据的增量更新