docs(W26): D2.10 端到端答辩文档入库 + D1.1 索引计数同步（v1.17）
- 新增 客服agent\D2.10-客服Agent端到端答辩文档-2026-09-21.html（v1.0，域 2 续号） 十段流水线 + 4 张 Mermaid 图 + 六出口 + INV-1~INV-5 / INV-M1~INV-M6 + 46 条金标前后对比 + 演示台词 + 必问主观题 + 坑与教训 + 诚实未做项 - D1.1 v1.16→v1.17：登记 D2.10；客服agent 9→10 份、总数 61→62 份、 域 D2 9→10、注入校验 57→58 份（客服agent\*.html 3→4） - 权威副本（D:\桌面\金融\）→ 仓库镜像 全量比对一致（0 缺失 / 0 不一致）
This commit is contained in:
张胜宇
File diff suppressed because it is too large
Load Diff
+27
-11
@@ -2,20 +2,20 @@
|
||||
|
||||
> **体系编号**：`D1.1` · 域：一、治理与索引 · 编号体系见 `D1.1` §4.0
|
||||
|
||||
> **编号**：CS-DOC-2026-017 | **版本**：v1.16 | **日期**：2026-09-21 | **状态**：**现行（活文档，随文档区变动同步更新）**
|
||||
> **编号**：CS-DOC-2026-017 | **版本**：v1.17 | **日期**：2026-09-21 | **状态**：**现行（活文档，随文档区变动同步更新）**
|
||||
> **性质**：本文件是 `开发文档\` 的**唯一入口**。任何人（含三个月后的自己）打开这一份，就应知道：先读什么、哪份为准、每份什么状态。
|
||||
> **盘点范围**：`开发文档\`（**53 个文件** = 52 份编号文档 + 1 份入口存根 `CLAUDE.md`，无归档子目录）+ `客服agent\`（**9 份**对外交付文档）。
|
||||
> **盘点范围**：`开发文档\`（**53 个文件** = 52 份编号文档 + 1 份入口存根 `CLAUDE.md`，无归档子目录）+ `客服agent\`（**10 份**对外交付文档）。
|
||||
|
||||
---
|
||||
|
||||
## 0. 一句话结论
|
||||
|
||||
**61 份文档（60 份编号 + 1 份不占编号的入口存根 `CLAUDE.md`）已按 8 个域统一编号为 `D<域>.<序>`（规则见 §4.0，层级见 §3）。开工只读 5 份 = `D2.1` / `D2.2` / `D2.3` / `D2.4` / `D3.3`（见 §2）。**
|
||||
**62 份文档（61 份编号 + 1 份不占编号的入口存根 `CLAUDE.md`）已按 8 个域统一编号为 `D<域>.<序>`（规则见 §4.0，层级见 §3）。开工只读 5 份 = `D2.1` / `D2.2` / `D2.3` / `D2.4` / `D3.3`（见 §2）。**
|
||||
|
||||
| 域 | 名称 | 份数 | 定位 |
|
||||
|---|---|---|---|
|
||||
| **D1** | 一、治理与索引 | 6 | 先读 `D1.1`（本文件）——编号体系、权威链、开工只读集 |
|
||||
| **D2** | 二、对外交付 | 9 | 🔴 **开工必读**（A1—A4；另含 `D2.5` 演示脚本、`D2.6` 答辩报告、`D2.7` 记忆与画像联动、`D2.8` RAG 全链路、`D2.9` 手动对话测试用例） |
|
||||
| **D2** | 二、对外交付 | 10 | 🔴 **开工必读**（A1—A4；另含 `D2.5` 演示脚本、`D2.6` 答辩报告、`D2.7` 记忆与画像联动、`D2.8` RAG 全链路、`D2.9` 手动对话测试用例、`D2.10` 端到端答辩文档） |
|
||||
| **D3** | 三、现行权威·完整版与专项 | 8 | 查证据、查 FR 推导过程（含 A5 鉴权专项 `D3.3`；检索升级 `D3.5`；架构 `D3.6`；**评测金标 `D3.7`**；**密钥轮换 `D3.8`**） |
|
||||
| **D4** | 四、清除与重建留痕 | 7 | 追溯「删了什么、怎么恢复」；`D4.1` 即**重建指南**，`D4.6` 为验收基线留痕，`D4.7` 为**投顾恢复现状** |
|
||||
| **D5** | 五、业务流程基线 | 1 | 两条业务线 / 三条红线 / 演示跑通验收 |
|
||||
@@ -75,7 +75,7 @@ A5 [D3.3] 访客与角色分离的鉴权方案建议（仅此一份，无新旧
|
||||
第 0 层 唯一入口 D1.1 D1.1-文档索引与权威声明.md
|
||||
第 1 层 域（8 个） D1 ─ D8
|
||||
第 2 层 子域（仅域 6 有） D6.1 ─ D6.5
|
||||
第 3 层 文档（61 份） D<域>.<序> / D<域>.<子域>.<序>
|
||||
第 3 层 文档（62 份） D<域>.<序> / D<域>.<子域>.<序>
|
||||
```
|
||||
|
||||
### 3.2 八个域（＝逻辑顺序＝阅读优先级）
|
||||
@@ -83,7 +83,7 @@ A5 [D3.3] 访客与角色分离的鉴权方案建议（仅此一份，无新旧
|
||||
| 域 | 域名称 | 份数 | 状态 | 什么时候读 |
|
||||
|---|---|---|---|---|
|
||||
| **D1** | 一、治理与索引 | 6 | 现行 | **先读 D1.1**（唯一入口，本文件） |
|
||||
| **D2** | 二、对外交付 | 9 | 现行 | 🔴 **开工必读**（含「开工只读 5 份」的 4 份） |
|
||||
| **D2** | 二、对外交付 | 10 | 现行 | 🔴 **开工必读**（含「开工只读 5 份」的 4 份） |
|
||||
| **D3** | 三、现行权威·完整版与专项 | 8 | 现行 | 查证据、查 FR 推导过程时读 |
|
||||
| **D4** | 四、清除与重建留痕 | 7 | 已完成 | 追溯「删了什么、怎么恢复」时读（D4.1 是重建指南；D4.7 是投顾恢复现状） |
|
||||
| **D5** | 五、业务流程基线 | 1 | 现行 | 核对业务范围与三条红线时读（**冲突时以它为准**） |
|
||||
@@ -91,15 +91,15 @@ A5 [D3.3] 访客与角色分离的鉴权方案建议（仅此一份，无新旧
|
||||
| **D7** | 七、早期系统文档 | 5 | **待确认** | 只在追查历史口径时读；已被上游依据表引用，**不可删**（见 §10） |
|
||||
| **D8** | 八、AI 协作规则 | 8 | 现行 | 让 AI 接手时的规则文件（`D8.1`=语言规范正文；`CLAUDE.md`=入口存根，不占编号） |
|
||||
|
||||
> 合计：9 + 6 + 8 + 7 + 1 + 17 + 5 + **8** = **61 份**（其中 `客服agent\` 的 9 份不计入 `开发文档\` 的 52 个文件；域 D8 的 8 份含 1 份**不占编号**的入口存根 `CLAUDE.md`）。
|
||||
> 合计：10 + 6 + 8 + 7 + 1 + 17 + 5 + **8** = **62 份**（其中 `客服agent\` 的 10 份不计入 `开发文档\` 的 52 个文件；域 D8 的 8 份含 1 份**不占编号**的入口存根 `CLAUDE.md`）。
|
||||
|
||||
---
|
||||
|
||||
## 4. 全量文档清单
|
||||
|
||||
> **本节结构**：**§4.0 = 编号规则 + 全量编号总表（61 份，按编号顺序）——查找入口**；§4.1—§4.8 = 按类别展开的明细表（编号见 §4.0 总表，同一逻辑顺序）。
|
||||
> **本节结构**：**§4.0 = 编号规则 + 全量编号总表（62 份，按编号顺序）——查找入口**；§4.1—§4.8 = 按类别展开的明细表（编号见 §4.0 总表，同一逻辑顺序）。
|
||||
|
||||
### 4.0 编号规则与全量编号总表（62 份）
|
||||
### 4.0 编号规则与全量编号总表（63 份）
|
||||
|
||||
**编号规则**
|
||||
|
||||
@@ -132,6 +132,7 @@ A5 [D3.3] 访客与角色分离的鉴权方案建议（仅此一份，无新旧
|
||||
| **D2.7** | `客服agent\D2.7-客服Agent中长期记忆与画像联动设计-2026-09-20.md` | 2026-09-20 | 现行 | 🔴 **记忆与画像专项**：三问直答 / 客服侧五道闸门取证 / 字段分域（`investor_type` 红线）/ **主设计主张：记忆改「行为」不改「输入」** / `INV-M1`~`INV-M6` / 两处过期理由更正 / 分期 P0—P2 / 待决 4 项 |
|
||||
| **D2.8** | `客服agent\D2.8-客服Agent知识库RAG全链路与选型说明-2026-09-20.md` | 2026-09-20 | 现行 | 🔴 **RAG 全链路**：解析 → 切片（叶子标题 + 表格行级子块）→ 向量化（`text-embedding-v3` / 1024 维）→ 入库七步 → 在线八步 → **检索增强 7 个动作** → 阈值与五出口 / 选型 8 项决策 26 备选 / **已知不一致与风险 5 项** |
|
||||
| **D2.9** | `客服agent\D2.9-客服Agent手动对话测试用例-2026-09-20.md` | 2026-09-20（**v1.1**，2026-09-21 全链路复跑回填） | 现行 | 🔴 **动手验收件**：46 条金标**逐条可问**（问句 / 期望出口 / 期望要点 / 禁止出现 / 实测基线）+ 11 条边界 `Z` 组 / 判分四问 / `M-1`~`M-10` 手动汇总 / 真 HTTP 核验配方 / 3 项实测缺口 |
|
||||
| **D2.10** | `客服agent\D2.10-客服Agent端到端答辩文档-2026-09-21.html` | **v1.0** | 现行 | 🔴 **端到端答辩文档**：**十段流水线**（入口 → 队列 → Worker → 安全路由 → 档位 → 意图 → 检索增强 → 出口 → 输出守护 → 治理返回）+ **4 张 Mermaid 图**（主流程图 / 时序图 / 安全路由 / 出口判定）+ 六出口 + `INV-1`~`INV-5` 与 `INV-M1`~`INV-M6` + 46 条金标前后对比 + 演示台词 + **必问主观题（Vibe Coding）** + 坑与教训 10 条 + 诚实未做项 10 条 |
|
||||
| **D3.1** | `开发文档\D3.1-客服Agent需求开发文档与设计方案.html` | **v2.6** | 现行 | D2.2 的**完整版**：逐条需求带证据引用与推导过程 |
|
||||
| **D3.2** | `开发文档\D3.2-知识库设计方案.html` | **v1.6** | 现行 | D2.4 的**完整版**：含被收敛掉的备选方案与否决理由 |
|
||||
| **D3.3** | `开发文档\D3.3-访客与角色分离的鉴权方案建议-2026-09-16.md` | CS-AUTH-2026-011 | 现行 | 🔴 鉴权专项（＝开工只读 5 份之 A5）：四方案 / 三不变量 / 甲乙时序 |
|
||||
@@ -180,9 +181,9 @@ A5 [D3.3] 访客与角色分离的鉴权方案建议（仅此一份，无新旧
|
||||
| **D8.6** | `开发文档\ai\D8.6-04_OUTPUT_RULES.md` | — | 现行 | 产出规则（§5 高风险变更须先确认） |
|
||||
| **D8.7** | `开发文档\ai\D8.7-05_PROJECT_CONTEXT.md` | — | 现行 | 项目背景速览 |
|
||||
|
||||
> **注入校验**：**57 份**可注入文档（**44** `开发文档\*.md` + 5 `开发文档\*.html` + 3 `客服agent\*.html` + `客服agent\D2.5-…md` + `客服agent\D2.6-…md` + `客服agent\D2.7-…md` + `客服agent\D2.8-…md` + `客服agent\D2.9-…md`）**已全部带「体系编号」行**；3 份 `.txt` 按上表例外处理。（原表述的 49 份**未计入** `客服agent\D2.1` 的 `.md` —— 该漏计是历史口径，本轮**只补新增件、不追改历史**。）「开工只读 5 份」对应 **D2.1 / D2.2 / D2.3 / D2.4 / D3.3**。
|
||||
> **注入校验**：**58 份**可注入文档（**44** `开发文档\*.md` + 5 `开发文档\*.html` + **4** `客服agent\*.html` + `客服agent\D2.5-…md` + `客服agent\D2.6-…md` + `客服agent\D2.7-…md` + `客服agent\D2.8-…md` + `客服agent\D2.9-…md`）**已全部带「体系编号」行**；3 份 `.txt` 按上表例外处理。（原表述的 49 份**未计入** `客服agent\D2.1` 的 `.md` —— 该漏计是历史口径，本轮**只补新增件、不追改历史**。）「开工只读 5 份」对应 **D2.1 / D2.2 / D2.3 / D2.4 / D3.3**。
|
||||
|
||||
### 4.1 Ⅰ 对外交付 / 现行权威（`客服agent\`，9 份）
|
||||
### 4.1 Ⅰ 对外交付 / 现行权威（`客服agent\`，10 份）
|
||||
|
||||
| 文件名 | 版本 | 日期 | 定位 | 关联 |
|
||||
|---|---|---|---|---|
|
||||
@@ -195,6 +196,7 @@ A5 [D3.3] 访客与角色分离的鉴权方案建议（仅此一份，无新旧
|
||||
| `D2.7-客服Agent中长期记忆与画像联动设计-2026-09-20.md` | — | 2026-09-20 | 中长期记忆与画像联动（读码取证 / `INV-M1`~`INV-M6` / 分期 P0—P2） | 上游依据：`开发文档\D7.3` §1.3 与 §6.2；口径：`D2.2` §1.7 第 12 / 18 / 21 项 |
|
||||
| `D2.8-客服Agent知识库RAG全链路与选型说明-2026-09-20.md` | — | 2026-09-20 | RAG 全链路（按流程逐步：解析 / 切片 / 向量化 / 入库 / 检索 / 增强 / 判定） | 上游：`D2.4` §6 / §7、`D3.2`、`D3.5`；实测：`knowledge\_chunks.jsonl` **755 块**（2026-09-21 `W24` 复测）+ Milvus 四集合直查 |
|
||||
| `D2.9-客服Agent手动对话测试用例-2026-09-20.md` | **v1.4** | 2026-09-20 | 手动对话测试用例（46 条金标逐条可问 + **每组实测答复原文** + 11 条边界 + 判分四问 + 汇总表 + §2.10 场内基金演示线） | 同口径输入件：`_eval_harness\cases_46.json` / `result_w25.json` / `score_w25.json`；答复全文：`_w25_http_manual.json` / `.txt` |
|
||||
| `D2.10-客服Agent端到端答辩文档-2026-09-21.html` | **v1.0** | 2026-09-21 | 端到端答辩文档（十段流水线 + 主流程图 / 时序图 / 安全路由图 / 出口判定图；六出口；不变量；演示台词；必问主观题） | 承接 `D2.6`（结论）与 `D2.8`（RAG 链路）；台词以 `D2.5` 为准；实测答复源自 `D2.9` |
|
||||
|
||||
### 4.2 Ⅱ 开发文档区内的现行权威（8 份）
|
||||
|
||||
@@ -931,3 +933,17 @@ A5 [D3.3] 访客与角色分离的鉴权方案建议（仅此一份，无新旧
|
||||
| **版本位** | 本文件头部 **v1.15 → v1.16**；`客服agent\D2.1` 标题 **v6.39 → v6.40**；`客服agent\D2.9` **v1.3 → v1.4**；`客服agent\D2.5` §4.7 出口口径更正（**属更正**，版本位不变）；`开发文档\D4.8` 新增 §11；`开发文档\D1.6` 新增 §12 |
|
||||
| **交叉引用** | `D1.6` §12（本轮对话上下文提取件）；`D4.8` §11（缺陷与验收）；`D2.1` `v6.40` 段 |
|
||||
| ⚠️ **未做（诚实声明）** | ① `E-02` / `H-01`（「那风险高吗？」）实测只回 28 字的**一行风险等级**（`E3` 原文直返一个单行块）—— 内容正确但**偏短**，要更饱满需另立改项；② `D-2` 残余（同句重问**候选会变**）仍未修；③ 本轮只做了「**不误删**」，**没有**把收益过滤推回语料层 |
|
||||
|
||||
## 33. 第二十九轮：端到端答辩文档成文（`D2.10`）+ 计数同步（2026-09-21）
|
||||
|
||||
| 项 | 内容 |
|
||||
|---|---|
|
||||
| **新增文档** | `客服agent\D2.10-客服Agent端到端答辩文档-2026-09-21.html`（域 2「对外交付」，`D2.x` 续号，**v1.0**） |
|
||||
| **为什么单独成文** | `D2.6` 回答「凭什么说改好了」、`D2.8` 回答「RAG 链路怎么走的」，但答辩现场最常被问的是「**一条提问进来，到底经过了什么、为什么变成那句答复**」。这条**端到端**链路（入口 → 队列 → Worker → 安全路由 → 档位 → 意图 → 检索增强 → 出口 → 输出守护 → 治理返回）此前分散在 4 份文档里，**无一份可独立讲完** |
|
||||
| **结构** | 0 一页速览 / 1 系统边界 / 2 端到端全景（**主流程图** + 十段说明 + 时序图）/ 3 十段流水线逐段详解 / 4 出口判定与阈值 / 5 安全不变量与白名单 / 6 实测效果与门禁 / 7 演示路径与台词 + 15 分钟分配 / 8 现场速答（含**必问主观题 Vibe Coding**）/ 9 坑与教训 10 条 / 10 诚实未做项 10 条 / 11 引用与留痕 |
|
||||
| **含 4 张 Mermaid 图** | 端到端主流程图（10 阶段 + 4 类安全分支）/ 端到端时序图（`sequenceDiagram`，含 202 + 轮询）/ 五档安全路由优先级图 / 出口判定决策树 |
|
||||
| **口径来源（不引入新数字）** | `D2.6`（金标 11 项前后对比）/ `D2.8`（阈值、常量、检索 7 动作）/ `D2.5`（台词与账号）/ `D2.7`（`INV-M1`~`INV-M6`）/ `D2.9`（实测答复原文）/ `D3.6`（出口依据）/ `D3.7`（判分）/ `D5.1`（三红线）/ `D4.8`（`W21`/`W24`/`W25` 三处缺陷） |
|
||||
| **交付前校验** | 项目自带校验脚本：**1466 行 / 25 锚点 / 41 表格 / 4 Mermaid / 1 代码块，全部通过**（标签闭合 / 锚点有效 / 围栏成对 / 无占位残留） |
|
||||
| **计数同步** | §0 结论 61 → **62 份**（60 → **61 份编号**）；§0 盘点范围 `客服agent\` 9 → **10 份**；§0 域表与 §3.2 表 D2 9 → **10**；§3.1 第 3 层 61 → **62**；「合计」行改 `10 + 6 + 8 + 7 + 1 + 17 + 5 + 8 = **62 份**`；§4.0 说明 61 → **62**；§4.0 标题 62 → **63**；§4.0 总表新增 `D2.10` 行；§4.1 标题（9 → **10 份**）与明细新增行；§4.0 尾「注入校验」**57 → 58 份**（`客服agent\*.html` 3 → **4**，即本文件） |
|
||||
| **版本位同步** | 本文件头部 **v1.16 → v1.17** |
|
||||
| ⚠️ **未做（诚实声明）** | ① **未做全量文件普查**，故本轮只做**增量同步**：§0 的「61 份 = 60 编号 + 1 存根」与「`开发文档\` 53 文件 = 52 编号 + 1 存根」+「`客服agent\` 9 份」三者**本就对不上**（52 + 9 = 61 编号 ≠ 60 编号），且 §4.0 标题长期比 §0 **多 1**。本轮**按原有偏移同步、未就地改写**——要定案须一次**全量文件普查**。② 本文档**已同步到仓库镜像** `group_fqcd_jr\客服agent\`（`D1.6` §4.38 单向覆盖；两侧 **SHA256 前 16 位一致** `f3a0102983563b4e`、**117078 字节**，已回读校验）。 |
|
||||
|
||||
Reference in New Issue
Block a user