ShaoHua
108 lines
3.0 KiB
Markdown
108 lines
3.0 KiB
Markdown
# 研发工单 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
|