# changelog.md - 版本记录

## 版本号格式

版本号格式: vMAJOR.MINOR.PATCH

## 待实现功能

- [ ] HTTP 模式服务支持
- [ ] 添加更多图表类型 (时间序列、热度图)
- [ ] 颜色配置选项
- [ ] 单元测试覆盖
- [ ] 集成测试覆盖

## 已实现功能

- [x] 项目结构创建
- [x] MCP 协议支持 (stdio + HTTP)
- [x] plot_line 折线图工具
- [x] plot_bar 柱状图工具
- [x] plot_scatter 散点图工具
- [x] Docker 支持
- [x] Makefile 构建支持

## 认知修正 (Q&A)

### Q: mcp-go SDK 与 modelcontextprotocol/go-sdk 的区别?

A: 
- `modelcontextprotocol/go-sdk` 是官方 SDK，但 API 不稳定
- `mcp-go` (mark3labs) 是社区实现，8.5k stars，更成熟更稳定
- 推荐使用 mcp-go

### 知识点: 
- 在选择 MCP SDK 时，社区活跃度是重要指标
- mcp-go 的 API 设计更加直观易用

---

### Q: lipgloss 导入路径错误?

A:
- 旧版本: `github.com/charmbracelet/lipgloss`
- 新版本 (v2): `charm.land/lipgloss/v2`
- 需要使用 v2 版本以兼容 Go 1.24

### 知识点:
- charmbracelet 的库在 v2 版本后迁移到 charm.land
- 使用前需要检查版本兼容性

---

### Q: mcp-go CallToolRequest 参数访问方式?

A:
- 直接使用 `request.Params` 是 struct 类型
- 需要通过 JSON 序列化再反序列化来访问参数
- 或者使用 mcp-go 提供的工具函数

### 知识点:
- mcp-go 的参数访问模式需要参考官方文档
- 当不确定时，可以用 json.Marshal -> json.Unmarshal

---

### Q: ntcharts 库 vs 自实现图表?

A:
- ntcharts 功能丰富但依赖BubbleTea框架
- 自实现更轻量且更容易控制
- 对于简单图表需求，自实现足够

### 知识点:
- 库的选择需要权衡功能和复杂度
- 简单需求时，自实现可能是更好的选择

---

## 版本历史

### v0.1.0 (2026-04-15)

**功能**:
- 初始版本
- MCP 服务支持 (stdio + HTTP)
- 三种图表工具: 折线图、柱状图、散点图
- Docker 支持
- Makefile 构建支持