# ADHDOS 接口变更记录

记录仓库中的公开接口变更。上线状态由部署记录确认；桌面应用版本不等于接口契约版本。

## 2026-10-26 · 契约 1.1.0 · 仓库实现

### Added

- 本地与云端 MCP 增加 import_tasks、delete_task、set_archived_task_liked、append_board_thought、delete_board_item、get_board_image，覆盖现有 REST 数据操作。
- update_task 支持按 ID 添加、编辑、完成和删除子事项，包括日期；create_board_item 支持初始 thought；本地列表支持筛选、分页和 tabsOnly。
- 本地新增写入使用桌面可恢复批量事务；重试编号与结果一起保存，避免重试重复新增、取消、追加或删除。
- 提供 OpenAPI 3.1 JSON 和无需额外依赖的 Node.js 示例。

### Fixed

- MCP 授权说明统一为每次用户请求明确要求使用 ADHDOS MCP；配置、握手与列出工具不授权读取个人数据。该说明属于代理使用约定，不是访问密钥的细粒度权限机制。
- 云端 Board 删除接受历史数字时间戳版本；需应用 20261026010426_board_api_numeric_version.sql，权限与冲突规则保持一致。
- Board 查询缺少 updatedAt 时返回 null，不用 createdAt 冒充版本；删除旧数据应传 expectedUpdatedAt=null。

### Compatibility

- REST 路径维持 /api/v1；MCP serverInfo.version 为 1.1.0。新增工具和可选参数不要求修改现有调用。
- 旧本地写工具仍接受省略 requestId/expectedUpdatedAt；建议客户端升级后传入，省略时不具备去重/版本保护。
- 本地 list_tasks 未指定 limit 时仍返回完整列表；云端默认每页 100。新增工具的必填字段由 tools/list 给出。
- 部署云函数后云端工具才生效；本地能力需要更新桌面程序。未在本次工作中部署或发布。