Hua.Todo/docs/project/研发工单-v1.3.0/03-会议任务拆分.md

研发工单 v1.3.0 - 03 会议任务拆分

术语澄清：本文件中"研发工单"指智能体/开发者执行的编码工作项；"任务/待办项/Todo"指 Hua.Todo 业务领域的 Todo 待办项（Task 实体），二者请勿混淆。

---

一、目标与范围

1.1 目标

实现"会议内容 → AI 任务拆分"功能：用户创建一个标记为"会议"类型的 Todo 待办项作为父目录，通过录音或文字输入会议内容，由 AI 分析后生成待办项建议列表，用户确认后批量创建为子任务。

1.2 核心流程

用户创建"会议"类型父任务（指定标题，如"周一产品评审会"）
     ↓
选择输入方式：
  ├─ 录音：录制会议音频 → 系统转写为文字
  └─ 文字：直接输入/粘贴会议纪要
     ↓
AI 分析会议内容 → 生成待办项建议列表
（每条建议含：标题、优先级、可选截止日期）
     ↓
用户审阅建议列表：
  ├─ 勾选/取消勾选
  ├─ 编辑建议内容（修改标题、调整优先级）
  └─ 手动补充新条目
     ↓
确认 → 批量创建为父任务的子待办项

1.3 范围

包含：

• "会议"类型标记：创建 Todo 时可指定为会议类型，UI 上以图标/标签区分
• 音频录制：前端录音控件，录制会议音频
• 音频转写：将录音发送至后端，调用 STT 服务转为文字
• 文字输入：直接输入/粘贴会议纪要文本
• AI 任务拆分：将会议文字内容发送给 LLM，生成结构化待办项建议
• 建议审阅与确认 UI：用户勾选、编辑、补充建议后批量创建子任务
• 与工单 02 的 LLM 基础设施复用（LlmClientService）

不包含：

• 实时语音转写（边录边转，后续版本考虑）
• 多人协作/会议纪要共享
• 音频文件持久存储（录音转写完成后不保留音频，节省空间；如需保留为后续版本需求）
• 会议录音的云同步（后续版本）

---

二、前置条件

条件	说明	状态
Hua.Todo v1.2.0	基础业务能力（Task CRUD、父子任务）	已完成
工单 02 LLM 基础设施	LlmClientService、AI 拆分服务	待实现
浏览器 MediaRecorder API	前端音频录制	已就绪（主流浏览器支持）
后端 STT 服务	音频转文字（可复用工单 02 的 STT 能力或调用第三方 API）	待实现

---

三、子工单拆分

子工单	标题	依赖	可并行
03-01	会议数据模型与 API	无	是
03-02	音频录制与转写	03-01（API 契约）	部分（前端录音 UI 可并行）
03-03	AI 任务拆分服务	03-01、工单 02 LlmClientService	部分（prompt 设计可并行）
03-04	任务建议与确认 UI	03-01、03-03	否（依赖后端 API 就绪）

执行顺序建议

03-01（模型与API） ──────┐
                         ├──→ 03-04（确认UI）
03-02（录制与转写） ──────┤
                         │
03-03（AI拆分服务） ──────┘

03-01、03-02、03-03 可部分并行推进；03-04 需等前三者 API 就绪后开始。

---

四、架构设计

4.1 整体架构

┌──────────────────────────────────────────────────┐
│                  Vue 前端                         │
│  ┌─────────────┐ ┌─────────────┐ ┌────────────┐ │
│  │ 录音控件     │ │ 文字输入区   │ │ 建议审阅   │ │
│  │ MediaRecorder│ │ Textarea    │ │ 确认对话框 │ │
│  └──────┬──────┘ └──────┬──────┘ └─────┬──────┘ │
│         │               │              │         │
│         ▼               ▼              │         │
│  ┌──────────────────────────────┐      │         │
│  │ meetingApi (前端 API 模块)    │      │         │
│  └──────────────┬───────────────┘      │         │
└─────────────────┼──────────────────────┼─────────┘
                  │ HTTP                 │
                  ▼                      │
┌─────────────────────────────────────────┤
│          后端 (Application 层)          │
│  ┌────────────┐  ┌─────────────────┐   │
│  │ Meeting    │  │ MeetingAi       │   │
│  │ Controller │  │ BreakdownService│   │
│  └─────┬──────┘  └───────┬─────────┘   │
│        │                 │             │
│  ┌─────▼──────┐  ┌──────▼─────────┐   │
│  │ Meeting    │  │ LlmClient      │   │
│  │ Service    │  │ Service (复用02)│   │
│  └─────┬──────┘  └────────────────┘   │
│        │                                │
│  ┌─────▼──────┐                        │
│  │ STT 服务   │                        │
│  │ (转写音频) │                        │
│  └────────────┘                        │
└─────────────────────────────────────────┘

4.2 数据模型扩展

在现有 TaskEntity 上新增 TaskType 字段，区分普通待办项与会议：

/// <summary>待办项类型枚举</summary>
public enum TaskType
{
    /// <summary>普通待办项（默认）</summary>
    Normal = 0,
    /// <summary>会议（可包含录音、纪要，支持 AI 任务拆分）</summary>
    Meeting = 1
}

TaskEntity 新增字段：

字段	类型	默认值	说明
TaskType	TaskType	Normal	待办项类型
MeetingNotes	string?	null	会议纪要/转写文字（仅 Meeting 类型有值）
AudioDuration	double?	null	录音时长（秒），仅 Meeting 类型有值

注意：音频文件本身不持久存储，转写完成后仅保留文字结果。AudioDuration 用于 UI 展示录音时长。

4.3 API 设计

4.3.1 创建会议类型待办项

POST /api/task
请求体：
{
  "title": "周一产品评审会",
  "priority": 1,
  "taskType": 1          // TaskType.Meeting = 1
}
响应体：
{
  "success": true,
  "data": {
    "id": 42,
    "title": "周一产品评审会",
    "taskType": 1,
    "meetingNotes": null,
    "audioDuration": null,
    ...
  }
}

4.3.2 上传录音并转写

POST /api/meeting/{taskId}/transcribe
Content-Type: multipart/form-data
字段：
  - audio: 音频文件（webm/wav/mp3）
  - format: 音频格式（可选，默认从文件扩展名推断）

响应体：
{
  "success": true,
  "data": {
    "taskId": 42,
    "transcript": "今天的产品评审会主要讨论了三个议题：第一...",
    "audioDuration": 1830.5
  }
}

4.3.3 保存会议纪要（文字输入）

POST /api/meeting/{taskId}/notes
请求体：
{
  "notes": "今天的产品评审会主要讨论了三个议题：第一..."
}
响应体：
{
  "success": true,
  "data": {
    "taskId": 42,
    "meetingNotes": "今天的产品评审会主要讨论了三个议题：第一..."
  }
}

4.3.4 AI 任务拆分建议

POST /api/meeting/{taskId}/breakdown
请求体：
{
  "notes": "..."    // 可选，若不传则使用已保存的 meetingNotes
}
响应体：
{
  "success": true,
  "data": {
    "taskId": 42,
    "suggestions": [
      {
        "title": "整理产品需求文档",
        "priority": 2,
        "reason": "会议中提到需要在本周五前完成需求文档的整理"
      },
      {
        "title": "安排技术方案评审",
        "priority": 1,
        "reason": "张三负责在下周三前输出技术方案"
      },
      {
        "title": "跟进客户反馈",
        "priority": 0,
        "reason": "李四反馈了三个客户问题，需后续跟进"
      }
    ]
  }
}

4.3.5 确认并批量创建子任务

POST /api/meeting/{taskId}/breakdown/confirm
请求体：
{
  "subTasks": [
    { "title": "整理产品需求文档", "priority": 2 },
    { "title": "安排技术方案评审", "priority": 1 }
  ]
}
响应体：
{
  "success": true,
  "data": {
    "createdCount": 2,
    "subTasks": [
      { "id": 43, "title": "整理产品需求文档", "priority": 2, "parentTaskId": 42 },
      { "id": 44, "title": "安排技术方案评审", "priority": 1, "parentTaskId": 42 }
    ]
  }
}

---

五、与工单 02 的边界

能力	工单 02	工单 03
LLM 调用	LlmClientService 基础设施	复用 LlmClientService，新增会议拆分专用 prompt
语音输入	STT 平台原生能力（语音指令）	前端 MediaRecorder 录音 → 后端 STT 转写（场景不同）
AI 拆分	对已有单个任务做拆分（AI_BREAKDOWN 意图）	对会议内容做拆分（输入为长文本，输出为多条建议）
确认流程	语音确认/点选候选	专门的审阅 UI（勾选、编辑、补充）

复用关系：

• LlmClientService：03 直接复用 02 的 LLM 调用封装
• AiBreakdownService：02 的单任务拆分服务，03 不直接复用（输入形式和输出结构不同），但设计上保持一致的调用模式

---

六、验收标准

验收项	验证方法	预期结果
创建会议类型待办项	创建 Todo 时选择"会议"类型	创建成功，列表中显示会议图标/标签
录音功能	点击录音按钮，录制一段音频	录音控件正常工作，显示录音时长
录音转写	录音完成后提交	后端返回转写文字，文字内容基本准确
文字输入纪要	在会议待办项中粘贴会议纪要	保存成功，再次打开可见纪要内容
AI 拆分建议	提交会议内容请求 AI 拆分	返回 3-10 条建议，每条含标题+优先级+理由
建议审阅	勾选/取消/编辑建议	UI 支持勾选、编辑标题和优先级
批量创建	确认勾选的建议	子任务批量创建到父任务下
离线降级	离线时请求 AI 拆分	提示"离线模式不支持 AI 拆分"
非会议类型	普通待办项不显示录音/拆分入口	功能入口仅对 Meeting 类型显示

---

七、风险与回滚

风险	影响	应对策略
STT 转写准确率不足	会议纪要质量差，影响 AI 拆分效果	支持文字输入作为备选；转写后允许用户编辑修正
LLM API 不稳定	AI 拆分功能不可用	功能降级，其他会议功能（录音、纪要）不受影响
录音文件过大	上传超时/存储压力大	前端限制录音时长（建议最长 2 小时）；压缩音频格式
浏览器 MediaRecorder 兼容性	部分平台录音功能不可用	降级提示"当前浏览器不支持录音，请使用文字输入"

---

八、Touch List

文件路径	修改类型	是否共享	说明
src/Hua.Todo.Core/Entities/TaskType.cs	新增	否	TaskType 枚举
src/Hua.Todo.Core/Entities/TaskEntity.cs	修改	是	新增 TaskType/MeetingNotes/AudioDuration 字段
src/Hua.Todo.Application/Data/TodoDbContext.cs	修改	是	新增字段映射 + 迁移
src/Hua.Todo.Application/Models/TaskModels.cs	修改	是	DTO 扩展（CreateTaskDto/TaskDto 新增字段）
src/Hua.Todo.Application/Meeting/	新增目录	否	会议相关服务目录
src/Hua.Todo.Application/Meeting/MeetingController.cs	新增	否	会议 API 端点
src/Hua.Todo.Application/Meeting/MeetingService.cs	新增	否	会议业务逻辑
src/Hua.Todo.Application/Meeting/MeetingAiBreakdownService.cs	新增	否	会议 AI 拆分服务
src/Hua.Todo.Application/Meeting/SttService.cs	新增	否	音频转写服务
src/Hua.Todo.Application/Meeting/Models/	新增	否	会议相关 DTO
src/Hua.Todo.Web/src/api/meeting.ts	新增	否	前端会议 API 模块
src/Hua.Todo.Web/src/composables/useAudioRecorder.ts	新增	否	前端录音组合式函数
src/Hua.Todo.Web/src/components/MeetingBreakdownDialog.vue	新增	否	会议任务拆分审阅对话框
src/Hua.Todo.Web/src/components/MeetingTaskItem.vue	新增	否	会议类型待办项（含录音/纪要入口）
src/Hua.Todo.Web/src/components/AudioRecorder.vue	新增	否	录音控件
src/Hua.Todo.Web/src/types/task.ts	修改	是	类型扩展（taskType/meetingNotes）

---

工单编号：03 标题：会议任务拆分 版本：v1.3.0 创建日期：2026-06-16