更新日志

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

格式基于 Keep a Changelog， 本项目遵循 语义化版本。

[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) 内存占用，使用环形缓冲区

  • 支持流式数据的增量更新