ShaoHua
3.0 KiB
3.0 KiB
研发工单 v1.3.0 - 总览
术语澄清：本文件中"研发工单"指智能体/开发者执行的编码工作项，与业务侧的 Todo 待办项无关。详见 .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