docs: 新增v1.3.0研发工单文档,清理旧文档引用
This commit is contained in:
@@ -0,0 +1,134 @@
|
||||
# 研发工单 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
|
||||
Reference in New Issue
Block a user