docs: 新增v1.3.0研发工单文档，清理旧文档引用

2026-06-15 23:24:02 +08:00
parent cf96c56bed
commit 2317c3c456
9 changed files with 345 additions and 1217 deletions
@@ -0,0 +1,107 @@
+# 研发工单 v1.3.0 - 总览
+
+> 术语澄清：本文件中"研发工单"指智能体/开发者执行的**编码工作项**，与业务侧的 Todo 待办项无关。详见 [.trae/rules/全局/05-研发工单规则.md](../../../.trae/rules/全局/05-研发工单规则.md)。
+
+---
+
+## 一、背景与目标
+
+Hua.Todo v1.3.0 版本聚焦于两个核心能力的升级：
+
+| 序号 | 能力 | 描述 |
+|---|---|---|
+| 1 | **MCP 服务映射** | 将现有 HTTP 服务转换为 MCP（Model Context Protocol）服务，提升服务调用效率与可扩展性 |
+| 2 | **语音交互** | 实现语音通话数据传输与语音控制功能，支持通过语音指令操作 Todo 待办项 |
+
+---
+
+## 二、工单拆分
+
+### 2.1 并行工单（可同步执行）
+
+| 工单编号 | 标题 | 负责人 | 状态 |
+|---|---|---|---|
+| 01 | HTTP 服务转换为 MCP 服务 | - | 待开始 |
+| 02 | 语音通话与语音控制功能 | - | 待开始 |
+
+### 2.2 串行工单（依赖前置工单完成）
+
+当前版本暂无串行工单依赖。
+
+---
+
+## 三、各子工单摘要
+
+### 3.1 工单 01 - HTTP 服务转换为 MCP 服务
+
+**目标**：基于 C# 现有映射框架，将 Hua.Todo 的 HTTP API 转换为 MCP 服务
+
+**核心需求**：
+- 将现有的 HTTP API 端点映射为 MCP 工具描述符
+- 生成符合 MCP 规范的契约文档
+- 验证 MCP 服务的可用性与正确性
+
+**验收标准**：
+- MCP 服务可正常对外提供接口
+- 所有原有 HTTP API 功能在 MCP 服务中可正常使用
+
+### 3.2 工单 02 - 语音通话与语音控制功能
+
+**目标**：实现语音通话数据传输与语音控制功能
+
+**核心需求**：
+- 语音通话数据传输能力
+- 语音指令识别与解析
+- 语音控制 Todo 待办项操作（创建、编辑、删除、完成等）
+- 与现有业务系统对接
+
+**验收标准**：
+- 语音通话功能可正常使用
+- 语音控制可准确执行 Todo 业务操作
+
+---
+
+## 四、待验证表
+
+| 子工单 | 验证项 | 状态 | 备注 |
+|---|---|---|---|
+| 01 | MCP 服务契约文档生成 | 待验证 | - |
+| 01 | MCP 服务可用性测试 | 待验证 | - |
+| 01 | 原有 API 功能兼容性 | 待验证 | - |
+| 02 | 语音通话连接测试 | 待验证 | - |
+| 02 | 语音指令识别准确率 | 待验证 | - |
+| 02 | Todo 业务操作覆盖度 | 待验证 | - |
+
+---
+
+## 五、关键决策
+
+| 决策点 | 结论 |
+|---|---|
+| MCP 框架选择 | 使用 TRAE 平台内置的 MCP 服务框架 |
+| 语音识别方案 | 集成平台语音识别能力 |
+| 服务注册方式 | 遵循平台标准注册流程 |
+
+---
+
+## 六、依赖与前置条件
+
+| 依赖项 | 状态 | 来源 |
+|---|---|---|
+| TRAE MCP SDK | 已就绪 | 平台内置 |
+| 语音识别服务 | 已就绪 | 平台内置 |
+| Hua.Todo v1.2.0 | 已完成 | 上一版本 |
+
+---
+
+## 七、风险与回滚
+
+| 风险 | 影响 | 应对策略 |
+|---|---|---|
+| MCP 服务注册失败 | 无法对外提供服务 | 保留 HTTP API 作为降级方案 |
+| 语音识别准确率不足 | 用户体验下降 | 提供文字输入作为备选方案 |
+
+---
+
+**创建日期**：2026-06-15
+**版本**：v1.3.0