Hua.Todo/docs/project/研发工单-v1.3.0/02-语音通话与语音控制.md

研发工单 v1.3.0 - 02 语音通话与语音控制功能

---

一、目标与范围

1.1 目标

实现语音通话数据传输与语音控制功能，支持通过语音指令操作 Todo 待办项，提升用户交互体验。

1.2 范围

包含：

• 语音通话数据传输能力
• 语音指令识别与解析
• 语音控制 Todo 待办项操作
• 与现有业务系统对接

不包含：

• 语音通话 UI 界面设计（仅提供能力层）
• 第三方语音服务集成（使用平台内置能力）

---

二、前置条件

条件	说明
Hua.Todo v1.2.0	已完成，提供基础业务能力
平台语音服务	已就绪
工单 01（可选）	MCP 服务就绪后可通过 MCP 调用

---

三、需求规格

3.1 语音通话数据传输

功能描述：支持语音通话数据的实时传输

接口设计：

工具名：startVoiceCall
参数：
  - target: string - 通话目标标识
返回：
  - callId: string - 通话 ID
  - status: string - 通话状态（connected/disconnected）

工具名：endVoiceCall
参数：
  - callId: string - 通话 ID
返回：
  - success: boolean - 是否成功结束

3.2 语音指令控制

功能描述：支持通过语音指令操作 Todo 待办项

支持的语音指令：

指令类型	示例指令	对应操作
创建任务	"创建任务 开会"	创建标题为"开会"的任务
创建任务（带优先级）	"创建高优先级任务 提交报告"	创建高优先级任务
完成任务	"完成任务 开会"	标记任务"开会"为已完成
删除任务	"删除任务 开会"	删除任务"开会"
更新任务	"更新任务 开会 改为 团队会议"	更新任务标题
查询任务	"查询未完成任务"	获取未完成任务列表
添加子任务	"给任务开会添加子任务 准备PPT"	为任务添加子任务

接口设计：

工具名：executeVoiceCommand
参数：
  - command: string - 语音指令文本
返回：
  - success: boolean - 是否执行成功
  - message: string - 执行结果描述
  - data: object - 返回数据（如任务列表）

3.3 语音状态管理

接口设计：

工具名：getVoiceStatus
参数：无
返回：
  - isListening: boolean - 是否正在监听
  - isSpeaking: boolean - 是否正在播报

工具名：speakText
参数：
  - text: string - 要播报的文本
返回：
  - success: boolean - 是否成功

---

四、验收标准

验收项	验证方法	预期结果
创建任务指令	说出"创建任务 测试"	成功创建标题为"测试"的任务
创建带优先级任务	说出"创建高优先级任务 紧急"	成功创建高优先级任务
完成任务指令	说出"完成任务 测试"	任务状态变为已完成
删除任务指令	说出"删除任务 测试"	任务被成功删除
查询任务指令	说出"查询未完成任务"	返回未完成任务列表
语音播报	调用 speakText	成功播放指定文本
语音通话	调用 startVoiceCall	通话连接成功

---

五、Touch List

文件路径	修改类型	说明
src/Hua.Todo.Application/Voice/	新增	语音服务目录
src/Hua.Todo.Application/Voice/VoiceService.cs	新增	语音服务实现
src/Hua.Todo.Application/Voice/VoiceCommandParser.cs	新增	语音指令解析器
src/Hua.Todo.Application/Voice/Models/	新增	语音相关 DTO
src/Hua.Todo.Application/Voice/VoiceServiceCollectionExtensions.cs	新增	服务注册扩展

---

工单编号：02 标题：语音通话与语音控制功能 版本：v1.3.0