# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [0.5.1] - 2025-01-04
### Added
- **CHANGELOG.md**: 新建完整的版本历史文档
- 添加详细的 v0.5.0 迁移指南到 PUBLISH_TO_PYPI.md
- 添加 CHANGELOG 管理章节到发布文档
- 添加 create_bitable_table 工具到 README.md
### Changed
- **PUBLISH_TO_PYPI.md**: 完整重构发布文档
- 统一所有命令使用 `uv` 而非 `pip`
- 更新版本号示例为当前版本
- 添加项目特定的两处版本号同步说明
- 简化 TestPyPI 验证步骤
- 完善发布检查清单（从 6 项增加到 8 项）
- 新增 6 个常见问题解答
- **README.md**: 更新项目文档
- 更新工具数量：9个 → 10个
- 添加说明：所有参数使用 JSON 字符串格式
- 更新所有工具参数说明：dict/list → JSON string
- 为每个参数添加 JSON 字符串使用示例
- 更新项目结构（移除已删除的 exceptions.py 和 tools/）
- 更新技术栈（移除 FastMCP，更新为官方 MCP SDK）
- 更新文档链接和参考资料
### Fixed
- 修复 PUBLISH_TO_PYPI.md 中过时的验证命令
- 修复 README.md 中工具参数类型与实际实现不一致的问题
## [0.5.0] - 2025-01-04
### Breaking Changes
- **工具参数类型变更**: 所有工具的对象和数组类型参数改为 JSON 字符串格式，以避免 MCP 协议序列化问题
- `fields` (object) → `fields` (JSON string)
- `records` (array) → `records` (JSON string)
- `record_ids` (array) → `record_ids` (JSON string)
- `filter` (object) → `filter` (JSON string)
- `fields` (array, create_bitable_table) → `fields` (JSON string)
### Migration Guide
#### 旧版本调用方式（v0.4.x 及之前）
```json
{
"app_token": "xxx",
"table_id": "xxx",
"fields": {
"name": "张三",
"age": 25
}
}
```
#### 新版本调用方式（v0.5.0+）
```json
{
"app_token": "xxx",
"table_id": "xxx",
"fields": "{\"name\":\"张三\",\"age\":25}"
}
```
### Added
- JSON 解析错误处理（`json.JSONDecodeError`）
- 更详细的工具描述文档，包含 JSON 字符串使用示例
- 在发布检查清单中添加 README.md 和 CHANGELOG.md 检查项
### Changed
- 统一所有命令使用 `uv` 而非 `pip`
- 更新文档中的版本号示例为 0.5.0
- 完善发布流程文档，添加项目特定的版本号同步说明
### Fixed
- 修复文档中过时的导入验证命令
## [0.4.4] - 2024-12-XX
### Added
- 使用官方 MCP SDK 重构整个项目
- 两层架构设计（server.py + impl.py）
- 统一错误处理机制
- 集中式工具路由
### Changed
- 从 FastMCP 迁移到官方 MCP SDK (`mcp.server.Server`)
- 移除 `@mcp.tool()` 装饰器模式
- 所有工具实现移至 `impl.py`，路由逻辑在 `server.py`
### Removed
- 删除 `tools/` 子目录结构
- 删除 `exceptions.py`（错误处理集中化）
- 删除 FastMCP 依赖
## [0.4.2] - 2024-XX-XX
### Changed
- 项目结构优化
## [0.3.0] - 2024-XX-XX
### Added
- 电子表格工具（计划中，未实现）
### Changed
- 重构工具架构
## [0.1.3] - 2024-XX-XX
### Fixed
- Bug 修复
## [0.1.2] - 2024-XX-XX
### Fixed
- Bug 修复
## [0.1.1] - 2024-XX-XX
### Fixed
- 初始版本修复
## [0.1.0] - 2024-XX-XX
### Added
- 初始版本发布
- 多维表格应用管理工具（创建、复制）
- 多维表格记录操作工具（创建、更新、查询）
- 批量操作工具（批量创建、更新、获取、删除）
- 支持 FastMCP 框架
- 自动 token 管理
- JSON 格式响应
