变更日志

所有值得注意的项目更改都将记录在此文件中。

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

[未发布]

新增

• 完整的项目文档系统
• 自动化 API 文档生成
• GitHub Pages 文档部署
• 贡献指南和开发文档

变更

• 重构 fetcher 架构，按功能分类组织
• 更新代码结构，提高可维护性
• 优化示例代码和文档

[0.2.0] - 2024-01-15

新增

• 🏗️ 重构 fetcher 架构
• stock/ 目录：股票相关数据获取器
• index/ 目录：指数相关数据获取器
• market/ 目录：市场相关数据获取器
• 🧪 完善测试体系
• 增加单元测试覆盖率
• 添加模拟测试数据
• 📖 优化文档和示例
• 更新 Jupyter notebook 示例
• 添加详细的 API 文档

变更

• 🔧 调整导入结构
• 简化模块导入路径
• 保持向后兼容性
• ⚡ 性能优化
• 优化数据缓存机制
• 减少不必要的 API 调用

修复

• 🐛 修复交易时间判断逻辑
• 🔧 修复缓存数据更新问题
• 📝 修正文档中的示例代码

[0.1.5] - 2023-12-20

新增

• 🆕 美股指数数据获取功能
• 支持 SP500、NASDAQ、DOW 等主要指数
• 实时和历史数据获取
• 📊 指数成分股查询功能
• 获取主要指数的成分股列表
• 支持权重信息查询

修复

• 🐛 修复数据获取失败时的异常处理
• 🔧 改进网络超时处理机制

[0.1.4] - 2023-12-01

新增

• 🧮 股票筹码分布数据获取
• 📈 市场情绪数据获取
• 🔍 股票信息详细查询功能

变更

• 📝 改进错误信息提示
• ⚡ 优化数据获取速度

修复

• 🐛 修复部分股票代码无法识别的问题
• 🔧 修复缓存失效问题

[0.1.3] - 2023-11-15

新增

• 💾 持久化字典功能 (PersistentDict)
• 自动数据缓存和持久化
• 支持过期时间设置
• 🕐 交易时间检查器
• 判断当前是否为交易时间
• 支持节假日识别

变更

• 🏗️ 重构核心架构
• 分离数据获取和数据处理逻辑
• 提高代码可维护性

[0.1.2] - 2023-10-20

新增

• 📊 股票历史 K 线数据获取
• 💰 股票实时行情数据获取
• 📈 指数数据获取功能

修复

• 🐛 修复数据格式转换问题
• 🔧 改进异常处理机制

[0.1.1] - 2023-10-01

新增

• 🎯 股票市场基础功能
• 📋 股票列表获取
• 🔧 基础配置管理

修复

• 🐛 修复初始化错误
• 📝 修正文档错误

[0.1.0] - 2023-09-15

新增

• 🚀 初始版本发布
• 📦 基础项目结构搭建
• 🔧 核心 StockData 类实现
• 📚 基础文档和示例

特性

• ✅ 支持 A 股股票数据获取
• ✅ 基于 akshare 的数据源
• ✅ 简单易用的 API 接口
• ✅ 基础缓存机制

---

版本说明

版本编号规则

• 主版本号 (Major)：不兼容的 API 修改
• 次版本号 (Minor)：向下兼容的功能性新增
• 修订号 (Patch)：向下兼容的问题修正

变更类型

• 新增 (Added)：新功能
• 变更 (Changed)：对现有功能的变更
• 弃用 (Deprecated)：不久将移除的功能
• 移除 (Removed)：已移除的功能
• 修复 (Fixed)：Bug 修复
• 安全 (Security)：安全问题修复

图标说明

• 🚀 重大功能发布
• 🆕 新功能
• 🔧 Bug 修复
• ⚡ 性能优化
• 📖 文档更新
• 🧪 测试改进
• 🏗️ 架构调整
• 🎯 功能增强
• 💾 数据处理
• 📊 数据分析
• 🕐 时间功能
• 💰 金融数据
• 📈 图表功能
• 🔍 查询功能
• 📝 文本处理
• 💬 用户体验