# 任务说明书

> **关联需求编号**: REQ-AI-004
> **需求类型**: [x] 新增 [ ] 变更 [ ] 废弃
> **任务编号**: TASK-123
> **版本**: v1.0
> **日期**: 2026-07-20
> **作者**: 许清楚

---

## 一、基本信息

| 字段 | 内容 |
|------|------|
| 任务编号 | TASK-123 |
| 需求编号 | REQ-AI-004 |
| 功能名称 | AI回复来源标识 |
| 需求类型 | 新增 |
| 优先级 | P1 |
| 阶段 | 近期（1-2个月） |
| 开发人员 | 待定 |
| 预计工时 | 5人天 |

---

## 二、需求概述

实现AI回复来源标识功能，在AI回复消息上显示来源图标（图谱/Dify/本地路由等），提升来源透明度和可追溯性。

---

## 三、技术方案要点

### 3.1 数据库

```sql
ALTER TABLE messages ADD COLUMN reply_source VARCHAR(50) DEFAULT NULL;
```

### 3.2 后端

- persist层统一追加标识
- 各路由返回携带reply_source字段
- 配置文件支持热更新

### 3.3 前端

- H5消息气泡显示标识
- 坐席端显示来源详情

---

## 四、关联文档

| 文档 | 路径 |
|------|------|
| PRD | `01-产品文档/03-AI服务/PRD-REQ-AI-004-AI回复来源标识-v1.0.md` |
| 技术方案 | `02-技术文档/技术架构/技术方案-REQ-AI-004-AI回复来源标识-v1.0.md` |
| 原型图 | `01-产品文档/03-AI服务/原型-REQ-AI-004-AI回复来源标识-v1.0.html` |
| 测试用例 | `03-测试文档/03-功能测试用例/TC-REQ-AI-004-AI回复来源标识.md` |

---

## 五、任务分解

| 序号 | 任务 | 预计工时 | 负责人 |
|------|------|----------|--------|
| 1 | 数据库迁移 | 0.5人天 | |
| 2 | 后端-标识配置 | 1人天 | |
| 3 | 后端-persist层改造 | 1人天 | |
| 4 | 前端-H5展示 | 1人天 | |
| 5 | 前端-坐席端展示 | 1人天 | |
| 6 | 联调测试 | 0.5人天 | |

---

## 六、验收标准

| 序号 | 验收标准 |
|------|----------|
| AC1 | 来源标识显示覆盖率 = 100% |
| AC2 | 来源记录可追溯率 = 100% |
| AC3 | 标识配置可维护性 |

---

## 七、里程碑

| 里程碑 | 计划日期 | 实际日期 |
|--------|----------|----------|
| 开始时间 | | |
| 开发完成 | | |
| 提测 | | |
| 测试通过 | | |
| 上线 | | |

---

## 八、备注

| 日期 | 内容 | 记录人 |
|------|------|--------|
| | | |