save

2026-08-13 23:10:49 +08:00
parent d784d4ae15
commit e31755e343
11 changed files with 4063 additions and 305 deletions
@@ -474,31 +474,53 @@ Agent 推荐发型（基于脸型知识）

 ---

-## 10. 待确认事项
+## 10. 待确认事项（已收口）

- [ ] 大模型选型：GPT 系列 / 文心一言 / 讯飞星火 / 通义千问 / 自研（需评估合规备案要求）
- [ ] 语音识别方案：鸿蒙系统能力 / 第三方 ASR
- [ ] 对话数据存储策略与保留时长（建议 L3 摘要 180 天，原文更短）
- [ ] 内容审核方案：自建 / 第三方
- [ ] 成本预算与调用配额（单轮 ≤ ¥0.05 是否可达）
- [ ] 长对话的摘要压缩策略与触发轮次
- [ ] 是否需要"造型师人格"设定（语气、称呼、专业度分级）
+### 10.1 已确认

-> 知识库技术方案（向量库 / 图谱 / RAG）与记忆系统技术方案的待确认项已移交对应独立文档，避免重复维护。
+| 原待确认项 | 结论 | 依据 |
+|-----------|------|------|
+| **大模型选型** | **DeepSeek 为主 + 智谱 GLM 为备**，通过**自建 LLM 网关**路由。对话与文案用 DeepSeek（单价低、缓存命中折扣显著、中文表达自然）；结构化抽取用轻量档；**图像理解用 GLM-4V 系**（DeepSeek 视觉覆盖不足）。**直接使用厂商官方 API，不走云平台 MaaS 中转** —— 因为备案与上架需要模型厂商侧的备案号与合作证明，云厂商无法代第三方模型厂商出具并盖章 | `TD-04`、`TD-19` |
+| 为什么必须自建网关而非直接调 SDK | ① 成本可归因（无 `ob_ai_call` 表则无法回答「哪个功能在烧钱」）；② 可切换（国内模型调价与迭代极频繁）；③ 可降级（主备切换、配额耗尽降级）；④ Prompt 版本化（Prompt 是核心资产，要像代码一样有版本与回滚）；⑤ 合规单点（关键词拦截、输入输出审核、日志留存一处实现全场景覆盖） | 架构 §8.1 |
+| 语音识别方案 | **鸿蒙 Core Speech Kit 端侧识别**，V2 功能。端侧延迟低、无音频外传（隐私更优）、无按量成本。准确率不达标时再评估云端 ASR 兜底 | `TD-14` |
+| 内容审核方案 | **腾讯云天御 IMS（图片）+ TMS（文本）**，输入与输出**双向审核**。TMS 的自定义关键词库正好承载备案要求的拦截词库，并提供 AI 生成识别能力。**审核不可用时 fail-close**（按拦截处理）—— 与其他外部依赖的 fail-soft 策略相反，因为漏审一条违规内容的代价远高于短时功能不可用 | `TD-13`、`CR-06` |
+| 成本预算与配额 | 单轮 ≤ ¥0.05 可达，**关键在缓存命中率**：主流模型缓存命中可将输入成本降至 1/5~1/30。因此**固定前缀纪律**是硬性设计要求 —— 系统提示词与稳定知识片段放 prompt 头部，且不得包含时间戳、随机 ID、用户昵称等变量，否则缓存永不命中、输入成本翻数倍。另设场景级日预算 + 用户级频控 + 日成本预警三道闸门 | `TD-04`、`NFR-COST-*` |
+| 对话数据保留时长 | 对话原文 90 天；L3/L4 摘要 180 天；审核日志与生成记录 ≥ 6 个月（法定） | `CR-03`、`CR-11` |
+| 长对话摘要压缩策略 | L4 滚动摘要存 `ag_conversation.rolling_summary`，压缩后 ≤ 400 token，关键约束（禁忌、明确偏好）不得在压缩中丢失。V2 功能 | `FR-MEM-10` |
+| 「造型师人格」设定 | **做，但用统一人格 + 白话释义，不做人格分级**。人格通过系统 Prompt 固定（固定前缀还能提升缓存命中率）。专业术语必须配一句白话释义；外观表述遵循「描述而非评判」 | `NFR-UX-03`/`04` |
+
+### 10.2 本轮补充的实现约束
+
+| 约束 | 说明 | 依据 |
+|------|------|------|
+| Token 预算硬性分配 | 系统提示词 ≤ 800、画像摘要 ≤ 500、会话摘要 ≤ 400、检索知识 ≤ 1500、用户输入 ≤ 500，**输入合计 ≤ 3700**，输出 ≤ 800。超限按优先级裁剪而非报错 | `FR-AGT-03`、架构 §7.2 |
+| 每条回答必须可复盘 | `ag_message` 需存 `retrieval_trace`（检索轨迹）与 `rule_hits`（命中规则 ID）。没有这两个字段，「为什么这么答」永远查不清 | `FR-AGT-09` |
+| 越界意图必须正确拒答 | 医疗诊断、身材贬损、评价他人、身份推断（收入/职业层级）均需拒答。这类约束要同时写入系统 Prompt、规则库禁忌用词表、生成后校验三处 | `CR-12`、合规方案 §3 |
+| Agent 回复需 AI 生成显式标识 | 会话界面固定位置提示「内容由 AI 生成」 | `CR-05` |
+| Prompt 注入防护 | 用户输入与系统指令严格分区；用户内容不得影响工具调用决策；输出侧校验 | `NFR-SEC-04` |
+| 解释链事实来自数据库 | 「为什么推荐」的推理路径来自图谱遍历与规则 ID，LLM 只做自然语言转写 | `FR-AGT-13` |
+
+> 知识库技术方案（向量库 / 图谱 / RAG）与记忆系统技术方案的选型结论已在《技术选型与调研报告》统一收口，本文不重复。

 ---

-**文档版本**：v1.1
+**文档版本**：v1.2
 **创建日期**：2026-08-11
-**更新日期**：2026-08-11
+**更新日期**：2026-08-13
 **作者**：产品团队
 **状态**：待评审
 **变更说明**：
+- v1.2（2026-08-13）：§10 待确认事项全部收口 —— 大模型定为 DeepSeek + GLM 双路由并自建网关（明确不走云平台 MaaS 中转，因备案需模型厂商合作证明）；语音用鸿蒙 Core Speech Kit；审核用腾讯云 IMS/TMS 双向且 fail-close；补充 token 预算硬性分配、缓存前缀纪律、回答可复盘字段、越界拒答三处落点等实现约束
 - v1.1：明确 Agent 与记忆系统、知识库的依赖边界；§3.4 改为规则前置的混合检索链路并补充防幻觉红线；§3.5 改为记忆读取与注入策略（含 token 预算与画像摘要示例）；补充 Phase 1 的画像注入、生成后校验、知识缺口埋点等任务
 - v1.0：初始版本

 **关联文档**：
+- [文档索引](./README.md)
+- [需求规格说明](./需求规格说明.md)（本文需求对应 `FR-AGT-01`~`FR-AGT-18`）
 - [美搭 · 智能穿搭美学助手 产品方案](./鸿蒙美搭-智能穿搭美学助手-产品方案.md)
+- [技术架构文档](./技术架构文档.md)（对话链路见 §7.2，LLM 网关见 §8.1，混合检索见 §8.3）
+- [技术选型与调研报告](./技术选型与调研报告.md)
+- [合规与安全方案](./合规与安全方案.md)
 - [美学报告需求文档](./美学报告-需求文档.md)
 - [用户系统与记忆系统需求文档](./用户系统与记忆系统-需求文档.md)
 - [美学知识库建设方案](./美学知识库-建设方案.md)