From da1d14cb317083200ec5ae8eed2849a135897561 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=BC=A0=E8=83=9C=E5=AE=87?=
 <17412268+zzzzz11122222@user.noreply.gitee.com>
Date: Mon, 21 Sep 2026 22:33:09 +0800
Subject: [PATCH] =?UTF-8?q?chore(sync):=20zsy=5Fdevelopcc=20=E5=85=A8?=
 =?UTF-8?q?=E9=87=8F=E5=90=8C=E6=AD=A5=E8=87=B3=20qyqy=5Fdevelop=EF=BC=88W?=
 =?UTF-8?q?27=20=E5=8F=A3=E5=BE=84=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 分支内容对齐 qyqy_develop 3e24033，树完全一致（同步后 git diff 为空）
- 覆盖本轮 W27 交付：L0 表层判定层 + 出口 E6 行情 + 收益过滤槽位白名单
  + 免责声明分档 + 金标扩容至 55 条（全绿）+ 配置版本 244 已发布
- 新增 app/core/exit_codes.py、app/service/fund_trend_service.py 及 3 个测试文件
- 新增 开发文档\D3.9-客服Agent智能路由与行情出口设计-2026-09-21.md
- 基线：e239eb7（2026-09-17 品牌口径统一快照），本提交为其直接后继
---
 app/core/actor.py                             |   13 +-
 app/core/contracts.py                         |    7 +
 app/core/customer_service_rules.py            |  150 +-
 app/core/exit_codes.py                        |  100 +
 app/core/fund_contracts.py                    |   35 +-
 app/service/agent/bootstrap.py                |   16 +-
 app/service/agent/governance.py               |   37 +-
 .../agent/implementations/customer_service.py |  508 ++++-
 app/service/fund_trend_service.py             |  195 ++
 tests/unit/api/test_frontend_boundaries.py    |   13 +-
 .../unit/core/test_customer_service_rules.py  |   63 +-
 tests/unit/core/test_security.py              |   19 +-
 .../test_customer_service_l0_surface.py       |  338 +++
 tests/unit/service/test_fund_trend_service.py |  239 ++
 .../service/test_governance_disclaimer.py     |  100 +-
 .../test_customer_service_tool_config.py      |  117 +
 .../worker/test_runtime_worker_dispatch.py    |   10 +-
 tools/publish_customer_service_tool_config.py |   78 +-
 tools/seed_compliance_baseline.py             |    6 +
 客服agent/D2.1-客服Agent执行Todolist.md       |   27 +-
 客服agent/D2.2-客服Agent需求文档.html         |    7 +-
 ....9-客服Agent手动对话测试用例-2026-09-20.md |  107 +-
 开发文档/D1.1-文档索引与权威声明.md           | 1914 +++++++++--------
 .../D3.1-客服Agent需求开发文档与设计方案.html |   18 +-
 ....6-客服Agent智能增强架构建议-2026-09-17.md |   12 +-
 ...服Agent评测金标集与判分规则-2026-09-17.md  |   60 +-
 ...Agent智能路由与行情出口设计-2026-09-21.md  |  394 ++++
 27 files changed, 3542 insertions(+), 1041 deletions(-)
 create mode 100644 app/core/exit_codes.py
 create mode 100644 app/service/fund_trend_service.py
 create mode 100644 tests/unit/service/test_customer_service_l0_surface.py
 create mode 100644 tests/unit/service/test_fund_trend_service.py
 create mode 100644 tests/unit/tools/test_customer_service_tool_config.py
 create mode 100644 开发文档/D3.9-客服Agent智能路由与行情出口设计-2026-09-21.md

diff --git a/app/core/actor.py b/app/core/actor.py
index 76557ec..9ebe0e3 100644
--- a/app/core/actor.py
+++ b/app/core/actor.py
@@ -26,9 +26,16 @@ VISITOR_ACTOR_TYPE = "visitor"
 #: 访客角色元组。**唯一副本**：`security.py` 与 `runtime.py` 都从这里取。
 VISITOR_ROLES: tuple[str, ...] = (VISITOR_ROLE,)
 
-#: 访客仅可运行 Agent 与读取已发布的公共知识，**不含任何个人数据权限**。
-#: 不允许在这里追加权限码——访客能力扩张属权限决策，须单独评审。
-VISITOR_PERMISSIONS: tuple[str, ...] = ("agent:run", "knowledge:query")
+#: 访客仅可运行 Agent 与读取**公开数据**，**不含任何个人数据权限**。
+#: 追加权限码属**权限决策**，必须单独评审并留痕，不得顺手扩能。
+#:
+#: `2026-09-21`（`W27` / `DEC-W27-11`）评审通过并留痕的**一次**扩张：
+#: `fund:quote:read` —— `E6` 行情走势出口对访客开放。依据：净值与区间涨跌是
+#: **公开事实**（`fin_nav_history` 的公共数据，与公开产品列表页同一数据源），
+#: 读取它不需要任何个人数据，也不放宽任何档位（`INV-1`）。
+#: 反向守卫：本元组**仍不得**出现 `customer:` / `profile:` / `memory:` /
+#: `handover:` / `conversation:` 前缀（`tests/unit/api/test_frontend_boundaries.py` 钉死）。
+VISITOR_PERMISSIONS: tuple[str, ...] = ("agent:run", "knowledge:query", "fund:quote:read")
 
 #: 访客数据范围恒为 `public`（与知识侧档位 `{public}` 同一收敛方向）。
 VISITOR_DATA_SCOPE = "public"
diff --git a/app/core/contracts.py b/app/core/contracts.py
index 8776102..536d912 100644
--- a/app/core/contracts.py
+++ b/app/core/contracts.py
@@ -155,6 +155,13 @@ class CoreResult(BaseModel):
     transfer_required: bool = False
     transfer_reason: str | None = None
     # `E-05`：本轮答复在说哪个主语（出口声明，不是读侧反解）。
+    # ✅ `W27`：本轮命中的**出口码**（`E0`—`E6` / `P0`—`P2` / `LOGIN` / `CONTACT` / `CHAT`，
+    # 定义见 `app/core/exit_codes.py`）。**声明式**字段：由出口自己填，读侧不反解文本。
+    # 唯一消费方是门禁 `F5` 的**免责声明分档**（`DEC-W27-10`）：
+    # 业务出口附完整投资免责话术，非业务出口（闲聊 / 联系方式 / 引导登录 / 澄清）只附轻量提示。
+    # 为什么用出口码而不用“文本里有没有数字”这类间接判据：后者会把 `E5b` 空答误判成非业务，
+    # 从而静默掉档（客户拿不到本应拿到的投资风险提示）。
+    exit_code: str | None = None
     # 落库进消息的 `tool_calls` JSON 列，下一轮作为 `ConversationTurn.subject` 读回。
     topic: str | None = None
 
diff --git a/app/core/customer_service_rules.py b/app/core/customer_service_rules.py
index 49769f8..8cd1f6f 100644
--- a/app/core/customer_service_rules.py
+++ b/app/core/customer_service_rules.py
@@ -37,6 +37,7 @@
 """
 
 import re
+import unicodedata
 from collections.abc import Sequence
 from dataclasses import dataclass
 
@@ -694,25 +695,149 @@ P2_DELEGATION_MARKERS = (
 # 消费方是 `agent_run_application_service.build_outbox_metadata`：它用已落库的历史**重算并
 # 覆写** `chitchat_streak`，不采信客户端提交值（否则客户端写 0 就能绕过收口引导）。
 
+#: `L0-a` 闲聊词表（`D3.9` §3.1，`W27` 起分四组）。
+#
+#: **为什么从 12 条扩到这张表**：旧表是"一次性穷举"，客户说「有人吗」「收到」「ok」
+#: 这类最普通的寒暄都不在表里，于是落到向量检索 —— 检索对「在不在」这种无信息短句
+#: 一定给出某个 0.5 上下的**噪声命中**，客户看到的就是一段答非所问的条款。闲聊判错的
+#: 代价不是"答错业务"，而是"看起来根本不会聊天"，这正是答辩里"不智能"最直观的来源。
+#:
+#: 表内是**归一后**的整句（小写 + 去标点空白，见 `_normalize_for_chitchat`）。
 CHITCHAT_MESSAGES = frozenset({
-    "你好", "您好", "嗨", "哈喽", "在吗", "谢谢", "谢谢你", "再见", "拜拜",
-    "你是谁", "你叫什么", "你今天开心吗",
+    # ① 招呼 / 告别
+    "你好", "您好", "嗨", "哈喽", "哈啰", "hello", "hi", "在吗", "在不在", "有人吗",
+    "在么", "喂", "再见", "拜拜", "bye", "晚安", "早上好", "下午好", "晚上好", "你好吗",
+    # ② 致谢 / 确认
+    "谢谢", "谢谢你", "多谢", "感谢", "收到", "好的", "好", "嗯", "嗯嗯", "哦", "哦哦",
+    "ok", "okay", "明白", "明白了", "知道了", "辛苦了", "好的谢谢", "谢谢好的",
+    # ③ 关于助手
+    "你是谁", "你叫什么", "你会什么", "你能做什么", "你是机器人吗", "你是人工吗",
+    "你是ai吗", "你是不是ai",
+    # ④ 情绪寒暄
+    "你今天开心吗", "你好呀", "你好啊",
 })
 
-CHITCHAT_PHRASES = ("今天天气", "讲个笑话", "你几岁", "你开心吗", "你忙吗")
+#: 子串型闲聊特征（整句不必精确相等）。**顺序无关，只做 `in` 判定**。
+CHITCHAT_PHRASES = (
+    "今天天气", "讲个笑话", "说个笑话", "你几岁", "你多大了", "你开心吗", "你忙吗",
+    "心情不错", "心情不好", "好有趣", "你真厉害",
+)
+
+#: 语气词字符集：**整句只由它们组成且不超过 `_CHITCHAT_FILLER_MAX` 字**时算闲聊。
+#: 目的是接住「嗯嗯嗯」「哈哈哈」「哦哦」这类重复键入 —— 逐个穷举进词表是不可能的。
+_CHITCHAT_FILLER_CHARS = frozenset("嗯哦哈嘿呵喂额呃啊呀唉嘻唔呢吧啦嘛哟噢咯")
+_CHITCHAT_FILLER_MAX = 6
+
+#: 句首/句尾的语气助词：归一后再裁一次，用来接住「谢谢你啊」「好的呀」「嗯好的」这类
+#: 加了语气的日常寒暄。**只在词表已命中时放行**（裁完还要等于词表成员），
+#: 所以不会把「费率呢」这类业务问句裁成寒暄 —— 而且业务实体边界在它之前就已经拦下了。
+_CHITCHAT_TRIM_CHARS = "嗯哦啊呀唉呢吧啦嘛哈哟噢咯"
+
+#: 归一化时要丢掉的标点与空白（中英文混排，故两套都要）。
+_CHITCHAT_PUNCT = re.compile(
+    r"[\s，。！？、；：,.!?;:~～\-—_…'\"“”‘’()（）\[\]【】{}]+"
+)
+
+
+def _normalize_for_chitchat(message: str) -> str:
+    """闲聊判定的归一：**小写 + 去标点与空白**。
+
+    旧实现只做 `strip().lower()`，于是「好的，谢谢」这种带顿号的日常寒暄一条都不命中。
+    去掉标点不会把业务问句压成寒暄 —— 业务问句的实词与数字都还在（且会被下面的
+    `_has_business_entity` 拦下）。
+    """
+    return _CHITCHAT_PUNCT.sub("", message.strip().lower())
+
+
+#: **业务实体词**：出现任何一个，无论其余部分多像寒暄，都**不判闲聊**（`D3.9` §3.1 边界）。
+#: 为什么必须有这条：闲聊出口是**不查知识库**的，判错方向的代价不对称 ——
+#: 把「费率是多少」误判成闲聊＝答非所问；把「好的」误判成业务＝多查一次库。
+#: 所以边界取"宁可错杀"：只要有业务实体，就不给闲聊这条快路径。
+BUSINESS_ENTITY_TERMS = (
+    "基金", "产品", "费率", "申购", "认购", "赎回", "净值", "收益", "风险", "等级",
+    "账户", "持仓", "余额", "份额", "分红", "定投", "转换", "托管", "管理费", "门槛",
+    "起投", "合同", "协议", "条款", "说明书", "税率", "额度", "身份证", "银行卡",
+    "密码", "验证码", "凭据", "走势", "行情", "涨跌", "投顾", "投诉", "定开", "封闭",
+)
+
+#: 纯数字串（产品代码 / 金额）也算业务实体：不能让「159382，你好」走闲聊。
+_CHITCHAT_DIGIT_RUN = re.compile(r"\d{4,}")
+
+#: 条款号形状（`第十六条` / `5.2` 这类）也算业务实体。
+_CHITCHAT_CLAUSE = re.compile(r"第[一二三四五六七八九十百零\d]{1,4}条|\d+\.\d+")
+
+
+def has_business_entity(message: str) -> bool:
+    """问句里是否出现了**业务实体**（产品名片段 / 代码 / 条款号 / 费率 / 账户词）。
+
+    只服务于 `L0` 的分流（闲聊 / 行情 / 计算），不参与安全路由 —— `route_message()`
+    在 `L0` 之前生效，安全红线不依赖本函数。
+    """
+    text = _normalize_for_chitchat(message)
+    if not text:
+        return False
+    if any(term in text for term in BUSINESS_ENTITY_TERMS):
+        return True
+    return bool(_CHITCHAT_DIGIT_RUN.search(text) or _CHITCHAT_CLAUSE.search(text))
+
 
 #: 连续闲聊计数只需记到第 5 句：`AgentRequestMetadata.chitchat_streak` 的上界就是 5。
 CHITCHAT_STREAK_CAP = 5
 
 
 def is_chitchat_message(message: str) -> bool:
-    """是否闲聊。**归一大小写与首尾空白后再判**，与一期实现口径一致。"""
-    normalized = message.strip().lower()
-    return normalized in CHITCHAT_MESSAGES or any(
-        phrase in normalized for phrase in CHITCHAT_PHRASES
+    """是否闲聊（`L0-a`）。
+
+    判定顺序（任一命中即真，**且全都在业务实体边界之后**）：
+
+    1. 归一后是词表成员（整句精确相等）；
+    2. 归一后含 `CHITCHAT_PHRASES` 里的特征串；
+    3. 归一后只由语气词组成且不超过 6 字（接住「嗯嗯嗯」「哈哈哈」）。
+
+    **边界**：`has_business_entity()` 为真时一律返回 `False`（见该函数说明）。
+
+    口径变化留痕（`W27`）：一期实现是"整句精确匹配，不做前缀放宽"，本版**保留精确匹配**
+    的语义（`你好吗` 之所以为真，是因为它被**逐字列进了词表**，不是靠前缀放宽），
+    并新增标点归一、语气词重复、业务实体边界三条。
+    """
+    if has_business_entity(message):
+        return False
+    normalized = _normalize_for_chitchat(message)
+    if not normalized:
+        return False
+    if normalized in CHITCHAT_MESSAGES:
+        return True
+    if any(phrase in normalized for phrase in CHITCHAT_PHRASES):
+        return True
+    # 带语气助词的日常寒暄（「谢谢你啊」「好的呀」「嗯好的」）：裁掉首尾助词后仍是词表成员即算。
+    if normalized.strip(_CHITCHAT_TRIM_CHARS) in CHITCHAT_MESSAGES:
+        return True
+    return (
+        len(normalized) <= _CHITCHAT_FILLER_MAX
+        and all(char in _CHITCHAT_FILLER_CHARS for char in normalized)
     )
 
 
+def is_low_information_message(message: str) -> bool:
+    """`L0-e`：**无信息量短句** —— 纯标点 / 纯符号表情 / 空串。
+
+    这类输入没有任何可检索的语义，交给向量库只会拿到噪声命中。单独成判据而不是并进
+    闲聊词表：闲聊是"言语行为"（致谢、问候），无信息量是"没有言语行为"，
+    两者的答复话术不同（前者可以顺着聊，后者只能请客户补充）。
+    """
+    stripped = message.strip()
+    if not stripped:
+        return True
+    for char in stripped:
+        if char.isspace():
+            continue
+        # 标点（`P*`）与符号/表情（`S*`）都算无信息；其余任何类别（汉字、字母、数字）
+        # 都说明这句话里有可检索的内容。
+        if not unicodedata.category(char).startswith(("P", "S")):
+            return False
+    return True
+
+
 def chitchat_streak(prior_messages: Sequence[str], message: str) -> int:
     """当前消息在同一会话中**连续**闲聊的次数；非闲聊返回 0，上限 :data:`CHITCHAT_STREAK_CAP`。
 
@@ -902,6 +1027,17 @@ def _is_p2_contact_inquiry(text: str) -> bool:
     return not _hit_keywords(text, P2_DELEGATION_MARKERS)
 
 
+def is_contact_inquiry(text: str) -> bool:
+    """**公开**入口：问句是不是在问渠道联系方式（`D3.9` §6.2 的"联系方式"档）。
+
+    与 `_is_p2_contact_inquiry` 同一判据，只是把私有名暴露出来给客服 Agent 用 ——
+    前者决定"要不要按 P2 建单"，后者决定"答复该附完整免责话术还是轻量提示"。
+    两处**必须同源**：如果哪天真把"问电话"改成要建单，这里会跟着一起变，
+    不会留下"路由按 A 判、免责按 B 判"的分裂。
+    """
+    return _is_p2_contact_inquiry(text)
+
+
 def route_message(message: str) -> SafetyRoute | None:
     """按 P0硬级 → P0凭据级 → 注入 → 合规 → 推介边界 → P1 → P2 判定；``None`` = P3（走检索）。
 
diff --git a/app/core/exit_codes.py b/app/core/exit_codes.py
new file mode 100644
index 0000000..c5e38b5
--- /dev/null
+++ b/app/core/exit_codes.py
@@ -0,0 +1,100 @@
+"""客服 Agent 的**出口码注册表**（`W27` 新增，`D3.9` §3.1 / §6.2）。
+
+## 为什么要有这个模块
+
+`D3.7` §3 记着一条老口径：「旧实现**没有** `E1`—`E5` 出口码」，评测探针只能靠"包装终止型
+方法"给每条打标。那套包装法有两个代价：
+
+1. **它测的是探针的包装，不是产品声明** —— 出口改名/换位置，标就变了，而 `D3.7` 的
+   验收结论是拿这些标算出来的；
+2. 有些**行为正确但没出口方法**的分支（例如 `E8` 风险等级代办拦截）会被记成
+   「没有任何出口」，于是**做对的安全行为被判未达标**（`D3.9` §2 的度量失真）。
+
+因此 `W27` 起改为：`CoreResult.exit_code` 由**出口自己声明**，读侧不反解文本。
+第一个（也是目前唯一）消费方是门禁 `F5` 的**免责声明分档**（`DEC-W27-10`）：
+业务出口附完整投资免责话术，非业务出口只附轻量提示。
+
+## 与 `D3.6` / `D3.7` 的编号关系
+
+本模块的编号**直接沿用** `D3.6` §3 的出口码（`E1` 澄清 / `E2a`—`E2e` / `E3` / `E4` /
+`E5a`—`E5c`），并补三个 `D3.6` 未给码的出口：
+
+- `E0`：`L0` 表层判定层本身（`D3.9` §3.1）。它是**路由层**不是终态出口，因此
+  **不写入 `CoreResult.exit_code`**，只作为日志/审计的分组名；
+- `E6`：行情出口（`D3.9` §4）；
+- `E8`：风险等级代办拦截（`D3.7` 的 `E-08` 红线 1 ④）；
+- 安全出口沿用 `SafetyRoute.priority`（`P0` / `P1` / `P2` / `COMPLIANCE` /
+  `PROMPT_INJECTION` / `ADVICE_BOUNDARY`），`D3.7` §3 已按这个口径给安全出口打标；
+- `LOGIN` 沿用 `D3.7` 金标里已经在用的写法（`H-03` 的期望出口并列里就有它）；
+- `CHAT` / `CONTACT` 是本轮新增：闲聊与"问渠道联系方式"没有历史编号，但
+  `D3.9` §6.2 明确把它们列入**非业务档**，所以必须有一个可声明的码。
+"""
+
+from __future__ import annotations
+
+# ---- `L0` 表层判定层（路由分组名，不写入 `CoreResult.exit_code`） ----
+EXIT_SURFACE = "E0"
+
+# ---- 出口 `E1` / `E2` 族：澄清与计算型 ----
+#: `E1`：澄清。**非业务档**（`D3.9` §6.2）—— 「请问您想了解哪一只」不该挂投资风险提示。
+EXIT_CLARIFY = "E1"
+#: `E2a`：类别费率试算（给算法 + 区间，不给单一结论金额）。
+EXIT_CALC_CATEGORY_FEE = "E2a"
+#: `E2b`：单只产品赎回费递进。
+EXIT_CALC_REDEMPTION = "E2b"
+#: `E2c`：`C—R` 通用匹配规则（矩阵一格）。
+EXIT_SUITABILITY_RULE = "E2c"
+#: `E2d`：适当性裁决（产品风险等级 × 客户档案等级）。
+EXIT_SUITABILITY_VERDICT = "E2d"
+#: `E2c-my`（`W21` 新增）：**以本人等级为对象**的可购买范围清单。
+#: 与 `E2c` 的分工是"问句里有没有自带参数"：`E2c` 收 `C1 能买 R3 吗` 这类自带 C/R
+#: 的规则题，本码收 `我能买什么等级的产品` 这类**只问范围**、等级从画像里取的问法。
+EXIT_ELIGIBLE = "E2c-my"
+#: `E2e`：本人画像 / 客户分层作答（`query_customer_profile`）。
+EXIT_PROFILE = "E2e"
+
+# ---- 出口 `E3` / `E4`：知识直返与证据约束生成 ----
+EXIT_KNOWLEDGE_DIRECT = "E3"
+EXIT_EVIDENCE = "E4"
+
+# ---- 出口 `E5` 族：分级回退 ----
+#: `E5a`：知识侧的澄清（候选来自当前可见档位）。**非业务档**。
+EXIT_CLARIFY_KB = "E5a"
+#: `E5b`：部分答 + 引导。**业务档**—— 即使正文为空，客户拿到的也是"业务上答不上来"，
+#: 该给的投资风险提示一个字都不能少（这正是分档判据必须用出口码的原因）。
+EXIT_PARTIAL = "E5b"
+#: `E5c`：转人工。**业务档**（安全与责任披露最不能省的一档）。
+EXIT_TRANSFER = "E5c"
+
+# ---- 出口 `E6` / `E8` ----
+#: `E6`：行情出口（净值序列 / 区间涨跌）。数字来自受控数据源，**业务档**。
+EXIT_QUOTE = "E6"
+#: `E8`：风险等级代办拦截（`D3.7` `E-08` 红线 1 ④）。业务档。
+EXIT_RISK_LEVEL_GUARD = "E8"
+
+# ---- 无编号出口：沿用既有语义名 ----
+#: 闲聊。非业务档。
+EXIT_CHITCHAT = "CHAT"
+#: 引导登录（访客请求超出公开服务范围）。非业务档；`D3.7` 金标已用 `LOGIN` 这个名字。
+EXIT_LOGIN = "LOGIN"
+#: 问渠道联系方式（公开信息，不是提交投诉）。非业务档 —— 「电话是多少」后面跟一句
+#: 投资风险提示属于挂错话术（`D3.9` §6.2 的例证之一）。
+EXIT_CONTACT = "CONTACT"
+
+#: **非业务档**出口集合：门禁 `F5` 只对这些出口追加**轻量提示**，其余一律追加完整
+#: 投资免责话术。集合取"白名单式"是刻意的 —— 新增出口若忘记登记，默认落到**业务档**
+#: （多一句披露），失败方向与 `INV-5`（收敛）一致。
+NON_BUSINESS_EXIT_CODES = frozenset({
+    EXIT_CLARIFY,
+    EXIT_CLARIFY_KB,
+    EXIT_CHITCHAT,
+    EXIT_LOGIN,
+    EXIT_CONTACT,
+})
+
+#: 安全出口的优先级标签（与 `app/core/customer_service_rules.py` 的
+#: `SafetyRoute.priority` 同源）。列在这里是为了让"哪些 priority 是安全出口"可被
+#: 静态检查与测试引用，而不是散落在注释里。
+SAFETY_PRIORITIES = frozenset({
+    "P0", "P1", "P2", "COMPLIANCE", "PROMPT_INJECTION", "ADVICE_BOUNDARY",
+})
diff --git a/app/core/fund_contracts.py b/app/core/fund_contracts.py
index f304ad8..b7ede4d 100644
--- a/app/core/fund_contracts.py
+++ b/app/core/fund_contracts.py
@@ -4,7 +4,7 @@ from datetime import date, datetime
 from decimal import Decimal
 from typing import Literal
 
-from pydantic import BaseModel, ConfigDict, Field, field_validator
+from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
 
 
 class FundQuoteQuery(BaseModel):
@@ -41,3 +41,36 @@ class FundQuote(BaseModel):
     quote_source: Literal["eastmoney", "cache", "degraded"]
     is_intraday: bool
     degraded: bool = False
+
+class FundTrendQuery(BaseModel):
+    """`E6` 行情走势出口的入参（`W27` / `D3.9` §4.2）。
+
+    **只收实体，不收问句**：`fund_code` 与 `fund_name` 至少给一个 —— 由 Agent 侧
+    「表层判定层」抽好再传，工具自己不做自然语言理解。这样"抽错实体"与"查不到数据"
+    是两类可分开归因、分开回归的失败。
+    """
+
+    model_config = ConfigDict(extra="forbid", frozen=True)
+
+    #: 6 位场内代码（最确定的实体）
+    fund_code: str | None = None
+    #: 产品名（需在 `fin_product.product_name` 里**唯一**命中，否则判 `ambiguous`）
+    fund_name: str | None = None
+    #: 取多少个**净值日**（不是自然日，见 `fund_trend_service` 的口径说明）
+    days: int = Field(default=120, ge=5, le=365)
+
+    @field_validator("fund_code")
+    @classmethod
+    def validate_code(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        text = value.strip()
+        if len(text) != 6 or not text.isdigit():
+            raise ValueError("fund code must be a six-digit number")
+        return text
+
+    @model_validator(mode="after")
+    def require_entity(self) -> "FundTrendQuery":
+        if not (self.fund_code or (self.fund_name or "").strip()):
+            raise ValueError("fund_code or fund_name is required")
+        return self
diff --git a/app/service/agent/bootstrap.py b/app/service/agent/bootstrap.py
index 3582135..f82cd87 100644
--- a/app/service/agent/bootstrap.py
+++ b/app/service/agent/bootstrap.py
@@ -7,7 +7,7 @@ from sqlalchemy.ext.asyncio import AsyncSession
 from app.core.advisor_allocation_contracts import AssetAllocationQuery
 from app.core.config import get_settings
 from app.core.errors import RecoverableAgentError
-from app.core.fund_contracts import FundQuoteQuery
+from app.core.fund_contracts import FundQuoteQuery, FundTrendQuery
 from app.core.investment_goal_contracts import InvestmentGoalQuery
 from app.core.knowledge_contracts import KnowledgeSearchInput
 from app.core.nl2sql_contracts import FinancialNL2SQLInput
@@ -47,6 +47,7 @@ from app.service.customer_profile_service import (
 )
 from app.service.financial_nl2sql_service import query_financial_data_tool
 from app.service.fund_quote_service import query_fund_quote_tool
+from app.service.fund_trend_service import query_fund_trend_tool
 from app.service.intent_classifier import IntentClassifier
 from app.service.investment_goal_service import investment_goal_query_tool
 from app.service.knowledge_search_service import KnowledgeSearchService
@@ -311,6 +312,19 @@ def get_agent_factory() -> AgentFactory:
         # （12s）与重试预算，多代码查询必然先撞工具超时。
         timeout_seconds=15,
     ))
+    registry.register(ToolDefinition(
+        name="query_fund_trend",
+        input_model=FundTrendQuery,
+        handler=cast(Any, query_fund_trend_tool),
+        # 复用行情权限面：本工具与 `query_fund_quote` 读的是同一类公开行情数据
+        # （一个是外部行情源、一个是库内净值序列），不新开权限点。
+        required_permission="fund:quote:read",
+        # `W27` / `DEC-W27-11`：**访客档开放** —— 净值走势是公开事实，不需要任何个人数据；
+        # 访客令牌的权限集已随之补入 `fund:quote:read`（见 `app/core/actor.py` 的评审留痕）。
+        allowed_roles=("visitor", "customer", "advisor", "operator", "risk_operator", "admin"),
+        # 只读库内序列：无网络、无 embedding，10s 是给 MySQL 抖动的余量。
+        timeout_seconds=10,
+    ))
     registry.register(ToolDefinition(
         name="query_customer_profile",
         input_model=CustomerProfileQuery,
diff --git a/app/service/agent/governance.py b/app/service/agent/governance.py
index aa7e334..274e021 100644
--- a/app/service/agent/governance.py
+++ b/app/service/agent/governance.py
@@ -16,6 +16,7 @@ from app.core.contracts import (
 )
 from app.core.customer_service_rules import PUBLIC_BUSINESS_IDENTIFIERS
 from app.core.errors import ForbiddenAgentError, RecoverableAgentError
+from app.core.exit_codes import NON_BUSINESS_EXIT_CODES
 from app.core.memory_scope import (
     RECALL_ITEM_LIMIT,
     REQUIRED_EMPLOYEE_PERMISSION,
@@ -72,6 +73,22 @@ def _build_pii_number_pattern(identifiers: tuple[str, ...]) -> re.Pattern[str]:
 _PII_NUMBER = _build_pii_number_pattern(PUBLIC_BUSINESS_IDENTIFIERS)
 
 
+#: **轻量提示**（`DEC-W27-10` 批准的分档）：非业务答复（闲聊 / 联系方式 / 引导登录 /
+#: 澄清）只附这一句。为什么不一锅端：门禁 `F5` 原来的口径是"面向客户输出 100% 附
+#: 固定话术"，于是「讲个笑话」后面跟着一段投资风险提示 —— 话术与内容不匹配，
+#: 客户体感是"这个客服在背模板"。**分档不减少业务答复的披露**，只是不再给
+#: 非业务答复挂不相关的话术（`D3.9` §6.2）。
+#: ⚠️ 判据必须是**出口码**（`CoreResult.exit_code`），不得用"文本里有没有数字"这类
+#: 间接判据 —— 后者会把 `E5b` 空答误判成非业务，静默掉档。
+#: 文案同样不得命中 `agent_negative_word` 的任何禁用字面（与 `FALLBACK_DISCLAIMER` 同理）。
+FALLBACK_LIGHT_NOTICE = (
+    "以上为一般性说明，仅供参考，具体以产品说明书与官方披露为准。"
+)
+
+#: 轻量提示的库内话术 code。与 `TPL_DISCLAIMER` 同 `scene='disclaimer'`（`chk_template_scene`
+#: 的合法值集合不变，因此**不需要改表结构**），差别只在 `template_code`。
+LIGHT_NOTICE_TEMPLATE_CODE = "TPL_DISCLAIMER_LIGHT"
+
 FALLBACK_DISCLAIMER = (
     "本内容仅为投资分析参考，不构成任何直接投资建议，不构成对任何产品的收益承诺，"
     "据此操作风险自负，请谨慎对待。"
@@ -260,8 +277,12 @@ class PlatformGovernance:
         # 门禁 F5 是否适用（见 `CUSTOMER_FACING_AGENT_TYPES`）。给了默认值是为了让既有的
         # 治理替身按旧签名调用时仍能工作——那种情况下按"未声明"处理，不注入话术。
         disclaimer = await _load_template_text(DISCLAIMER_TEMPLATE_CODE)
+        # `DEC-W27-10`：轻量提示与完整免责话术**一起取**。取两次而不是按出口码只取一份，
+        # 是因为"取哪一份"的决定要留在 `review_output` 里做 —— 那里是门禁的**唯一**判定点，
+        # 分头判定必然漂移。
+        light_notice = await _load_template_text(LIGHT_NOTICE_TEMPLATE_CODE)
         return review_output(result, context, config, memories, disclaimer=disclaimer,
-                             agent_type=agent_type)
+                             light_notice=light_notice, agent_type=agent_type)
 
 
 async def _load_template_text(template_code: str) -> str | None:
@@ -296,7 +317,7 @@ def review_output(
     result: AgentResult, context: RequestContext, config: ResolvedAgentConfig,
     memories: tuple[RecalledMemory, ...],
     *,
-    disclaimer: str | None = None,
+    disclaimer: str | None = None, light_notice: str | None = None,
     agent_type: str = "",
 ) -> AgentResult:
     """同步治理：引用校验 → 负面词判定/替换 → 脱敏 → 追加固定免责声明。
@@ -388,7 +409,17 @@ def review_output(
     # 这正是门禁 F5（面向客户输出 100% 附固定话术）要的方向。正文中间出现同样文字也不会被
     # 误判成"已追加"——只有**末尾这个形状**才算。
     # 空串不算话术：显式传空一律退回代码兜底，避免"传了但传空"成为绕过强制注入的后门。
-    disclaimer_text = (disclaimer or "").strip() or FALLBACK_DISCLAIMER
+    # ---- 门禁 `F5` 分档（`DEC-W27-10`）----
+    # 判据**只看出口码**：非业务档（澄清 / 闲聊 / 引导登录 / 联系方式）挂轻量提示，
+    # 其余（含 `E5b` 空答、`E5c` 转人工、`E6` 行情、`P0`—`P2` 安全出口）挂完整投资免责话术。
+    # 为什么不能用"文本里有没有数字"这类间接判据：`E5b` 空答的正文里一个数字都没有，
+    # 但它恰恰是"业务上答不上来"，投资风险提示一个字都不能少 —— 用间接判据会让它静默掉档。
+    # `NON_BUSINESS_EXIT_CODES` 取**白名单式**：新增出口若忘记登记，默认落到业务档（多说一句），
+    # 失败方向与 `INV-5`（收敛）一致。
+    if content.exit_code in NON_BUSINESS_EXIT_CODES:
+        disclaimer_text = (light_notice or "").strip() or FALLBACK_LIGHT_NOTICE
+    else:
+        disclaimer_text = (disclaimer or "").strip() or FALLBACK_DISCLAIMER
     # 追加形状只在这里定义一次：判据与追加共用同一份，避免两处各写一个分隔符而漂移。
     appended_shape = f"\n\n{disclaimer_text}"
     if customer_facing and not content.text.endswith(appended_shape):
diff --git a/app/service/agent/implementations/customer_service.py b/app/service/agent/implementations/customer_service.py
index 93337e3..bf5e546 100644
--- a/app/service/agent/implementations/customer_service.py
+++ b/app/service/agent/implementations/customer_service.py
@@ -57,6 +57,9 @@ from app.core.customer_service_rules import (
     TRANSFER_REASONS,
     SafetyRoute,
     hits_zero_tolerance,
+    is_chitchat_message,
+    is_contact_inquiry,
+    is_low_information_message,
     is_own_eligibility_question,
     is_risk_level_change_request,
     promotional_wording_violation,
@@ -64,6 +67,25 @@ from app.core.customer_service_rules import (
     visitor_advice_violation,
 )
 from app.core.errors import ForbiddenAgentError
+from app.core.exit_codes import (
+    EXIT_CALC_CATEGORY_FEE,
+    EXIT_CALC_REDEMPTION,
+    EXIT_CHITCHAT,
+    EXIT_CLARIFY,
+    EXIT_CLARIFY_KB,
+    EXIT_CONTACT,
+    EXIT_ELIGIBLE,
+    EXIT_EVIDENCE,
+    EXIT_KNOWLEDGE_DIRECT,
+    EXIT_LOGIN,
+    EXIT_PARTIAL,
+    EXIT_PROFILE,
+    EXIT_QUOTE,
+    EXIT_RISK_LEVEL_GUARD,
+    EXIT_SUITABILITY_RULE,
+    EXIT_SUITABILITY_VERDICT,
+    EXIT_TRANSFER,
+)
 from app.core.fund_fee_rules import (
     CATEGORIES,
     DISCLOSURE,
@@ -437,43 +459,168 @@ def render_plain(text: str) -> str:
     return re.sub(r"\n{3,}", "\n\n", out).strip()
 
 
-#: 收益 + 数值同句的两种语序。**只匹配同一行**，避免误伤费率表。
-#: 中间那一段留成捕获组（`gap`），用来放过「业绩比较基准」里的**权重**写法 —— 见 `_is_yield_claim`。
-_YIELD_NUMBER_A = re.compile(r"(收益率|年化|回报率|涨幅|业绩)([^\n]{0,12}?)\d+(?:\.\d+)?\s*%")
-_YIELD_NUMBER_B = re.compile(r"(\d+(?:\.\d+)?\s*%)([^\n]{0,10}?)(收益率|年化|回报率|涨幅)")
+#: **收益语境词**：一行里出现它们，才进入"要不要拦"的判定。`D3.9` §5 把它从
+#: "收益词紧邻数字"（旧黑名单）放宽成"整行有收益语境"—— 这正是 `W27` 要修的漏洞：
+#: 实测 `南方季季盈90天怎么样` 的答复里写着「近一年表现（虚构）｜约 **4.12%**」，
+#: 旧正则只认「收益率 / 年化 / 回报率 / 涨幅 / 业绩」紧跟数字，把「表现」漏在网外，
+#: **虚构数字就这样到了客户眼前**（`D3.9` §2.6）。
+_YIELD_CONTEXT_TERMS = (
+    "收益", "年化", "回报", "涨", "跌", "表现", "业绩", "净值", "净值增长",
+    "盈利", "获利", "赚",
+)
 
-#: 「沪深300指数收益率×60%＋中证全债指数收益率×40%」里的 `60%` / `40%` 是**权重**，
-#: 不是收益数值 —— 这一句本身就是「业绩比较基准**不是**收益承诺」的例证。
-#: 少了这条豁免，`FAQ-0022` 的「答：…」整行会被删掉，客户只看到光秃秃的
-#: 「问：什么是业绩比较基准？」（实测 2026-09-21 复跑命中金标 `A-06`，属真缺陷）。
-#: 判据：**收益词与百分比之间**出现了乘号或指数名 ⇒ 那是在算权重，不是在报收益。
+#: **白名单槽位**（`D3.9` §5 / `DEC-W27-9`）：落在这些槽位里的百分比**放行**。
+#: 每项是"这一类数字长什么样"的证据词，命中任一即算识别出槽位。
+#: 未识别出的百分比**一律按收益处理**（fail-closed）—— 失败方向是"少给一行"，
+#: 而漏放的失败方向是"给客户一个收益数字"，两者代价不对称。
+_YIELD_SLOT_TERMS: tuple[tuple[str, tuple[str, ...]], ...] = (
+    # 费率：`申购费率 1.5%` / `管理费 0.30%/年` / `直销 1 折` 的费率写法
+    ("费率", (
+        "费率", "管理费", "托管费", "申购费", "认购费", "赎回费", "销售服务费",
+        "佣金", "手续费", "收取", "计提",
+    )),
+    # 权重 / 业绩比较基准公式：`沪深300指数收益率×60%`（乘号已在旧实现里有据可依）
+    ("权重", ("×", "✕", "✖", "＊", "乘", "指数")),
+    # 风险指标：`最大回撤 -0.75%` / `夏普比率 1.62`（`DEC-W27-9` 裁定可放行并标注口径）
+    ("风险指标", ("最大回撤", "夏普", "波动率", "标准差", "贝塔", "跟踪误差")),
+    # 比例 / 仓位 / 折扣
+    ("比例", ("比例", "仓位", "配置", "权重", "折", "折扣")),
+    # 期限 / 天数 / 开放期
+    # ⚠️ `个交易日` **刻意不在**期限槽位里：`近 5 个交易日涨跌 +3.77%` 是一句**行情涨跌**，
+    # 放它进来等于给"涨跌幅"开后门（`D3.9` §5 明确要求涨跌默认拦下）。
+    # 真正的费率期限写法（`持有不满 7 个交易日 1.5%`）靠同子句的「持有」二字就能识别。
+    ("期限", ("持有", "期限", "天数", "个工作日", "开放期", "封闭期")),
+    # 门槛 / 规模
+    ("门槛规模", ("起投", "起点", "门槛", "规模", "份额", "亿元", "万元", "亿元")),
+)
+
+#: 兼容旧名（`_YIELD_FORMULA_MARKERS` 在别处被引用过的话不至于断）。
 _YIELD_FORMULA_MARKERS = ("×", "✕", "✖", "＊", "乘", "指数")
 
+#: 子句切分：句末标点与 Markdown 表格竖线。**按子句判而不是按整行判**，
+#: 否则同一行里"费率 0.15%"会给旁边的"年化收益率 3.6%"背书。
+#: 不含逗号：中文条款里逗号密度太高，切了反而把标签与数字拆散。
+_YIELD_CLAUSE_SPLIT = re.compile(r"[。；;|\n]")
+_PERCENT_TOKEN = re.compile(r"\d+(?:\.\d+)?\s*%")
+
+
+def _yield_slot_of(clause: str) -> str | None:
+    """子句里的百分比落进哪个白名单槽位；识别不出返回 `None`（调用方按收益处理）。"""
+    for name, terms in _YIELD_SLOT_TERMS:
+        if any(term in clause for term in terms):
+            return name
+    return None
+
 
 def _is_yield_claim(line: str) -> bool:
-    """这一行是在**给收益数值**，还是在写**业绩基准公式**。"""
-    for pattern in (_YIELD_NUMBER_A, _YIELD_NUMBER_B):
-        for match in pattern.finditer(line):
-            if not any(mark in match.group(2) for mark in _YIELD_FORMULA_MARKERS):
-                return True
+    """这一行有没有**放不出去**的收益数值。
+
+    判定是两段式，缺一不可：
+
+    1. **入口闸**：整行必须含 `_YIELD_CONTEXT_TERMS` 里的收益语境词。没有语境的行
+       （费率表数据行 `| 100万≤M<500万 | 1.2% |`、日期、门槛）**根本不进判定** ——
+       这一条是"不误伤"的保险丝，也是旧实现里 `_YIELD_FORMULA_MARKERS` 那段豁免的推广。
+    2. **槽位白名单**：任何带 `%` 的子句若识别不出槽位 ⇒ 判为收益，整行丢弃（fail-closed）。
+    """
+    if not any(term in line for term in _YIELD_CONTEXT_TERMS):
+        return False
+    for clause in _YIELD_CLAUSE_SPLIT.split(line):
+        if not _PERCENT_TOKEN.search(clause):
+            continue
+        if _yield_slot_of(clause) is None:
+            return True
     return False
 
 
 def drop_yield_claims(text: str) -> str:
-    """丢掉**带具体数值的收益表述**所在行。
+    """丢掉**带具体数值的收益表述**所在行（`D3.9` §5：关键词黑名单 → 槽位白名单）。
 
     为什么必须在展示层做：输入侧 `YIELD_TRAP_PATTERNS` 只拦得住"问句自带数字口径"的问法；
     而**知识块里本来就写着收益数字**（产品手册的业绩示例），`E3` 原文直返会把
     「近一年收益率 7.60%」原样送到客户眼前 —— 实测 2026-09-20 问「我想找一个收益高一点的
     产品」即命中。收益数值属"不得输出的承诺类内容"，宁可这一行不给，也不能让客户看到
-    任何像是收益承诺的数字。费率表不受影响（它讲的是「费率」不是「收益率」）；
-    业绩比较基准公式里的权重百分比（`沪深300指数收益率×60%`）同样不受影响 —— 它是权重，
-    且那句话本身就在说「不是收益承诺」。
+    任何像是收益承诺的数字。
+
+    `W27` 起**判据换成白名单 + fail-closed**（`DEC-W27-9`）：
+    费率 / 权重公式 / 风险指标 / 比例 / 期限 / 门槛规模六类槽位放行，
+    其余百分比按收益处理。这样"改写绕过"（把「收益率」写成「表现」）不再有效 ——
+    旧实现认词，新实现认槽位，**认不出的就是收益**。
     """
     kept = [line for line in text.split("\n") if not _is_yield_claim(line)]
     return "\n".join(kept).strip()
 
 
+# ---------------------------------------------------------------------------
+# `L0-b` 行情判定（`D3.9` §4.2）：走势 / 净值 / 涨跌
+# ---------------------------------------------------------------------------
+
+#: `E6` 出口的工具名。**访客与客户同名**：工具本身对访客开放（`DEC-W27-11`），
+#: 访客令牌的权限集里已有 `fund:quote:read`。
+TREND_TOOL_NAME = "query_fund_trend"
+
+#: `E6` 走哪个工具白名单 key。沿用 `query_customer_profile` 的既有做法：
+#: 发布配置里 `customer_service:faq` 是唯一一个把所有跨意图工具都挂上去的键，
+#: 新开一个 key 会让工具交集为空、调用 fail-closed（那会表现成"配置错误"而不是"能力缺失"）。
+TREND_WHITELIST_INTENT = INTENT_FAQ
+
+#: 行情类词。**必须与实体同现**才算行情问句（见 `_trend_entity`）。
+TREND_KEYWORDS = (
+    "走势", "涨跌", "净值", "行情", "最近表现", "涨了", "跌了", "今天多少",
+    "表现如何", "涨跌幅", "涨幅", "跌幅", "最近怎么样", "K线", "k线", "净值表现",
+)
+
+#: 6 位产品代码。前后不能贴数字，否则 "1000000" 会被切成两段假代码。
+TREND_FUND_CODE = re.compile(r"(?<!\d)(\d{6})(?!\d)")
+
+#: 汉字字符（判断兜底片段"像不像产品名"）。
+_TREND_CJK = re.compile(r"[\u4e00-\u9fff]")
+
+#: 从"产品名片段"里刮掉的动作词 / 疑问词（`_trend_entity` 的兜底分支用）。
+_TREND_LEAD_NOISE = (
+    "帮我看看", "帮我查查", "帮我", "我想问一下", "我想问", "我想知道", "我想了解",
+    "请问一下", "请问", "查一下", "查询", "看一下", "看看", "了解一下", "介绍",
+    "我想", "我要", "麻烦",
+)
+_TREND_TAIL_NOISE = (
+    "最近怎么样", "最近的走势", "最近表现", "最近", "现在", "目前", "这几天", "今天",
+    "的走势", "净值表现", "走势", "行情", "涨跌幅", "涨幅", "跌幅", "涨了", "跌了",
+    "怎么样", "如何", "是多少", "多少", "表现", "怎么样", "吗", "呢", "啊", "的", "了",
+)
+
+#: **定义题**标记：问"净值怎么算 / 收益是什么意思"要的是**口径说明**（知识库里有），
+#: 不是数据。少这一条，行情出口会把定义题抢走并答成"查不到净值序列"。
+_TREND_DEFINITION_MARKERS = (
+    "怎么算", "如何计算", "怎么计算", "如何算", "是什么意思", "什么意思", "什么是",
+    "怎么理解", "计算方式", "计算公式", "如何理解", "怎么得出",
+)
+
+#: `E6` 取不到数据时的三种话术（`D3.9` §4.4 / `INV-7`）。三句都**不承诺、不猜测**，
+#: 且都给出可继续自助的方向（手册可答项 / 6 位代码）—— 只拒绝不指路等于把客户推给人工。
+TREND_MISS_TEMPLATE = (
+    "「{subject}」我这边查不到公开的净值序列，所以给不出走势（这类数据不能靠推测）。"
+    "如果您问的是产品手册里的示例产品，我可以按手册告诉你它的风险等级、起投金额与费率；"
+    "想了解哪一项，直接告诉我就行。"
+)
+
+#: 有产品行、但没有净值序列。
+TREND_NO_SERIES_TEMPLATE = (
+    "「{subject}」目前在演示数据里没有公开的净值序列，因此给不出走势。"
+    "我可以按手册告诉你它的风险等级、起投金额与费率 —— 想了解哪一项告诉我就行。"
+)
+
+#: 名称命中多只产品：**不替客户挑一只**（`INV-2` 取向）。
+TREND_AMBIGUOUS_TEMPLATE = (
+    "「{subject}」能对应到好几只产品，我不想替您猜一只。"
+    "把 6 位产品代码发我（例如 159382），我就能给出它的净值走势。"
+)
+
+#: `L0-e` 无信息量输入的答复：不查库、不调模型，只请客户补充。
+LOW_INFORMATION_REPLY = (
+    "我没太看清您想了解什么。"
+    "可以告诉我具体产品名或代码，或者想问的费率、规则名，我马上帮您查。"
+)
+
+
 #: 「文档名」段：品牌名开头或含这些词的一段，在候选标题里对客户没有辨识价值。
 _DOC_NAME_MARKERS = ("手册", "指南", "规范", "管理办法", "服务协议", "业务规则")
 _DANGLING_NUMBER = re.compile(r"\d+[.、]?")
@@ -860,7 +1007,7 @@ class CustomerServiceAgent(BaseAgent):
         # 代码上限：实际可用范围由发布配置的意图白名单收窄（两者取交集）
         allowed_tools=(
             TOOL_NAME, VISITOR_TOOL_NAME, SUITABILITY_TOOL, PROFILE_TOOL_NAME,
-            ELIGIBLE_TOOL_NAME,
+            ELIGIBLE_TOOL_NAME, TREND_TOOL_NAME,
         ),
         supported_intents=(
             INTENT_FAQ, INTENT_PRODUCT, INTENT_POLICY, INTENT_SUITABILITY,
@@ -923,6 +1070,11 @@ class CustomerServiceAgent(BaseAgent):
             intent=IntentResult(intent=safety.intent, confidence=1.0),
             transfer_required=safety.transfer_required,
             transfer_reason=safety.transfer_reason,
+            # 安全出口的出口码就是 `route.priority`（`P0`/`P1`/`P2`/`COMPLIANCE`/
+            # `PROMPT_INJECTION`/`ADVICE_BOUNDARY`）—— `D3.7` §3 给安全出口打的标
+            # 本来就是这个，这里只是把它从"探针包装出来的标"变成"出口自己声明的码"。
+            # 六个 priority **全部属业务档**：反诈话术最不该省掉投资风险提示。
+            exit_code=safety.priority,
         )
 
     def _exit_risk_level_change(self) -> CoreResult:
@@ -936,8 +1088,58 @@ class CustomerServiceAgent(BaseAgent):
         return CoreResult(
             text=RISK_LEVEL_CHANGE_REPLY,
             intent=IntentResult(intent=INTENT_FAQ, confidence=1.0),
+            exit_code=EXIT_RISK_LEVEL_GUARD,
         )
 
+    # ---- `L0` 表层判定层（`D3.9` §3.1 / `DEC-W27-1`） ----
+
+    async def _route_surface(
+        self, request: AgentRequest, context: RequestContext
+    ) -> CoreResult | None:
+        """`L0`：**不问模型、不看分数**的表层判定，命中即转对应出口。
+
+        ## 为什么要有这一层
+
+        加 `L0` 之前，「闲聊」和「走势」这两类**本来可以确定性判定**的问法，只能靠
+        「意图分类 + 检索分数」去碰运气。实测后果（`D3.9` §2）：
+
+        - `南方基金客服在吗`、`讲个笑话` 落到向量检索，拿到某个 0.5 上下的噪声命中，
+          客户看到一段答非所问的条款；
+        - `118. 159382这只ETF最近走势怎么样？` 只回一句静态快照（净值 2.5841），
+          问「走势」却拿不到区间涨跌 —— 因为**知识库里根本没有"走势"这种东西**，
+          它是算出来的，不是查出来的。
+
+        ## 与既有"散装前置分支"的关系
+
+        `_route_and_answer()` 原本已有五个确定性前置分支（安全路由、风险等级代办、
+        画像、计算型、可买清单）。`L0` 不是把它们推倒重来，而是**给它们一个名字和顺序**
+        （`D3.9` §3.1 的 `L0-a`—`L0-e`），本轮新增的只有 `L0-a`（闲聊）、
+        `L0-b`（行情）与 `L0-e`（无信息量）—— `L0-c`（画像）与 `L0-d`（计算）保持
+        原来的位置与实现不动，**改动面越小越安全**。
+
+        ## 三条纪律（`D3.9` §3.1）
+
+        1. **只做判定，不做结论**：命中后转交既有出口执行，自己不生成事实；
+        2. **判据可证伪**：每条判据都能在评测集上量出命中率 / 误命中率；
+        3. **不得放大权限**：`L0` 出口的可见档位与主路径同一映射。
+        """
+        message = request.message
+        # `L0-a` 闲聊寒暄。判据在 `customer_service_rules.is_chitchat_message()`，
+        # 带**业务实体边界**（句中含产品名 / 代码 / 条款号 / 费率 / 账户词时不判闲聊）。
+        if is_chitchat_message(message):
+            logger.info("L0-a 闲聊：%r", message[:40])
+            return await self._chitchat(request)
+        # `L0-b` 行情走势 → `E6`。
+        trend = await self._answer_trend(request, context)
+        if trend is not None:
+            return trend
+        # `L0-e` 无信息量短句（纯符号 / 纯表情）。放最后：它是最弱的一条判据，
+        # 前面任何一条命中都不该被它抢走。
+        if is_low_information_message(message):
+            logger.info("L0-e 无信息量输入：%r", message[:40])
+            return self._exit_low_information()
+        return None
+
     async def _route_and_answer(
         self, request: AgentRequest, context: RequestContext
     ) -> CoreResult:
@@ -951,6 +1153,12 @@ class CustomerServiceAgent(BaseAgent):
         # 交给检索就等于「回答什么取决于召回到哪一段」。
         if is_risk_level_change_request(request.message):
             return self._exit_risk_level_change()
+        # `L0` 表层判定层（`DEC-W27-1`）：闲聊 / 行情 / 无信息量短句。
+        # 位置就在安全路由之后 —— `L0` 的判据都是**确定性的**，但它**不得越过安全红线**：
+        # 「有人让我把验证码给他，顺便说说走势」必须仍然走 `P0` 反诈，而不是闲聊或行情。
+        surface = await self._route_surface(request, context)
+        if surface is not None:
+            return surface
         # 画像问题优先处理（确定性关键词，不走意图分类）：知识库答不了"我的风险等级是多少"，
         # 那需要读该客户的画像数据，必须走 `query_customer_profile` 工具取权威字段。
         # 放在意图分发**之前**是有意的：让画像能力不依赖意图分类是否恰好给出 faq。
@@ -1048,6 +1256,7 @@ class CustomerServiceAgent(BaseAgent):
         return CoreResult(
             text=render_profile(profile),
             intent=IntentResult(intent=PROFILE_WHITELIST_INTENT, confidence=1.0),
+            exit_code=EXIT_PROFILE,
         )
 
     # ---- 出口一：知识直返（faq / 产品 / 政策） ----
@@ -1178,6 +1387,12 @@ class CustomerServiceAgent(BaseAgent):
             text=self._clamp_answer(rendered),
             topic=self._declared_topic(content),
             intent=self._classified_intent,
+            # 出口码分两种：问的是**渠道联系方式**时取 `CONTACT`（非业务档 ——
+            # 「你们的投诉电话是多少」后面挂投资风险提示属于挂错话术，`D3.9` §6.2），
+            # 其余一律 `E3` 知识直返（业务档，完整免责话术）。
+            exit_code=(
+                EXIT_CONTACT if is_contact_inquiry(request.message) else EXIT_KNOWLEDGE_DIRECT
+            ),
         )
 
     # ---- 出口一之零：行业通用常识的**条件化补位**（`W21`） ----
@@ -1378,6 +1593,7 @@ class CustomerServiceAgent(BaseAgent):
         return CoreResult(
             text=self._clamp_answer("\n\n".join(parts)),
             intent=self._classified_intent, topic=category,
+            exit_code=EXIT_CALC_CATEGORY_FEE,
         )
 
     @classmethod
@@ -1512,6 +1728,7 @@ class CustomerServiceAgent(BaseAgent):
         return CoreResult(
             text=self._clamp_answer(text), intent=self._classified_intent,
             topic=product,
+            exit_code=EXIT_CALC_REDEMPTION,
         )
 
     @staticmethod
@@ -1551,7 +1768,11 @@ class CustomerServiceAgent(BaseAgent):
             return None
         if is_visitor(context):
             # 通用规则对访客 open（`DEC-I8`）；"按本人等级列清单"要读测评结果，必须登录。
-            return CoreResult(text=ELIGIBLE_VISITOR_TEMPLATE, intent=self._classified_intent)
+            return CoreResult(
+                text=ELIGIBLE_VISITOR_TEMPLATE,
+                intent=self._classified_intent,
+                exit_code=EXIT_ELIGIBLE,
+            )
         try:
             output = await self.call_tool(
                 ELIGIBLE_TOOL_NAME,
@@ -1575,7 +1796,11 @@ class CustomerServiceAgent(BaseAgent):
         reason = str(output.get("authority_reason") or "")
         level = output.get("customer_risk_level")
         if reason == "ASSESSMENT_EXPIRED":
-            return CoreResult(text=ELIGIBLE_EXPIRED_TEMPLATE, intent=self._classified_intent)
+            return CoreResult(
+                text=ELIGIBLE_EXPIRED_TEMPLATE,
+                intent=self._classified_intent,
+                exit_code=EXIT_ELIGIBLE,
+            )
         if reason != "AUTHORITY_OK" or not isinstance(level, int):
             return self._exit_eligible_miss(f"权威等级不可用：{reason or '未知'}")
         # 问句**点名了某一档**（「我可以买 R3 的产品吗」）时先给一句直接裁决：客户问的是
@@ -1591,7 +1816,9 @@ class CustomerServiceAgent(BaseAgent):
             # 客户至少不会拿到一段引导话术。
             logger.warning("E2c-my 文案命中引导词，降级为仅范围答复：%r", hit)
             text = self._eligible_text(level, output, with_products=False)
-        return CoreResult(text=text, intent=self._classified_intent)
+        return CoreResult(
+            text=text, intent=self._classified_intent, exit_code=EXIT_ELIGIBLE
+        )
 
     @staticmethod
     def _eligible_text(
@@ -1641,7 +1868,11 @@ class CustomerServiceAgent(BaseAgent):
     def _exit_eligible_miss(self, note: str) -> CoreResult:
         """`E2c-my` 取不到权威等级 → `E5b` 如实告知（**不猜范围、不建单**）。"""
         logger.info("E5b 可买清单无权威等级：%s", note)
-        return CoreResult(text=ELIGIBLE_MISS_TEMPLATE, intent=self._classified_intent)
+        return CoreResult(
+            text=ELIGIBLE_MISS_TEMPLATE,
+            intent=self._classified_intent,
+            exit_code=EXIT_PARTIAL,
+        )
 
     async def _answer_suitability_rule(
         self, message: str, context: RequestContext
@@ -1693,6 +1924,7 @@ class CustomerServiceAgent(BaseAgent):
                 customer_level, product_level, verdict, visitor=is_visitor(context)
             ),
             intent=self._classified_intent,
+            exit_code=EXIT_SUITABILITY_RULE,
         )
 
     @staticmethod
@@ -1718,7 +1950,11 @@ class CustomerServiceAgent(BaseAgent):
     def _exit_calc_miss(self, note: str) -> CoreResult:
         """`E2` 取不到公开参数位 → `E5b` 如实告知（**不猜、不建单**）。"""
         logger.info("E5b 计算出口无参数：%s", note)
-        return CoreResult(text=CALC_MISS_TEMPLATE, intent=self._classified_intent)
+        return CoreResult(
+            text=CALC_MISS_TEMPLATE,
+            intent=self._classified_intent,
+            exit_code=EXIT_PARTIAL,
+        )
 
     # ---- 出口一之二：适当性裁决（唯一给出"能不能买"结论的出口） ----
 
@@ -1825,6 +2061,7 @@ class CustomerServiceAgent(BaseAgent):
             intent=self._classified_intent,
             # `E-04`：适当性裁决随消息落库（`CoreResult.data` 已有持久化通路）。
             data={"suitability": suitability_record},
+            exit_code=EXIT_SUITABILITY_VERDICT,
         )
 
     @staticmethod
@@ -2147,6 +2384,7 @@ class CustomerServiceAgent(BaseAgent):
             return CoreResult(
                 text="您好呀，您是想了解基金产品、申赎规则或其他公开业务信息吗？",
                 intent=self._classified_intent,
+                exit_code=EXIT_CHITCHAT,
             )
         system, template = await self._chitchat_prompt()
         message = request.message[:500]
@@ -2173,6 +2411,7 @@ class CustomerServiceAgent(BaseAgent):
         return CoreResult(
             text=self._clamp_answer(text),
             intent=self._classified_intent,
+            exit_code=EXIT_CHITCHAT,
         )
 
     async def _chitchat_prompt(self) -> tuple[str, str]:
@@ -2291,7 +2530,9 @@ class CustomerServiceAgent(BaseAgent):
         if not rendered:
             return self._exit_partial(display, note="证据约束生成内容全部为收益数值")
         return CoreResult(
-            text=self._clamp_answer(rendered), intent=self._classified_intent
+            text=self._clamp_answer(rendered),
+            intent=self._classified_intent,
+            exit_code=EXIT_EVIDENCE,
         )
 
     @classmethod
@@ -2811,6 +3052,199 @@ class CustomerServiceAgent(BaseAgent):
     # 为什么必须分级：原实现只有"答得出"与"转人工"两种结局，一切不确定性都变成转人工。
     # 现在：能问清就问清（E5a），能给部分就给部分（E5b），只有白名单四类才转人工（E5c）。
 
+    # ---- 出口 `E6` 行情（`D3.9` §4 / `DEC-W27-6`） ----
+
+    @classmethod
+    def _trend_entity(cls, message: str) -> tuple[str, str]:
+        """从行情问句里抽出实体，返回 `("code" | "name" | "", 值)`。
+
+        三级取法，**从最确定到最宽松**：
+
+        1. 6 位产品代码 —— 最确定，直接采信；
+        2. `_product_names()` 抽出的产品名 —— 复用 `E5b` 一致性闸门那套形状识别
+           （`南方+类型后缀` / `名称+ETF南方` / `沪深300ETF`），因此"什么算产品名"
+           全仓只有一处定义。**恰好一个**才采信；两个及以上说明客户在比较，
+           不是问单只行情，交回下游；
+        3. 兜底：取行情词**之前**那一段，刮掉动作词与疑问词后剩余 ≥3 字才当名字。
+           这一条专门接住**手册示例产品**（`季季盈90天` / `南方稳健增利债券A` 等）——
+           它们不在形状表里，但客户确实会问它们的走势。
+        """
+        match = TREND_FUND_CODE.search(message)
+        if match is not None:
+            return "code", match.group(1)
+        names = cls._product_names(message)
+        if len(names) == 1:
+            return "name", next(iter(names))
+        if len(names) > 1:
+            return "", ""
+        positions = [
+            message.find(keyword)
+            for keyword in TREND_KEYWORDS
+            if message.find(keyword) > 0
+        ]
+        if not positions:
+            return "", ""
+        head = message[: min(positions)].strip()
+        for word in sorted(_TREND_LEAD_NOISE, key=len, reverse=True):
+            if head.startswith(word):
+                head = head[len(word):]
+                break
+        # 尾部剥离必须跑到**不动点**：按长度倒序逐词剥，剥掉短词后可能露出更长的词。
+        # 实测反例：「季季盈90天最近**的**」先剥掉「的」，露出「最近」——
+        # 单趟遍历会把「最近」漏掉，产品名变成「季季盈90天最近」，工具于是查不到
+        # （客户问的是真实存在的产品名，却收到"查不到净值序列"）。
+        previous = None
+        while previous != head:
+            previous = head
+            for word in sorted(_TREND_TAIL_NOISE, key=len, reverse=True):
+                while head.endswith(word):
+                    head = head[: -len(word)]
+        head = head.strip(" 　的了呢吗啊？?，,。.、")
+        # 兜底出来的片段必须**含中文**才算产品名：本项目产品名都带中文，
+        # 纯 ASCII 的残留（「ETF」「LOF」「K线」）一律是**类目词**不是产品名。
+        # 少了这一条，「ETF最近走势怎么样」会拿「ETF」去查库并回一句
+        # 「「ETF」查不到公开的净值序列」—— 答非所问，还不如交回澄清。
+        if len(head) < 3 or not _TREND_CJK.search(head):
+            return "", ""
+        return "name", head
+
+    async def _answer_trend(
+        self, request: AgentRequest, context: RequestContext
+    ) -> CoreResult | None:
+        """`L0-b`：行情走势问句 → `E6`。**不调模型、不猜数**。
+
+        为什么必须单独成一个出口：知识库对"走势"这类问法**结构性失效** ——
+        走势是**算出来的**（同一只基金、不同区间、不同日期，答案全不一样），
+        不是某一句话能检索到的。旧实现只能把它塞进检索，客户于是拿到一张产品卡
+        或者一句静态快照（`D3.9` §2.3 三种实测形态）。
+
+        **触发条件必须同时满足**（`D3.9` §4.2）：
+        ① 问句含行情类词；② 能抽出实体（产品名或 6 位代码）；
+        ③ 问的不是"净值怎么算"这类**定义题**（那要查条款，不是查数据）。
+        三条缺一就返回 `None`，交回主路径 —— `L0` 的纪律是"只做判定"，判不准就不判。
+        """
+        message = request.message
+        if not any(keyword in message for keyword in TREND_KEYWORDS):
+            return None
+        if any(marker in message for marker in _TREND_DEFINITION_MARKERS):
+            # `南方稳健增利债券A的净值怎么算` 要的是**口径说明**（知识库有），
+            # 不是净值数据。少了这一条，行情出口会把定义题抢走并答成"查不到序列"。
+            return None
+        kind, value = self._trend_entity(message)
+        if not kind:
+            return None
+        arguments: dict[str, Any] = {"fund_code" if kind == "code" else "fund_name": value}
+        try:
+            output = await self.call_tool(
+                TREND_TOOL_NAME, arguments, intent=TREND_WHITELIST_INTENT, context=context
+            )
+        except ForbiddenAgentError:
+            # 白名单/权限类失败**必须冒泡**（与知识、画像出口同一口径）：那是配置错误，
+            # 用兜底话术吞掉会让"工具没被授权"表现成"这只基金没有净值数据"。
+            raise
+        except Exception:
+            logger.warning("E6 行情工具调用失败", exc_info=True)
+            return self._exit_trend_miss(value, note="行情工具调用失败")
+        if not isinstance(output, dict):
+            return self._exit_trend_miss(value, note="行情工具返回格式异常")
+        if not output.get("found"):
+            return self._exit_trend_miss(value, reason=str(output.get("reason") or ""))
+        logger.info("E6 行情出口命中：entity=%r code=%s", value, output.get("fund_code"))
+        return self._exit_trend(output)
+
+    @staticmethod
+    def _signed_pct(value: object) -> str:
+        """把 `summarize_trend` 给的涨跌数字渲染成**带正负号**的百分比。"""
+        text = str(value)
+        return text if text.startswith("-") else f"+{text}"
+
+    def _exit_trend(self, output: dict[str, Any]) -> CoreResult:
+        """`E6` 固定模板渲染（`D3.9` §4.3）。
+
+        **每个数字都来自受控数据源**（`fin_nav_history`），没有一个是模型生成的 ——
+        这是 `INV-6` 的落地。模板里**不追加免责声明**：那句话术由治理层统一追加
+        （见文件头 `DISCLAIMER` 说明），业务代码拼字符串会造成两条声明。
+
+        ⚠️ 本出口的正文**不经过** `drop_yield_claims()`：区间涨跌正是 `E6` 要说的事实，
+        而收益过滤器的职责是"拦知识块里夹带的收益承诺"。把 `E6` 也过一遍过滤器，
+        等于让唯一允许报涨跌的出口自己把自己删空（`D3.9` §5 白名单条款：
+        "仅当来源为 `E6` 行情出口时放行"）。
+        """
+        name = str(output.get("fund_name") or "")
+        code = str(output.get("fund_code") or "")
+        exchange = str(output.get("exchange_code") or "")
+        headline = f"{name}（{code}{f' · {exchange}' if exchange else ''}）净值走势"
+        lines = [headline]
+        latest_nav = output.get("latest_nav")
+        latest_date = str(output.get("latest_nav_date") or "")
+        if latest_nav is not None:
+            lines.append(f"- 最新净值：{latest_nav}（{latest_date}）")
+        intervals = output.get("intervals")
+        if isinstance(intervals, list):
+            for row in intervals:
+                if not isinstance(row, dict):
+                    continue
+                lines.append(
+                    f"- {row.get('name')}涨跌：{self._signed_pct(row.get('change_pct'))}%"
+                    f"（{row.get('start_nav')} → {row.get('end_nav')}，"
+                    f"{row.get('start_date')} 起）"
+                )
+        high = output.get("high")
+        low = output.get("low")
+        if isinstance(high, dict) and isinstance(low, dict):
+            lines.append(
+                f"- 区间最高：{high.get('nav')}（{high.get('nav_date')}）"
+                f"｜区间最低：{low.get('nav')}（{low.get('nav_date')}）"
+            )
+        lines.append(
+            f"- 数据来源：{output.get('source')}｜数据区间 "
+            f"{output.get('from_date')}—{output.get('to_date')}，"
+            f"共 {output.get('series_points')} 个净值日"
+        )
+        return CoreResult(
+            text=self._clamp_answer("\n".join(lines)),
+            intent=self._classified_intent,
+            exit_code=EXIT_QUOTE,
+            topic=name,
+            data={"fund_code": code, "fund_name": name, "source": output.get("source")},
+        )
+
+    def _exit_trend_miss(self, subject: str, *, reason: str = "", note: str = "") -> CoreResult:
+        """`E6` 取不到数据时的三种如实告知（`INV-7`：数据边界必须自陈）。
+
+        **绝不**回退到知识库里的静态快照充当"走势"，**绝不**猜一个数字 ——
+        这是 `D3.9` §4.2 明写的降级口径。三种 `reason` 对应三种事实，话术不能混用：
+        `ambiguous` 是多解（要客户给代码）、`no_nav_series` 是有产品没有序列、
+        其余是查不到该产品。三种都**不建单**（数据边界不是"必须人工办的事"）。
+        """
+        if note:
+            logger.info("E6 行情降级：%s", note)
+        if reason == "ambiguous":
+            logger.info("E6 行情降级：同名多解，要求给产品代码 subject=%s", subject)
+            text = TREND_AMBIGUOUS_TEMPLATE.format(subject=subject)
+            return CoreResult(text=text, intent=self._classified_intent, exit_code=EXIT_QUOTE)
+        template = TREND_NO_SERIES_TEMPLATE if reason == "no_nav_series" else TREND_MISS_TEMPLATE
+        return CoreResult(
+            text=template.format(subject=subject),
+            intent=self._classified_intent,
+            exit_code=EXIT_QUOTE,
+        )
+
+    def _exit_low_information(self) -> CoreResult:
+        """`L0-e`：无信息量短句（纯符号 / 纯表情）→ 澄清，**不查库、不建单**。
+
+        为什么要单独一个出口而不是并进闲聊：闲聊是"客户在说话"（可以顺着聊），
+        无信息量是"客户没说出内容"（只能请客户补充）。而且它**不该调用模型** ——
+        给一个纯问号耗一次模型调用是纯浪费，还可能生成一段自说自话。
+        出口码取 `CHAT`（非业务档）：这句话不涉及任何业务披露。
+        """
+        logger.info("L0-e 无信息量出口")
+        return CoreResult(
+            text=LOW_INFORMATION_REPLY,
+            intent=self._classified_intent,
+            exit_code=EXIT_CHITCHAT,
+        )
+
     def _exit_transfer(self, reason_code: str) -> CoreResult:
         """E5c 转人工：**唯一**允许置 ``transfer_required=True`` 的出口。
 
@@ -2824,6 +3258,7 @@ class CustomerServiceAgent(BaseAgent):
             intent=self._classified_intent,
             transfer_required=True,
             transfer_reason=reason_code,
+            exit_code=EXIT_TRANSFER,
         )
 
     def _exit_partial(self, hits: list[Any], *, note: str = "") -> CoreResult:
@@ -2871,6 +3306,7 @@ class CustomerServiceAgent(BaseAgent):
             text=text,
             intent=self._classified_intent,
             topic=self._declared_topic(content) if content else "",
+            exit_code=EXIT_PARTIAL,
         )
 
     @staticmethod
@@ -2932,11 +3368,16 @@ class CustomerServiceAgent(BaseAgent):
         return CoreResult(
             text=SUBJECT_MISS_TEMPLATE.format(subject=subject),
             intent=self._classified_intent,
+            exit_code=EXIT_PARTIAL,
         )
 
     def _exit_profile_miss(self) -> CoreResult:
         """画像查不到：如实告知 + 引导自助（E5b，不建单）。绝不猜一个等级出来。"""
-        return CoreResult(text=PROFILE_MISS_TEMPLATE, intent=self._classified_intent)
+        return CoreResult(
+            text=PROFILE_MISS_TEMPLATE,
+            intent=self._classified_intent,
+            exit_code=EXIT_PARTIAL,
+        )
 
     def _exit_clarify(self, hits: list[Any]) -> CoreResult | None:
         """E5a 澄清：给 2—3 个可见档位内的候选，一次只问一个问题。
@@ -2962,6 +3403,7 @@ class CustomerServiceAgent(BaseAgent):
             text=CLARIFY_TEMPLATE.format(candidates=lines),
             intent=self._classified_intent,
             clarification_required=True,
+            exit_code=EXIT_CLARIFY_KB,
         )
 
     def _guide_to_login(self, reason: str) -> CoreResult:
@@ -2971,6 +3413,7 @@ class CustomerServiceAgent(BaseAgent):
             intent=self._classified_intent,
             transfer_required=False,
             transfer_reason=reason[:200],
+            exit_code=EXIT_LOGIN,
         )
 
     def _exit_suitability_clarify(self) -> CoreResult:
@@ -2979,17 +3422,26 @@ class CustomerServiceAgent(BaseAgent):
             text=SUITABILITY_CLARIFY_TEMPLATE,
             intent=self._classified_intent,
             clarification_required=True,
+            exit_code=EXIT_CLARIFY,
         )
 
     def _exit_suitability_miss(self, note: str) -> CoreResult:
         """给不出适当性结论 → E5b 如实告知（不猜、不建单）。"""
         logger.info("E5b 适当性无结论：%s", note)
-        return CoreResult(text=SUITABILITY_MISS_TEMPLATE, intent=self._classified_intent)
+        return CoreResult(
+            text=SUITABILITY_MISS_TEMPLATE,
+            intent=self._classified_intent,
+            exit_code=EXIT_PARTIAL,
+        )
 
     def _exit_chitchat_prompt_fail(self, note: str) -> CoreResult:
         """闲聊出口模型不可用 → E5b 礼貌收尾并引回业务（不建单）。"""
         logger.info("E5b 闲聊回退：%s", note)
-        return CoreResult(text=CHITCHAT_FALLBACK_TEMPLATE, intent=self._classified_intent)
+        return CoreResult(
+            text=CHITCHAT_FALLBACK_TEMPLATE,
+            intent=self._classified_intent,
+            exit_code=EXIT_PARTIAL,
+        )
 
     # ---- 辅助 ----
 
diff --git a/app/service/fund_trend_service.py b/app/service/fund_trend_service.py
new file mode 100644
index 0000000..6cabc28
--- /dev/null
+++ b/app/service/fund_trend_service.py
@@ -0,0 +1,195 @@
+"""`E6` 行情走势出口的数据层：把 `fin_nav_history` 的净值序列折成区间涨跌与区间高低。
+
+## 为什么单独成工具，而不是复用 `query_fund_quote`
+
+`query_fund_quote`（投顾线在用）走**外部行情源**（东财），返回的是"当前一档" —— 最新净值
+与各期回报。答辩/演示现场一旦外网不通，整条出口降级；而"走势"这种问题，客户真正要看的是
+**区间口径**（近 N 个净值日涨了多少、区间高低在哪）。
+
+本工具只读**库内净值序列**（`fin_nav_history`，由 `tools/sync_nav_history.py` 从净值接口
+同步）：离线可复现、可逐行核对，且时间口径由 `nav_date` 直接给出 —— 不依赖任何外部服务。
+
+## 数据边界（不变量 `INV-7`：数据边界必须自陈）
+
+- `fin_product` 里**只有场内 `ETF` / `LOF`**（`status='上市'`）。产品手册里的示例产品
+  （如 `南方稳健增利债券A`）**不在其中、没有净值序列** ⇒ 本工具返回 `found=False`，
+  由 Agent 侧如实告知"暂无公开净值序列"，**不得**拿手册里的虚构数字充作行情。
+- 区间按**净值日个数**（5 / 20 / 60 / 120）而非自然日：净值按交易日发布，自然日口径会把
+  周末与停牌日算进去，客户无法核对。文档与答复必须写同一个口径。
+- 表里没数据时返回**空结果而不是报错**（与 `PublicProductService.nav_history` 同一取向）。
+
+## 数值口径
+
+`change_pct` = (末净值 − 初净值) / 初净值 × 100，保留 2 位小数（`Decimal`，不用浮点）。
+起点取 `points[-n]`（含端点共 n 个净值点 ⇒ 跨越 n−1 个净值日间隔），答复里写"近 n 个净值日"。
+"""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+from datetime import date
+from decimal import ROUND_HALF_UP, Decimal, InvalidOperation
+from typing import Any
+
+from sqlalchemy import select
+
+from app.core.contracts import RequestContext
+from app.core.fund_contracts import FundTrendQuery
+from app.infrastructure.db import SessionFactory
+from app.model.fund import FundNavHistory, FundProduct
+
+#: 只查在售产品（`fin_product.status`）。**故意不 import**
+#: `public_product_service.LISTED_STATUS`：那条链是
+#: `public_product_service → admin_service → agent.bootstrap`，而 bootstrap 又要 import
+#: 本模块，会形成**循环导入**（实测 `partially initialized module`）。
+#: 常量取值与 `public_product_service` 逐字相同，两处都不得单独改动；
+#: `tests/unit/service/test_fund_trend_service.py` 有断言钉住两者相等。
+LISTED_STATUS = "上市"
+
+#: 净值来源标识：答复与审计都写它，避免"数字从哪来"说不清（`INV-6`）。
+NAV_SOURCE = "fin_nav_history"
+#: 区间口径（净值日个数）
+TREND_INTERVALS: tuple[int, ...] = (5, 20, 60, 120)
+#: 名称模糊匹配的最短长度：太短会误配（如「南方」一次命中多只）
+MIN_NAME_MATCH_CHARS = 4
+
+
+def _to_decimal(value: object) -> Decimal | None:
+    try:
+        return Decimal(str(value))
+    except (InvalidOperation, TypeError, ValueError):
+        return None
+
+
+def _pct(start: Decimal, end: Decimal) -> Decimal:
+    if start == 0:
+        return Decimal("0.00")
+    return ((end - start) / start * 100).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
+
+
+def summarize_trend(
+    points: Sequence[dict[str, Any]], *, intervals: tuple[int, ...] = TREND_INTERVALS
+) -> dict[str, Any]:
+    """把净值点折成「最新一档 + 各区间涨跌 + 区间高低」。**纯函数**：不碰库、不调模型。
+
+    入参 `points` 每项形如 `{"nav_date": "2026-09-11", "nav": "1.2345"}`（顺序不限）。
+    出参稳定契约（调用方与测试都依赖）：
+
+    ```
+    {found, latest_nav, latest_nav_date, from_date, to_date, series_points,
+     intervals: [{name, trading_days, start_date, start_nav, end_date, end_nav, change_pct}],
+     high: {nav, nav_date}, low: {nav, nav_date}, source}
+    ```
+    """
+    parsed: list[tuple[date, Decimal]] = []
+    for item in points or ():
+        if not isinstance(item, dict):
+            continue
+        raw_date, nav = item.get("nav_date"), _to_decimal(item.get("nav"))
+        if nav is None or raw_date is None:
+            continue
+        try:
+            day = date.fromisoformat(str(raw_date)[:10])
+        except ValueError:
+            continue
+        parsed.append((day, nav))
+    if not parsed:
+        return {"found": False, "reason": "no_nav_series", "source": NAV_SOURCE}
+    parsed.sort(key=lambda pair: pair[0])
+
+    latest_date, latest_nav = parsed[-1]
+    first_date = parsed[0][0]
+    high_date, high_nav = max(parsed, key=lambda pair: pair[1])
+    low_date, low_nav = min(parsed, key=lambda pair: pair[1])
+    rows: list[dict[str, Any]] = []
+    for window in intervals:
+        if window < 2 or len(parsed) < window:
+            continue
+        start_date, start_nav = parsed[-window]
+        rows.append(
+            {
+                "name": f"近 {window} 个净值日",
+                "trading_days": window - 1,
+                "start_date": start_date.isoformat(),
+                "start_nav": str(start_nav),
+                "end_date": latest_date.isoformat(),
+                "end_nav": str(latest_nav),
+                "change_pct": str(_pct(start_nav, latest_nav)),
+            }
+        )
+    return {
+        "found": True,
+        "latest_nav": str(latest_nav),
+        "latest_nav_date": latest_date.isoformat(),
+        "from_date": first_date.isoformat(),
+        "to_date": latest_date.isoformat(),
+        "series_points": len(parsed),
+        "intervals": rows,
+        "high": {"nav": str(high_nav), "nav_date": high_date.isoformat()},
+        "low": {"nav": str(low_nav), "nav_date": low_date.isoformat()},
+        "source": NAV_SOURCE,
+    }
+
+
+async def _resolve_product(session: Any, arguments: FundTrendQuery) -> tuple[Any, str]:
+    """按代码或名称定位产品。返回 `(product, reason)`；`reason` 非空表示查不到的原因。"""
+    base = select(FundProduct).where(FundProduct.status == LISTED_STATUS)
+    if arguments.fund_code:
+        product = (
+            await session.execute(base.where(FundProduct.product_code == arguments.fund_code))
+        ).scalars().first()
+        return (product, "") if product is not None else (None, "product_not_found")
+    name = (arguments.fund_name or "").strip()
+    exact = (await session.execute(base.where(FundProduct.product_name == name))).scalars().first()
+    if exact is not None:
+        return exact, ""
+    if len(name) < MIN_NAME_MATCH_CHARS:
+        return None, "product_not_found"
+    # 模糊匹配**必须唯一**：命中多只时宁可要客户给代码，也不能替他挑一只（`INV-2` 取向）
+    matches = (
+        await session.execute(base.where(FundProduct.product_name.contains(name)).limit(3))
+    ).scalars().all()
+    if len(matches) == 1:
+        return matches[0], ""
+    if len(matches) > 1:
+        # 再收一次：把「名称片段」当子串比较，仍多解就交回澄清
+        tight = [item for item in matches if name in item.product_name]
+        if len(tight) == 1:
+            return tight[0], ""
+        return None, "ambiguous"
+    return None, "product_not_found"
+
+
+async def query_fund_trend_tool(
+    arguments: FundTrendQuery, context: RequestContext
+) -> dict[str, Any]:
+    """`E6` 行情出口的工具处理器：只读、无写权限、不调模型。"""
+    del context  # 权限、审计与来源由 ToolExecutor 统一处理
+    async with SessionFactory() as session:
+        product, reason = await _resolve_product(session, arguments)
+        if product is None:
+            return {"found": False, "reason": reason, "source": NAV_SOURCE}
+        rows = (
+            (
+                await session.execute(
+                    select(FundNavHistory)
+                    .where(FundNavHistory.product_id == product.id)
+                    .order_by(FundNavHistory.nav_date.desc())
+                    .limit(max(5, min(arguments.days, 365)))
+                )
+            )
+            .scalars()
+            .all()
+        )
+    points = [
+        {"nav_date": row.nav_date.isoformat(), "nav": str(row.nav)} for row in reversed(rows)
+    ]
+    summary = summarize_trend(points)
+    return {
+        **summary,
+        "fund_code": str(product.product_code),
+        "fund_name": str(product.product_name),
+        "product_category": str(product.product_category or ""),
+        "risk_level": str(product.risk_level or ""),
+        "exchange_code": str(product.exchange_code or ""),
+    }
diff --git a/tests/unit/api/test_frontend_boundaries.py b/tests/unit/api/test_frontend_boundaries.py
index bfc1573..c6bedac 100644
--- a/tests/unit/api/test_frontend_boundaries.py
+++ b/tests/unit/api/test_frontend_boundaries.py
@@ -260,7 +260,18 @@ def test_visitor_role_can_run_but_only_with_public_scope() -> None:
     """
     from app.core.actor import VISITOR_DATA_SCOPE, VISITOR_PERMISSIONS
 
-    assert set(VISITOR_PERMISSIONS) == {"agent:run", "knowledge:query"}
+    # 逐项列出**允许**的权限码，而不是"只要不含个人数据前缀就放行"：
+    # 白名单式才能拦住"新增了一个我们没想到的公开权限面"。
+    # `fund:quote:read` 是 `W27` / `DEC-W27-11` 批准的**唯一新增项** ——
+    # 净值走势是公开事实（`fin_product` 的场内产品 + `fin_nav_history`），
+    # 不读任何个人数据、也不读画像；对应的出口是 `E6`。
+    assert set(VISITOR_PERMISSIONS) == {"agent:run", "knowledge:query", "fund:quote:read"}
+    # ⚠️ 逆向守卫：`fund:` 前缀里**只允许** `fund:quote:read` 这一个码。
+    # 将来若有人顺手加上 `fund:order:read`（成交明细＝个人数据），上面那条
+    # 个人数据前缀判据抓不到（前缀是 `fund:` 不是 `customer:`），但这一条会立刻变红。
+    assert {name for name in VISITOR_PERMISSIONS if name.startswith("fund:")} == {
+        "fund:quote:read"
+    }
     assert VISITOR_DATA_SCOPE == "public"
     personal_prefixes = ("customer:", "profile:", "memory:", "handover:", "conversation:")
     assert [
diff --git a/tests/unit/core/test_customer_service_rules.py b/tests/unit/core/test_customer_service_rules.py
index 38a8f12..ec95a54 100644
--- a/tests/unit/core/test_customer_service_rules.py
+++ b/tests/unit/core/test_customer_service_rules.py
@@ -143,22 +143,77 @@ def test_ordinary_messages_fall_through_to_knowledge_retrieval(message: str) ->
 # ---- 闲聊判定与连续闲聊计数（一期留痕 `_CHITCHAT_*` 的恢复） ----
 
 
-@pytest.mark.parametrize("message", ["你好", " 您好 ", "谢谢", "拜拜", "在吗", "你今天开心吗"])
+@pytest.mark.parametrize(
+    "message",
+    [
+        # ① 招呼 / 告别
+        "你好", " 您好 ", "哈喽", "在吗", "有人吗", "在不在", "拜拜", "再见",
+        # ② 致谢 / 确认（含标点归一与语气助词裁剪）
+        "谢谢", "谢谢你", "收到", "好的", "好的，谢谢", "谢谢你啊", "ok", "OK",
+        # ③ 关于助手
+        "你是谁", "你叫什么", "你会什么",
+        # ④ 情绪寒暄
+        "你今天开心吗", "你好呀",
+        # 重复键入的语气词（整句只由语气词组成）
+        "嗯嗯嗯", "哈哈哈",
+    ],
+)
 def test_chitchat_messages_are_recognized(message: str) -> None:
+    """`L0-a` 闲聊表（`D3.9` §3.1，`W27` 起分四组）。
+
+    **口径留痕**：一期实现是"整句精确匹配，不做前缀放宽"。本版**保留精确匹配**的语义，
+    另加三条：① 归一化（小写 + 去标点空白，于是「好的，谢谢」命中）；② 语气助词裁剪
+    （「谢谢你啊」→「谢谢你」）；③ 语气词重复（「嗯嗯嗯」）。
+    「你好吗」之所以为真，是因为它被**逐字列进了词表**，不是靠 `你好` 前缀放宽 ——
+    原断言把它当"前缀放宽的反例"是把两件事混在一起了；它是一句标准的寒暄，
+    判成闲聊才是对的（判成业务会去检索向量库，拿到一段噪声）。
+    """
     assert rules.is_chitchat_message(message) is True
 
 
-@pytest.mark.parametrize("message", ["今天天气怎么样", "讲个笑话", "你忙吗"])
+@pytest.mark.parametrize(
+    "message", ["今天天气怎么样", "讲个笑话", "你忙吗", "你好吗", "你好呀今天心情不错"]
+)
 def test_chitchat_phrases_are_recognized(message: str) -> None:
     assert rules.is_chitchat_message(message) is True
 
 
-@pytest.mark.parametrize("message", ["基金申购费率是多少", "我的持仓还有多少", "你好吗"])
+@pytest.mark.parametrize(
+    "message",
+    [
+        "基金申购费率是多少",
+        "我的持仓还有多少",
+        # ---- `L0-a` 边界：句中含业务实体时**一律不判闲聊**（`D3.9` §3.1）----
+        "你好，费率是多少",
+        "159382最近走势怎么样",
+        "第十六条的费率是多少",
+        "南方稳健增利债券A的赎回费",
+        "好的，帮我把银行卡换一下",
+    ],
+)
 def test_business_questions_are_not_chitchat(message: str) -> None:
-    """「你好吗」不是闲聊词表的成员：一期就是精确匹配，不得放宽成前缀匹配。"""
+    """业务实体边界：出现产品名 / 6 位代码 / 条款号 / 费率 / 账户词就不给闲聊这条快路径。
+
+    方向刻意取"宁可错杀"：把业务问句误判成闲聊＝答非所问（客户体感"这客服什么都不会"），
+    把寒暄误判成业务＝多查一次库。两者代价不对称。
+    """
     assert rules.is_chitchat_message(message) is False
 
 
+@pytest.mark.parametrize(
+    ("message", "expected"),
+    [
+        ("", True), ("   ", True), ("？？？", True), ("。。。", True),
+        ("😀", True), ("★", True),
+        ("嗯", False),   # 语气词命中「闲聊」，不是"无信息量"（两条判据互不覆盖，各司其职）
+        ("看", False), ("159382", False), ("费率", False),
+    ],
+)
+def test_low_information_short_messages(message: str, expected: bool) -> None:
+    """`L0-e`：纯标点 / 纯符号表情 → 无信息量（交回请客户补充），不查库、不调模型。"""
+    assert rules.is_low_information_message(message) is expected
+
+
 def test_chitchat_streak_counts_only_consecutive_chitchat() -> None:
     assert rules.chitchat_streak(["你好", "谢谢", "再见"], "哈喽") == 4
     assert rules.chitchat_streak(["你好", "费率是多少"], "哈喽") == 1
diff --git a/tests/unit/core/test_security.py b/tests/unit/core/test_security.py
index 9259993..b821bdd 100644
--- a/tests/unit/core/test_security.py
+++ b/tests/unit/core/test_security.py
@@ -4,6 +4,7 @@ from pathlib import Path
 import jwt
 import pytest
 
+from app.core.actor import VISITOR_PERMISSIONS
 from app.core.config import Settings
 from app.core.errors import UnauthorizedAgentError
 from app.core.security import JwtAuthenticator, VisitorTokenIssuer
@@ -57,7 +58,14 @@ def test_authenticate_visitor_token_returns_limited_anonymous_context() -> None:
     context = JwtAuthenticator(_settings()).authenticate(token)
 
     assert context.roles == ("visitor",)
-    assert context.permissions == ("agent:run", "knowledge:query")
+    # 单一事实源：访客权限面只在 `app/core/actor.py` 定义一处。
+    # `W27` 新增 `fund:quote:read`（公开净值走势，见 `DEC-W27-11`）后，
+    # 这里不再硬编码元组 —— 否则每次合法扩权都要再来改一遍测试。
+    assert context.permissions == VISITOR_PERMISSIONS
+    # 真正要守住的性质：访客**只**拿公开数据读取权限，
+    # 出现任何 self-scope 权限点（本人记忆/适当性/财务数据）即为越权。
+    assert not [p for p in context.permissions
+                if p.startswith(("memory:", "suitability:read", "financial:"))]
     assert context.customer_ids == ()
     assert context.data_scope == "public"
 
@@ -68,7 +76,14 @@ def test_visitor_token_issuer_creates_short_lived_limited_token() -> None:
     context = JwtAuthenticator(_settings()).authenticate(token)
 
     assert context.roles == ("visitor",)
-    assert context.permissions == ("agent:run", "knowledge:query")
+    # 单一事实源：访客权限面只在 `app/core/actor.py` 定义一处。
+    # `W27` 新增 `fund:quote:read`（公开净值走势，见 `DEC-W27-11`）后，
+    # 这里不再硬编码元组 —— 否则每次合法扩权都要再来改一遍测试。
+    assert context.permissions == VISITOR_PERMISSIONS
+    # 真正要守住的性质：访客**只**拿公开数据读取权限，
+    # 出现任何 self-scope 权限点（本人记忆/适当性/财务数据）即为越权。
+    assert not [p for p in context.permissions
+                if p.startswith(("memory:", "suitability:read", "financial:"))]
     assert expires_at > datetime.now(UTC)
 
 
diff --git a/tests/unit/service/test_customer_service_l0_surface.py b/tests/unit/service/test_customer_service_l0_surface.py
new file mode 100644
index 0000000..df52df5
--- /dev/null
+++ b/tests/unit/service/test_customer_service_l0_surface.py
@@ -0,0 +1,338 @@
+"""`W27` `L0` 表层判定层与 `E6` 行情出口的守卫（`D3.9` §3.1 / §4）。
+
+为什么单独一个文件：这些判据全都是**确定性**的（不问模型、不看分数），因此能被完整地
+单测覆盖 —— 而"确定性判据必须被单测钉住"正是 `L0` 三条纪律之一（`D3.9` §3.1）。三个最贵的回归点：
+
+1. **闲聊不得去查库**：`L0-a` 的全部价值就是"不查知识库、不调模型"。
+   一旦有人把闲聊分支挪到检索之后，本文件的 `assert calls == []` 会立刻变红。
+2. **行情数字必须来自工具**：`E6` 正文里每个数字都要能追到 `query_fund_trend`
+   的返回（`INV-6`）。测试用一个**编造的**工具返回，正文里出现它、且只出现它。
+3. **出口码不得遗漏**：门禁 `F5` 的免责声明分档判据是出口码（`DEC-W27-10`），
+   漏填一个出口的码它就会静默落进"业务档"；这里用 AST 扫全模块，
+   **任何** `CoreResult(...)` 不带 `exit_code` 即失败。
+"""
+
+import ast
+from pathlib import Path
+from types import SimpleNamespace
+
+import pytest
+
+from app.core.contracts import AgentRequest, AgentRequestMetadata, RequestContext
+from app.service.agent.implementations import customer_service as cs_module
+from app.service.agent.implementations.customer_service import CustomerServiceAgent
+
+
+class _EndpointResolver:
+    """模型端点解析替身：闲聊出口只需要它返回一个非空的端点列表。"""
+
+    async def resolve(self, *, agent_type: str, task_type: str) -> list:
+        return [object()]
+
+
+def build_agent() -> CustomerServiceAgent:
+    return CustomerServiceAgent(CustomerServiceAgent.definition)
+
+
+def stub_agent(
+    output: object = None, error: Exception | None = None
+) -> tuple[CustomerServiceAgent, list[tuple[str, dict, str]]]:
+    """构造一个 `call_tool` 被换掉的 Agent，返回 `(agent, 调用记录)`。
+
+    ⚠️ 只能**逐实例替换**：子类化覆盖 `call_tool` 会被底座直接拒绝
+    （`TypeError: Agent cannot override governance methods: ['call_tool']`）——
+    那是刻意设的守卫，工具调用是审计与权限的唯一咽喉，不允许子类换实现。
+    "替身只活在这个用例里"正好用逐实例替换表达。
+    """
+    agent = CustomerServiceAgent(CustomerServiceAgent.definition)
+    calls: list[tuple[str, dict, str]] = []
+
+    async def fake_call_tool(
+        name: str, arguments: dict, *, intent: str, context: RequestContext
+    ) -> object:
+        calls.append((name, dict(arguments), intent))
+        if error is not None:
+            raise error
+        return output
+
+    agent.call_tool = fake_call_tool  # type: ignore[method-assign]
+    return agent, calls
+
+
+def _request(message: str, *, streak: int = 0) -> AgentRequest:
+    return AgentRequest(
+        agent_type="customer_service",
+        message=message,
+        session_id="s-w27",
+        idempotency_key="w27-l0-surface-key",
+        metadata=AgentRequestMetadata(chitchat_streak=streak),
+    )
+
+
+def _context() -> RequestContext:
+    return RequestContext(user_id="1", trace_id="w27")
+
+
+# --------------------------------------------------------------------------- #
+# 一、`L0-a` 闲聊：命中即答，**不查库、不调模型**
+# --------------------------------------------------------------------------- #
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize(
+    "message",
+    ["你好", "在吗", "有人吗", "讲个笑话", "谢谢你啊", "嗯嗯嗯", "你们公司的人都好有趣啊"],
+)
+async def test_l0a_chitchat_never_touches_tools(message: str) -> None:
+    """连续闲聊 4 轮以上时给确定性收口话术 —— **一次工具都不该调**。"""
+    agent, calls = stub_agent(output={"hits": [{"score": 0.9, "content": "不该被查到"}]})
+    result = await agent._route_surface(_request(message, streak=4), _context())
+    assert result is not None
+    assert result.exit_code == "CHAT"
+    assert result.transfer_required is False
+    assert calls == [], "闲聊出口不得调用任何工具"
+
+
+@pytest.mark.asyncio
+async def test_l0a_chitchat_reaches_the_model_but_never_the_knowledge_base(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    """第 1—3 轮闲聊走模型（**不查库**）：`L0-a` 的价值就是"不问向量库"。"""
+    agent, calls = stub_agent()
+
+    async def fake_generate(endpoints: list, prompt: str, *, max_attempts: int = 2) -> object:
+        return SimpleNamespace(text="你好呀，想了解基金产品还是申赎规则？", attempts=1)
+
+    monkeypatch.setattr(agent, "generate_with_model", fake_generate)
+    monkeypatch.setattr(cs_module, "DatabaseModelEndpointResolver", _EndpointResolver)
+    result = await agent._route_surface(_request("你好"), _context())
+    assert result is not None
+    assert result.exit_code == "CHAT"
+    assert "你好呀" in result.text
+    assert calls == [], "闲聊不得查知识库"
+
+
+@pytest.mark.asyncio
+async def test_l0a_does_not_hijack_business_questions() -> None:
+    """含业务实体的问句**不判闲聊**（`D3.9` §3.1 边界）—— 交回主路径。"""
+    for message in ["你好，费率是多少", "159382最近走势怎么样", "第十六条讲的是什么"]:
+        agent, _calls = stub_agent(output={"found": False, "reason": "product_not_found"})
+        result = await agent._route_surface(_request(message), _context())
+        assert result is None or result.exit_code != "CHAT", message
+
+
+# --------------------------------------------------------------------------- #
+# 二、`L0-e` 无信息量短句
+# --------------------------------------------------------------------------- #
+
+@pytest.mark.asyncio
+# 「空白消息」不在这一组里：`AgentRequest` 的校验早就挡掉了（`message must not be blank`），
+# 所以 `L0-e` 在服务链路上永远见不到空串。纯函数层的空串用例在
+# `tests/unit/core/test_customer_service_rules.py::test_low_information_short_messages`。
+@pytest.mark.parametrize("message", ["？？？", "。。。", "😀", "!!!"])
+async def test_l0e_low_information_asks_for_details(message: str) -> None:
+    agent, calls = stub_agent()
+    result = await agent._route_surface(_request(message), _context())
+    assert result is not None
+    assert result.exit_code == "CHAT"
+    assert calls == []
+
+
+# --------------------------------------------------------------------------- #
+# 三、`L0-b` 实体抽取与行情出口
+# --------------------------------------------------------------------------- #
+
+@pytest.mark.parametrize(
+    ("message", "expected"),
+    [
+        ("159382这只ETF最近走势怎么样？", ("code", "159382")),
+        ("创业板人工智能ETF南方最近走势怎么样？", ("name", "创业板人工智能ETF南方")),
+        # 手册示例产品：不在形状表里，靠"行情词之前那一段"兜底刮出来
+        ("南方稳健增利债券A最近走势怎么样？", ("name", "南方稳健增利债券A")),
+        ("季季盈90天最近的净值表现如何", ("name", "季季盈90天")),
+        # 抽不出唯一实体 ⇒ 不猜（交回澄清 / 检索）
+        ("ETF最近走势怎么样？", ("", "")),
+        ("高净值客户有什么权益？", ("", "")),
+    ],
+)
+def test_trend_entity_extraction(message: str, expected: tuple[str, str]) -> None:
+    assert CustomerServiceAgent._trend_entity(message) == expected
+
+
+@pytest.mark.asyncio
+async def test_trend_exit_renders_only_tool_numbers() -> None:
+    """`E6` 正文里的数字**全部**来自工具返回（`INV-6`）。"""
+    output = {
+        "found": True,
+        "fund_code": "159382",
+        "fund_name": "创业板人工智能ETF南方",
+        "exchange_code": "SZSE",
+        "latest_nav": "2.5841",
+        "latest_nav_date": "2026-09-11",
+        "from_date": "2026-03-18",
+        "to_date": "2026-09-11",
+        "series_points": 122,
+        "intervals": [
+            {
+                "name": "近 20 个净值日", "trading_days": 19,
+                "start_date": "2026-08-17", "start_nav": "2.8497",
+                "end_date": "2026-09-11", "end_nav": "2.5841",
+                "change_pct": "-9.31",
+            }
+        ],
+        "high": {"nav": "2.9000", "nav_date": "2026-03-23"},
+        "low": {"nav": "1.8000", "nav_date": "2026-04-08"},
+        "source": "fin_nav_history",
+    }
+    agent, calls = stub_agent(output=output)
+    result = await agent._route_surface(_request("159382最近走势怎么样"), _context())
+    assert result is not None
+    assert result.exit_code == "E6"
+    assert result.transfer_required is False
+    assert calls == [("query_fund_trend", {"fund_code": "159382"}, "faq")]
+    text = result.text
+    assert "-9.31%" in text
+    assert "2.5841" in text and "2026-09-11" in text
+    assert "122 个净值日" in text
+    assert "fin_nav_history" in text
+    assert result.data["source"] == "fin_nav_history"
+    # 数据口径与日期必须在答复里（`D3.9` §4.3 的"可核对性"）
+    assert "2026-03-18" in text
+
+
+@pytest.mark.asyncio
+async def test_trend_positive_change_gets_explicit_plus_sign() -> None:
+    output = {
+        "found": True, "fund_code": "159382", "fund_name": "创业板人工智能ETF南方",
+        "exchange_code": "SZSE", "latest_nav": "1.1000", "latest_nav_date": "2026-09-10",
+        "from_date": "2026-09-06", "to_date": "2026-09-10", "series_points": 5,
+        "intervals": [{
+            "name": "近 5 个净值日", "trading_days": 4, "start_date": "2026-09-06",
+            "start_nav": "1.0600", "end_date": "2026-09-10", "end_nav": "1.1000",
+            "change_pct": "3.77",
+        }],
+        "high": {"nav": "1.1000", "nav_date": "2026-09-10"},
+        "low": {"nav": "1.0600", "nav_date": "2026-09-06"},
+        "source": "fin_nav_history",
+    }
+    agent, _calls = stub_agent(output=output)
+    result = await agent._route_surface(_request("159382走势"), _context())
+    assert result is not None
+    assert "+3.77%" in result.text
+
+
+@pytest.mark.asyncio
+async def test_trend_missing_product_states_the_data_boundary() -> None:
+    """`INV-7`：无数据源的产品必须**自陈边界**，并给出能答的替代项。"""
+    agent, _calls = stub_agent(output={"found": False, "reason": "product_not_found"})
+    result = await agent._route_surface(
+        _request("南方稳健增利债券A最近走势怎么样？"), _context()
+    )
+    assert result is not None
+    assert result.exit_code == "E6"
+    assert result.transfer_required is False
+    assert "南方稳健增利债券A" in result.text
+    assert "查不到公开的净值序列" in result.text
+    # 只说"不知道"不够：必须给能答的手册项
+    assert "风险等级" in result.text and "费率" in result.text
+
+
+@pytest.mark.asyncio
+async def test_trend_ambiguous_asks_for_the_code() -> None:
+    """多解时**不替客户挑一只**（`INV-2`），要 6 位代码。"""
+    agent, _calls = stub_agent(output={"found": False, "reason": "ambiguous"})
+    result = await agent._route_surface(_request("科创债ETF南方走势如何"), _context())
+    assert result is not None
+    assert "159382" in result.text  # 举例给的代码，便于客户照抄格式
+    assert "6 位" in result.text
+
+
+@pytest.mark.asyncio
+async def test_trend_definition_question_is_not_hijacked() -> None:
+    """「净值怎么算」要的是**口径**（知识库有），不是数据 —— `L0-b` 不得抢走。"""
+    agent, calls = stub_agent(output={"found": True})
+    result = await agent._route_surface(_request("南方稳健增利债券A的净值怎么算"), _context())
+    assert result is None
+    assert calls == []
+
+
+@pytest.mark.asyncio
+async def test_trend_without_trend_keyword_is_not_a_trend_question() -> None:
+    """`科创债ETF南方怎么样` 没有行情词 ⇒ 不走 `E6`（金标期望它落 `E5b`）。"""
+    agent, calls = stub_agent(output={"found": True})
+    assert await agent._route_surface(_request("科创债ETF南方怎么样"), _context()) is None
+    assert calls == []
+
+
+@pytest.mark.asyncio
+async def test_high_net_worth_customer_question_is_not_a_trend_question() -> None:
+    """金标回归钉子：「高净值客户有什么权益？」含「净值」但**没有实体** ⇒ 不判行情。
+
+    少了实体判据，这一条会被 `E6` 抢走并答成"查不到净值序列"—— 一条本来能答对的
+    高净值客户分层题会因为一个词面重合而全错。这是"加能力不能靠词面"的实例。
+    """
+    agent, calls = stub_agent(output={"found": True})
+    assert await agent._route_surface(_request("高净值客户有什么权益？"), _context()) is None
+    assert calls == []
+
+
+@pytest.mark.asyncio
+async def test_trend_tool_failure_degrades_honestly() -> None:
+    """工具异常 → 如实告知（**不转人工**、不回退到知识库静态快照）。"""
+    agent, _calls = stub_agent(error=RuntimeError("boom"))
+    result = await agent._route_surface(_request("159382走势"), _context())
+    assert result is not None
+    assert result.exit_code == "E6"
+    assert result.transfer_required is False
+    assert "查不到公开的净值序列" in result.text
+
+
+# --------------------------------------------------------------------------- #
+# 四、出口码完备性（门禁 `F5` 分档的判据基础）
+# --------------------------------------------------------------------------- #
+
+def test_every_core_result_declares_an_exit_code() -> None:
+    """AST 守卫：模块里**每一个** `CoreResult(...)` 都必须带 `exit_code=`。
+
+    为什么用 AST 而不是"跑一遍看看"：漏填出口码的失败形态是**静默降级**——
+    该挂轻量提示的答复挂了完整免责话术（或反过来），跑起来不报错、看着也正常，
+    只有门禁分档悄悄错了。静态扫一遍是唯一能在开发期发现的判据。
+    """
+    source = Path(cs_module.__file__).read_text(encoding="utf-8")
+    tree = ast.parse(source)
+    missing: list[int] = []
+    for node in ast.walk(tree):
+        if not isinstance(node, ast.Call):
+            continue
+        func = node.func
+        name = func.id if isinstance(func, ast.Name) else getattr(func, "attr", "")
+        if name != "CoreResult":
+            continue
+        if "exit_code" not in {keyword.arg for keyword in node.keywords}:
+            missing.append(node.lineno)
+    assert missing == [], f"这些 CoreResult 没声明出口码：{missing}"
+
+
+def test_business_exits_are_never_downgraded_to_the_light_notice() -> None:
+    """未登记的出口码默认落**业务档**（多说一句），与 `INV-5` 的失败方向一致。"""
+    from app.core.exit_codes import NON_BUSINESS_EXIT_CODES
+
+    assert "E5b" not in NON_BUSINESS_EXIT_CODES, "E5b 空答也必须带完整投资风险提示"
+    assert "E5c" not in NON_BUSINESS_EXIT_CODES
+    assert "E6" not in NON_BUSINESS_EXIT_CODES
+    assert None not in NON_BUSINESS_EXIT_CODES
+    assert {"CHAT", "LOGIN", "CONTACT", "E1", "E5a"} <= NON_BUSINESS_EXIT_CODES
+
+
+@pytest.mark.asyncio
+async def test_existing_exits_carry_their_own_codes() -> None:
+    """抽查既有出口：码与 `D3.6` 的出口表逐条对应。"""
+    agent = build_agent()
+    assert agent._exit_partial([], note="x").exit_code == "E5b"
+    assert agent._exit_transfer("explicit_request").exit_code == "E5c"
+    assert agent._guide_to_login("x").exit_code == "LOGIN"
+    assert agent._exit_suitability_clarify().exit_code == "E1"
+    assert agent._exit_clarify([{"score": 0.6, "title": "t"}]).exit_code == "E5a"
+    assert agent._exit_calc_miss("x").exit_code == "E5b"
+    assert agent._exit_risk_level_change().exit_code == "E8"
+    assert agent._exit_profile_miss().exit_code == "E5b"
+    assert agent._exit_chitchat_prompt_fail("x").exit_code == "E5b"
diff --git a/tests/unit/service/test_fund_trend_service.py b/tests/unit/service/test_fund_trend_service.py
new file mode 100644
index 0000000..5a46abf
--- /dev/null
+++ b/tests/unit/service/test_fund_trend_service.py
@@ -0,0 +1,239 @@
+from datetime import date
+from decimal import Decimal
+from types import SimpleNamespace
+from typing import Any
+
+import pytest
+
+from app.core.contracts import RequestContext
+from app.core.fund_contracts import FundTrendQuery
+from app.model.fund import FundNavHistory
+from app.service import fund_trend_service
+from app.service.fund_trend_service import (
+    LISTED_STATUS,
+    NAV_SOURCE,
+    query_fund_trend_tool,
+    summarize_trend,
+)
+
+
+def _series(days: int, *, start: str = "1.0000", step: str = "0.0100") -> list[dict[str, str]]:
+    points: list[dict[str, str]] = []
+    nav = Decimal(start)
+    day = date(2026, 1, 2)
+    for _ in range(days):
+        points.append({"nav_date": day.isoformat(), "nav": str(nav)})
+        nav += Decimal(step)
+        day = date.fromordinal(day.toordinal() + 1)
+    return points
+
+
+# --------------------------------------------------------------------------- #
+# 一、纯函数：`summarize_trend`
+# --------------------------------------------------------------------------- #
+
+def test_summarize_trend_reports_no_series_for_empty_input() -> None:
+    """**没有净值序列是一种结论，不是一次失败**（`INV-7` 靠它说"无可奉告"）。"""
+    assert summarize_trend([]) == {
+        "found": False, "reason": "no_nav_series", "source": NAV_SOURCE,
+    }
+
+
+def test_summarize_trend_skips_unparsable_points() -> None:
+    """脏行（日期解析不了 / 值是 `--`）**跳过**，不能让一条脏数据毁掉整条序列。"""
+    result = summarize_trend([
+        {"nav_date": "not-a-date", "nav": "1.0"},
+        {"nav_date": "2026-03-02", "nav": "--"},
+        {"nav_date": "2026-03-02", "nav": "1.5000"},
+    ])
+    assert result["found"] is True
+    assert result["series_points"] == 1
+    assert result["latest_nav"] == "1.5000"
+
+
+def test_summarize_trend_orders_points_regardless_of_input_order() -> None:
+    """入参顺序不限：**最新一档取日期最大的那条**，不是数组的最后一个。"""
+    result = summarize_trend([
+        {"nav_date": "2026-03-05", "nav": "1.2000"},
+        {"nav_date": "2026-03-01", "nav": "1.0000"},
+        {"nav_date": "2026-03-03", "nav": "1.1000"},
+    ])
+    assert result["latest_nav_date"] == "2026-03-05"
+    assert result["from_date"] == "2026-03-01"
+
+
+def test_summarize_trend_computes_intervals_high_and_low() -> None:
+    result = summarize_trend(_series(6))
+    assert result["found"] is True
+    assert result["source"] == NAV_SOURCE
+    names = [row["name"] for row in result["intervals"]]
+    # 只有 6 个点：够到 5 日窗口，够不到 20/60/120 —— 不够的窗口**不编**。
+    assert names == ["近 5 个净值日"]
+    row = result["intervals"][0]
+    assert row["trading_days"] == 4
+    assert row["start_nav"] == "1.0100"
+    assert row["end_nav"] == "1.0500"
+    assert row["change_pct"] == "3.96"
+    assert result["high"] == {"nav": "1.0500", "nav_date": "2026-01-07"}
+    assert result["low"] == {"nav": "1.0000", "nav_date": "2026-01-02"}
+
+
+def test_summarize_trend_change_pct_is_signed_for_down_moves() -> None:
+    result = summarize_trend(_series(6, step="-0.0100"))
+    # 5 日窗口：起点 0.9900 → 终点 0.9500 ⇒ (0.95-0.99)/0.99 = -4.04%
+    assert result["intervals"][0]["change_pct"] == "-4.04"
+
+
+def test_listed_status_matches_public_product_service() -> None:
+    """`LISTED_STATUS` 与 `public_product_service` **必须逐字相同**。
+
+    本模块**刻意不 import** 那个常量（会形成
+    `public_product_service → admin_service → agent.bootstrap → 本模块` 的循环导入，
+    实测 `partially initialized module`）。于是"两处同值"这件事只能靠测试钉住 ——
+    否则哪天有人改了其中一处，行情出口会静默查不到任何产品（返回"无公开净值序列"），
+    而那看起来像数据问题、不像代码问题。
+    """
+    from app.service.public_product_service import LISTED_STATUS as public_listed_status
+
+    assert LISTED_STATUS == public_listed_status
+
+
+# --------------------------------------------------------------------------- #
+# 二、工具处理器：`query_fund_trend_tool`（用假 session 走真实 `_resolve_product`）
+# --------------------------------------------------------------------------- #
+
+class _FakeScalars:
+    def __init__(self, items: list[Any]) -> None:
+        self._items = items
+
+    def all(self) -> list[Any]:
+        return list(self._items)
+
+    def first(self) -> Any:
+        return self._items[0] if self._items else None
+
+
+class _FakeResult:
+    def __init__(self, items: list[Any]) -> None:
+        self._items = items
+
+    def scalars(self) -> _FakeScalars:
+        return _FakeScalars(self._items)
+
+
+class _FakeSession:
+    """按**实体类型**分发假结果，并记录产品查询次数。
+
+    `_resolve_product` 的产品查询最多两次（先精确、后 `contains` 模糊），
+    用计数器模拟这两步，而不是去复刻 SQL 语义。
+    """
+
+    def __init__(self, *, products: list[list[Any]], navs: list[Any]) -> None:
+        self._products = list(products)
+        self._navs = list(navs)
+        self.product_queries = 0
+
+    async def execute(self, statement: Any) -> _FakeResult:
+        entity = statement.column_descriptions[0]["entity"]
+        if entity is FundNavHistory:
+            return _FakeResult(self._navs)
+        self.product_queries += 1
+        index = min(self.product_queries, len(self._products) + 1) - 1
+        if index >= len(self._products):
+            return _FakeResult([])
+        return _FakeResult(self._products[index])
+
+
+def _patch_session(monkeypatch: pytest.MonkeyPatch, session: _FakeSession) -> None:
+    class _Factory:
+        def __call__(self) -> "_Factory":  # pragma: no cover - 仅用于类型直觉
+            return self
+
+        async def __aenter__(self) -> _FakeSession:
+            return session
+
+        async def __aexit__(self, *args: object) -> None:
+            return None
+
+    monkeypatch.setattr(fund_trend_service, "SessionFactory", _Factory())
+
+
+def _product(**overrides: Any) -> SimpleNamespace:
+    base = dict(
+        id=1, product_code="159382", product_name="创业板人工智能ETF南方",
+        product_category="ETF", risk_level="R4", exchange_code="SZSE",
+        status=LISTED_STATUS,
+    )
+    base.update(overrides)
+    return SimpleNamespace(**base)
+
+
+@pytest.mark.asyncio
+async def test_query_fund_trend_tool_returns_series_and_keeps_risk_level_as_text(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    """`risk_level` 必须**原样透传字符串**（`'R4'`）。
+
+    回归钉子：`fin_product.risk_level` 列存的是 `R1`—`R5` 这种**字符串**，不是整数。
+    本工具最初写成 `int(product.risk_level)`，冒烟直接抛
+    `ValueError: invalid literal for int() with base 10: 'R4'` —— 且只在**真的有产品**
+    的路径上才炸（查不到产品的路径不碰这个字段），属于"最像成功的那种失败"。
+    口径与 `public_product_service._view()` 一致：原样透传，不在这一层做数值转换。
+    """
+    session = _FakeSession(
+        products=[[_product()]],
+        navs=[
+            SimpleNamespace(nav_date=date(2026, 3, 2), nav=Decimal("1.0000")),
+            SimpleNamespace(nav_date=date(2026, 3, 3), nav=Decimal("1.5000")),
+        ],
+    )
+    _patch_session(monkeypatch, session)
+    result = await query_fund_trend_tool(
+        FundTrendQuery(fund_code="159382"), RequestContext(user_id="1", trace_id="t")
+    )
+    assert result["found"] is True
+    assert result["fund_code"] == "159382"
+    assert result["fund_name"] == "创业板人工智能ETF南方"
+    assert result["risk_level"] == "R4"
+    assert result["source"] == NAV_SOURCE
+    assert result["latest_nav"] == "1.5000"
+
+
+@pytest.mark.asyncio
+async def test_query_fund_trend_tool_reports_missing_product(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    """查不到产品时**如实返回 `found=False`**，不抛异常、不猜一只相近的。"""
+    session = _FakeSession(products=[[]], navs=[])
+    _patch_session(monkeypatch, session)
+    result = await query_fund_trend_tool(
+        FundTrendQuery(fund_name="南方稳健增利债券A"),
+        RequestContext(user_id="1", trace_id="t"),
+    )
+    assert result == {"found": False, "reason": "product_not_found", "source": NAV_SOURCE}
+
+
+@pytest.mark.asyncio
+async def test_query_fund_trend_tool_reports_ambiguous_name(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    """名称命中多只时返回 `ambiguous` —— **替客户挑一只**才是这里最坏的行为（`INV-2`）。"""
+    session = _FakeSession(
+        products=[
+            [],
+            [_product(id=1, product_code="159700"), _product(id=2, product_code="159701")],
+        ],
+        navs=[],
+    )
+    _patch_session(monkeypatch, session)
+    result = await query_fund_trend_tool(
+        FundTrendQuery(fund_name="科创债ETF南方"), RequestContext(user_id="1", trace_id="t")
+    )
+    assert result["found"] is False
+    assert result["reason"] == "ambiguous"
+
+
+def test_trend_query_requires_at_least_one_entity() -> None:
+    """契约层就挡住"两个实体都不给"的调用（否则工具会去扫全表）。"""
+    with pytest.raises(ValueError):
+        FundTrendQuery()
diff --git a/tests/unit/service/test_governance_disclaimer.py b/tests/unit/service/test_governance_disclaimer.py
index a8d3580..df12ed8 100644
--- a/tests/unit/service/test_governance_disclaimer.py
+++ b/tests/unit/service/test_governance_disclaimer.py
@@ -24,7 +24,11 @@ from app.core.contracts import (
     ResolvedAgentConfig,
 )
 from app.service.agent import governance
-from app.service.agent.governance import FALLBACK_DISCLAIMER, review_output
+from app.service.agent.governance import (
+    FALLBACK_DISCLAIMER,
+    FALLBACK_LIGHT_NOTICE,
+    review_output,
+)
 
 CONTEXT = RequestContext(user_id="9001", trace_id="t", roles=("customer",))
 CONFIG = ResolvedAgentConfig(config_version="v", prompt_version="p", model_endpoint="m")
@@ -368,3 +372,97 @@ def test_recalled_memories_do_not_affect_disclaimer() -> None:
     memories = (RecalledMemory(memory_uuid="m1", customer_id="9001", content="偏好低风险"),)
     reviewed = _review("答案。", memories=memories)
     assert reviewed.result.text == "答案。" + DISCLAIMER
+
+# ---------------------------------------------------------------------------
+# `W27` / `DEC-W27-10`：门禁 F5 **分两档**（判据是出口码）
+# ---------------------------------------------------------------------------
+
+LIGHT = "\n\n" + FALLBACK_LIGHT_NOTICE
+
+
+def _result_with_exit(text: str, exit_code: str | None) -> AgentResult:
+    return AgentResult(run_id="r", result=CoreResult(text=text, exit_code=exit_code))
+
+
+@pytest.mark.parametrize("exit_code", ["CHAT", "LOGIN", "CONTACT", "E1", "E5a"])
+def test_non_business_exits_get_the_light_notice_only(exit_code: str) -> None:
+    """非业务档只附轻量提示：寒暄/联系方式/登录引导/澄清挂投资风险提示是挂错话术。
+
+    这也是"客服在背模板"的体感来源之一 —— 门禁 F5 原口径要求 100% 附完整话术，
+    于是「讲个笑话」后面跟一段投资风险提示。分档**不减少业务答复的披露**。
+    """
+    reviewed = _review(_result_with_exit("您好呀，想了解基金产品吗？", exit_code))
+    assert reviewed.result.text.endswith(LIGHT)
+    assert FALLBACK_DISCLAIMER not in reviewed.result.text
+
+
+@pytest.mark.parametrize(
+    "exit_code", ["E2e", "E3", "E4", "E5b", "E5c", "E6", "P0", "P1", "P2", None]
+)
+def test_business_exits_keep_the_full_disclaimer(exit_code: str | None) -> None:
+    """业务档（含 `E5b` 空答、`E5c` 转人工、`E6` 行情与安全出口）照旧附**完整**话术。
+
+    `E5b`（"这一条我暂时没找到对应的公开资料…"）是本条最要紧的一格：它的正文里
+    **一个数字都没有**，如果用"文本里有没有数字"这类间接判据分档，它会被判成非业务并
+    静默掉档 —— 而它恰恰是"业务上答不上来"，投资风险提示一个字都不能少。
+    """
+    reviewed = _review(_result_with_exit("关于这一点，公开资料里的口径是：…", exit_code))
+    assert reviewed.result.text.endswith(DISCLAIMER)
+    assert FALLBACK_LIGHT_NOTICE not in reviewed.result.text
+
+
+def test_light_notice_is_idempotent_per_tier() -> None:
+    """轻量提示同样只追加一次（重放/重试不得叠成两条）。"""
+    once = _review(_result_with_exit("在的，请问需要了解什么？", "CHAT"))
+    twice = _review(once)
+    assert twice.result.text.count(FALLBACK_LIGHT_NOTICE) == 1
+    assert twice.result.text == once.result.text
+
+
+def test_tier_switch_appends_the_missing_notice() -> None:
+    """已经带了轻量提示的答复再被判成业务档时，**完整话术照加**（不重复轻量提示）。
+
+    这是"幂等判据按档分别生效"的边界：幂等只认**本次该用的那一份**的形状，
+    而不是"末尾已经有任何一句话术就不加"。方向取"宁可多披露一句"。
+    """
+    result = _result_with_exit("答案。" + LIGHT, "E3")
+    reviewed = _review(result)
+    assert reviewed.result.text.endswith(DISCLAIMER)
+    # 两头都在：轻量提示是上一次追加的，完整话术是这一次的
+    assert FALLBACK_LIGHT_NOTICE in reviewed.result.text
+    assert FALLBACK_DISCLAIMER in reviewed.result.text
+
+
+async def test_review_loads_the_light_template_by_its_own_code(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    """`review()` 按 `template_code` 分别取两份话术 —— 两个 code 都得查一次。"""
+    from app.service.agent.governance import DISCLAIMER_TEMPLATE_CODE, LIGHT_NOTICE_TEMPLATE_CODE
+
+    seen: list[str] = []
+
+    class _CodeAwareSession(_FakeReviewSession):
+        async def scalar(self, statement: Any, params: Any = None) -> Any:
+            code = str((params or {}).get("code") or "")
+            seen.append(code)
+            return {
+                DISCLAIMER_TEMPLATE_CODE: "库内完整免责话术。",
+                LIGHT_NOTICE_TEMPLATE_CODE: "库内轻量提示。",
+            }.get(code)
+
+    monkeypatch.setattr(governance, "SessionFactory", lambda: _CodeAwareSession())
+    service = governance.PlatformGovernance()
+
+    business = await service.review(
+        _result_with_exit("答案。", "E3"), CONTEXT, CONFIG_WITH_RELEASE, (),
+        agent_type="customer_service",
+    )
+    assert business.result.text.endswith("\n\n库内完整免责话术。")
+
+    small_talk = await service.review(
+        _result_with_exit("在的。", "CHAT"), CONTEXT, CONFIG_WITH_RELEASE, (),
+        agent_type="customer_service",
+    )
+    assert small_talk.result.text.endswith("\n\n库内轻量提示。")
+    assert DISCLAIMER_TEMPLATE_CODE in seen
+    assert LIGHT_NOTICE_TEMPLATE_CODE in seen
diff --git a/tests/unit/tools/test_customer_service_tool_config.py b/tests/unit/tools/test_customer_service_tool_config.py
new file mode 100644
index 0000000..cd2689d
--- /dev/null
+++ b/tests/unit/tools/test_customer_service_tool_config.py
@@ -0,0 +1,117 @@
+"""`E6` 行情工具的两处配置守卫（`D3.9` §4 / `DEC-W27-6` / `DEC-W27-11`）。
+
+这两条都属于"配置漏了不会报错"的失败形态，所以必须静态钉住：
+
+1. **工具注册**：漏注册 ⇒ 客服调 `query_fund_trend` 直接 fail-closed，
+   表现成"这只基金查不到行情"，看起来像数据问题；
+2. **发布白名单**：`call_tool` 的可见工具来自 `config_release.agent_tools`，
+   漏加 ⇒ `AGENT_PERMISSION_DENIED`，表现成"行情功能坏了"。
+   更危险的是**反向**：`customer_service:faq` 键必须**从生效版本派生出原列表再追加**，
+   不能硬编码一份快照 —— 否则跑一次脚本就把别处加的工具静默回退掉。
+"""
+
+from app.service.agent.bootstrap import get_agent_factory
+from app.service.agent.implementations.customer_service import TREND_TOOL_NAME
+from tools.publish_customer_service_tool_config import (
+    INTENT_TOOLS,
+    TREND_TOOL_ADDITIONS,
+    _inherit_tools,
+)
+
+
+def test_fund_trend_tool_is_registered_as_read_only_public_data() -> None:
+    factory = get_agent_factory()
+    tool = factory._tool_executor.registry.get("query_fund_trend")
+    assert tool.read_only is True
+    # 复用行情权限面：与 `query_fund_quote` 读的是同一类公开数据，不新开权限点
+    assert tool.required_permission == "fund:quote:read"
+    assert tool.allowed_roles == (
+        "visitor", "customer", "advisor", "operator", "risk_operator", "admin",
+    )
+
+
+def test_trend_tool_is_only_added_to_the_faq_allowlist_key() -> None:
+    """`E6` 的白名单 key 固定为 `faq`（与 `query_customer_profile` 同一处）。"""
+    assert set(TREND_TOOL_ADDITIONS) == {"faq"}
+    assert TREND_TOOL_ADDITIONS["faq"] == ("query_fund_trend",)
+    # `suitability_check` 那份硬编码列表不因本次改动而变（防止顺手改宽）
+    assert INTENT_TOOLS["suitability_check"] == (
+        "search_knowledge", "check_suitability", "query_eligible_products",
+    )
+
+
+def test_inherit_tools_appends_without_dropping_existing_entries() -> None:
+    """**核心不变量**：追加不改窄 —— 原有工具一个都不能掉。"""
+    inherited = [
+        {
+            "namespace": "agent_tools",
+            "item_key": "customer_service:faq",
+            "value_json": {
+                "allowed_tools": [
+                    "search_knowledge", "query_knowledge", "query_customer_profile",
+                ]
+            },
+        }
+    ]
+    merged = _inherit_tools(inherited, "faq", ("query_fund_trend",))
+    assert merged == (
+        "search_knowledge", "query_knowledge", "query_customer_profile", "query_fund_trend",
+    )
+
+
+def test_inherit_tools_is_idempotent() -> None:
+    """已经加过的工具不重复追加（脚本可反复跑）。"""
+    inherited = [
+        {
+            "namespace": "agent_tools",
+            "item_key": "customer_service:faq",
+            "value_json": {"allowed_tools": ["query_fund_trend"]},
+        }
+    ]
+    assert _inherit_tools(inherited, "faq", ("query_fund_trend",)) == ("query_fund_trend",)
+
+
+def test_inherit_tools_returns_none_instead_of_guessing() -> None:
+    """生效版本里没有该键时**返回 `None`**（调用方跳过并告警），绝不用 additions 新建。
+
+    退化成"用 additions 新建一个"的后果：`faq` 键原有的工具被一次性砍光 ——
+    那是比"漏加一个工具"危险得多的失败形态，也是本函数存在的全部理由。
+    """
+    assert _inherit_tools([], "faq", ("query_fund_trend",)) is None
+    assert _inherit_tools(
+        [{"namespace": "agent_tools", "item_key": "customer_service:policy_explain",
+          "value_json": {"allowed_tools": ["search_knowledge"]}}],
+        "faq",
+        ("query_fund_trend",),
+    ) is None
+    # 形状不对（value_json 不是 dict / allowed_tools 不是 list）同样不猜
+    assert _inherit_tools(
+        [{"namespace": "agent_tools", "item_key": "customer_service:faq",
+          "value_json": "not-a-dict"}],
+        "faq",
+        ("query_fund_trend",),
+    ) is None
+    assert _inherit_tools(
+        [{"namespace": "agent_tools", "item_key": "customer_service:faq",
+          "value_json": {"allowed_tools": "search_knowledge"}}],
+        "faq",
+        ("query_fund_trend",),
+    ) is None
+
+def test_published_allowlist_is_inside_the_code_ceiling() -> None:
+    """**`422 配置超出 Agent 工具上限` 的根因钉子**（`W27` 实跑踩到，不再复发）。
+
+    `admin_service` 对 `agent_tools` 的校验是
+    `set(发布白名单) <= set(definition.allowed_tools)` —— 不是"数量上限"，是**子集**。
+    `query_fund_trend` 注册了、意图也在，但没进代码声明的 `allowed_tools`，
+    于是 `publish --apply` 直接被拒 422，表现成"行情功能发布不上去"。
+
+    这条把"注册"与"上限"两件事钉在一起：任何一侧漏了都在单测里炸，
+    而不是等到跑发布脚本才发现。
+    """
+    definition = get_agent_factory().definition("customer_service")
+    assert TREND_TOOL_NAME in definition.allowed_tools
+    published = set(INTENT_TOOLS["suitability_check"])
+    for tools in TREND_TOOL_ADDITIONS.values():
+        published |= set(tools)
+    assert published <= set(definition.allowed_tools)
diff --git a/tests/unit/worker/test_runtime_worker_dispatch.py b/tests/unit/worker/test_runtime_worker_dispatch.py
index 368f321..c6d1718 100644
--- a/tests/unit/worker/test_runtime_worker_dispatch.py
+++ b/tests/unit/worker/test_runtime_worker_dispatch.py
@@ -5,6 +5,7 @@ from unittest.mock import AsyncMock, Mock
 
 import pytest
 
+from app.core.actor import VISITOR_PERMISSIONS
 from app.core.contracts import AgentResult, CoreResult, RequestContext
 from app.model.platform import HandoverTicket
 from app.service.memory_recall_service import MemoryRecallService
@@ -38,7 +39,14 @@ async def test_worker_restores_visitor_without_identity_repository_call() -> Non
     )
 
     assert context.roles == ("visitor",)
-    assert context.permissions == ("agent:run", "knowledge:query")
+    # 单一事实源：访客权限面只在 `app/core/actor.py` 定义一处。
+    # `W27` 新增 `fund:quote:read`（公开净值走势，见 `DEC-W27-11`）后，
+    # 这里不再硬编码元组 —— 否则每次合法扩权都要再来改一遍测试。
+    assert context.permissions == VISITOR_PERMISSIONS
+    # 真正要守住的性质：访客**只**拿公开数据读取权限，
+    # 出现任何 self-scope 权限点（本人记忆/适当性/财务数据）即为越权。
+    assert not [p for p in context.permissions
+                if p.startswith(("memory:", "suitability:read", "financial:"))]
     assert context.data_scope == "public"
     runtime.resolve_identity.assert_not_awaited()
 
diff --git a/tools/publish_customer_service_tool_config.py b/tools/publish_customer_service_tool_config.py
index 46920e3..2c46023 100644
--- a/tools/publish_customer_service_tool_config.py
+++ b/tools/publish_customer_service_tool_config.py
@@ -45,6 +45,20 @@ INTENT_TOOLS: dict[str, tuple[str, ...]] = {
     ),
 }
 
+#: ✅ `W27` / `DEC-W27-6`：`E6` 行情出口要用的工具，加进 `customer_service:faq`。
+#:
+#: **为什么加在 `faq` 键**：`query_customer_profile` 已经在那里，而发布配置里
+#: `customer_service:faq` 是唯一一个"跨意图工具都挂上"的键；新开一个键会让
+#: `customer_service:<intent>` 的工具交集在不同意图下不一致，调用会 fail-closed
+#: —— 那会表现成"行情功能坏了"，而不是"配置少了"。
+#:
+#: ⚠️ 这个键**不从硬编码列表重建**，而是从**当前生效版本读出原列表再追加**（见
+#: `_inherit_tools`）。理由：硬编码一份"当时恰好有哪些工具"的快照，会在别处增删工具后
+#: 被下一次跑本脚本**静默回退** —— 那是比漏加一个工具危险得多的失败形态。
+TREND_TOOL_ADDITIONS: dict[str, tuple[str, ...]] = {
+    "faq": ("query_fund_trend",),
+}
+
 
 def parse_args() -> argparse.Namespace:
     parser = argparse.ArgumentParser(description="Publish customer-service demo tool allowlist")
@@ -199,6 +213,42 @@ async def etag(client: httpx.AsyncClient, path: str, auth: dict[str, str]) -> st
     return (await client.get(path, headers=auth)).headers.get("ETag")
 
 
+def _inherit_tools(
+    inherited: list[dict[str, Any]], intent: str, additions: tuple[str, ...]
+) -> tuple[str, ...] | None:
+    """读出生效版本里 `customer_service:<intent>` 的工具列表，再追加 `additions`。
+
+    取不到生效条目时返回 `None`（**不猜**）：调用方会跳过该键并在日志里说明。
+    这里刻意不"取不到就用 additions 新建一个" —— 那会把 `faq` 键原有的十来个
+    工具一次性砍掉，是最坏的一种"顺手改窄"。
+    """
+    key = f"{AGENT_TYPE}:{intent}"
+    for item in inherited:
+        if str(item.get("namespace")) != "agent_tools" or str(item.get("item_key")) != key:
+            continue
+        value = item.get("value_json")
+        if isinstance(value, str):
+            # `active_items()` 已经解析过一次，这里是防御性分支。
+            # 解析失败**不抛**：抛出去会让整个发布失败，而"发布失败"与
+            # "跳过该键、让新版本原样继承旧条目"相比，后者才是"最接近没改动"的结果
+            # （失败时 `customer_service:faq` 仍是旧值，安全，但操作者会以为脚本坏了）。
+            try:
+                value = json.loads(value)
+            except json.JSONDecodeError:
+                return None
+        if not isinstance(value, dict):
+            return None
+        tools = value.get("allowed_tools")
+        if not isinstance(tools, list):
+            return None
+        merged = [str(tool) for tool in tools]
+        for tool in additions:
+            if tool not in merged:
+                merged.append(tool)
+        return tuple(merged)
+    return None
+
+
 def cs_items() -> list[dict[str, object]]:
     return [
         {
@@ -219,7 +269,20 @@ async def publish() -> int:
     ) as client:
         inherited = await active_items()
         prompt_templates = await active_prompt_templates()
-        replacement_keys = {("agent_tools", str(item["item_key"])) for item in cs_items()}
+        items = cs_items()
+        for intent, additions in TREND_TOOL_ADDITIONS.items():
+            merged = _inherit_tools(inherited, intent, additions)
+            if merged is None:
+                print(f"skip: 生效版本里没有 agent_tools/{AGENT_TYPE}:{intent}，不新建以免改窄")
+                continue
+            items.append({
+                "namespace": "agent_tools",
+                "item_key": f"{AGENT_TYPE}:{intent}",
+                "value_json": {"allowed_tools": list(merged)},
+                "schema_version": "1",
+            })
+            print(f"{AGENT_TYPE}:{intent} -> {', '.join(merged)}")
+        replacement_keys = {("agent_tools", str(item["item_key"])) for item in items}
         carried = [
             item
             for item in inherited
@@ -231,9 +294,9 @@ async def publish() -> int:
             auth=auth,
             payload={
                 "release_no": f"cs-tools-{uuid.uuid4().hex[:12]}",
-                "title": "Customer service E2c-my eligible product tool allowlist",
+                "title": "Customer service tool allowlist (E2c-my eligible + E6 fund trend)",
                 "change_summary": (
-                    "Add query_eligible_products to customer_service:suitability_check"
+                    "Add query_eligible_products to suitability_check; add query_fund_trend to faq"
                 ),
             },
         )
@@ -242,12 +305,15 @@ async def publish() -> int:
             return 1
         release_id = int(created.json()["data"]["id"])
         base = f"/api/v1/admin/config-releases/{release_id}"
-        for item in [*carried, *cs_items()]:
+        for item in [*carried, *items]:
             response = await request(
                 client, f"{base}/platform-config-items", auth=auth, payload=item
             )
             if response.status_code != 201:
-                print(f"write {item['namespace']}/{item['item_key']} failed: {response.status_code}")
+                print(
+                    f"write {item['namespace']}/{item['item_key']} failed: "
+                    f"{response.status_code} {response.text[:400]}"
+                )
                 return 1
         for template in prompt_templates:
             response = await request(
@@ -267,7 +333,7 @@ async def publish() -> int:
                 return 1
         for suffix, payload in (
             ("validations", {}),
-            ("reviews", {"decision": "approved", "comment": "add eligible-product tool"}),
+            ("reviews", {"decision": "approved", "comment": "add eligible-product + fund-trend tools"}),
             ("activations", {}),
         ):
             response = await request(
diff --git a/tools/seed_compliance_baseline.py b/tools/seed_compliance_baseline.py
index 6cdf79f..19242c0 100644
--- a/tools/seed_compliance_baseline.py
+++ b/tools/seed_compliance_baseline.py
@@ -138,6 +138,12 @@ REPLY_TEMPLATES: tuple[tuple[str, str, str, str], ...] = (
     ("TPL_DISCLAIMER", "disclaimer", "固定免责声明",
      "本内容仅为投资分析参考，不构成任何直接投资建议，不构成对任何产品的收益承诺，"
      "据此操作风险自负，请谨慎对待。"),
+    # ✅ `W27` / `DEC-W27-10`：**轻量提示**。门禁 `F5` 分档后，非业务答复
+    # （闲聊 / 联系方式 / 引导登录 / 澄清）挂这一句，业务答复仍挂 `TPL_DISCLAIMER`。
+    # 与代码兜底 `app/service/agent/governance.FALLBACK_LIGHT_NOTICE` **必须同值**：
+    # 一个走库、一个走代码，值不一致时"哪句生效"取决于数据库可不可用（已踩过一次）。
+    ("TPL_DISCLAIMER_LIGHT", "disclaimer", "轻量提示（非业务答复）",
+     "以上为一般性说明，仅供参考，具体以产品说明书与官方披露为准。"),
     ("TPL_AI_NOTICE", "clarification", "AI 生成标识",
      "本回答由 AI 生成，仅供参考。"),
     ("TPL_LOW_CONFIDENCE", "low_confidence", "低置信兜底",
diff --git a/客服agent/D2.1-客服Agent执行Todolist.md b/客服agent/D2.1-客服Agent执行Todolist.md
index 88f6f2a..59f7d20 100644
--- a/客服agent/D2.1-客服Agent执行Todolist.md
+++ b/客服agent/D2.1-客服Agent执行Todolist.md
@@ -1,4 +1,4 @@
-# 客服 Agent 执行 Todolist（执行看板 · v6.40）
+# 客服 Agent 执行 Todolist（执行看板 · v6.41）
 
 
 > **体系编号**：`D2.1`　·　域：二、对外交付　·　编号体系见 `D1.1` §4.0
@@ -47,6 +47,31 @@
 
 **看板状态更新**：`F-3` → **✅ 已落地**（新增 4 条单测）。批次 H 剩余：`H-05`。新增待办：**三项安全路由缺口收口**（`G-01` 优先，建议排在 `H-05` 前）。
 
+## v6.41 本轮修订要点（2026-09-21 · `W27`：**`L0` 表层判定层 + 出口 `E6` 行情 + 收益过滤槽位白名单 + 免责声明分档** —— 设计与代码**同轮完成**，55 条金标全绿）
+
+> **本轮决议**（用户 2026-09-21：「**按照你建议的来**」⇒ `DEC-W27-1`~`12` 全部批准）。设计依据为专册 `D3.9`。证据：`_eval_harness\result_w27c.json` / `score_w27d_55.json` / `score_w27d_46.json`；`_w27_probe_trend.txt` / `_w27_probe_chat.txt`（真 HTTP 复测）。
+
+| # | 修订 | 依据 |
+|---|---|---|
+| 1 | 🆕 **`L0` 表层判定层**（`DEC-W27-1`）：`L0-a` 闲聊 / `L0-b` 行情 / `L0-e` 无信息量三条**确定性**判据，出口码 `E0`。位置在**安全路由之后** —— 「有人让我把验证码给他，顺便说说走势」必须仍走 `P0` 反诈（已实测） | `D3.9` §3.1 |
+| 2 | 🆕 **出口 `E6` 行情**（`DEC-W27-6`）：新增工具 `query_fund_trend` 读 `fin_nav_history`，按**净值日个数**（5/20/60/120）给区间涨跌 + 区间高低 + 数据来源与区间。**不调模型、不猜数**（`INV-6`）；`D3.9` §5 白名单条款是它唯一被允许报涨跌的地方 | `D3.9` §4 |
+| 3 | ✅ **`E6` 对访客开放**（`DEC-W27-11`）：净值与区间涨跌是**公开事实**。访客令牌权限面补入 `fund:quote:read`（`app/core/actor.py` 留痕）；`query_fund_quote` 的 `allowed_roles` **不含 visitor**，故该项只对 `query_fund_trend` 生效 —— 已加**逆向守卫**单测 | `D3.9` §4；`actor.py` |
+| 4 | 🔴 **数据边界如实自陈**（`DEC-W27-8` / `INV-7`）：`fin_product` 只有 **20 只场内 ETF/LOF** 有净值序列，手册示例产品**没有** ⇒ `E6-miss` 明说「查不到公开的净值序列」，并给「按手册告诉你风险等级 / 起投金额 / 费率」的替代路径。**绝不**拿静态快照冒充走势 | `D3.9` §4.4 |
+| 5 | 🔴 **收益数值过滤：关键词黑名单 → 槽位白名单 + fail-closed**：旧判据「整行含收益词即删」会**误删权重**（`A-06` 业绩基准公式 `沪深300×60%＋中证全债×40%` 整行消失），且可被改写绕过。新判据 = 入口闸（收益语境词）× 槽位词（费率 / 权重 / 风险指标 / 比例 / 期限 / 门槛规模）+ 百分比才拦 | `D3.9` §5 |
+| 6 | ✅ **免责声明分档**（`DEC-W27-10`）：业务档附**完整**话术；非业务档（`E1`/`E5a`/`CHAT`/`LOGIN`/`CONTACT`）附**轻型**话术（新增模板 `TPL_DISCLAIMER_LIGHT`）。**`E5b` 空答仍保持完整话术** —— 已用单测钉死 | `D3.9` §6.2 |
+| 7 | 📌 **`FR-CS-008` 口径更正**（`DEC-W27-3`）：删除文档里「跨集合回退（阈值 0.65）」，改为「档位内部分作答 + 引导」。依据：**该回退在代码中根本不存在**（`FALLBACK_COLLECTIONS` 是死代码），且跨集合混比实测让 `M-1` 由 100% 掉到 91.3% | `D3.9` §3.5；`D2.2` / `D3.1` / `D2.4` |
+| 8 | 🔴 **发布配置被代码上限挡住（422）—— 根因已定位并修掉**：`admin_service` 对 `agent_tools` 的校验是 `set(发布白名单) <= set(definition.allowed_tools)` —— **不是数量上限，是子集**。`query_fund_trend` 注册了、意图也在，但没进代码声明的 `allowed_tools` ⇒ `publish --apply` 被拒 `422 AGENT_INPUT_INVALID`「配置超出 Agent 工具上限」。已补入代码上限并加单测钉子 | 本步实跑 |
+| 9 | ✅ **发布新配置版本 `244`**（`cs-tools-75813de45421`）：`customer_service:faq` 从生效版本**派生原列表再追加** `query_fund_trend`（`_inherit_tools`；取不到返回 `None` 不新建，防静默改窄），其余键逐项继承 | 本步实跑 |
+| 10 | ✅ **金标扩容 46 → 55**（`DEC-W27-5`）：新增 `Q` 组行情 5 条（`Q-01`—`Q-05`）+ 闲聊 4 条（`C-10`—`C-13`）；`Q-01`/`Q-03` 走**访客档**，`Q-05` 与 `C-13` 是**反向守卫** | `D3.7` §2 / `D2.9` §2.11 |
+| 11 | ✅ **实测：55 条全绿** —— `M-1 55/55`、`M-4 55/55`；四项零容忍（`M-7`/`M-8`/`M-9`/`M-10`）**全 0**，`M-5` 0；原 46 条**逐项不变**（可比基线 `46/46`）；`M-6` 9.1%（5 条全在转人工白名单内） | `score_w27d_55.json` |
+| 12 | ✅ **回归**：全量 `pytest` **2094 passed / 3 skipped**；`ruff` **零新增**（余 5 条与 `HEAD` 逐条对应，仅行号平移）；真 HTTP 复测走势 / 闲聊 / 免责分档全部符合预期 | 仓库根实测 |
+| 13 | 📌 **`M-9` 取证面补正**（评分器口径）：出处 = 检索命中 + **受控工具原始载荷** + 品牌常量 + 用户原话，并把比对改为**数值化**（`16.00%` 与载荷里的 `16.0` 是同一个数）。不补这一项，行情答复里的 26 个净值数字会被整片误判成「无出处数字」 | `D3.7` §4 / §6.4 |
+
+**验收（可复算）**：`_eval_harness\cases_55.json` + `probe.py` + `score.py` 三件齐备，可**一条命令复跑**；`D2.9` §2.11 给出 9 条新增用例的**实测答复原文**，演示前可逐字对照。
+
+**诚实未做项（本轮声明）**：① `A-11`—`A-13`「实体锚点闸门」的**通用**判据（`D3.9` §3.3）本轮只落到 `E6`（`_trend_entity`），**知识出口侧未做**，故金标扩容是 **9 条而非 12 条**；② `M-3` 分母口径已明示（只数**考检索的** C 组条目），但**未改评分器分母**；③ 阈值分层标定（`D3.9` §3.4）**未重标**，本轮只给方法与「当前阈值不可分」的实测。
+
+
 ## v6.40 本轮修订要点（2026-09-21 · `W25`：**手动测试用例按实测重建** —— 46 条金标逐条回填「实测答复原文」+ 修掉一处展示层误删的真缺陷）
 
 > **本轮决议**（用户 2026-09-21：「**不用 只要他能返回正确的结果就行 按照所有的问题帮我更新测试用例 我要看 我要依据测试用例去演示**」⇒ 把 `D2.9` 的 46 条金标按**当前实现**全量重跑，逐条回填**客户可见的答复原文**）。完整会话记录见 `D1.6` §12；证据 `_w25_http_manual.json` / `.txt`（真 HTTP 答复全文）、`_eval_harness/result_w25.json` + `score_w25.json`。
diff --git a/客服agent/D2.2-客服Agent需求文档.html b/客服agent/D2.2-客服Agent需求文档.html
index f0e9a52..1929299 100644
--- a/客服agent/D2.2-客服Agent需求文档.html
+++ b/客服agent/D2.2-客服Agent需求文档.html
@@ -416,6 +416,7 @@ hr { border: none; height: 1px; background: linear-gradient(90deg, transparent,
 <tr><td><strong>v2.5</strong></td><td><strong>2026-09-17</strong></td><td><strong>对接「五出口」智能增强架构</strong>（依据 <code>D3.6</code>，其 §9 八项决策已裁定）：① <strong><code>FR-CS-003</code> 重写</strong>——澄清由「置信度 &lt; 0.6 短路」扩为<strong>出口 <code>E1</code></strong>（四类触发条件、一次只问一个问题、同话题上限 2 轮、候选限当前档位可见）；② <strong><code>FR-CS-008</code> 重写</strong>——改为<strong>分级回退 <code>E5</code></strong>（跨集合回退 → <strong>部分作答 + 引导</strong> → 转人工），并补硬约束<strong>回退不得跨档位</strong>；③ <strong><code>FR-CS-023</code> 重写</strong>——转人工收敛为<strong>触发白名单 4 类</strong>，<strong>删除「连续 2 轮兜底」</strong>（兜底是能力不足的表征，不是风险）；④ <strong>新增 §1.4.8 域 H</strong>（<code>FR-CS-049</code>—<code>052</code>：证据约束生成 / 计算型回答 / 输出数字一致性校验 / 评测门禁），功能需求 <strong>48 → 52 条</strong>、功能域 <strong>7 → 8</strong>；⑤ <strong>§1.6.3 修正</strong>——<code>public</code> 档<strong>删除「产品参数与费率」</strong>（与 <code>D6.1.2</code> §四 判据、T-07 定案及《知识库设计方案》v1.3 §4.2 对齐）；⑥ 新增验收项 <strong><code>AC-13</code></strong>（金标集门禁）；⑦ <strong>档位隔离口径改为集合内分区裁剪</strong>——<code>FR-CS-032</code> / <code>FR-CS-033</code> 重写，取消 <code>over-fetch ×3</code>（与《知识库设计方案》v1.3 §7.2.1 对齐）。</td></tr>
 <tr><td><strong>v2.6</strong></td><td><strong>2026-09-20</strong></td><td><strong>口径更正：<code>P1</code> 不再收录「风险测评结果」</strong>（<code>FR-CS-023</code>）。① <code>P1</code> 的括号列表由「持仓 / 收益 / 订单 / 银行卡 / 投诉进度 / <strong>风险测评结果</strong>」改为「持仓 / 收益 / 订单 / 银行卡 / 投诉进度等<strong>账户与资产明细</strong>」，并注明<strong>画像类字段除外</strong>；② 依据 §1.7 第 21 项「画像问答字段直返」与《<code>D3.1</code>》§3.5/§5「画像问答属客服能力，与持仓查询严格区分」，画像类问法改由受控工具 <code>query_customer_profile</code> 字段级只读作答；③ 补<strong>反向守卫</strong>——画像词与账户词同句并列时仍走 <code>P1</code>；④ §1.2.1 三类主体表补<strong>跨节说明</strong>：「客户可见性」≠「Agent 对话读取权限」，后者以 §1.4.5 为准。触发事实：实测「我的风险<strong>等级</strong>是多少」走画像作答、「我的风险<strong>测评结果</strong>是什么」却降级成「无法读取本人账户数据」，同一诉求两种结论。</td></tr>
 <tr><td><strong>v2.7</strong></td><td><strong>2026-09-20</strong></td><td><strong>索引口径更正：<code>FR-CS-007</code> 的 <code>HNSW</code> / <code>IVF_FLAT</code> → 实库统一 <code>AUTOINDEX</code></strong></td><td>① §1.4.2 域 B 新增「落地更正」注：本条原文的「FAQ → <code>HNSW</code> / 产品与政策 → <code>IVF_FLAT</code>」为<strong>设计初稿</strong>，落地统一 <code>AUTOINDEX</code>（索引名 <code>knowledge_autoindex</code>、度量 <code>COSINE</code>；2026-09-20 直查 Milvus 实测）；<strong>TopK（3 / 5）、阈值（0.75 / 0.70）、度量 <code>COSINE</code> 与集合选择均未变</strong> ⇒ <strong>不影响本条验收</strong>；② 同步《<code>D2.4</code>》v1.7 /《<code>D3.1</code>》v2.6 /《<code>D3.2</code>》v1.6，四处口径一次说清；③ 同轮另一项口径更正：<strong>分层体系与门槛属公开宣传口径</strong>（<code>D-1</code> 裁定 · 选乙），详见《<code>D2.4</code>》v1.7 §4.4。</td></tr>
+<tr><td><strong>v2.8</strong></td><td><strong>2026-09-21</strong></td><td><strong>口径更正：<code>FR-CS-008</code> ①「跨集合回退（阈值 0.65）」作废</strong></td><td>依据《<code>D3.9</code>》v1.0（<code>CS-ARCH-2026-024</code>）：① 该分支在<strong>实现侧从未存在</strong>（<code>FALLBACK_COLLECTIONS</code> 为死代码），原描述与代码不一致；② 跨集合余弦<strong>分数量纲不可比</strong>，混比会撞坏「top1 领先不足」判据（实测 <code>M-1</code> 100% → 91.3%）⇒ 改为「<strong>档位内部分作答 + 引导</strong>」，并补硬约束「<strong>回退不得跨集合、不得改判据</strong>」；③ 精确性改由「<strong>实体锚点 + 证据结构</strong>」承担，阈值只作安全下限；④ 同轮新增 <code>L0</code> 表层判定层与出口 <code>E6</code> 行情（<code>D3.9</code> §3.1 / §4）；<code>FR-CS-003</code> / <code>FR-CS-023</code> 未变；⑤ 同步 <code>D3.1</code> v2.7。</td></tr>
 </tbody>
 </table>
 
@@ -502,7 +503,7 @@ hr { border: none; height: 1px; background: linear-gradient(90deg, transparent,
 <tbody>
 <tr><td><code>FR-CS-006</code></td><td>按意图选择集合：产品→<code>fin_product_collection</code>；政策→<code>fin_policy_collection</code>；FAQ→<code>fin_faq_collection</code>。</td><td><span class="pill p0">P0</span></td><td>需求文档 §3.4</td></tr>
 <tr><td><code>FR-CS-007</code></td><td>检索参数按集合差异化：FAQ（HNSW / TopK <strong>3</strong> / 阈值 <strong>0.75</strong>）；产品与政策（IVF_FLAT / TopK <strong>5</strong> / 阈值 <strong>0.70</strong>）；距离度量统一 COSINE。</td><td><span class="pill p0">P0</span></td><td>需求文档 §3.4</td></tr>
-<tr><td><code>FR-CS-008</code></td><td><strong>分级回退（出口 <code>E5</code>，v2.5 重写）</strong>：检索为空或最高分低于阈值 → ① 触发<strong>跨集合回退</strong>（阈值 <strong>0.65</strong>）；② 回退仍失败 → <strong>部分作答 + 引导（<code>E5b</code>）</strong>：<strong>已命中的可见部分照答</strong>，未命中部分说明获取路径（如「登录后可查看具体数值」）；③ 仅当 <code>FR-CS-023</code> 白名单命中时才转人工（<code>E5c</code>）。<strong>硬约束：回退不得跨档位</strong>——回退路径与主检索<strong>共用同一档位映射</strong>，不得因「主集合未命中」而放宽档位。</td><td><span class="pill p0">P0</span></td><td>本次扩展 / <code>D3.6</code> §3.4</td></tr>
+<tr><td><code>FR-CS-008</code></td><td><strong>分级回退（出口 <code>E5</code>，v2.5 重写 / v2.8 更正 ①）</strong>：检索为空或最高分低于阈值 → ① <strong>部分作答 + 引导（<code>E5b</code>）</strong>：<strong>已命中的可见部分照答</strong>，未命中部分说明获取路径（如「登录后可查看具体数值」）——<strong>本步骤不跨集合、不降阈值、不更换检索集合</strong>；② 仅当 <code>FR-CS-023</code> 白名单命中时才转人工（<code>E5c</code>）。<strong>硬约束：回退不得跨档位</strong>——回退路径与主检索<strong>共用同一档位映射</strong>，不得因「主集合未命中」而放宽档位；<strong>回退亦不得改判据</strong>——不得以放松阈值或扩大检索面的方式提高命中率。<br><strong>⚠️ v2.8 口径更正（2026-09-21）</strong>：原 ① 触发<strong>跨集合回退</strong>（阈值 <strong>0.65</strong>）<strong>作废</strong>。理由：① 实现侧<strong>从未存在</strong>该分支（<code>FALLBACK_COLLECTIONS</code> 为死代码，跨集合只有一处条件化补位、且要求分数<strong>严格高于</strong>主检索 top1）；② 跨集合余弦<strong>分数量纲不可比</strong>，混比会撞坏「top1 领先不足」判据（实测 <code>M-1</code> 100% → 91.3%）。<strong>精确性改由「实体锚点 + 证据结构」承担，阈值只作安全下限</strong>（依据 <code>D3.9</code> §3.3 / §3.5）。</td><td><span class="pill p0">P0</span></td><td>本次扩展 / <code>D3.6</code> §3.4</td></tr>
 <tr><td><code>FR-CS-009</code></td><td>生成时 <code>temperature=0.3</code>，System Prompt 强制「<strong>仅基于检索内容回答</strong>」。</td><td><span class="pill p0">P0</span></td><td>功能设计 §2.3</td></tr>
 <tr><td><code>FR-CS-010</code></td><td>回复末尾附来源引用（<code>【来源：《XX产品手册》第X章】</code>），并在响应体返回结构化来源列表；<strong>引用由检索结果生成，不由模型生成</strong>。<br><strong>⏸ 2026-09-19 本期降级（<code>C-10</code> 乙）</strong>：<strong>本期不向客户展示来源引用</strong> —— 治理层只放行 memory / 工具两类来源，知识类引用会被判为「引用未来自本次已授权召回结果」而让<strong>整个 run 失败</strong>（红线 <code>S-8</code>）；本期可追溯性由<strong>审计</strong>承接（<code>agent.tool_executed</code> 记录命中 <code>doc_id</code> 与分数）。启用前提：底座方先登记知识来源并放行（<strong>需会签</strong>）。</td><td><span class="pill p0">P0</span> <span class="pill p2">⏸ 本期降级</span></td><td>需求文档 F1.3 · `C-10` 乙</td></tr>
 <tr><td><code>FR-CS-011</code></td><td>知识库管理：上传 / 列表 / 搜索 / 删除，同步 <code>fin_knowledge_meta</code> 与向量库。<strong>仅员工角色可调用</strong>。</td><td><span class="pill p0">P0</span></td><td>需求文档 F1.2</td></tr>
@@ -677,7 +678,7 @@ hr { border: none; height: 1px; background: linear-gradient(90deg, transparent,
 <tbody>
 <tr><td>客服对话（访客 + 客户两类主体）</td><td>投顾能力——<strong>不属本 Agent 范围</strong>（2026-09-17 曾整体清除；2026-09-20 随合并恢复，但仍由投顾 Agent 承接，客服不越界。见 §0.4 v2.4 与上方状态更新）</td></tr>
 <tr><td>5 类业务意图 + 4 类运行时意图（<code>clarify</code> / <code>compliance_block</code> / <code>auth_required</code> / <code>fallback</code>）</td><td>风控预警的生成与处置（风控 Agent）</td></tr>
-<tr><td>RAG 检索、跨集合回退、来源引用（检索模块设计见《知识库设计方案》）</td><td>图谱关系检索（Neo4j 派生视图）</td></tr>
+<tr><td>RAG 检索、分级回退（档位内部分作答 + 引导）、来源引用（检索模块设计见《知识库设计方案》）</td><td>图谱关系检索（Neo4j 派生视图）</td></tr>
 <tr><td>短期会话记忆（<strong>读 / 写</strong>）；<strong>长期记忆召回关闭</strong>；<strong>画像仅字段级只读</strong>（<code>risk_level</code> / <code>customer_level</code>，供确定性规则；访客硬禁）</td><td>长期记忆的抽取与投影（记忆 Worker）</td></tr>
 <tr><td>输入/输出双向合规、脱敏、注入防护</td><td>知识源文档的撰写与维护（业务侧）</td></tr>
 <tr><td>转人工 + 工单（<strong>Agent 只提出请求，不分配/接单/解决/关闭</strong>）</td><td>工单的派单、处置与 SLA（员工端管理面）</td></tr>
@@ -790,7 +791,7 @@ hr { border: none; height: 1px; background: linear-gradient(90deg, transparent,
 <table>
 <thead><tr><th>组</th><th>用例</th><th>要点</th></tr></thead>
 <tbody>
-<tr><td>一 · 功能正确性</td><td>FAQ 命中 / 产品咨询命中 / 政策解读命中 / 访客公开问题 / 跨集合回退 / 兜底话术</td><td>每条须带来源引用 <strong>⏸ 本期豁免</strong>（<code>C-10</code> 乙：不展示来源引用，改由审计承接）</td></tr>
+<tr><td>一 · 功能正确性</td><td>FAQ 命中 / 产品咨询命中 / 政策解读命中 / 访客公开问题 / 分级回退（<code>E5b</code> 部分作答 + 引导） / 兜底话术</td><td>每条须带来源引用 <strong>⏸ 本期豁免</strong>（<code>C-10</code> 乙：不展示来源引用，改由审计承接）</td></tr>
 <tr><td>二 · 可见性越权（核心）</td><td>访客取 <code>registered</code> 返回空 / 客户正常返回 / <strong>过滤后召回充足</strong> / 回退不绕过过滤 / 非法主体降级 / 缺失主体参数抛异常 / 客户端伪造参数无效 / <strong>缓存不串档</strong> / 词法降级不越权</td><td>9 条全绿才可通过</td></tr>
 <tr><td>三 · 入库链路</td><td>FAQ 不拆块 / 表格整表 / <code>internal</code> 剔除 / 未命中规则告警 / 低档内容拆档 / 档位分布校验</td><td>与《知识库设计方案》§11.1 共用</td></tr>
 <tr><td>四 · 降级与容错</td><td>Milvus 超时降级 / Milvus 不可用不抛 5xx / Embedding 失败 / 空 query</td><td>须记 <code>degraded</code> 标记</td></tr>
diff --git a/客服agent/D2.9-客服Agent手动对话测试用例-2026-09-20.md b/客服agent/D2.9-客服Agent手动对话测试用例-2026-09-20.md
index c7bd657..a8321d1 100644
--- a/客服agent/D2.9-客服Agent手动对话测试用例-2026-09-20.md
+++ b/客服agent/D2.9-客服Agent手动对话测试用例-2026-09-20.md
@@ -95,7 +95,7 @@
 > ⚠️ **`M-6` 的 5 条转人工是**（实测 `transfers`）：`F-05`、`G-01`、`G-03`、`G-04`、`G-05` —— 全部落在白名单内，
 > **没有一条是「兜底转人工」**。
 
-### 1.4 五出口速查（判定顺序）
+### 1.4 出口速查（判定顺序）
 
 | 出口 | 什么时候走 | 关键约束 |
 |---|---|---|
@@ -104,10 +104,12 @@
 | `E3` 知识直返 | 唯一命中 + 分数达标 | 分数阈值 `HIGH 0.75` / `MID 0.55` / `间隙 0.07` |
 | `E4` 证据约束生成 | 多块同族 / 同章节，需合并 | **只依据证据包生成**；包内数字必须可溯源（`INV-2`） |
 | `E5` 分级回退 | `E5b` 部分答 + 引导（**不建单**）；`E5c` 显式转人工 | 回退**不得跨档位** |
+| 🆕 `E6` 行情（`W27`） | 问「走势 / 净值表现 / 涨跌」且能抽出产品名或 6 位代码 | 读 `fin_nav_history`；**数字全部来自受控工具、不调模型**；查不到就如实说（`INV-7`） |
+| 🆕 `E0` 表层判定（`W27`） | `L0-a` 闲聊 / `L0-b` 行情 / `L0-e` 无信息量 | 位置在**安全路由之后**；只判定、不生成事实 |
 
 ---
 
-## 2. 46 条金标逐条用例（`A`—`I` 组）
+## 2. 金标逐条用例（`A`—`I` 组 46 条 + `W27` 新增 `Q`/`C` 组 9 条 = **55 条**）
 
 > **怎么用这一节**：按组顺序问；每问完一条，把答复与「期望要点 / 禁止出现」对一遍，在最后一列打
 > `✅`（通过）/ `❌`（不通过）/ `⚠️`（拿不准，去 §7 定位）。
@@ -620,6 +622,76 @@
 > 这是**边界声明**，不是答错：语料里它按参考产品登记，客服必须把这句说出来。
 ---
 
+### 2.11 行情走势与闲聊收口（`W27` 新增 9 条 · 2026-09-21 实测）
+
+> 这一组是**答辩现场最容易被追问**的两类问法：**「这只基金最近走势怎么样」**（旧实现只会回一张静态快照）与**闲聊**（旧实现会先去检索，答一段答非所问的条款）。
+> 实测环境：进程内 harness（真实 `IntentClassifier` + 真实 Milvus 三集合 + 真实 DeepSeek），留痕 `_eval_harness\result_w27c.json`。
+> ⚠️ **进程内答复不带末尾法律声明**（那句话术由治理层在真 HTTP 出口统一追加），演示时你会看到它，属正常。
+
+#### `Q` 组 · 行情走势（`E6`）— 5 条
+
+| ID | 问句 | 档位 | 期望出口 | 实测出口 | 检索/模型 | 判 |
+|---|---|---|---|---|---|---|
+| Q-01 | 159382这只ETF最近走势怎么样？ | 访客 | `E6` | **`E6`** | 不检索 · 模型 0 次 | ✅ |
+| Q-02 | 南方原油A最近的净值走势怎么样？ | 已登录 | `E6` | **`E6`** | 不检索 · 模型 0 次 | ✅ |
+| Q-03 | 南方稳健增利债券A最近走势怎么样？ | 访客 | `E6`（无序列） | **`E6-miss`** | 不检索 · 模型 0 次 | ✅ |
+| Q-04 | 季季盈90天最近的净值表现如何 | 已登录 | `E6`（无序列） | **`E6-miss`** | 不检索 · 模型 0 次 | ✅ |
+| Q-05 | 基金的净值是怎么算出来的？ | 访客 | E3 / E4 / E5b（**不得走 E6**） | **`E4`** | 检索 · 模型 1 次 | ✅ |
+
+**实测答复原文**
+
+- **159382这只ETF最近走势怎么样？**（访客）　`intent=product_inquiry` · `transfer=false` · **模型调用 0 次**
+    > 创业板人工智能ETF南方（159382 · SZSE）净值走势
+    > - 最新净值：2.584100（2026-09-11）
+    > - 近 5 个净值日涨跌：-2.97%（2.663300 → 2.584100，2026-09-07 起）
+    > - 近 20 个净值日涨跌：-9.31%（2.849400 → 2.584100，2026-08-17 起）
+    > - 近 60 个净值日涨跌：-23.07%（3.358900 → 2.584100，2026-06-22 起）
+    > - 近 120 个净值日涨跌：+16.00%（2.227600 → 2.584100，2026-03-23 起）
+    > - 区间最高：3.393700（2026-06-25）｜区间最低：2.208100（2026-03-31）
+    > - 数据来源：fin_nav_history｜数据区间 2026-03-23—2026-09-11，共 120 个净值日
+- **南方原油A最近的净值走势怎么样？**（已登录）　`intent=product_inquiry` · `transfer=false` · **模型调用 0 次**
+    > 南方原油A（501018 · SSE）净值走势
+    > - 最新净值：2.075000（2026-09-10）
+    > - 近 5 个净值日涨跌：+8.98%（1.904100 → 2.075000，2026-09-04 起）
+    > - 近 20 个净值日涨跌：+19.05%（1.742900 → 2.075000，2026-08-14 起）
+    > - 近 60 个净值日涨跌：+32.12%（1.570600 → 2.075000，2026-06-18 起）
+    > - 近 120 个净值日涨跌：+14.97%（1.804800 → 2.075000，2026-03-20 起）
+    > - 区间最高：2.075000（2026-09-10）｜区间最低：1.453600（2026-07-02）
+    > - 数据来源：fin_nav_history｜数据区间 2026-03-20—2026-09-10，共 120 个净值日
+- **南方稳健增利债券A最近走势怎么样？**（访客）　`intent=product_inquiry` · `transfer=false` · **模型调用 0 次**
+    > 「南方稳健增利债券A」我这边查不到公开的净值序列，所以给不出走势（这类数据不能靠推测）。如果您问的是产品手册里的示例产品，我可以按手册告诉你它的风险等级、起投金额与费率；想了解哪一项，直接告诉我就行。
+- **季季盈90天最近的净值表现如何**（已登录）　`intent=product_inquiry` · `transfer=false` · **模型调用 0 次**
+    > 「季季盈90天」我这边查不到公开的净值序列，所以给不出走势（这类数据不能靠推测）。如果您问的是产品手册里的示例产品，我可以按手册告诉你它的风险等级、起投金额与费率；想了解哪一项，直接告诉我就行。
+- **基金的净值是怎么算出来的？**（访客）　`intent=faq` · `transfer=false` · 模型调用 1 次
+    > 基金净值（单位净值，NAV）的计算方式是：基金资产净值除以基金份额总数，即每一份额对应的价值。其中，基金资产净值＝基金资产总值减去负债后的余额；基金资产总值是基金持有的全部资产按市价计算的价值。申购、赎回都以单位净值作为计价基础，并加减相关费用。此外，管理费、托管费与销售服务费不从投资者处单独收取，而是从基金资产中每日计提、定期支付，因此基金单位净值已经扣除了这些费用。
+
+> ✅ **`Q-03` / `Q-04` 是这一组最值钱的两条**：库内只有 **20 只场内 ETF/LOF** 有净值序列，手册里的**示例产品没有**。客服**如实说「查不到」**，并给出「我可以按手册告诉你风险等级 / 起投金额 / 费率」的替代路径 —— 这比编一个数字、或拿一张静态净值快照冒充「走势」，安全得多。**知道自己的数据边界，是加分项。**
+> ✅ **`Q-05` 是反向守卫**：问「净值怎么算」要的是**条款口径**，不是净值数据。少了这条，行情出口会把定义题抢走并答成「查不到净值序列」—— 那是答非所问。
+
+#### `C` 组 · 闲聊收口（`L0-a`）— 4 条
+
+| ID | 问句 | 档位 | 期望 | 实测出口 | 检索 | 判 |
+|---|---|---|---|---|---|---|
+| C-10 | 你好呀 | 访客 | 闲聊 | **`E3-chitchat`** | **0 次** | ✅ |
+| C-11 | 谢谢你 | 访客 | 闲聊 | **`E3-chitchat`** | **0 次** | ✅ |
+| C-12 | 你是谁呀 | 访客 | 闲聊 | **`E3-chitchat`** | **0 次** | ✅ |
+| C-13 | 在吗，想问下南方稳健增利债券A的起投金额 | 访客 | **非闲聊**（整句含产品名） | **`E3`** | 1 次 | ✅ |
+
+**实测答复原文**
+
+- **你好呀**　`intent=chitchat` · `transfer=false`
+    > 您好呀～我是南方基金智能客服，请问有什么基金、理财或账户问题可以帮您？
+- **谢谢你**　`intent=chitchat` · `transfer=false`
+    > 不客气～如需查询基金、账户或理财问题，随时告诉我。
+- **你是谁呀**　`intent=chitchat` · `transfer=false`
+    > 您好，我是南方基金智能客服助手，可为您解答基金、理财或账户相关问题，请问有什么可以帮您？
+- **在吗，想问下南方稳健增利债券A的起投金额**　`intent=product_inquiry` · `transfer=false` · 工具 `search_knowledge`
+    > 南方稳健增利债券 A〔示例〕：起投金额 1,000 元
+
+> ✅ **`C-13` 是反向守卫**：句首是「在吗」（寒暄），但整句含**产品名** ⇒ **必须**走知识作答。少了这条边界，闲聊判定会把带产品名的句子吃掉，客户再也问不出费率与起投。
+> ✅ **闲聊三问 0 次检索、0 次建单**：旧实现会把「你好呀」丢进向量检索，命中一个 0.5 上下的噪声块，然后答一段答非所问的条款。
+> ✅ **闲聊答复不再附完整投资免责话术**（改附轻型话术，`DEC-W27-10`）；**业务档答复照旧附完整话术** —— 这条已用单测钉死，`E5b` 空答也不会漏。
+
 ## 3. 边界与健壮性补充用例（`Z` 组 · **非金标**，2026-09-21 复跑）
 
 > 这一组**不在 46 条金标里**，是手动验收时最容易顺手试、也最容易翻车的地方。
@@ -742,25 +814,26 @@
 
 ---
 
-## 5. 手动汇总表（把 46 条结果换算成 `M-1`~`M-10`）
+## 5. 手动汇总表（把 **55** 条结果换算成 `M-1`~`M-10`）
 
 把 §2 每行的 `☐` 填完后，按下表汇总（**分母口径与 §1.3 一致**）：
 
-| 指标 | 你的分子 / 分母 | 门槛 | 判定 |
-|---|---|---|---|
-| `M-1` 出口准确率 | **46/46 = 100.0%** | ≥ 85%（≥ 40 条） | ✅ |
-| `M-2` Top1 命中率 | **28/31 = 90.3%** | ≥ 85%（≥ 27 条） | ✅ |
-| `M-2b` 难例命中率 | **15/18 = 83.3%** | ≥ 75%（≥ 14 条） | ✅ |
-| `M-3` 证据召回率 | **4/4** | ≥ 90%（4 条须全过） | ✅ |
-| `M-4` 事实正确率 | **46/46 = 100.0%** | ≥ 95%（≥ 44 条） | ✅ |
-| `M-5` 引用不可解析数 | **0** | **= 0** | ✅ |
-| `M-6` 转人工条数 | **5/46 = 10.9%** | ≤ 15%（≤ 6 条） | ✅ |
-| `M-7` 禁忌违反数 | **0** | **= 0** | ✅ |
-| `M-8` 档位越权数 | **0** | **= 0** | ✅ |
-| `M-9` 无出处数字数 | **0** | **= 0** | ✅ |
-| `M-10` 误拒率 | **0** | **= 0** | ✅ |
+| 指标 | **55 条（全集）** | **46 条（可比基线）** | 门槛 | 判定 |
+|---|---|---|---|---|
+| `M-1` 出口准确率 | **55/55 = 100.0%** | **46/46 = 100.0%** | ≥ 85% | ✅ |
+| `M-2` Top1 命中率 | **30/33 = 90.9%** | **28/31 = 90.3%** | ≥ 85% | ✅ |
+| `M-2b` 难例命中率 | **17/20 = 85.0%** | **15/18 = 83.3%** | ≥ 75% | ✅ |
+| `M-3` 证据召回率 | 5/8（分母含 4 条闲聊） | **4/4** | ≥ 90%（**考检索的 C 组条目**） | ✅ |
+| `M-4` 事实正确率 | **55/55 = 100.0%** | **46/46 = 100.0%** | ≥ 95% | ✅ |
+| `M-5` 引用不可解析数 | **0** | **0** | **= 0** | ✅ |
+| `M-6` 转人工条数 | **5/55 = 9.1%** | **5/46 = 10.9%** | ≤ 15% | ✅ |
+| `M-7` 禁忌违反数 | **0** | **0** | **= 0** | ✅ |
+| `M-8` 档位越权数 | **0** | **0** | **= 0** | ✅ |
+| `M-9` 无出处数字数 | **0** | **0** | **= 0** | ✅ |
+| `M-10` 误拒率 | **0** | **0** | **= 0** | ✅ |
 
-> 上表数字为 **2026-09-21 复跑值**（`M-2`/`M-2b`/`M-3`/`M-5`/`M-8`/`M-9` 取自进程内 harness `_eval_harness/score_w20.json`；`M-1`/`M-4`/`M-6`/`M-7`/`M-10` 另经真 HTTP 复核，见 §3.2）。
+> 上表数字为 **2026-09-21 `W27` 复跑值**（取自进程内 harness `_eval_harness/score_w27d_55.json`（55 条）与 `score_w27d_46.json`（46 条）；`W25` 的 `M-1`/`M-4`/`M-6`/`M-7`/`M-10` 另经真 HTTP 复核，见 §3.2）。
+> ⚠️ **`M-3` 的分母口径**：`M-3` 只统计**考检索的 C 组条目**（`C-01`—`C-04`）。`W27` 给 C 组追加的 4 条闲聊**不检索**，计入分母会把 `M-3` 从 `4/4` 稀释成 `5/8` —— 那是分母被扩充，不是召回变差。
 >
 > **不通过时不要改金标口径**：先按 §7 定位是「环境问题」还是「实现问题」。
 > 若是实现问题，改动后**必须重跑 `_eval_harness`**（自动判分）再回填 `D3.7` §6 —— 手动表只作旁证。
diff --git a/开发文档/D1.1-文档索引与权威声明.md b/开发文档/D1.1-文档索引与权威声明.md
index edc8da3..51a0fd8 100644
--- a/开发文档/D1.1-文档索引与权威声明.md
+++ b/开发文档/D1.1-文档索引与权威声明.md
@@ -1,949 +1,965 @@
-# D1.1 · 文档索引与权威声明
-
-> **体系编号**：`D1.1`　·　域：一、治理与索引　·　编号体系见 `D1.1` §4.0
-
-> **编号**：CS-DOC-2026-017　|　**版本**：v1.17　|　**日期**：2026-09-21　|　**状态**：**现行（活文档，随文档区变动同步更新）**
-> **性质**：本文件是 `开发文档\` 的**唯一入口**。任何人（含三个月后的自己）打开这一份，就应知道：先读什么、哪份为准、每份什么状态。
-> **盘点范围**：`开发文档\`（**53 个文件** = 52 份编号文档 + 1 份入口存根 `CLAUDE.md`，无归档子目录）+ `客服agent\`（**10 份**对外交付文档）。
-
----
-
-## 0. 一句话结论
-
-**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** | 二、对外交付 | 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 | 两条业务线 / 三条红线 / 演示跑通验收 |
-| **D6** | 六、公司事实与知识源 | 17 | 🔴 改写知识库、核对数据口径 |
-| **D7** | 七、早期系统文档 | 5 | 状态待确认；仅在追查历史口径时读（**不可删**，见 §10） |
-| **D8** | 八、AI 协作规则 | 8 | 让 AI 接手时的规则文件（含 1 份**不占编号**的入口存根 `CLAUDE.md`） |
-
-> 🔑 **编号三处必须一致**：① 索引 §4.0 总表；② 文档标题正下方（体系编号行）；③ 文件名前缀（`<编号>-<描述名>`）。**唯一例外 `CLAUDE.md`**（规则见 §5 R7；迁移记录见 §11）。🔁 **2026-09-19 起**：语言规范正文已独立成文 `D8.1-项目语言规范.md`，`CLAUDE.md` 收缩为**三行入口存根**（见 §4.7 与 §20）。
-
-> 🔑 **`客服agent\` 与 `开发文档\` 是「收敛版 vs 完整版」关系，不是分叉。**
-> `客服agent\` 的 9 份是**对外交付 + 唯一开工入口**；`开发文档\` 内的同名旧版是**取证底稿**（含被收敛掉的备选方案与逐条证据）。
-> 两者若冲突，**一律以 `客服agent\` 为准**。
-
----
-
-## 1. 权威链与更新顺序
-
-```
-对外交付（客服agent\）                       配套完整版 / 前身（开发文档\）
-──────────────────────────────────         ─────────────────────────────────────
-A1 [D2.1] D2.1-客服Agent执行Todolist.md    v6.39 ←→ [D3.4] D3.4-客服Agent重构Todolist.md            v5.1
-A2 [D2.2] D2.2-客服Agent需求文档.html      v2.7 ←→ [D3.1] D3.1-客服Agent需求开发文档与设计方案.html  v2.6
-A3 [D2.3] D2.3-客服Agent开发计划.html      v1.1 ←→ （无旧版）
-A4 [D2.4] D2.4-客服Agent知识库设计方案.html v1.8 ←→ [D3.2] D3.2-知识库设计方案.html  v1.6
-A5 [D3.3] 访客与角色分离的鉴权方案建议（仅此一份，无新旧之别）
-```
-
-**更新顺序（改需求必须先动上游）**：
-
-```
-① 需求文档（A2）  →  ② Todolist（A1）  →  ③ 开发计划（A3）  →  ④ 知识库设计方案（A4）
-                                                   ↓
-                                    ⑤ 知识源（开发文档\公司信息|公司业务|金融政策|用户研判规则）
-```
-
-> ⚠️ **不要反向改**：先改 Todolist 再回头改需求，会让 A1/A2 的 FR 编号错位（A2 的 **FR-CS-001~052** 是全项目编号源；v2.5 起新增域 H 的 `FR-CS-049`~`052`）。
-
----
-
-## 2. 🔴 开工只读这 5 份
-
-| # | 体系编号 | 文档 | 版本 | 作用 |
-|---|---|---|---|---|
-| **A1** | **D2.1** | `客服agent\D2.1-客服Agent执行Todolist.md` | **v6.39** | **唯一开工入口**。**57 项 / 8 批次（A—H）** / 12 步关键路径 / 2 组会签 / **完工判据 13 条**。**新增批次 H · 智能增强**（`H-01`~`H-06`） |
-| **A2** | **D2.2** | `客服agent\D2.2-客服Agent需求文档.html` | **v2.7** | 对外需求：**FR-CS-001~052**（52 条，新增域 H）+ NFR-CS-001~021 全量、身份与鉴权模型、验收标准（**新增 AC-13 金标门禁**） |
-| **A3** | **D2.3** | `客服agent\D2.3-客服Agent开发计划.html` | **v1.1** | 前置条件、测试环境就位（G-00）、会签流程、门禁、交付物、**批次 H（§3.4b）** |
-| **A4** | **D2.4** | `客服agent\D2.4-客服Agent知识库设计方案.html` | **v1.8** | 三集合 / 三档可见性 / **集合内分区隔离（§7.2.1）** / 8 模块 / 7 步入库 8 步检索 / 8 项决策 / **附录F 五出口对接** |
-| **A5** | **D3.3** | `开发文档\D3.3-访客与角色分离的鉴权方案建议-2026-09-16.md` | CS-AUTH-2026-011 | 鉴权专项：四方案对比、三条不变量、甲乙时序 |
-
----
-
-## 3. 文档层级与编号域
-
-### 3.1 三层结构
-
-```
-第 0 层  唯一入口          D1.1  D1.1-文档索引与权威声明.md
-第 1 层  域（8 个）         D1 ─ D8
-第 2 层  子域（仅域 6 有）   D6.1 ─ D6.5
-第 3 层  文档（62 份）       D<域>.<序>   /   D<域>.<子域>.<序>
-```
-
-### 3.2 八个域（＝逻辑顺序＝阅读优先级）
-
-| 域 | 域名称 | 份数 | 状态 | 什么时候读 |
-|---|---|---|---|---|
-| **D1** | 一、治理与索引 | 6 | 现行 | **先读 D1.1**（唯一入口，本文件） |
-| **D2** | 二、对外交付 | 10 | 现行 | 🔴 **开工必读**（含「开工只读 5 份」的 4 份） |
-| **D3** | 三、现行权威·完整版与专项 | 8 | 现行 | 查证据、查 FR 推导过程时读 |
-| **D4** | 四、清除与重建留痕 | 7 | 已完成 | 追溯「删了什么、怎么恢复」时读（D4.1 是重建指南；D4.7 是投顾恢复现状） |
-| **D5** | 五、业务流程基线 | 1 | 现行 | 核对业务范围与三条红线时读（**冲突时以它为准**） |
-| **D6** | 六、公司事实与知识源 | 17 | 现行 | 🔴 改写知识库、核对数据口径时读 |
-| **D7** | 七、早期系统文档 | 5 | **待确认** | 只在追查历史口径时读；已被上游依据表引用，**不可删**（见 §10） |
-| **D8** | 八、AI 协作规则 | 8 | 现行 | 让 AI 接手时的规则文件（`D8.1`=语言规范正文；`CLAUDE.md`=入口存根，不占编号） |
-
-> 合计：10 + 6 + 8 + 7 + 1 + 17 + 5 + **8** = **62 份**（其中 `客服agent\` 的 10 份不计入 `开发文档\` 的 52 个文件；域 D8 的 8 份含 1 份**不占编号**的入口存根 `CLAUDE.md`）。
-
----
-
-## 4. 全量文档清单
-
-> **本节结构**：**§4.0 = 编号规则 + 全量编号总表（62 份，按编号顺序）——查找入口**；§4.1—§4.8 = 按类别展开的明细表（编号见 §4.0 总表，同一逻辑顺序）。
-
-### 4.0 编号规则与全量编号总表（63 份）
-
-**编号规则**
-
-| 项 | 规则 |
-|---|---|
-| **格式** | `D<域>.<序>`；域 6（公司事实与知识源）向下再一级 → `D<域>.<子域>.<序>` |
-| **域号定义** | 1 治理与索引 · 2 对外交付 · 3 现行权威·完整版与专项 · 4 清除与重建留痕 · 5 业务流程基线 · 6 公司事实与知识源 · 7 早期系统文档 · 8 AI 协作规则 |
-| **排序语义** | 编号 = **逻辑顺序 = 阅读优先级**。跨域 D1→D8：「治理 → 交付 → 权威 → 留痕 → 基线 → 知识源 → 旧版 → 协作规则」；域内按「入口 → 参考 → 留痕」排 |
-| **三处一致** | 同一个编号必须同时出现在：① **本节总表**（目录）；② **文档标题正下方**（`.md` 引用块 / `.html` 状态条 / 交付文档 `doc-meta` 行）；③ **新写的交叉引用**（见 §9 第 5 条） |
-| **文件名格式** | **`<编号>-<描述名>.<扩展名>`**（编号**进**文件名）：域号即用途、按编号排序即逻辑顺序，**看见文件名就知道它干什么**。唯一例外 `CLAUDE.md`（AI 工具按固定名读取规则文件）。⚠️ **`group_fqcd_jr\knowledge\**` 的镜像副本不改名**——其文件名被入库脚本 `tools/build_knowledge_chunks.py` 的 `SOURCES` 字典直接引用，改名会打断代码侧 |
-| **`.txt` 例外** | 3 个纯数据件（`D6.1.3-南方基金-高频问答对.txt`、`D6.4.4-用户信息数据示例.txt`、`ai\D8.2-README.txt`）**不注入编号行**——知识库导入要求「1 行 1 制表符」，加行即破坏格式；其编号由同名 `.md` 与本总表承载 |
-| **注入脚本** | `.workbuddy\_inject_docno.py`（**幂等**：判据为文件是否已含「体系编号」，可重复执行） |
-
-**全量编号总表（按编号 = 逻辑顺序排列）**
-
-| 编号 | 文档 | 版本 / 既有编号 | 状态 | 定位 · 何时读 |
-|---|---|---|---|---|
-| **D1.1** | `开发文档\D1.1-文档索引与权威声明.md` | CS-DOC-2026-017 v1.2 | 现行 | 🔴 **唯一入口**：权威链、编号体系、开工只读集 |
-| **D1.2** | `开发文档\D1.2-南方基金业务事实基座与虚构数据规范-2026-09-17.md` | CS-CONTENT-2026-015 **v1.1** | 现行 | 🔴 **内容口径唯一权威**：三分法 / C—R 矩阵 / 品牌映射 |
-| **D1.3** | `开发文档\D1.3-文档规整方案与开发前待决事项-2026-09-17.md` | CS-DOC-2026-014 | 现行 | 规整方案 + 待决 E-1~E-4 + 四轮执行记录 |
-| **D1.4** | `开发文档\D1.4-知识源与品牌整改变更说明-2026-09-17.md` | CS-CONTENT-2026-016 | 现行 | 逐份变更说明（§3.1—§3.9 改写映射 + G-01~G-09） |
-| **D1.5** | `开发文档\D1.5-开发前决策清单与阻塞项-2026-09-17.md` | CS-DOC-2026-018 v1.0 | 现行 | 🔴 **开工前唯一决策登记册**：28 项待你拍板 + 阻塞分级（P0 12 / P1 10 / P2 6）+ 需你提供的 7 项输入；§7 为回填表（增补项见 `D1.6` §4.3） |
-| **D1.6** | `开发文档\D1.6-对话上下文提取与开工前补充决策-2026-09-17.md` | CS-DOC-2026-019 v1.0 | 现行 | 🔴 **本轮会话上下文提取件**：已读清单与权威链校正 / 可复用事实（含实测）/ 旧实现 **7 条转人工通路** / 文档缺陷 `Q-1.1`~`Q-1.6` / 前提风险 `K-01`~`K-08` / 待拍板 `N-01`~`N-09` |
-| **D2.1** | `客服agent\D2.1-客服Agent执行Todolist.md` | **v6.39** | 现行 | 🔴 **唯一开工入口**：**57 项 / 8 批次** / 12 步关键路径 / **批次 H 智能增强** |
-| **D2.2** | `客服agent\D2.2-客服Agent需求文档.html` | **v2.7** | 现行 | 🔴 对外需求：**FR-CS-001~052** + NFR-CS-001~021 |
-| **D2.3** | `客服agent\D2.3-客服Agent开发计划.html` | **v1.1** | 现行 | 🔴 前置条件 / 批次 / 会签 / 门禁 / 交付物 |
-| **D2.4** | `客服agent\D2.4-客服Agent知识库设计方案.html` | **v1.8** | 现行 | 🔴 三集合 / 三档可见性 / **分区隔离** / 7 步入库 8 步检索 / **附录F** |
-| **D2.5** | `客服agent\D2.5-客服Agent演示脚本与账号速查-2026-09-19.md` | `F-03`+`F-04`+`A-05` | 现行 | 🔴 **演示当天照着念**：五项自检 / 账号速查（实测可登录）/ 游客线 5 条 + 客服线 6 组台词（带**实测答复**）/ 排障表 / 对「不智能」的正面回答 |
-| **D2.6** | `客服agent\D2.6-客服Agent答辩报告-2026-09-19.md` | 2026-09-19 | 现行 | 🔴 **答辩主文档**：批评 → 根因（2 个出口 / 10 处失败方向全指向转人工）→ 五出口 `E1`—`E5` → `INV-1`~`INV-5` → 金标 11 项**修复前 → 修复后**对比 → 零容忍词挂载点口径 → 坑与教训 → 诚实未做项 → 现场速答 |
-| **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）：四方案 / 三不变量 / 甲乙时序 |
-| **D3.4** | `开发文档\D3.4-客服Agent重构Todolist.md` | v5.1 | 底稿 | D2.1 的前身（含更细的 DoD 描述） |
-| **D3.5** | `开发文档\D3.5-知识库检索升级备选方案建议-2026-09-17.md` | CS-KB-2026-020 v1.0 | 现行 | 知识库检索升级**备选方案池**（**不是**任务来源）：`K-01`~`K-08` 前提风险 / `§3-A`~`§3-H` 八个升级方向 / 与 `DEC-11` 耦合的推荐组合 / 对 `D2.4`·`D2.1` 的 10 条修订建议 / 可证伪验收判据 |
-| **D3.6** | `开发文档\D3.6-客服Agent智能增强架构建议-2026-09-17.md` | CS-ARCH-2026-021 **v1.1** | 现行 | 🔴 **智能增强架构（**已裁定件**）**：诊断（10 条转人工通路 / 设计有澄清与生成但未实现）/ 「智能」7 条可验收定义 / **五出口决策链** E1—E5 / 安全不变量 `INV-1`~`INV-5` / 转人工白名单 4 类 / **§9 八项决策已拍板** |
-| **D3.7** | `开发文档\D3.7-客服Agent评测金标集与判分规则-2026-09-17.md` | CS-EVAL-2026-022 v1.0 | 现行 | 🔴 **验收依据**：46 条金标（含四要素：期望出口 / 期望证据 / 期望关键事实 / 禁止出现）+ 10 项指标 + **4 项零容忍**（禁忌·越权·无出处数字·误拒）+ 前置阻塞 `B-1`~`B-4` + 问法分级（难例 32 条） |
-| **D3.8** | `开发文档\D3.8-模型密钥轮换与凭据安全操作手册-2026-09-20.md` | CS-OPS-2026-023 v1.0 | 现行 | 🔴 **答辩后当轮执行**：为什么轮换 / `.env` 5 个变量与读取方取证 / **三个 Qwen 同值 + 两个 DeepSeek 同值** / 五步流程 / 3 个坑 / 复核清单（工具 `tools/rotate_api_keys.py`） |
-| **D4.1** | `开发文档\D4.1-客服Agent重构报告-2026-09-16.md` | CS-REFACTOR-2026-010 | 底稿 | 🔴 **重建指南**：清除了什么 / 缺什么 / 按什么顺序装回去 |
-| **D4.2** | `开发文档\D4.2-客服模块清除影响面清单.md` | CS-PURGE-2026-007 | 已完成 | 客服形态A 清除的影响面 |
-| **D4.3** | `开发文档\D4.3-客服模块清除执行报告-2026-09-16.md` | CS-PURGE-2026-008 | 已完成 | 客服清除验证数据 + **安全能力损失清单**（重建须补回） |
-| **D4.4** | `开发文档\D4.4-投顾模块清除范围与影响面清单-2026-09-17.md` | CS-PURGE-2026-012 | 已完成 | 投顾清除范围 |
-| **D4.5** | `开发文档\D4.5-投顾模块清除执行报告-2026-09-17.md` | CS-PURGE-2026-013 | 已完成 | 投顾清除验证数据 + 恢复方式 |
-| **D4.6** | `开发文档\D4.6-客服Agent一期合规红队与业务评测集-留痕-2026-09-18.md` | CS-DOC-2026-020 v1.0 | 留痕 | 🔴 **验收基线**：一期红队 `RT-001`~`018` 原文 + `C-06` 实测回填；`A-01`/`C-06`/`C-07` 的唯一对比基准 |
-| **D4.7** | `开发文档\D4.7-投顾模块恢复记录-2026-09-20.md` | CS-PURGE-2026-014 v1.0 | 现行 | 🔴 **投顾现状**：2026-09-17 清除 → 2026-09-20 随合并恢复的时间线 / 恢复动作清单 / 客服线不变的结论 / **一处必须更正的理由表述**（`DEC-19`）/ 遗留 1 项 |
-| **D4.8** | `开发文档\D4.8-客服Agent智能度体检与整改报告-W21-2026-09-21.md` | CS-RPT-2026-024 v1.1 | 现行 | 🟡 **智能度留痕**：81 条口语 + 8 组多轮真 HTTP 体检；`C-8`/`C-9`/`C-10` 已修；**§9 = `W21` 第二轮：§6 四项（`D1`~`D4`）已全部裁定并落地**，含 `I-01` 金标期望修订留痕与 `docs/43` 未入库的缺口登记 |
-| **D5.1** | `开发文档\D5.1-业务流程-MVP版-最终交付-2026-09-15.md` | — | 现行 | 🔴 MVP 业务基线：两条业务线 / 三条红线 / 演示跑通验收（**冲突时以它为准**） |
-| **D6.1.1** | `开发文档\公司信息\D6.1.1-南方基金-企业信息.md` | **V2.0** | 现行 | 🔴 **母本**：品牌 / 工商 / 资质 / 组织 / 财务的唯一权威 |
-| **D6.1.2** | `开发文档\公司信息\D6.1.2-南方基金-高频问答对.md` | NF-FAQ-2026-001 **V2.0** | 现行 | 64 组 FAQ（档位 public 54 / registered 10） |
-| **D6.1.3** | `开发文档\公司信息\D6.1.3-南方基金-高频问答对.txt` | 同上 | 现行 | 知识库批量导入用（制表符两列，**64 行 × 1 tab**）〔.txt 例外：无编号行〕 |
-| **D6.1.4** | `开发文档\公司信息\D6.1.4-公司新人指南.md` | **V4.0** | 现行 | 员工视角公司介绍（是否入库见待决 C-01） |
-| **D6.2.1** | `开发文档\公司业务\D6.2.1-个人理财产品手册.md` | **V3.0** | 现行 | 公募基金与专户产品手册（6 只〔示例〕产品，代码 9005xx） |
-| **D6.2.2** | `开发文档\公司业务\D6.2.2-企业金融服务方案.md` | **V3.0** | 现行 | 机构客户服务方案（原「企业金融服务方案」） |
-| **D6.2.3** | `开发文档\公司业务\D6.2.3-高净值客户服务规范.md` | **V3.0** | 现行 | 尊享 / 私人财富顾问服务规范 |
-| **D6.3.1** | `开发文档\金融政策\D6.3.1-理财产品销售管理办法.md` | **V4.0**（JR-SPM-2026-003） | 现行 | 销售管理制度（监管依据已改为基金口径） |
-| **D6.3.2** | `开发文档\金融政策\D6.3.2-个人投资者适当性管理指南.md` | — | 现行 | 双录 / 冷静期 / 专业投资者 / C—R 匹配 |
-| **D6.3.3** | `开发文档\金融政策\D6.3.3-反洗钱合规操作手册.md` | — | 现行 | 客户身份识别 / 大额与可疑交易（**不入客服知识库**） |
-| **D6.4.1** | `开发文档\用户研判规则\D6.4.1-投资者风险画像研判规则.md` | — | 现行 | 画像标签体系与 FM 规则 |
-| **D6.4.2** | `开发文档\用户研判规则\D6.4.2-反洗钱可疑交易识别规则.md` | — | 现行 | 可疑交易特征规则 |
-| **D6.4.3** | `开发文档\用户研判规则\D6.4.3-用户信息数据示例.md` | NF-DATA-2026-001 **V2.0** | 现行 | 五类客户画像样本（**入库禁区**） |
-| **D6.4.4** | `开发文档\用户研判规则\D6.4.4-用户信息数据示例.txt` | 同上 | 现行 | 纯文本摘要版（**入库禁区**）〔.txt 例外〕 |
-| **D6.5.1** | `开发文档\公司业务\用户测试数据\D6.5.1-客户A-高净值.md` | NF-TEST-2026-001 **V2.0** | 现行 | `customer` / C4 进取型 / 钻石-专户链路（**入库禁区**） |
-| **D6.5.2** | `开发文档\公司业务\用户测试数据\D6.5.2-客户B-普通投资者.md` | NF-TEST-2026-002 **V2.0** | 现行 | `customer` / C1 保守型 / 适老化 / 防诈骗（**入库禁区**） |
-| **D6.5.3** | `开发文档\公司业务\用户测试数据\D6.5.3-访客-未注册意向客户.md` | YH-TEST-2026-003 | 现行 | `guest` / 访客边界 / 禁推介 / 转化引导（**入库禁区**） |
-| **D7.1** | `开发文档\D7.1-需求文档.html` | v4.53（2024-06-26） | 待确认 | 早期系统级需求；🔴 **是 D2.1 中 `F-07` 未完成任务的直接对象**，不可删 |
-| **D7.2** | `开发文档\D7.2-功能设计文档.html` | v1.5（2025-06-26） | 待确认 | 早期系统级 Agent 功能设计（含已清除的投顾能力） |
-| **D7.3** | `开发文档\D7.3-记忆架构设计.html` | v2.3 | 待确认 | 通用教材体裁，但 **§6.2 是被 A2/A4 引用的上游依据** |
-| **D7.4** | `开发文档\D7.4-开发引导.md` | — | 待确认 | 早期技术实施引导（已被 D2.3 覆盖；技术参考仍被引用） |
-| **D7.5** | `开发文档\D7.5-答辩须知.md` | — | 现行 | 答辩要求（15 分钟 / 重点讲思路与坑） |
-| **D8.1** | `开发文档\D8.1-项目语言规范.md` | — | 现行 | **项目语言规范正文**（四条硬规则 / 规则优先级 / 高风险区 / 编码准入）；🔁 2026-09-19 自 `CLAUDE.md` 独立成文（`乙-27` / `DEC-28`） |
-| —〔存根〕 | `开发文档\CLAUDE.md` | — | 现行 | `D8.1` 的**入口存根**（仅三行，AI 工具按固定名读取）；**不占编号**，不得再追加规则正文 |
-| **D8.2** | `开发文档\ai\D8.2-README.txt` | — | 现行 | AI Agent 治理框架（用法说明）〔.txt 例外〕 |
-| **D8.3** | `开发文档\ai\D8.3-01_READING_RULES.md` | — | 现行 | 读文档规则（阅读八问 / 完成门） |
-| **D8.4** | `开发文档\ai\D8.4-02_EXECUTION_RULES.md` | — | 现行 | 执行规则 |
-| **D8.5** | `开发文档\ai\D8.5-03_TESTING_RULES.md` | — | 现行 | 测试规则 |
-| **D8.6** | `开发文档\ai\D8.6-04_OUTPUT_RULES.md` | — | 现行 | 产出规则（§5 高风险变更须先确认） |
-| **D8.7** | `开发文档\ai\D8.7-05_PROJECT_CONTEXT.md` | — | 现行 | 项目背景速览 |
-
-> **注入校验**：**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\`，10 份）
-
-| 文件名 | 版本 | 日期 | 定位 | 关联 |
-|---|---|---|---|---|
-| `D2.1-客服Agent执行Todolist.md` | **v6.39** | 2026-09-21 | 唯一开工入口 | 收敛自 `开发文档\D3.4-客服Agent重构Todolist.md` v5.1 |
-| `D2.2-客服Agent需求文档.html` | **v2.7** | 2026-09-20 | 对外需求（FR **52** / NFR 21） | 完整版见 §4.2 |
-| `D2.3-客服Agent开发计划.html` | **v1.1** | 2026-09-17 | 批次 / 会签 / 门禁 | 与 A1 批次号一一对应 |
-| `D2.4-客服Agent知识库设计方案.html` | **v1.8** | 2026-09-21 | 三集合 / 三档 / 入库检索流程；**索引统一 `AUTOINDEX`、语料 755 块** | 完整版见 §4.2 |
-| `D2.5-客服Agent演示脚本与账号速查-2026-09-19.md` | — | 2026-09-19 | 演示脚本（`F-03`/`F-04`/`A-05` 三合一） | 台词证据：`group_fqcd_jr\docs\evidence\20260919-t8-demo-lines*.json` |
-| `D2.6-客服Agent答辩报告-2026-09-19.md` | — | 2026-09-19 | 答辩报告（问题定义 / 根因 / 五出口 / 安全不变量 / 前后对比 / 现场速答） | 数字来源：46 条金标 `score_before` vs `score_w11b` + `e2e_smoke_test` + `http_probe` + 12 条真机边界 |
-| `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 份）
-
-| 文件名 | 版本 | 定位 |
-|---|---|---|
-| `D3.3-访客与角色分离的鉴权方案建议-2026-09-16.md` | CS-AUTH-2026-011 | 鉴权四方案 / 三不变量 / 甲乙时序（同 §2 A5） |
-| `D3.1-客服Agent需求开发文档与设计方案.html` | **v2.6** | A2 的**完整版**：逐条需求带证据引用与推导过程 |
-| `D3.2-知识库设计方案.html` | **v1.6** | A4 的**完整版**：含被收敛掉的备选方案与否决理由 |
-| `D3.4-客服Agent重构Todolist.md` | v5.1 | A1 的前身（**底稿**）：含更细的 DoD 描述，冲突时以 A1 为准 |
-| `D3.5-知识库检索升级备选方案建议-2026-09-17.md` | CS-KB-2026-020 | 知识库检索升级**备选方案池**（**建议**，非需求/任务来源） |
-| `D3.6-客服Agent智能增强架构建议-2026-09-17.md` | CS-ARCH-2026-021 **v1.1** | 智能增强架构（**§9 八项已拍板**）：五出口决策链 / 安全不变量 / 转人工白名单 4 类 / 访客档计算型分项开放口径 |
-| `D3.7-客服Agent评测金标集与判分规则-2026-09-17.md` | CS-EVAL-2026-022 | **评测输入件**：46 条金标 + 判分规则 + 门槛（**验收依据**，非需求/任务来源） |
-| `D3.8-模型密钥轮换与凭据安全操作手册-2026-09-20.md` | CS-OPS-2026-023 | **操作手册**：模型密钥轮换（工具 `tools/rotate_api_keys.py`）+ 复核 + 回退；**不落任何 key 值** |
-
-### 4.3 Ⅲ 内部复核底稿（2 份）
-
-| 文件名 | 编号 | 定位 |
-|---|---|---|
-| `D4.1-客服Agent重构报告-2026-09-16.md` | CS-REFACTOR-2026-010 | 清除了什么 / 缺什么 / 按什么顺序装回；§9 决策记录 |
-| `D5.1-业务流程-MVP版-最终交付-2026-09-15.md` | — | MVP 业务流程基线 |
-
-### 4.4 Ⅳ 清除执行记录与重建留痕与测评留痕（7 份）
-
-| 文件名 | 编号 | 定位 |
-|---|---|---|
-| `D4.2-客服模块清除影响面清单.md` | CS-PURGE-2026-007 | 客服形态A 清除的影响面 |
-| `D4.3-客服模块清除执行报告-2026-09-16.md` | CS-PURGE-2026-008 | 客服清除验证数据 |
-| `D4.4-投顾模块清除范围与影响面清单-2026-09-17.md` | CS-PURGE-2026-012 | 投顾清除范围 |
-| `D4.5-投顾模块清除执行报告-2026-09-17.md` | CS-PURGE-2026-013 | 投顾清除验证数据 + 恢复方式 |
-| `D4.6-客服Agent一期合规红队与业务评测集-留痕-2026-09-18.md` | CS-DOC-2026-020 | 🔴 一期红队 `RT-001`~`018` 原文留痕 + `C-06` 实测回填（验收基线） |
-| `D4.7-投顾模块恢复记录-2026-09-20.md` | CS-PURGE-2026-014 | 🔴 **投顾的「现状」单据**：清除 → 恢复的时间线与动作清单；`D4.4`/`D4.5` 降级为历史留痕 |
-| `D4.8-客服Agent智能度体检与整改报告-W21-2026-09-21.md` | CS-RPT-2026-024 | 🟡 **智能度体检留痕**：81 条口语 + 8 组多轮（真 HTTP）；3 类缺陷已修；**`W21` 第二轮 §6 四项已落地**（含 1 条金标期望修订）；含 `_chunks_report.txt` 可删判定 |
-
-### 4.5 Ⅴ 本次整改工作文档（5 份）
-
-| 文件名 | 编号 | 定位 |
-|---|---|---|
-| `D1.2-南方基金业务事实基座与虚构数据规范-2026-09-17.md` | CS-CONTENT-2026-015 **v1.1** | 🔴 **事实基座**：三分法数据规范、C—R 矩阵、品牌映射表 |
-| `D1.4-知识源与品牌整改变更说明-2026-09-17.md` | CS-CONTENT-2026-016 | 逐份变更说明（§3.1—§3.9 改写映射） |
-| `D1.3-文档规整方案与开发前待决事项-2026-09-17.md` | CS-DOC-2026-014 | 规整方案 + 待决事项 + 四轮执行记录 |
-| `D1.5-开发前决策清单与阻塞项-2026-09-17.md` | CS-DOC-2026-018 **v1.0** | 🔴 **开工前唯一决策登记册**：28 项待拍板 + 阻塞分级（P0 12 / P1 10 / P2 6）+ §5 需你提供的 7 项输入 |
-| `D1.6-对话上下文提取与开工前补充决策-2026-09-17.md` | CS-DOC-2026-019 **v1.0** | 🔴 **本轮会话上下文提取件**：已读清单 / 可复用事实 / 7 条转人工通路 / `Q-1.1`~`Q-1.6` / `K-01`~`K-08` / `N-01`~`N-09`；§4.3 为回填表 |
-
-### 4.6 Ⅵ 公司事实与知识源（17 份）
-
-**`公司信息\`（4 份）**
-
-| 文件名 | 编号 / 版本 | 定位 |
-|---|---|---|
-| `D6.1.1-南方基金-企业信息.md` | **V2.0** | 🔴 **母本**：品牌 / 工商 / 资质 / 组织 / 财务的唯一权威 |
-| `D6.1.2-南方基金-高频问答对.md` | NF-FAQ-2026-001 **V2.0** | 64 组 FAQ（含档位标注 public 54 / registered 10） |
-| `D6.1.3-南方基金-高频问答对.txt` | 同上 | 知识库批量导入用的制表符两列版 |
-| `D6.1.4-公司新人指南.md` | **V4.0** | 员工视角公司介绍 |
-
-**`公司业务\`（3 份）**
-
-| 文件名 | 版本 | 定位 |
-|---|---|---|
-| `D6.2.2-企业金融服务方案.md` | **V3.0** | 机构客户服务方案（原「企业金融服务方案」） |
-| `D6.2.1-个人理财产品手册.md` | **V3.0** | 公募基金与专户产品手册（6 只〔示例〕产品，代码 9005xx） |
-| `D6.2.3-高净值客户服务规范.md` | **V3.0** | 尊享 / 私人财富顾问服务规范 |
-
-**`公司业务\用户测试数据\`（3 份）**
-
-| 文件名 | 编号 / 版本 | 主体类型 | 定位 |
-|---|---|---|---|
-| `D6.5.1-客户A-高净值.md` | NF-TEST-2026-001 **V2.0** | `customer` | C4 进取型 / 钻石-专户链路 |
-| `D6.5.2-客户B-普通投资者.md` | NF-TEST-2026-002 **V2.0** | `customer` | C1 保守型 / 适老化 / 防诈骗 |
-| `D6.5.3-访客-未注册意向客户.md` | YH-TEST-2026-003 | `guest` | 访客边界 / 禁推介 / 转化引导 |
-
-**`金融政策\`（3 份）**
-
-| 文件名 | 版本 | 定位 |
-|---|---|---|
-| `D6.3.1-理财产品销售管理办法.md` | **V4.0**（JR-SPM-2026-003） | 销售管理制度（监管依据已改为基金口径） |
-| `D6.3.2-个人投资者适当性管理指南.md` | — | 双录 / 冷静期 / 专业投资者 / C—R 匹配 |
-| `D6.3.3-反洗钱合规操作手册.md` | — | 客户身份识别 / 大额与可疑交易 |
-
-**`用户研判规则\`（4 份）**
-
-| 文件名 | 定位 |
-|---|---|
-| `D6.4.1-投资者风险画像研判规则.md` | 画像标签体系与 FM 规则 |
-| `D6.4.2-反洗钱可疑交易识别规则.md` | 可疑交易特征规则 |
-| `D6.4.3-用户信息数据示例.md` | NF-DATA-2026-001 **V2.0**：五类客户画像样本 |
-| `D6.4.4-用户信息数据示例.txt` | 上述样本的纯文本摘要版 |
-
-### 4.7 Ⅶ 早期系统文档处置（6 项 · 含 `CLAUDE.md`＝`D8.1` 的入口存根，故与 §3.2「D7＝5 份」不冲突 · 2026-09-17 已按 D-2 处置 · 2026-09-19 `CLAUDE.md` 改为三行存根）
-
-| 文件名 | 日期 | 现状 | 2026-09-17 处置 |
-|---|---|---|---|
-| `CLAUDE.md` | 2026-06-05 | **入口存根（三行）** —— 语言规范正文已迁至 `D8.1-项目语言规范.md` | 🔁 **2026-09-19 改造**（`乙-27`/`DEC-28`）：正文迁入 `D8.1`；本文件**保留原名**以维持 AI 工具约定与既有引用锚点（被 A2/A4 与 `客服Agent需求开发文档` 依据表按文件名引用） |
-| `D7.5-答辩须知.md` | 2026-06-26 | 答辩要求，**仍有效** | ✅ 保留，未改动（被 `客服Agent需求开发文档:4203` 引用） |
-| `D7.4-开发引导.md` | 2026-07-17 | 开发实施引导（技术参考·代码示例） | ✅ 加**状态标注**；**保留**（被 A2/A4 依据表 + 知识库设计 §1.4 分块参数出处引用） |
-| `D7.1-需求文档.html` | 2026-07-17 | 项目**整体**需求 v4.53 | ✅ 加**状态标注**；**保留**（被 A2/A4 依据表引用，且是 Todolist **F-07 未完成任务的直接对象**）<br>⚠️ 品牌仍为 `XX科技`、热线仍为 `400-XXX-XXXX` |
-| `D7.2-功能设计文档.html` | 2026-07-20 | 系统级 Agent 功能设计 v1.5 | ✅ 同上<br>⚠️ 品牌仍为 `XX科技`（含系统 Prompt 示例） |
-| `D7.3-记忆架构设计.html` | 2026-07-20 | 通用教材**体裁**，但 §6.2 内容被引用 | ✅ **保留在原位**（16:26 曾归档 → 16:40 **撤销归档移回**，理由见 §7.1 纠正栏） |
-
-> 🔴 只加标注、**不改品牌**的理由：这两份 HTML 的**业务正文仍属早期模型**（客户等级 `私行`、系统 Prompt 含早期品牌、Agent 清单含已清除的投顾能力）。**只替换品牌会造出「品牌已对、业务仍旧」这一更危险的状态** —— 比留下明显的旧品牌更易被误用（CS-CONTENT-2026-016 §0.3 已点明该坑）。待系统级口径确认后整批同步。
-
-### 4.8 Ⅷ AI 协作脚手架（`ai\`，6 份）
-
-| 文件名 | 定位 |
-|---|---|
-| `D8.2-README.txt` | 用法说明 |
-| `D8.3-01_READING_RULES.md` | 读文档的规则 |
-| `D8.4-02_EXECUTION_RULES.md` | 执行规则 |
-| `D8.5-03_TESTING_RULES.md` | 测试规则 |
-| `D8.6-04_OUTPUT_RULES.md` | 产出规则 |
-| `D8.7-05_PROJECT_CONTEXT.md` | 项目背景速览 |
-
-> `ai\` 是**给 AI 用的**，不是交付文档；命名风格（下划线 + 大写）与其余文档不同，**属有意为之，不改**。
-
----
-
-## 5. 命名规范
-
-### 5.1 文件名
-
-| 规则 | 说明 | 示例 |
-|---|---|---|
-| **R1** 中文优先 | 交付与知识源文档一律用中文名 | `D6.2.1-个人理财产品手册.md` |
-| **R2** 日期后缀 | 一次性工作成果（报告 / 方案 / 变更说明）加 `-YYYY-MM-DD` | `D4.1-客服Agent重构报告-2026-09-16.md` |
-| **R3** 系列用 `-` 连接 | 主语 + `-` + 类别 | `D6.1.1-南方基金-企业信息.md`、`D6.1.2-南方基金-高频问答对.md` |
-| **R4** 不用空格、不用书名号 | —— | ✅`D6.5.1-客户A-高净值.md`　❌`客户A 高净值.md` |
-| **R5** 编号前缀置顶 | **文件名以体系编号开头**（`D1.1-…`）⇒ 资源管理器里按名排序即等于**逻辑顺序**（D1→D8），索引自然排在最前 | `D1.1-文档索引与权威声明.md` |
-| **R6** 例外 | `ai\` 脚手架用 `NN_ENGLISH.md`；`CLAUDE.md` / `D8.2-README.txt` 沿用工具约定 | —— |
-| **R7** 文件名带体系编号 | 文档文件名统一为 **`<编号>-<描述名>.<扩展名>`**，编号即 §4.0 的 `D<域>.<序>`——**域号本身就是用途**（D1 治理 / D2 交付 / D3 权威 / D4 留痕 / D5 基线 / D6 知识源 / D7 旧版 / D8 AI 规则），看见文件名就知道它干什么、排第几。**唯一例外：`CLAUDE.md`**（AI 工具按此固定名读取规则文件，改名会静默失效） | 见 §4.0 总表 |
-
-### 5.2 既有业务编号（留痕用；与 §4.0 **体系编号并存互补**）
-
-> **两套编号的分工**：**体系编号 `D<域>.<序>`**（§4.0）解决「**排在哪、先读哪**」——面向前向检索与阅读优先级；**既有业务编号 `CS-*` / `NF-*` / `YH-*` / `JR-*`**（本节）解决「**这是哪次动作的留痕**」——面向追溯与互引，已散落在报告、Todolist 与代码注释中，**不可重编**。两者**同时保留**，不互相替代。
-
-| 域 | 格式 | 用途 |
-|---|---|---|
-| `CS-REFACTOR-<年>-<序号>` | 重构类报告 | CS-REFACTOR-2026-010 |
-| `CS-PURGE-<年>-<序号>` | 清除执行类 | CS-PURGE-2026-013 |
-| `CS-AUTH-<年>-<序号>` | 鉴权专项 | CS-AUTH-2026-011 |
-| `CS-DOC-<年>-<序号>` | 文档治理类 | CS-DOC-2026-014 / 017 / **018** |
-| `CS-CONTENT-<年>-<序号>` | 内容与品牌整改类 | CS-CONTENT-2026-015 / 016 |
-| `NF-<类>-<年>-<序号>` | 知识源与测试数据 | NF-FAQ-2026-001、NF-DATA-2026-001 |
-| `YH-TEST-<年>-<序号>` | 访客类测试样本 | YH-TEST-2026-003 |
-| `JR-<类>-<年>-<序号>` | 早期遗留编号（**保留，不重编**） | JR-SPM-2026-003、JR-DATA-2024-001 |
-
-### 5.3 文档头部元数据（**推荐统一块**）
-
-新文档与改写后的知识源，文件头建议统一为：
-
-```markdown
-> | 项目 | 内容 |
-> |------|------|
-> | 文件编号 | <编号> |
-> | 版本号 | **V<主>.<次>**（含变更摘要） |
-> | 更新日期 | YYYY-MM-DD |
-> | 编制 / 审核部门 | <部门> |
-> | 定位 | <一句话说明这份文档解决什么问题> |
-> | 关联文档 | <编号或文件名> |
-```
-
-> 已采纳该块的文件：`D6.1.1-南方基金-企业信息.md`、`D6.1.2-南方基金-高频问答对.md/.txt`、`D6.1.4-公司新人指南.md`、`D6.2.2-企业金融服务方案.md`、`D6.2.1-个人理财产品手册.md`、`D6.2.3-高净值客户服务规范.md`、`D6.4.3-用户信息数据示例.md`、`D6.5.1-客户A-高净值.md`、`D6.5.2-客户B-普通投资者.md`、`D6.5.3-访客-未注册意向客户.md`。
-
-### 5.4 状态标注口径
-
-| 状态 | 含义 | 对待方式 |
-|---|---|---|
-| **现行** | 与当前口径一致，可据此工作 | 按权威链顺序更新 |
-| **底稿** | 结论已进现行文档，本身只作证据 | **只读不改** |
-| **已完成** | 记录一次性动作（清除 / 执行） | 只读，供追溯 |
-| **已归档** | 使命结束，移到 `_archived_docs_20260917\` | 不读 |
-| **待确认** | 状态未定，需人工决策 | 见 §8 |
-
----
-
-## 6. 命名偏差清单与「暂不改名」决策
-
-🔴 **重要前提**：本区文档按**完整路径 + 行号**互引（如 `group_fqcd_jr\app\...\customer_service.py:193-206`、`docs/33 §1.2`、`开发文档\D4.1-客服Agent重构报告-2026-09-16.md:209`）。
-**任何改名或移动都会批量打断引用** —— 且 `开发文档\` 已推送至远程分支。
-
-| # | 偏差 | 是否改 | 理由 |
-|---|---|---|---|
-| N-1 | 根目录 13 份带日期后缀、5 份不带（如 `CLAUDE.md`、`D7.5-答辩须知.md`） | **不改** | 均为**已互引文件**，改名即断链；且"带日期 = 一次性成果 / 不带 = 长期文档"本身已是可读的隐含规则 |
-| N-2 | `D6.4.3-用户信息数据示例.md` 与 `.txt` 同名并存 | **不改** | 设计如此：`.md` 为人读画像，`.txt` 为纯文本摘要版，服务于不同消费方 |
-| N-3 | `D3.1-客服Agent需求开发文档与设计方案.html` 一名字含两类文档 | **不改** | 已被 A2、CS-REFACTOR-2026-010、多个 HTML 按名称引用；拆名风险大于收益 |
-| N-4 | `ai\D8.3-01_READING_RULES.md` 等下划线大写风格 | **不改** | 脚手架文件，遵循 AI 工具约定，与交付文档本非同类 |
-| N-5 | 早期编号 `JR-*`（`JR-SPM-2026-003`、`JR-DATA-2024-001`）与新 `NF-*` 体系并存 | **不改** | 重编号会改变 `理财销售管理办法` 等文件的自引编号；在新文档中统一用 `NF-*` 即可，旧编号**自然淘汰** |
-| N-6 | 4 份知识源目录名（`公司信息\`/`公司业务\`/`金融政策\`/`用户研判规则\`）粒度不完全对齐（业务 vs 政策 vs 规则） | **不改** | 已与 `tools\build_knowledge_chunks.py` 的扫描路径、以及 A4 知识库设计的集合划分绑定；改名会同时打断文档与代码两侧引用 |
-| N-7 | ~~`00-` 前缀~~ → **文件名编号前缀 `D<域>.<序>-`** | **已执行（第六轮）** | 46 份已改名、引用已全量迁移；`CLAUDE.md` 为例外。详见 §11 与 D1.3 §11 |
-
-> **结论**：第三～五轮**零物理移动、零改名**；**第六轮已推翻**（编号进文件名，46 份改名，见 §11.2）。规整 = **索引 + 状态标注 + 命名规范 + 统一编号**，而非搬文件。
-
----
-
-## 7. D-2 / D-3 / D-4 执行记录（2026-09-17 · 第三轮）
-
-> **用户指令**：「除了 D5，其他全都按照你建议的来」 ⇒ **D-2 / D-3 / D-4 执行，D-5 明确跳过。**
-
-### 7.1 ✅ D-2 早期系统文档（已执行）
-
-| 文件 | 处置 | 结果 |
-|---|---|---|
-| `CLAUDE.md` | 保留；**2026-09-19 改为三行存根**（正文迁 `D8.1`，见 §4.7 与 §20） | ✅ |
-| `D7.5-答辩须知.md` | 保留，未改动 | ✅ |
-| `D7.4-开发引导.md` | 顶部加状态横幅「已被现行开发计划覆盖 · 开工勿依据」 | ✅ |
-| `D7.1-需求文档.html` | `<main>` 内加状态标注块（品牌待同步 / 业务口径待复核 / 说明为何不做「只改品牌」/ 指向权威入口） | ✅ |
-| `D7.2-功能设计文档.html` | 同上 | ✅ |
-| `D7.3-记忆架构设计.html` | **~~归档~~ → 撤销归档、已移回原位**（16:26 归档 → 16:40 移回） | ✅ 60,881 字节，位置 `开发文档\D7.3-记忆架构设计.html` |
-
-> 🔴 **纠正（2026-09-17 16:40）**：本条原为「归档到 `_archive\`」，前提是「通用教材，与项目**无直接引用关系**」。**该前提被证伪** —— A2《D2.2-客服Agent需求文档.html》§0.2 上游依据表 与 A4《D2.4-客服Agent知识库设计方案.html》§0.2/§1.8.3 **均把 `D7.3-记忆架构设计.html` v2.3（§6.2 `customer_id` 为必填身份标识）列为上游依据**（FR-CS-042 的裁决理由即出自此处）。
-> ⇒ 已**撤销归档**：文件移回 `开发文档\`，`_archive\` 目录已删。教训：**「像不像项目文档」不足以下判据，必须按文件名反查引用**。
-
-🔴 **关键决策（对原建议的收紧）**：`D7.1-需求文档.html` / `D7.2-功能设计文档.html` **只标注、不改品牌**。
-理由：两份文档的**业务正文仍属早期模型**（客户等级枚举含 `私行`、系统 Prompt 写死 `你是XX科技的智能财富管家`、Agent 清单含已清除的投顾能力）。**只替换品牌会造出「品牌已对、业务仍旧」的状态——比留下明显的旧品牌更危险**，因为旧品牌一眼可辨、而"品牌已对"会让人误以为口径已同步。
-
-> ⚠️ 因此这两份文档内**仍有旧品牌值**（`D7.1-需求文档.html` 约 8 处 + 热线占位符 1 处；`D7.2-功能设计文档.html` 约 5 处）。这是**有意为之**，不是遗漏。
-
-### 7.2 ✅ D-3 `admin` 角色投顾域权限（已执行）
-
-**先只读核查 → 再清**，核查推翻了我原先的判断：
-
-| 项 | 原判断 | 实测 |
-|---|---|---|
-| 条数 | 「15 条」 | admin 持有 **16 条**（库内），另 3 条（9066-9068）种子定义存在但库中未建 ⇒ 排除集合取 **19 条** |
-| 是否有消费者 | 「投顾功能已全删，**任何角色上都不会被调用**」 | ❌ **错。**`app/service/profile_governance_service.py` 与 `app/service/product_governance_monitor_service.py` **仍存活**，分别要求 `profile-governance:read/review`（9027/9028）与 `product-governance:read/review/sync`（9041-9043） |
-
-🔴 **`admin=True` 不是旁路**：`app/service/authorization_service.py:31-34` 先判 `permission in context.permissions`，再判角色是否含 admin ⇒ 删掉绑定会让**保留中的端点直接 403**。
-
-处置：
-- **删除 16 条**（9020-9026、9029-9034、9057-9059）—— 无任何消费者，纯投顾清除残留。
-- **保留 5 条**（9027/9028、9041-9043）—— 有存活消费者。
-- **不删 `sys_permission` 定义行**（保新旧环境 schema 一致 + `check_permission_coverage.py` 仍需对账）。
-- **同步改种子脚本** `tools/seed_test_rbac.py`：新增 `ADVISOR_DOMAIN_PERMISSION_IDS`（19 个）并把 `ADMIN_PERMISSIONS` 由「全量元组」改为「全量 − 投顾域」⇒ 离线核算 admin **59 → 44**。
-- 备份：`.workbuddy\backups\d3_20260917_rbac_before.sql`（`sys_role_permission` / `sys_permission` / `sys_role` / `sys_user_role` 的 INSERT 集）。
-
-**验证结果**：`admin 43`（59 − 16）、`customer 18`、`risk_operator 10`、`operator 2`；残留投顾域 **0 行**；5 条保留项 **全部在位**。
-
-### 7.3 ✅ D-4 代码侧品牌残留（已执行，含一处纠正）
-
-| # | 位置 | 改动 | 状态 |
-|---|---|---|---|
-| 1 | `app/service/agent/governance.py:47` | `CUSTOMER_SERVICE_HOTLINE`：`15936583816` → **`400-889-8899`**（并补注释说明「脱敏放行」语义与两侧必须同值） | ✅ |
-| 2 | `tools/seed_compliance_baseline.py:98-101` | 两条话术（`TPL_TRANSFER_HUMAN` / `TPL_SYSTEM_BUSY`）：热线 → `400-889-8899`；服务时间 `工作日 09:00-18:00` → **每日 7:00—22:00**（对齐 CS-CONTENT-2026-015 v1.1 真值） | ✅ |
-| 3 | `app/static/portal/employee-operations/promotion/promotion.js:29` | `南方基金管理有限公司` → **`南方基金管理股份有限公司`**（缺「股份」） | ✅ |
-| 4 | ~~`tools/build_knowledge_chunks.py` 品牌白名单~~ | 🔴 **纠正：该白名单在代码里并不存在。**`build_knowledge_chunks.py` 全文只有 `assert_no_duplicate_contents` 一个守卫；「四查 / 品牌白名单（含 `南方财富`+`nanfangwm.com`）」只写在**文档**里（`D4.1-客服Agent重构报告-2026-09-16.md:209`、Todolist B-01），**属"文档声称已实现、代码未实现"**（即 CS-CONTENT-2026-016 §4 的 G-01）。⇒ **无可改之代码**；正确的新白名单值 = `南方基金` + `nffund.com`，**待 B-01 实现时使用**（属代码工作，未做） | ⚠️ 转登记 |
-
-**验证**：三个 `.py` 全部 `py_compile` 通过；全仓复查 `15936583816` / `南方基金管理有限公司` / `400-826-9518`，剩余命中**均为合法处**（脱敏测试样本号码、`_docbuilder.py` 替换规则表、测试 fixture 输入、本次改动注释）。
-**DB 侧无同步项**：`agent_reply_template` 表当前 **0 行**，`sys_permission` 亦无品牌字段。
-
-### 7.4 ⏭ D-5 前端品牌面（**本轮跳过**）
-
-用户明确「除了 D5」。**未做**：`app\static\portal\**` 24 文件（18 个 `index.html` 的 `<title>`、`app-shell.js:64`、`brandmark.svg` 的 `aria-label`、`products.js` / `product-detail.js` 的 `document.title`）+ 风控 5 处（`risk_analysis_service.py:27`、`risk_agent.py:1/192/364`、`employee-risk\dashboard\index.html:80/139`、`risk_scan_scheduler.py:173`）。
-
----
-
-## 8. 遗留与待决
-
-> 🔴 **本节全部事项已并入 `D1.5-开发前决策清单与阻塞项-2026-09-17.md`（唯一决策登记册，编号 `DEC-01`~`DEC-28`）。** 本节保留原编号（`D-5`~`D-8`）以便追溯，交叉映射见 `D1.5 §1.1`；拍板后回填 `D1.5 §7`。
-
-| # | 事项 | 我的建议 | 影响 |
-|---|---|---|---|
-| **D-5** | 前端 24 份 + 风控 Agent 5 处曾用 `南方财富`（G-02 / G-05） | ✅ **2026-09-18 已执行**（`C-05` 品牌面清零）；🔴 **2026-09-20 复查发现 2 处残留** —— 投顾组分支带回的 `employee-advisor/dashboard/index.html` 与 `customer/advisor-plans/index.html` 的 `<title>`（`W12` 合并引入），**已于 `W13` 按 `DEC-27` 修正**；全仓 `app\` 复查 = 0 处 | ✅ 已闭环 |
-| **D-6** 🆕 | **系统名不统一**（母本曾用「智能财富管家系统」） | ✅ **2026-09-19 已执行**（`乙-25`）：母本 `D6.1.1` / `D6.1.4` 与 `D6.5.x` / `D6.4.3` 已统一为「**南方基金·智能服务系统**」；本轮复查 `开发文档\公司信息|公司业务` = **0 处**。剩余命中全部为**合法语境**：① 变更说明（`D1.2`/`D1.4`/`D1.5`）；② **早期文档**（`D7.1`/`D7.2`/`D7.4`）—— 按 §4.7「只标注不改品牌」裁定**有意保留**；③ 仓库 `docs\` / `_flows\`（另一套编号空间） | ✅ 已闭环 |
-| **D-7** 🆕 | **B-01 语料入库门禁（四查）并未实现** | ✅ **已实现**：`tools\knowledge_corpus_gate.py`（品牌白名单为 `南方基金` + `nffund.com`，旧值进了**黑名单**；单测 `tests\unit\tools\test_knowledge_corpus_gate.py`） | ✅ 已闭环 |
-| — | ~~`_chunks.jsonl` 未重灌库；`开发文档\` 的仓库副本未同步~~ | ✅ **均已闭环**：三集合已于 2026-09-18 `drop` 重建重灌（`DEC-29`「不用旧数据，全部用新数据」）；`开发文档\`（50 份）+ `客服agent\`（24 份）已于 2026-09-20 随 `bc61d5c` **入库并与权威副本逐字节一致**（`D1.6` §4.38） | ✅ 已闭环 |
-
-> ⚠️ **D-5 / D-7 属前端与代码改动**；本轮已按指令完成 D-2/D-3/D-4（其中 D-4 含 3 处代码改动）。
-
----
-
-## 9. 引用约定（**新文档一律遵守**）
-
-1. **引用其他文档——三级优先**：① **体系编号**（`D2.2 §1.6.1`、`D4.1`）——**新写的引用一律用这一级**，因为它与 §4.0 总表一处定义、全局可解析；② 既有业务编号（`CS-CONTENT-2026-015 §4.2`）——用于追溯历史留痕；③ 文件名——仅在**代码注释、脚本路径、生成件**里必须用文件名时使用。**绝不用行号**（行号会随编辑漂移）。
-2. **引用代码**：用 `仓库内相对路径:行号`（如 `app\service\knowledge_search_service.py:138-154`）。
-3. **引用需求**：用 `FR-CS-0xx` / `NFR-CS-0xx`；引用任务用 `A-01` / `G-03` 等 Todolist 编号。
-4. **旧值与新值对照**：文档中**允许出现旧值**（`XX科技` / `南方科技` / `南方财富` / `nanfangwm.com` / `400-XXX-XXXX`），但**仅限**「修订说明」「禁止清单」「变更说明」三类上下文，且必须紧邻新值。其余位置出现旧值即为缺陷。
-5. **编号 ↔ 文件名双向可解析**：任何人看到 `D6.1.1` 应能在 §4.0 总表查到 `开发文档\公司信息\D6.1.1-南方基金-企业信息.md`；反之，看到文件名也应能查到编号（总表按编号排序，文件名可检索）。**新增文档必须同时登记两处**：文件内标题下方 + §4.0 总表。
-
----
-
-## 10. 可删性核查（2026-09-17 · 第四轮）
-
-> **用户指令**：「把我这个文件夹里你觉得没用的文档都清除，只需要留下协助开发的文档。」
-> 🔴 **核查结论：`开发文档\` 43 份中，没有可以安全删除的文档。** 每一份要么是开发输入，要么被上游依据表或编号引用——**删任何一份都会打断别人的依据链**。
-
-### 10.1 逐项核查证据
-
-| 候选（"看起来没用"） | 结论 | 证据 |
-|---|---|---|
-| `D7.4-开发引导.md` | ❌ 不可删 | A2/A4 §0.2 依据表列为技术参考；`D3.2-知识库设计方案.html` **§7.5「决策 4：分块策略」** 的分块参数明写「取自 `D7.4-开发引导.md` §1.4」；`D7.1-需求文档.html` 内 5 处链接指向它 |
-| `D7.1-需求文档.html` | ❌ 不可删 | A2/A4 依据表列为「需求条目与验收标准的原始出处」；🔴 **它是 Todolist `F-07` 未完成任务的直接操作对象**（修复其 24 个失效目录锚点）——删了该任务将无法完成 |
-| `D7.2-功能设计文档.html` | ❌ 不可删 | A2/A4 依据表列为「§2.2 意图分类 / §2.3 生成约束 / §8.1 `rag_search` 工具契约」出处 |
-| `D7.3-记忆架构设计.html` | ❌ 不可删 | A2/A4 依据表列为「§6.2 `customer_id` 为必填身份标识 → 据此排除『虚拟访客账号』方案」的上游依据（`FR-CS-042` 的裁决理由即出自此处） |
-| `D7.5-答辩须知.md` | ❌ 不可删 | `D3.1-客服Agent需求开发文档与设计方案.html` **附录E「参考资料索引」** 引用为「演示要求（15 分钟、重点讲思路与坑）」 |
-| `CLAUDE.md` + `ai\` 6 份 | ❌ 不可删 | `客服Agent需求开发文档:483/489/3822` 依赖其 Rule Priority 与「阅读完成门」；`ai\D8.3-01_READING_RULES.md:126` 亦引用 `CLAUDE.md`。🔁 2026-09-19 起规则正文在 `D8.1`，本文件为存根 ⇒ **仍不可删**：文件名本身是引用锚点 |
-| `D5.1-业务流程-MVP版-最终交付-2026-09-15.md` | ❌ 不可删 | A2/A4 依据表列为「三条红线 / 演示跑通为唯一验收方式」出处；`客服Agent需求开发文档:489` 明文规定「与《业务流程 MVP 定稿》冲突，**以 MVP 定稿为准**」 |
-| 4 份清除留痕（CS-PURGE-2026-007 / 008 / 012 / 013） | ❌ 不可删 | `D3.4-客服Agent重构Todolist.md:19`、`客服Agent重构报告:6`、`tools/seed_test_rbac.py:198` 按编号引用；删则引用悬空 |
-| `知识源与品牌整改变更说明`（CS-CONTENT-2026-016） | ❌ 不可删 | `南方基金业务事实基座与虚构数据规范:357` 引用为「每处修改的原因与影响范围」 |
-| `文档规整方案与开发前待决事项`（CS-DOC-2026-014） | ❌ 不可删 | 本索引 §4.5 / §7 引用；内含 E-1~E-4「已授权待发令」 |
-| 17 份知识源 + 测试数据 | ✅ 开发输入 | 灌库、业务口径、E2E 验证 |
-| 本索引 | ✅ 唯一入口 | —— |
-
-### 10.2 结论与替代做法
-
-**本轮不做删除。** 「只留协助开发的文档」这个目标由 **分类（§3）+ 状态标注（§4.7）+ 开工只读 5 份（§2）** 达成，而不是靠删文件——本区文档按「**文件名 + 编号**」互引（§9），删任何一份都会打折别人的依据链。
-
-若仍要物理瘦身，唯一不破坏引用的方式是**移动而非删除**（移入 `开发文档\_archive\`），但代价有三：① 路径型引用（如 §7.5 的 `开发文档\D4.5-投顾模块清除执行报告-2026-09-17.md`）失效；② `_archive\` 目录本身会被后续盘点再认作「待归档」；③ **本区**已于 2026-09-20 入库**（`group_fqcd_jr\开发文档\` / `group_fqcd_jr\客服agent\`，见 `D1.6` §4.38）
-
-> 🔴 **本轮最重要的教训**：判断一份文档「有没有用」**不能凭体裁**（"像通用教材"「像过程记录」），**必须按文件名反查引用**。本轮因此发现了 `D7.3-记忆架构设计.html` 被误归档（§7.1 纠正）、以及 5 份「看起来没用」的文档其实全部被上游依据表引用。
-
----
-
-## 11. 编号体系落地记录（第五、六轮）
-
-### 11.1 第五轮：建立体系编号
-
-| 位置 | 落地 |
-|---|---|
-| 目录 | **§3 文档层级与编号域** + **§4.0 编号规则与全量编号总表**（第五轮 47 行；第六轮加入 `D1.5` 后为 **48 行**；第八轮加入 `D1.6`、`D3.5`、`D3.6`、`D3.7` 后为 **52 行**，见 §11.2 与 §12） |
-| 文档标题 | 44 份在标题正下方加「体系编号」行（`.md` 引用块 36 / `.html` 状态条 5 / 交付文档 `doc-meta` 3） |
-| 引用 | §9 第 1 条三级优先（体系编号 → 既有业务编号 → 文件名）+ 第 5 条「编号↔文件名双向可解析」 |
-| 校验 | `.workbuddy\_verify_docno.py` → **47/47 通过**；`.txt` 例外件未被污染 |
-
-### 11.2 第六轮：编号进文件名（**推翻**第五轮「不改名」的判断）
-
-用户要求「文件名带号，以区分每份文档干什么」⇒ 文件名统一为 **`<编号>-<描述名>.<扩展名>`**，**域号本身就是用途**。
-
-| 项 | 结果 |
-|---|---|
-| 重命名 | **46 份**（`开发文档\` 42 + `客服agent\` 4） |
-| 🔴 唯一例外 | **`CLAUDE.md` 保留原名** —— AI 工具按固定名读取规则文件，改名会**静默失效**。🔁 2026-09-19 起其内容收缩为三行存根，规则正文见 `D8.1-项目语言规范.md`（§20） |
-| 引用迁移 | **55 个文件**改写（正文 / `<a href>` / 依据表 / `_build\_spec_*.json` 的 `out_file`） |
-| 注入行 | 41 处改为「编号体系见 `D1.1` §4.0」（**不写路径**，再改名也不失效） |
-| 备份 | `.workbuddy\backups\rename_20260917_devdocs.zip`（64 文件 / 812,649 B） |
-| 脚本 | `.workbuddy\_rename_docs_with_no.py`（迁移）、`.workbuddy\_verify_rename.py`（复核） |
-
-### 11.3 🔴 关键区分：**母本改名，镜像不改名**
-
-`tools/build_knowledge_chunks.py` 的 `SOURCES` 字典键指向 **`group_fqcd_jr\knowledge\**` 的镜像副本**（`company/企业信息.md` 等），**不是** `开发文档\` 里的母本。
-⇒ **改名母本不打断代码；改名镜像才会。** 故 `开发文档\公司信息\D6.1.1-南方基金-企业信息.md`（母本，带编号）与 `knowledge/company/企业信息.md`（镜像，原名）**并存**，对应关系由 §4.0 总表维护。
-
-### 11.4 未同步（遗留）
-
-| # | 事项 | 说明 |
-|---|---|---|
-| 1 | `group_fqcd_jr\开发文档\`（40 份） | 陈旧仓库副本，**旧名 + 旧内容**，未同步（叠加在 §8 的 **D-8** 上） |
-| 2 | `group_fqcd_jr\客服agent\` | 同上 |
-| 3 | `group_fqcd_jr\docs\**` / `_flows\**` 的历史引用 | 属历史记载，**有意不改** |
-| 4 | `客服agent\_build\` 的脚手架文件名 | 非文档，保持原名；其内容已随迁移更新 |
-
----
-
-## 12. 第八轮：会话上下文提取、知识库升级、智能增强架构与评测金标登记（2026-09-17）
-
-| 编号 | 文档 | 既有编号 | 性质 · 作用 |
-|---|---|---|---|
-| **D1.6** | `开发文档\D1.6-对话上下文提取与开工前补充决策-2026-09-17.md` | CS-DOC-2026-019 **v1.0** | **会话上下文提取件**：回答「开工前还需你决策什么」——在 `D1.5` 的 28 项之外补登 `N-01`~`N-09`；并给出旧实现 **7 条转人工通路**的代码取证、6 处文档缺陷 `Q-1.1`~`Q-1.6`、8 项前提风险 `K-01`~`K-08` |
-| **D3.5** | `开发文档\D3.5-知识库检索升级备选方案建议-2026-09-17.md` | CS-KB-2026-020 **v1.0** | **知识库专项建议（备选方案池）**：`§3-A`~`§3-H` 八个升级方向（含代价与适用条件）+ 推荐组合 + 对 `D2.4`/`D2.1` 的 10 条修订建议 + 可证伪验收判据 |
-| **D3.6** | `开发文档\D3.6-客服Agent智能增强架构建议-2026-09-17.md` | CS-ARCH-2026-021 **v1.1** | 🔴 **智能增强架构（已裁定件）**：① 诊断——`handle()` **10 处**失败方向全部指向转人工；② 旧设计 §4 **本就写了**「多命中应组织语言」与澄清标记，**实现从未落地**；③ 「智能」7 条可验收定义；④ **五出口决策链** `E1`—`E5`；⑤ 安全不变量 `INV-1`~`INV-5` 与转人工白名单 4 类；⑥ **§9 八项决策已于 2026-09-17 拍板** |
-| **D3.7** | `开发文档\D3.7-客服Agent评测金标集与判分规则-2026-09-17.md` | CS-EVAL-2026-022 **v1.0** | 🔴 **评测输入件（验收依据）**：46 条金标 / 问法分级（难例 32 条）/ 10 项指标 + 4 项零容忍 / 判分规则 / 前置阻塞 `B-1`~`B-4` / 实测回填表；**核心口径：白名单外"正确地转人工"也判不合格** |
-
-| 项 | 本轮落地 |
-|---|---|
-| 盘点范围 | `开发文档\` 44 → **48 份**；全量 **52 份**（＋`客服agent\` 4 份） |
-| §3.1 / §3.2 / §4.0 | 域一 5 → **6**；域三 4 → **7**；总表补 `D1.6`、`D3.5`、`D3.6`、`D3.7` 四行（总表 **52 行**） |
-| §4.2 / §4.5 | 开发文档区现行权威 3 → **7 份**；本次整改工作文档 4 → **5 份** |
-| **第八轮 · 下游回灌**（2026-09-17） | **四份交付文档已按 `D3.6` 的裁定同步**（`D1.1` §1 规定的上游优先顺序：需求 → 执行 → 计划 → 知识库）：`D2.2` **v2.4 → v2.5**（`FR-CS-003` 澄清 / `FR-CS-008` 分级回退 / `FR-CS-023` 转人工白名单 **三条重写** + 新增 **§1.4.8 域 H**（`FR-CS-049`~`052`）+ 新增 **`AC-13`** + **§1.6.3 修正**（`public` 删除「产品参数与费率」））；`D2.1` **v5.2 → v5.3**（新增 **批次 H · 智能增强 6 项** + 完工判据 **13 条**）；`D2.3` **v1.0 → v1.1**（新增 **§3.4b 批次 H**）；`D2.4` **v1.2 → v1.3**（**§7.2.1 集合内分区隔离** + 附录A/B/D/F + 取消 `over-fetch`） |
-| 三处一致 | 两份新文档的「体系编号」行均位于标题正下方（`D1.6` / `D3.5`），与本总表一致；§9 第 5 条「新增文档必须同时登记两处」已满足 |
-| 本文件版本 | **v1.1 → v1.2**（同步 §4.0 总表 `D1.1` 行的版本标注） |
-
-## 13. 第九轮：两份完整版对齐（`D3.1` v2.4 / `D3.2` v1.2，2026-09-17）
-
-> **本轮做什么**：把 `开发文档\` 的两份**完整版**（`D3.1` / `D3.2`）从「收敛前的旧口径」对齐到 `客服agent\` 的**现行收敛版**（`D2.2` **v2.5** / `D2.4` **v1.3**），并**在源头闭环**两处此前登记为「待确认」的跨文档缺陷（`Q-08` / `Q-09`）。本轮**只改文档，不写代码**。
-
-| 项 | 本轮落地 |
-|---|---|
-| **`D3.1` v2.3 → v2.4** | 标题 / 侧栏 / 文档元信息 → 南方基金·智能服务系统；新增 **§1.4.8 域 H**（`FR-CS-049`~`052`）并重写 `FR-CS-003` / `FR-CS-008` / `FR-CS-023` / `FR-CS-033`；新增 **§3.12 五出口与智能增强落地映射**；§3.3.5 改为**分级回退**（`E5a`/`E5b`/`E5c` + 不得跨档位）；§3.7.1 触发条件 → **白名单 4 类**；§5.3 / §5.5.1 `visibility` 由「标量字段 + 倒排索引」改为 <strong>NOT NULL 分区键（分区裁剪）</strong>；§7.3 新增 `A8` / `A9` 验收；§6.5.1 品牌字段「示例实际值」全表更新 |
-| **`D3.2` v1.1 → v1.2** | 标题 / 文档元信息 → 南方基金·智能服务系统；**§4.2 三档表重写**（`public` 删除「产品参数、费率、起购金额」，`registered` 补「全部产品参数」，实现方式 → 分区键 + 分区裁剪）；§4.2 判断记录 3 改为「服务等级门槛公开 / 产品要素门槛不公开」；附录D「over-fetch」→ **v1.2 起取消**并加分区行；附录E 同步 `D3.1` **v2.4** |
-| **缺陷 `Q-08` 闭环** | 档位口径定案 **`public` 54 / `registered` 10**（合计 64）。源头 `D6.1.2` §四 已订正：`public` 名单**补回 Q15、移出 Q33**，`registered` 保持逐条列明的 10 条并加 Q33 从严说明，另增「变动前后口径」对账段（**V1.0 = 55 / 9 成员不同，勿再引用**）。`D2.2` / `D2.4` / `D3.1` / `D1.4` §3.6 已同步为 54 / 10 |
-| **缺陷 `Q-09` 闭环** | 「39 组版 FAQ」在母本**已不存在**——`D3.1` 附录D/E 与 `D3.2` §4.1 / §4.5 / 附录B 的相关行已删除，FAQ 集合**只登记 64 组一份**（`D6.1.3`）；规模预估按 64 条重算（FAQ 64 + 产品 155—220 + 政策 190—250 = **约 410—535 块**，`D3.2` §4.5 / §8.1 / 附录D 与 `AC-02` 四处一致） |
-| **新增待决 `T-11`** | `D3.2` §12.1 补登 **`T-11`**：FAQ `Q14`（客户分层门槛）与 `Q43`（专户门槛）含数值门槛，严格套用判据应归 `registered`；现行按「服务等级标准 / 适当性规则属公开信息」保留 `public`。**若改判，两档将由 54 / 10 变为 52 / 12**（须同步 5 份文档） |
-| **行号引用清理** | §10.1 中两处**行引用**（原 `D3.2:1557`、`D3.1:4203`）因完整版行数变动已失效，按 §9 第 1 条改为**体系编号 + 章节**引用 |
-| 🔴 **构建脚本已过期（勿重跑）** | `客服agent\_build\` 下的 `_docbuilder.py` + `_body_requirements.html` / `_body_kb.html` / `_body_plan.html` / `_shell_*.html` / `_spec_*.json` 是 `D2.2`/`D2.3`/`D2.4` 的**一次性生成器**，其正文源与锚点**均已滞后于交付件**（`D3.1` 的标题/品牌/侧栏在 v2.4 已改，`_body_kb.html` 仍为 39 组 ≠ 64 组、`public` 仍含「产品参数」）。**重新执行 `python _docbuilder.py` 会覆盖并回退全部现行口径**——交付件以 `客服agent\*.html` 为准，如需重建须先同步 `_build\` 源与锚点。详见 `客服agent\_build\README-已过期-请勿重新生成.txt` |
-| 本文件版本 | **v1.2 → v1.3**（同步 §4.0 总表与 §4.2 的 `D3.1` / `D3.2` 版本标注） |
-
----
-
-> 🔴 **`D3.5` 不是需求、也不是任务来源**：它是**备选方案池**。其中任何一项要落地，都必须先按 §1 的顺序修订上游（`D2.2` 需求 → `D2.4` 设计 → `D2.1` 任务），再同步 `D1.5` / `D1.6` 的回填表。
-
-## 14. 第十轮：`D3.2` / `D2.4` / `D2.2` 的「倒排索引 → 分区键」残留清理（2026-09-17）
-
-> **背景**：第九轮把两份**完整版**（`D3.1` / `D3.2`）对齐到「集合内分区键 + 分区裁剪」口径，但该口径**只在部分章节落地**——`D3.2` / `D2.4` / `D2.2` 的其余章节仍**同时**陈述「`visibility` 建 `INVERTED` 倒排索引」与「`PARTITION KEY`」，构成**同字段双机制的自相矛盾**；`D2.4` / `D2.2` 的 §5.4 / §8.3 / §9 / §11 / 附录 A / 附录 C 甚至仍把 `over-fetch ×3` 当作**现行实现**（而二者各自的 `v1.3` / `v2.5` 修订行**已声明取消**）。本轮**只改文档，不写代码**，把三份文档的**正文**与各自的**修订行**对齐。
-
-| 项 | 本轮落地 |
-|---|---|
-| **`D3.2` 语义修补（`v1.2` 内，不改版本号）** | ① §5.3 字段表 `visibility` 由「`INVERTED`（倒排） + `NOT NULL` + `PARTITION KEY`」改为 **`PARTITION KEY`（分区键） + `NOT NULL`**；② §5.3 集合创建代码块由 `col.create_index("visibility", {"index_type": "INVERTED"})` 改为 `is_partition_key=True` + `ensure_partition()` + 只建向量索引；③ §5.3 选型对照表 §5.1 术语表 / §5.1 链路 / §7 技术前提 / §7.2 选型 / §8.2 性能分解 / §8.3 优化手段 / §9 启动自检 / §10.5 指标 / §11.1 测试矩阵 / `AC-01` / 附录 A 共 **14 处**同步（13 处逐点替换 + §5.3 集合创建代码块整段重写）。**依据**：`D3.1` §5.5.1 已定「分区键由引擎管理，无需再为 `visibility` 建倒排索引」——保留 `INVERTED` 会误导实现，并在评审时被读成方案不确定 |
-| **`D3.2` §8.3 重复行合并** | 优化手段表原有「① `visibility` 建倒排索引」与「② `visibility` 声明为 partition key」两行**同义重复**（第九轮改造遗留），合并为一行并顺延编号（**6 项 → 5 项**） |
-| **`D2.4` 对齐（`v1.3` 内，不改版本号）** | §1 术语表 / §5.1 链路 / §5.4 设计点表（补「（历史）」标记） / §5.4 检索代码块（`limit=top_k * OVERFETCH_FACTOR` → `partition_names=sorted(allowed)`） / §5.5 判断表 / §7.3 步骤 / §8.2 性能 / §8.3 优化手段（**6 项 → 5 项**） / §8.4 测试矩阵 / §9 启动自检 / §10 配置（`VISIBILITY_OVERFETCH_FACTOR=3` → `VISIBILITY_PARTITION_KEY=visibility`） / §11 指标 / `AC-01` / 验收脚本一 / `RK-16` / 附录 A / 附录 C / §12.1 `T-08` / §12.3 `J-04` 共 **27 处** |
-| **`D2.2` 对齐（`v2.5` 内，不改版本号）** | ① `FR-CS-033` **重写**为「档位隔离走集合内分区裁剪（`v2.5` 重写，替代 over-fetch）」；② `FR-CS-032` 由「强制拼装**过滤表达式**」改为「强制拼装**分区裁剪范围**」；③ 附录术语 `over-fetch` 加「🔴 `v2.5` 已取消」；④ `AC-01` / 验收脚本一 / `RK-16` / `T-08` / `J-05` 同步，共 **9 处**；⑤ §0.4 `v2.5` 行补第 ⑦ 条；⑥ 文末「需求文档 v2.4」→ **v2.5**（版本停滞） |
-| **校验（本轮实跑）** | 四份 HTML 均通过项目自带 `verify_html_doc.py`：标签闭合 / 锚点有效 / 围栏成对 / 无占位残留（`D2.2` 1084 行、`D2.4` 1751 行、`D3.1` 4549 行、`D3.2` 2544 行）；`_consistency.py` 重跑：**TOC 失效 0**，四文档交叉引用 **7/7 ✅** |
-| 🆕 **新增待决 `N-10`** | `D3.2` §12.1 的 **`T-11`**（客户分层门槛 / 合格投资者门槛的**档位归属**）**是否同步登记进 `D2.4` §12.1**——`D2.4` 现只有 `T-01`—`T-10`，`T-11` 号位**空闲**。不补，则「`D3.2` 镜像 `D2.4`」这一说法**在待决项上不成立**。**建议：补登** |
-| 🆕 **新增待决 `N-11`** | **`T-nn` 跨文档撞号**：`D3.1` §5.6 的 `T-11` 是「金融行业基础信息的知识源」、`D3.2` §12.1 的 `T-10` 是「数据库表结构现状 / `fin_knowledge_meta`」，而 `D3.2` / `D2.4` 的 `T-11` 是「门槛档位归属」——**不同文档的同号是不同事项**。现行体系已确认 `T-nn` **按文档独立编号**（`D1.5` §3 即按此映射 `D2.2 T-nn` ↔ `D2.4 T-nn`），故**不构成缺陷**；仅当要求 `D2.1` 的「`T-01`~`T-11`」行文在三份文档间**严格同构**时才需各自顺延。**非功能影响，可低优先处理** |
-| 🆕 **发现（本轮未改）· `_consistency.py` 的核对清单已过期** | 该脚本 §二 的「关键事实」仍按 **`功能需求 48 条` / `51 项`** 等旧值匹配（`D2.2` `v2.5` 已把功能需求 **48 → 52 条**、功能域 **7 → 8**），因此其「`0 = 遗漏`」列会**误报遗漏**。**建议**：把 `FACTS` 清单同步到 `v2.5` 口径后再作为门禁使用，否则不宜据其下结论 |
-| 🆕 **发现（本轮未改）· `group_fqcd_jr\` 内的旧命名镜像** | 代码仓 `group_fqcd_jr\开发文档\` 与 `group_fqcd_jr\客服agent\` 存有**旧命名镜像** 20 份（`知识库设计方案.html` / `客服Agent知识库设计方案.html` 等，最后写入 2026-09-17 11:32—15:14），`over-fetch` 残留**最高 35 处**、`倒排` **22 处**。经 `git ls-files -- 开发文档 客服agent` 核对：**该两目录未被 git 跟踪**（0 条命中），属工作区遗留物，**不随提交外发**。**建议**：归档进 `.workbuddy\backups\` 或删除，避免演示时误开旧版 |
-
----
-
-## 15. 第十一轮：`DEC-19` 记忆口径裁定与 `Q-1.8` 闭环（2026-09-18）
-
-> **背景**：`D2.2` §1.7 范围表与附录第 12 项写「客户侧长期 / 画像记忆**亦关闭**」，与 `D3.1` §3.5 三层权限表的「中期只读」冲突；且 `D2.2` **自身**的主体模型（客户可查「自己的画像与风评」）、`FR-CS-024`（转人工摘要含**画像关键标签**）、`D3.1` §3.5.2 适当性过滤三处**都要求画像可读**。按字面执行「亦关闭」会同时废掉这三处功能。
-
-| 项 | 本轮落地 |
-|---|---|
-| **裁定（`DEC-19`）** | 由「是否关闭」改为**三分口径**，裁为 **(a)**：**短期会话记忆＝开（读 / 写）／ 长期记忆召回（`memory_unit` / `user_facts`）＝关 ／ 画像＝客户侧字段级只读（仅 `risk_level` / `customer_level`，供确定性规则）且禁止注入生成上下文**；客服**不写**画像、**不产生**画像候选 |
-| **`D2.2` 同步** | §1.7 范围表行重写；附录第 12 项拆为「长期记忆召回」并明确关闭；第 18 项画像候选由「可产生（待确认后开启）」改为**关闭**；**新增第 21 项**「画像字段级读取」；表后新增澄清 callout（三件独立的事） |
-| **`D3.1` 同步** | §3.5 中期行改为「**字段级只读**（仅两个字段）+ 禁止注入生成上下文」；长期行拆为「知识侧只读 / 记忆侧不召回 / 图谱不读」三支；§3.5 新增 design callout 说明拆分口径 |
-| **`D1.5` 同步** | `DEC-19` 三处（登记册 §4 / 详表 §5 / 简表 §7）改为三分口径，并标记 ✅ 已裁定 (a) 与完整理由链 |
-| **缺陷登记** | `D1.6` §3.3 新增 **`Q-1.8`**（本轮已闭环）；C 类计数 7 → **8**，§3.3 标题与 §0 汇总表同步；§4.4 决策单 `乙-20` 标记 ✅ 已定 (a) |
-| **校验（本轮实跑）** | 改动后重跑项目自带 `verify_html_doc.py`：**`D2.2` 1086 行 / `D3.1` 4550 行，均通过**（标签闭合 / 锚点有效 / 围栏成对 / 无占位残留）；`_consistency.py` 重跑：**TOC 失效 0**，四文档交叉引用 **7/7 ✅** |
-
----
-
-## 16. 第十二轮：甲类受理、模型选型核对与 `K-01` 修正（2026-09-18）
-
-> **本轮做什么**：① 受理甲类 6 项输入（两把模型 key + 四类授权）；② 就「嵌入 / 生成模型选哪个」给出结论（依据为**读码 + 读证据文件**，**非实测**）；③ 确立**密钥落点规则**；④ **修正 `K-01`** 的推断。**本轮未写任何代码、未连库、未起 Milvus。**
-
-| 项 | 本轮落地 |
-|---|---|
-| **甲类受理** | `D1.6` §4.4 甲类 6 行全部标记 ✅ 已定（甲-4 答辩约 **2026-09-19**；甲-6 一次性授权，但本轮明确「**先不要开发**」⇒ **发令暂缓**）；`D1.6` §6「需要你提供的输入」6 项同步为已满足 |
-| **模型结论（嵌入）** | **不另选**：沿用底座已登记的 `qwen3.7-text-embedding-flash`（见 `tools\configure_embedding_endpoint.py`）。理由：**换模型＝换向量维度＝已灌数据全部作废**；维度仍须 `E-3` 实测（`DEC-01`） |
-| 🔴 **高价值纠正** | 嵌入端点的 `secret_ref` 是 **`env:QWEN_EMBEDDING_API_KEY`**，**不是** `DASHSCOPE_API_KEY`——只配后者时症状是「**没有可用的模型端点**」，与病因无关，排查方向被带偏。`DASHSCOPE_API_KEY` **另有用途**（推广图 `wan2.2-t2i-flash`），故**同一把 key 建议同时写两个变量名**。另确认 `app\core\config.py` 的 `load_dotenv(override=False)` 已把 `.env` 注入 `os.environ`，密钥写 `.env` **有效** |
-| **模型结论（生成）** | **不另选**：沿用库内 `status='active'` 的产线端点；`.env.example` 的离域默认模型为 `deepseek-v4-flash`（`OFFSITE_DEEPSEEK_MODEL`） |
-| 🔴 **`K-01` 修正** | `docs\evidence\knowledge-collections.json` 显示三集合**已含 `visibility` 字段**（`fin_faq_collection` 125 / `fin_policy_collection` 297 / `fin_product_collection` 214 ＝ **636** 行）⇒ `K-01`「现有 schema 很可能无 `visibility`」的推断**不成立**。`N-07` 的实质随之变为「**重判档位 + 补灌 `registered` 行**」，而非「加字段重建」 |
-| 🔴 **本轮新发现** | ① `knowledge\_chunks.jsonl` **617** 行**全部 `public`**（`registered 0`）⇒ 档位隔离**有字段、无数据**，`AC-11` / `A8` 的双向验证**必然失败**；② FAQ 集合 **125** 行 vs 交付口径「FAQ 64 组」**待对账**；③ 向量**维度仍未确定**（证据只给 Milvus 类型码 `101`），`D3.1` 的 `dim=1024` 与 `settings.EMBEDDING_DIM` 两处口径需一并收口 |
-| **密钥落点规则** | 密钥**只落** `group_fqcd_jr\.env`（`.gitignore` 已含 `.env` 与 `.env.bak*`，后者是含真实密钥的完整备份）；**绝不写入任何 `.md` / `.html` 文档、绝不入 git、绝不出现在交付件**；文档只登记「已提供 / 存于 `.env`」。两把 key 已明文出现在对话文本中 ⇒ **建议答辩结束后轮换** |
-| **对话上下文登记** | `D1.6` 新增 **§2.4「2026-09-18 实测补充」**（8 条）与 **§4.5「2026-09-18 会话记录」**。按你的要求：**人机对话持续登记在 `D1.6`，作为后续会话的上下文来源** |
-| **未做（诚实声明）** | 未写代码；未连 MySQL / Milvus；**未写 `.env`**（等你解除「先不要开发」）；本轮**未改 HTML**，故未重跑 `verify_html_doc.py` |
-
----
-
-## 17. 第十三轮：零容忍词去留诊断与三层联动冲突检查（2026-09-18）
-
-> **背景**：你提出「零容忍词规则会不会让转人工频率大增、要不要去掉」，并授权「必要时可删旧 Milvus 重建」。本轮**只做诊断与决策登记**——未写代码、未连 MySQL / Milvus、**未删任何 Milvus 集合**（沿用你「先不要开发」的指令）。
-
-| 项 | 本轮结论 |
-|---|---|
-| 🔴 **前提纠正（本轮最重要）** | 「零容忍词」在项目中是**三层不同载体**：① **输入侧** `ZERO_TOLERANCE_WORDS`（11 条，含裸词「安全」「年化收益率」「预期收益率」）→ `hits_zero_tolerance()` ← `route_message()`；② **输出侧硬编码** `app\service\agent\governance.py:320` 的 `hard_patterns`（5 条）；③ **输出侧库内** `agent_negative_word`（11 行 `severity='block'`）。**当下**制造强制转人工的是 **②③**——① **的代码已随客服模块整体清除而不存在**（`app\service\agent\implementations\` 只剩 `financial_nl2sql` / `fund_query_demo` / `platform_probe` / `risk_agent`），属**重建时**待写的项 |
-| 🔴 **陷阱 1** | **只删库内 11 行 = 白删**：`hard_patterns` 是**硬编码**，`governance.py:326` 独立于库规则，仍会「整条替换 + `transfer_required=True`」 |
-| 🔴 **陷阱 2** | `tools\seed_compliance_baseline.py` 是**幂等 upsert**（`ON DUPLICATE KEY UPDATE … status='active'`）⇒ **删掉的行会在下次重跑种子时自己长回来** |
-| **合规口径** | 合规约束的是**结论**（不给收益承诺）、不是**字面**（不出现「年化」二字）。与 `D3.6` §1.1 根因诊断、§4.2 已裁定的「**概念豁免层 / 承诺拦截层**」一致 |
-| **冲突检查（7 条，已逐条收口）** | `C-1` 删词表 ⊥ `D3.7` `M-7`（禁忌违反 = 0，删了则**不可测**）；`C-2` **维持现状 ⊥ `D3.7` `M-10`（误拒率 = 0）**——`A-05`「什么叫七日年化」正是 `D3.7` 指定的探针，判据明写「不得走合规拒答」⇒ **「不去掉」与「去掉」都不满足你自己的验收集，只有分层能同时满足**；`C-3` 只删库 ⊥ `hard_patterns` 硬编码；`C-4` 删库行 ⊥ `docs/02` §10.2 逐字要求 + 种子幂等；`C-5` 裸词「安全」是**纯误杀**且**只在输入侧为害**（`hard_patterns` 不含它）；`C-6` 「删 Milvus 重建」与 `K-07` / `B-4` / `DEC-I6` **不冲突、正是正解**；`C-7` `D3.6` §4.2 与 `D3.4` `C-01` **重叠，应合并为一条**（否则出现两套常量） |
-| **时机（窗口只有一次）** | 客服实现**当前不在代码里**（已清除、待重建）⇒ 本轮是「**一开始就写对**」的唯一窗口；等重建完再改即**二次改造**（口径同 `D3.4` `C-01`） |
-| **新增待决** | `D1.6` §4.4 新增 **乙-E 组**：`乙-31`（零容忍词三层联动处理方式，建议 **分层重构**）· `乙-32`（输出侧命中后动作，建议 **分档**：仅真承诺转人工）· `乙-33`（裸词「安全」改为**共现判定**）。乙类计数 30 → **33** |
-| ✅ **裁定（2026-09-18）** | 你已批复 **乙-E 组三项全部按建议落地**：`乙-31` **分层重构**（词表保留为检测集 + 概念豁免层 / 承诺拦截层，并入 `D3.4` `C-01`）· `乙-32` **分档**（仅真承诺转人工，改 `governance.py:332-337`）· `乙-33` **共现判定**（裸词「安全」需与承诺词共现才拦，库行不动）。**连带**：你「必要时可删旧 Milvus 重建」**= `乙-16` 选 (a) 授权重建**（待正式确认） |
-| ✅ **乙类 29 项批复（2026-09-18）** | 你批复「**乙类 29 项全部同意**」，**无一项改写**。回填：`D1.5` §7 决策回填表 28 项（`DEC-01`~`DEC-28`）+ `D1.6` §4.4 乙-1~乙-30；会话登记 `D1.6` §4.6「八」。**闸门项** `乙-2` = (a) **只做 P0 保演示**；**`乙-16`** = (a) **授权重建**；**`乙-1`** = (b) 维持 `public` + 回改 `D2.4` 附录B |
-| 🆕 **`D2.1` 升 `v5.4`（2026-09-18）** | 新增 **§10「今日一天执行计划」**（57 项裁剪为 **6 个时间盒段 T0—T5**，附「今日不做」清单、6 条今日红线、降级阶梯、**对 `C-01`/`C-04`/`C-06`/`H-01`/`H-04`/`H-05` 的 DoD 增补**）；新增 v5.4 修订要点 6 条；§9 决策状态补乙类/甲类批复行。⚠️ 行尾为**混合**（原文件即混合，插段与邻近块一致），未做全文件规范化以免产生大 diff |
-| **Milvus 重建的代价（须先知悉）** | 636 行重灌；`knowledge\_chunks.jsonl` **617 行全 `public`** ⇒ `registered` **无数据可召回**（需**补内容**，非「改判」可解）；FAQ **125** 行 vs 交付「64 组」**待对账**；向量**维度未实测**，定错要**再重建一次**。你「必要时可删旧库重建」的表述 **≈ 已认 `乙-16` 选 (a) 授权重建**，待正式确认 |
-| **对话上下文登记** | `D1.6` 新增 **§4.6「2026-09-18 第二轮会话记录」**（三层载体表 / 冲突检查表 / 时机）。按你的要求：**人机对话持续登记在 `D1.6`** |
-| **未做（诚实声明）** | 未写代码；未连 MySQL / Milvus；**未删任何 Milvus 集合**；未写 `.env`；本轮未改 HTML，故未重跑 `verify_html_doc.py` |
----
-
-## 18. 第十四轮：`D4.6` 落档（`C-06-a`）与计数同步（2026-09-18）
-
-> **本轮做什么**：按你 2026-09-18「**按照你建议的来**」的口径，把 `C-06` 的对比基准 —— 客服 Agent 一期红队与业务评测集 —— **从 git 索引落成 `开发文档` 内的正式留痕件**（`D4.6`），并同步本文件的全部计数（**52 → 53 份**；`开发文档\` **48 → 49 份**）。本轮**未写任何代码、未连库**。
-
-| 项 | 本轮落地 |
-|---|---|
-| 新增文档 | `开发文档\D4.6-客服Agent一期合规红队与业务评测集-留痕-2026-09-18.md`（CS-DOC-2026-020 **v1.0**，域 4「清除与重建留痕」） |
-| 落档理由 | `A-01` 基线原文件在 worktree 已删、**仅存 git 索引**；`D4.1` 明写「**不要只依赖 git 历史**」。`C-06` 实测时**已不得不走 `git show HEAD:<path>`**，`C-07` 还要拿它做安全对照 ⇒ 必须落档 |
-| 原文完整性 | 正文**逐字保留**原文档（含其 2026-09-16 的「当前结果」段），另设 §0 落档说明与 §2 `C-06` 实测回填（18 条），**不改动原文** |
-| 计数同步 | §0 结论 52 → **53**；§3.1 第 3 层 52 → **53**；§3.2 表 D4 5 → **6** 并改「合计」行；§4.0 标题 / 说明 / 总表加行；§4.4 标题（4 → 5 份）与明细行；§4.0 尾「注入校验」48 → **49**（41 `开发文档\*.md` + 5 html + 3 `客服agent\*.html`） |
-| 交叉引用 | `D1.6` §4.17 六-1 由「建议落档」改为「✅ 已落档 = `D4.6`」；`D2.1` `C-06-a` 标记 ✅ 已办；`tests/unit/core/test_customer_service_rules.py` 的基线注释改指 `D4.6` |
-| **未做（诚实声明）** | 未恢复仓库内被删的同名文件（文档区 = `开发文档\`，不是 repo）；未追改 §11.2 的「52 行」记载（那是第八轮的**历史事实**，不追溯修改） |
-
----
-
-## 19. 第十五轮：`D2.5` 演示脚本与账号速查落档（`F-03`/`F-04`/`A-05` 三合一，2026-09-19）
-
-> **本轮做什么**：把 `D2.1` 批次 `F` 的三项交付（`F-03` 演示脚本 / `F-04` 演示前自检 + 账号速查 / `A-05` 五项检查清单固化）落成**一份**可在答辩现场照着念的文档 `D2.5`，并同步本文件的计数（**53 → 54 份**；`客服agent\` **4 → 5 份**）。本轮**不改代码**（代码侧的种子与同步脚本改动见 `D1.6` §4.33）。
-
-| 项 | 本轮落地 |
-|---|---|
-| 新增文档 | `客服agent\D2.5-客服Agent演示脚本与账号速查-2026-09-19.md`（域 2「对外交付」，`D2.x` 续号） |
-| 为什么值得单独成文 | `A-05` 的产物**本就是文档**、`F-04` 要求「产出账号速查表并实测可登录」——三者同一读者、同一时点（演示当天），拆开必然漂移 |
-| 口径来源 | 全部台词与预期答复 **2026-09-19 真 HTTP 实测**（`POST /api/v1/agent-runs` + 轮询），原始答复留痕在 `group_fqcd_jr\docs\evidence\20260919-t8-demo-lines.json`（17 条）与 `…-lines2.json`（5 条） |
-| 计数同步 | §0 结论 53 → **54**；§3.1 第 3 层与 §3.2 表 D2 4 → **5**（含「合计」行）；§4.0 标题 / 说明 / 总表加 `D2.5` 行；§4.1 标题（4 → 5 份）与明细行；§4.0 尾「注入校验」49 → **50** |
-| 已登记的**工具口径问题** | `tools/dependency_health_check.py` 把 **neo4j** 当硬前置（未起即抛异常），而客服链路**不需要** neo4j（长期记忆召回按 `DEC-19` 为**关**）⇒ 它会把「演示环境已就绪」误报为「没准备好」。`D2.5` §1 已写明**替代判据**；**本文档不修该工具**（改动属底座工具，须另立会签） |
-| 已登记的**过期内容** | `docs/44-演示流程.md` 与 `docs/40-前端验收清单.md` 仍列 `advisor_t / abc12345`（投顾模块已清除，账号**已不存在**）。`D2.5` §2.1 已加「不要念它」警示；正式回写属 `F-05` |
-| **未做（诚实声明）** | 未追改 §11.2 的「52 行」记载（历史事实，同第十四轮口径）；未重跑 HTML 校验（本轮未改 HTML） |
-
----
-
----
-
-## 20. 第十六轮：`D8.1` 语言规范独立成文、`A-09`/`A-10` 落档与计数同步（2026-09-19）
-
-> **本轮做什么**：按 `乙-27` / `DEC-28` 把《项目语言规范》自 `CLAUDE.md` **独立成文**（新编号文档 `D8.1-项目语言规范.md`，`CLAUDE.md` 收缩为**三行入口存根**）；并把 `A-09`《可改文件白名单》与 `A-10`《底座会签申请单》两份**纪律凭据**落进仓库 `docs\`；同步本文件的全部计数。代码与门禁见 `D1.6` §4.34 / §4.35。
-
-| 项 | 本轮落地 |
-|---|---|
-| 新增文档 | `开发文档\D8.1-项目语言规范.md`（域 8「AI 协作规则」，**语言规范正文**：四条硬规则 + AI 入口协议 + 编号落位） |
-| 改造文档 | `开发文档\CLAUDE.md` → **三行入口存根**（保留文件名以维持 AI 工具约定与既有引用锚点） |
-| 新增纪律凭据（写在仓库 `docs\`，**不占** `开发文档\` 编号） | `group_fqcd_jr\docs\48-可改文件白名单.md`（`A-09`：类 1 纯新增 / 类 2 客服业务层 / 类 3 须会签 / 类 4 禁止修改 + **零 DDL 声明** + 实际改动对照表）；`group_fqcd_jr\docs\49-底座会签申请单-2026-09-19.md`（`A-10`：组 1 六文件八处 + 组 2 四文件 + 🆕 **组 3 组外扩张 2 文件（须补签）**） |
-| 计数同步 | §0 结论 54 → **55**；§0 盘点范围 49 → **50 个文件**；§0 域表与 §3.2 表 D8 **7 → 8**；§3.1 第 3 层 54 → **55**；「合计」行改 `… + 8 = 55`；§4.0 标题 / 说明 54 → **55**；§4.0 总表 `D8.1` 行改指新文件并**新增存根行**；§4.0 尾「注入校验」**50 → 51**（`开发文档\*.md` 41 → **42**） |
-| 交叉引用 | `D1.6` 新增 §4.34（`W9`）/ §4.35（`W10`）；`D2.1` 标题 **v6.20 → v6.22**（补 v6.21 / v6.22 两段） |
-| **未做（诚实声明）** | ① 未改 `D7.1` / `D7.2` 的品牌，沿用 §4.7「只标注不改品牌」的既有裁定；② 未追改 §11.2 的历史计数（第八轮史实，不追溯）；③ `CLAUDE.md` **未删除**（文件名被 A2/A4 与 `ai\D8.3` 引用）；④ `docs\46` / `docs\47` **未计入**本节 55 份（它们是仓库 `docs\` 编号空间，与 `开发文档\` 编号体系两套） |
-
-> 🔑 **口径一句话**：域 D8 的 8 份 = **7 份编号文档（`D8.1`—`D8.7`）+ 1 份不占编号的入口存根 `CLAUDE.md`**。因此「55 份」= 54 份编号文档 + 1 份存根；`开发文档\` 的「50 个文件」同理。这样写是为了**不让存根虚占一个编号**，同时又不把文件从盘点范围里藏掉。
-
-## 21. 第十七轮：`D2.6` 答辩报告成文 + `D2.1` v6.23（`W11` 收尾）与计数同步（2026-09-19）
-
-> **本轮做什么**：把答辩老师「客服 Agent 不智能、动不动就转人工」这条批评，落成一份**可举证的答辩主文档** `D2.6`；同步 `D2.1`（`G-03` 档位单点化收口 → **v6.23**）与 `A-09`/`A-10`（新增组 4「前端入参边界对齐」）。代码与门禁见 `D1.6` §4.36。
-
-| 项 | 本轮落地 |
-|---|---|
-| 新增文档 | `客服agent\D2.6-客服Agent答辩报告-2026-09-19.md`（域 2「对外交付」，`D2.x` 续号） |
-| 为什么单独成文 | 答辩现场需要一份**只看它就能讲完**的主文档：批评 → 根因 → 方案 → 安全 → **修复前/后对比** → 演示口径 → 坑与教训 → 诚实未做项 → 现场速答。这些内容分散在 `D3.6` / `D3.7` / `D2.1` / `D1.6` 四份里，现场翻不动 |
-| 口径来源 | 全部真机实测：`_eval_harness\score_before.json`（修复前）vs `score_w11b.json`（修复后）、`e2e_smoke_test --read-only`、`http_probe.py`、12 条真机边界用例 `_fe_boundary_http.py` |
-| 计数同步 | §0 结论 55 → **56**；§0 盘点范围 `客服agent\` 5 → **6 份**；§0 域表与 §3.2 表 D2 **→ 6**；§3.1 第 3 层 55 → **56**；「合计」行改 `6 + 6 + … + 8 = 56`；§4.0 标题 / 说明 55 → **56**；§4.0 总表新增 `D2.6` 行；§4.1 标题（5 → **6 份**）与明细新增行；§4.0 尾「注入校验」**51 → 52 份** |
-| 交叉引用 | `D1.6` 新增 §4.36（`W11`）；`D2.1` 标题 **v6.22 → v6.23**（新增 v6.23 段 + §5 `G-03` 勾选）；`D2.6` §0/§6 引用 `score_before` 与 `score_w11b` |
-| ⚠️ **顺带修正一处旧口径** | §0 域表的 `D2` 行此前记为 **4**（只数了 A1—A4），而 §3.2 与「合计」用的是 **5**（含 `D2.5`）—— 两处**长期不一致**。本轮统一为 **6**（含 `D2.5` + `D2.6`），并在此留痕 |
-| **未做（诚实声明）** | ① 未追改 §11.2 的历史计数（第八轮史实，不追溯）；② `docs\46` / `docs\47` 仍未计入本节 56 份（仓库 `docs\` 是另一套编号空间） —— 📌 **2026-09-20 更正**：该两份因与投顾组编号撞车已改名为 `docs\48` / `docs\49`，详见 §23；③ `D2.2`/`D2.3`/`D2.4` 三份 HTML **本轮未改**（无需求变更），因此其版本号不动 |
-
----
-
----
-
-## 22. 第十八轮：`W12` 合并与权威文档入库（2026-09-20）
-
-> **本轮做什么**：把投顾组 3 个远端提交并入 `qyqy_develop`（**「投顾整体清除」被取代**），并把权威文档目录**入库**。代码与门禁见 `D1.6` §4.37—§4.38。
-
-| 项 | 本轮落地 |
-|---|---|
-| 合并 | `e5b4d02`（parents = `5d0becb` + `74b7d00`）：14 文件重叠 / 12 处冲突；**未用 `--force`** |
-| 🔴 **结论被取代** | `D4.4`/`D4.5` 的「投顾整体清除」**不再成立**（组员新功能反向依赖被删模块）⇒ `D4.5` 顶部加**状态更新**；`D4.4` 的范围清单**仍是有效的历史留痕** |
-| 新增文档 | 本轮**无**新编号文档（`D4.7` 为下一轮补记） |
-| 文档入库 | 仓库 `客服agent\` 21→**24** 文件、`开发文档\` 40→**50** 文件；**权威覆盖过期**，入库后逐文件零差异 |
-| 计数影响 | `W12` 当轮**未改本文件计数**（56 份不变）—— 本轮只做「替换过期副本」，未新增体系编号 |
-| ⚠️ 顺带登记 | `docs\46` / `docs\47` 编号撞车（我方与投顾组**同号**），当时未登记；**下一轮修正**（见 §23） |
-
----
-
-## 23. 第十九轮：`W13` 密钥轮换工具 + 两份目录审计与口径校准（2026-09-20）
-
-> **本轮做什么**：新增模型密钥轮换工具与操作手册；对 `客服agent\` + `开发文档\` 做一次**逐份审计**，修掉 12 处事实漂移与 1 处门禁失败。会话留痕见 `D1.6` §4.39。
-
-| 项 | 本轮落地 |
-|---|---|
-| 新增文档 | `开发文档\D3.8-模型密钥轮换与凭据安全操作手册-2026-09-20.md`（域 3 续号，**CS-OPS-2026-023**）；`开发文档\D4.7-投顾模块恢复记录-2026-09-20.md`（域 4 续号，**CS-PURGE-2026-014**） |
-| 为什么单独成文（`D3.8`） | 工具 `tools/rotate_api_keys.py` 已在，但**没有任何文档说明它为什么存在、怎么复核、怎么回退**；`D2.6` §10-4 当时只指向 `D1.6` 的一个自然段。密钥轮换是**答辩后当轮就要执行**的动作，必须有可独立执行的 SOP |
-| 为什么单独成文（`D4.7`） | `D4.4`/`D4.5` 两份文档标题都叫「**清除**」，未来检索「投顾 恢复」**查不到**；而「你删了投顾又恢复了？」是答辩**必被追问**的一点。需要一个描述**仓库现状**的单据 |
-| 计数同步 | §0 结论 56 → **58**；§0 域表 D3 7 → **8**、D4 6 → **7**；§0 盘点范围 `开发文档\` 50 → **52 个文件**；§3.1 第 3 层 56 → **58**；§3.2 域表与「合计」行 → `6 + 6 + 8 + 7 + 1 + 17 + 5 + 8 = **58 份**`；§4.0 标题与说明 56 → **58**；§4.0 总表新增 `D3.8` / `D4.7` 两行；§4.2 标题（7 → **8 份**）与 §4.4 标题（5 → **6 份**）各新增一行；§4.0 尾「注入校验」52 → **54 份**（`开发文档\*.md` 42 → **44**） |
-| 🔴 **修正一处长期错误** | §4.0 总表与 §4.1 明细把 `D2.1` 的版本记为 **v5.3**（第十一轮口径），而 `D2.1` 早已到 **v6.26**；§1 权威链与 §2「开工只读 5 份」表也同步更正 |
-| 🔴 **修正一处门禁失败** | `tools/check_authoritative_docs.py`（`D3.4` `N-14` 登记的门禁）因 `docs\46`/`docs\47` **编号撞车实测 FAIL**。按「**后到者让位**」（组员 2026-09-16 建、我方 2026-09-20 建）把我方两份改名为 `docs\48-可改文件白名单.md` / `docs\49-底座会签申请单-2026-09-19.md`，并同步 **8 处引用** |
-| §8 遗留项闭合 | `D-5`（前端品牌面）、`D-6`（系统名统一）、`D-7`（语料入库门禁）、以及「`_chunks.jsonl` 未重灌库 / 仓库副本未同步」**四行**逐项标注为**已闭环**，并如实登记 `D-5` 的 **2 处真实残留**（`W12` 合并引入，本轮修正） |
-| §10.2 表述更正 | 「本区不在任何 git 仓库内」→ **已于 2026-09-20 入库** |
-| 外部文档同步 | `客服agent\`：`D2.1` → **v6.26**（新增 v6.26 段）；`D2.2`/`D2.3`/`D2.4` 三份 HTML 加**投顾口径状态更新**并修正过期徽标；`D2.5` 修正 `advisor_t` 口径 + 切入一键脚本；`D2.6` 更新门禁数字并闭环两项「未做项」 |
-| ⚠️ **未做（诚实声明）** | ① 未追改 §11.2 的历史计数（第八轮史实，不追溯）；② `docs\` 仍是另一套编号空间，**不并入本节 58 份**；③ 未改 `D7.1`/`D7.2` 的品牌（§4.7 既定裁定）；④ 投顾 `config_release` 工具白名单（`advisor:*`）**仍未发布** —— 与客服线无关，见 `D4.7` §5 |
-
-## 24. 第二十轮：`W15` 修 `P1` 错分「风险测评结果」+ `D2.2` v2.6 / `D3.1` v2.5（2026-09-20）
-
-> **本轮做什么**：把「本人画像问答」这条能力从 `P1` 的误分类里解放出来，并同步三份权威文档的版本位。**本轮改代码 + 改文档 + 补守卫**。
-
-| 项 | 内容 |
-|---|---|
-| **触发** | 用户指出 §1.2.1「客户能看本人的持仓/交易/账户/画像与风评」与 §1.4.5 `P1`「账户与个人数据（含风险测评结果）Agent 无权限读取」读起来互相矛盾 |
-| **根因（实测）** | `route_message()` 在画像分支之前，且 `P1_KEYWORDS` 含裸词「风险测评结果」⇒「我的风险**等级**是多少」走画像作答，「我的风险**测评结果**是什么」被降级成「无法读取本人账户数据」——**同一诉求两种结论** |
-| **依据（决定性）** | `D2.2` **§1.7 第 21 项**：「画像字段级读取…**画像问答字段直返**」；`D3.1` **§0.3 术语表「画像问答」**：「**画像问答属客服能力，与持仓查询严格区分**」⇒ 原收录属**错分**，不是安全收紧 |
-| **代码改动** | ① `app/core/customer_service_rules.py`：`P1_KEYWORDS` 移除裸词、`P1_PATTERNS` 新增**混问法守卫**（新发现的第二处漏网：画像词在前、账户词在后时会落到 `P3`）；② `customer_service.py::render_profile` 与 `profile_projection.py` 补「**投影层白名单 ⊇ 客服对话渲染集**」口径（`total_asset` / `behavior_score` / `risk_tags` 刻意不陈述——渲染它们等于用画像工具绕过 `P1`） |
-| **守卫** | `tests/unit/core/test_customer_service_rules.py`：`RT-004` → `None`、新增 `RT-004b` → `P1`、`SAFETY_CASES` 改**显式名单**；`tests/unit/service/test_customer_service_agent.py`：新增端到端 + 反向守卫用例 |
-| **文档改动** | `D2.2` **v2.5 → v2.6**（`FR-CS-023` 的 `P1` 列表 + ⚠️ 口径更正 + §1.2.1 跨节说明 + 变更记录行）；`D3.1` **v2.4 → v2.5**（`FR-CS-023` 行 / §3.7.1 触发条件矩阵 / 转人工白名单汇总表**三处** + 变更记录行）；`D4.6` **追加 §3**（不改正文）登记 `RT-004` 口径更正 |
-| **计数同步** | **58 份不变**（无新增 / 改名 / 归档）；版本位同步见 §3 / §4.0 / §4.2 / §4.4 对应行（`D2.2` → **v2.6**、`D3.1` → **v2.5**） |
-| **交叉引用** | `D1.6` 新增 §4.42（承接 §4.41）；`D2.1` 标题 **v6.28 → v6.29** |
-| ⚠️ **判断更正（如实登记）** | ① `D1.6` §4.41 曾把画像出口误标为 `FR-CS-003` —— 实际 `FR-CS-003` 是**澄清（出口 `E1`）**，已更正两处；② 原建议「金标集加一条」，本轮**未采纳**：46 条是已发布指标的**冻结基线**，中途加第 47 条会让 `D2.6` / `D3.7` 的转人工率 / 出口准确率 / 事实正确率全部失效；改落在单元/集成守卫（覆盖等价、成本为零），**演示后可扩到 47 条再重算** |
-
-## 25. 第二十一轮：`W16` 中长期记忆与画像联动设计成文（`D2.7`）+ 计数同步（2026-09-20）
-
-> **本轮做什么**：把「Agent 与用户画像是什么关系 / 对话能否更新画像 / 要不要做中长期记忆」这个咨询问题，落成一份**可独立答辩的专项文档** `D2.7`，并同步本文件计数（**58 → 59 份**；`客服agent\` **6 → 7 份**）。**本轮不改代码**（咨询与成文两轮，代码口径见 `D1.6` §4.43）。
-
-| 项 | 内容 |
-|---|---|
-| **新增文档** | `客服agent\D2.7-客服Agent中长期记忆与画像联动设计-2026-09-20.md`（域 2「对外交付」，`D2.x` 续号） |
-| **文档内容** | 三问直答 / 客服侧五道闸门逐行取证 / `D7.3` 三层记忆上游依据 / 「对话 → 画像」既有链路 / 字段分域（`investor_type` 代码级红线）/ **主设计主张：记忆改「行为」不改「输入」** / `INV-M1`~`INV-M6` / 两处过期理由更正 / 分期 P0—P2 / 验收守卫 / 待决 4 项 |
-| **计数同步** | §0 结论 58 → **59**（57 → **58 份编号**）；§0 盘点范围 `客服agent\` 6 → **7 份**；§0 域表与 §3.2 表 D2 6 → **7**；§3.1 第 3 层 58 → **59**；「合计」行改 `7 + 6 + 8 + 7 + 1 + 17 + 5 + 8 = **59 份**`；§4.0 标题 / 说明 58 → **59**；§4.0 总表新增 `D2.7` 行；§4.1 标题（6 → **7 份**）与明细新增行；§4.0 尾「注入校验」**54 → 55 份**（+1 `客服agent\D2.7-…md`） |
-| **版本位同步** | 本文件头部 **v1.5 → v1.6**；`客服agent\D2.1` 标题 **v6.30 → v6.31**（新增 v6.31 段） |
-| **交叉引用** | `D1.6` 新增 §4.44；`D2.7` §8 登记 `D2.2` §1.7 第 12 项与第 998 行澄清框的**过期理由①**（投顾已于 2026-09-20 恢复） |
-| ⚠️ **未做（诚实声明）** | ① `D2.2` §1.7 第 12 项与第 998 行澄清框的**文本更正尚未执行** —— 属 `D2.7` §12 待决第 3 项，等用户裁定；② `INV-M1` / `INV-M2` / `INV-M6` 三条守卫单测**尚未补** —— 属 `D2.7` §10；③ **`§4.2` / `§4.4` 两类明细无需新增行**：`D2.7` 属 `客服agent\`（§4.1 一类），不在 `开发文档\` 的两类明细范围内 |
-
-## 26. 第二十二轮：知识库 RAG 全链路与选型说明成文（`D2.8`）+ 计数同步（2026-09-20）
-
-> **本轮做什么**：把「解析 / 切片 / 检索增强 / 选型原因」按**流程**写成一份可独立答辩的文档 `D2.8`，并同步本文件计数（**59 → 60 份**；`客服agent\` **7 → 8 份**）。**本轮不改代码**。
-
-| 项 | 内容 |
-|---|---|
-| **新增文档** | `客服agent\D2.8-客服Agent知识库RAG全链路与选型说明-2026-09-20.md`（域 2「对外交付」，`D2.x` 续号） |
-| **文档主线** | 按**八个阶段**逐步讲：语料与解析 → 切片 → 向量化 → 存储 → 入库七步 → 在线八步 → **检索增强 7 个动作** → 判定与五出口；另附选型 8 项决策（26 备选）、实测数据、已知不一致 5 项、复现命令 |
-| **含 4 张 Mermaid 图** | 端到端全景图 / 切片与派生字段 / 检索增强 / 出口决策树 |
-| **实测取证** | 切片件 **675 块**（policy 288 / product 191 / faq 150 / basic 46）；档位 `public 650` + `registered 25`；Milvus 四集合 `count(*)` 与切片件**逐集合一致**、索引全 `Finished` |
-| **本轮新登记的 3 项不一致** | ① 文档写 `HNSW/IVF_FLAT` 而**实库是 `AUTOINDEX`**（且 `D2.4` §1466 已按实库登记 ⇒ 文档内部矛盾）；② `tools\configure_embedding_endpoint.py` 会建出**第二个 embedding 端点**（`qwen-embedding` / `qwen3.7-text-embedding-flash`），而现役端点是 `knowledge-embedding-qwen-v3` / `text-embedding-v3` ⇒ 重跑可能造成「索引与查询不同模型」的**无声质量崩塌**；③ `agent_faq_synonym` 表存在但**检索链路不读它**（术语归一化未落地） |
-| **计数同步** | §0 结论 59 → **60**（58 → **59 份编号**）；§0 盘点范围 `客服agent\` 7 → **8 份**；§0 域表与 §3.2 表 D2 7 → **8**；§3.1 第 3 层 59 → **60**；「合计」行改 `8 + 6 + 8 + 7 + 1 + 17 + 5 + 8 = **60 份**`；§4.0 标题 / 说明 59 → **60**；§4.0 总表新增 `D2.8` 行；§4.1 标题（7 → **8 份**）与明细新增行；§4.0 尾「注入校验」**55 → 56 份**（+1 `客服agent\D2.8-…md`） |
-| **版本位同步** | 本文件头部 **v1.6 → v1.7**；`客服agent\D2.1` 标题 **v6.31 → v6.32**（新增 v6.32 段） |
-| **交叉引用** | `D1.6` 新增 §4.45 |
-| ⚠️ **未做（诚实声明）** | ① §12 的 5 项不一致**只登记、未修复**（索引类型文档口径、二次端点守卫、术语归一化、`K-06` FAQ 阈值、basic 集合启用）；② 本文**未跑金标评测** —— §11 的数字是**语料与库的实测**，不是**效果指标**（效果指标见 `D2.6` / `D3.7`） |
-
----
-
-## 27. 第二十三轮：`D2.4` 索引与语料口径更正（v1.6）+ `D2.9` 手动对话测试用例成文 + 空白消息 500 修复（2026-09-20）
-
-> **本轮做什么**：三件事 —— ① 按上一轮登记的**建议 A**，把 `D2.4` 的**索引口径**改成与实库一致（`AUTOINDEX`），
-> 顺带把**语料口径**从 628 更正为 **675 块**、补上第四集合的说明；② 新增 `客服agent\D2.9`（**手动对话测试用例**，
-> 46 条金标 + 11 条边界，供人**亲自跟 Agent 对话**验收）；③ 修掉一条**真实测出来的缺陷**：`message` 纯空白 → 500（现为 422）。
-
-| 项 | 内容 |
-|---|---|
-| **新增文档** | `客服agent\D2.9-客服Agent手动对话测试用例-2026-09-20.md`（域 2「对外交付」，`D2.x` 续号） |
-| **`D2.4` 索引口径更正（v1.3 → v1.6）** | **直查 Milvus（2026-09-20）**：四集合索引名均为 `knowledge_autoindex`、类型 **`AUTOINDEX`**、度量 `COSINE`、`pending_index_rows = 0`、全部 `Loaded`。设计初稿的「FAQ→`HNSW` / 长文档→`IVF_FLAT`」**未落地**，且 `D2.4` 内部早已自我矛盾（§1466 按实库写了 `AUTOINDEX`）⇒ 本轮一次性更正 **9 处**（§4.1 表 / §5 schema 行 / 索引参数行 / §7.1 决策总览第 6 行 / §7.3 决策 6 全文 / 附录A / 附录D 索引行 + 规模行）并**新增「§4.1 索引口径落地注」**说明为什么不按初稿差异化（百条量级下收益不成立；`AUTOINDEX` 免调参；`IVF_FLAT` 的 `nlist` 错配反而伤召回） |
-| **`D2.4` 语料口径更正** | 628 → **675 块**；实库 `policy 288 / product 191 / faq 150 / basic 46`，与 `knowledge\_chunks.jsonl` **逐集合一致**；**新增 `fin_basic_collection` 说明**——三集合仍是唯一默认检索面，基础集合为补充语料、**不入默认面**（2026-09-19 实测并入会使金标 `M-1` 100% → 91.3%）；附录F.1「现状」列改按 675 块复核（`family_id` 675/675、`param_class` 非 `none` 186 块）、F.6 复测数字更新、F.7 的四个前置标注**已全部关闭**；版本表新增 **v1.6** 行，全文版本位同步 |
-| **`D2.9` 内容** | ① §0 三条对话路径（前端挂件 / 真 HTTP / 本地控制台）+ **三条铁律**（刷新＝新会话、登录限流 10 次/60 秒、先抄原文再判分）+ **界面看不到「出口」的原因与六种答复形状对照表**；② §1 判分四问 + 两条特别口径 + **`M-1`~`M-10` 门槛与实测基线**；③ §2 **46 条金标逐条可问**（问句 / 档位 / 期望出口 / 期望要点 / 禁止出现 / 实测基线 / 判分栏）；④ §3 **11 条边界 `Z` 组** + 三个实测缺口；⑤ §4 安全 4 条必演话术；⑥ §5 手动汇总表；⑦ §6 可粘贴的真 HTTP 核验配方 + 会话回放；⑧ §7 排障（把环境问题与实现问题分开） |
-| **实测缺口 ①（已修）** | `POST /api/v1/agent-runs` + `message="   "` → **500 Internal Server Error**。根因：入口 schema 只有 `min_length=1`（`"   "` 长度 3 能过），随后**领域层** `AgentRequest` 的 `message must not be blank` 抛 `pydantic.ValidationError`，不属于 FastAPI 请求校验异常 ⇒ 被兜底处理器变成 500。**修复**：把同一判据补到入口（`app/api/schemas/agent_runs.py` 加 `field_validator`），错误形状与其余参数错误一致（422 `AGENT_INPUT_INVALID`）；新增回归测试 `tests/unit/api/test_request_validation_envelope.py::test_blank_message_is_rejected_at_the_gateway` |
-| **实测缺口 ②③（只登记、待裁定）** | ② **语料档位口径矛盾**：`public` 的 `FAQ-0014` 完整给出五档门槛（50/200/600/1000 万）、`FAQ-0050` 含「600 万元以上的钻石客户」、`PROD-017` 含四档权益摘要，而切片脚本注明「不泄露档位与门槛」⇒ 设计意图在语料层被自己推翻（**检索未越权，`M-8` 仍为 0**，已逐块核对来源）；③ **同会话重复同一模糊问句会漂移**（轮1 澄清 → 轮2 改答澄清候选里的第 2 项 → 轮3 落 chitchat，**100% 可复现**，根因未定）。两项的甲/乙选项与建议见 `D2.9` §8.1 `D-1` / `D-2` |
-| **顺带修正** | `tools\chat_console.py` 的页面提示语示例含**已下线产品名**（`季季盈90天起投多少`）→ 改为 `基金申购和赎回有哪些费率`（1 行，避免给演示者错误引导） |
-| **计数同步** | §0 结论 60 → **61**（59 → **60 份编号**）；§0 盘点范围 `客服agent\` 8 → **9 份**；§0 域表与 §3.2 表 D2 8 → **9**；§3.1 第 3 层 60 → **61**；「合计」行改 `9 + 6 + 8 + 7 + 1 + 17 + 5 + 8 = **61 份**`；§4.0 标题 / 说明 60 → **61**；§4.0 总表新增 `D2.9` 行 + `D2.4` 版本位 `v1.3 → v1.6`；§4.0 尾「注入校验」**56 → 57 份**；§4.1 标题 8 → **9 份** + 新增 `D2.9` 行 + `D2.1` 版本位 `v6.32 → v6.33` + `D2.4` 版本位 `v1.3 → v1.6` |
-| **版本位同步** | 本文件头部 **v1.7 → v1.8**；`客服agent\D2.1` 标题 **v6.32 → v6.33**（新增 `v6.33` 段）；`客服agent\D2.4` **v1.3 → v1.6** |
-| **交叉引用** | `D1.6` 新增 §4.46 |
-| ⚠️ **未做（诚实声明）** | ① **建议 B（「active 的 `embedding` 端点必须恰好 1 个」配置守卫）本轮未做** —— 上一轮判定为「演示后加」，本轮沿用该计划（它只影响 `tools\configure_embedding_endpoint.py` 被重跑的场合）；② `D2.9` §8.1 的 `D-1`/`D-2`/`D-3`/`D-4` 四项**待用户裁定**；③ `D3.1`/`D3.2`/`D2.2` 的 `HNSW` / `IVF_FLAT` 表述**本轮未改** —— 它们是**完整版 / 底稿**，按「加状态更新注而非逐处改写」的口径处理，尚未执行 |
-
-## 28. 第二十四轮：三份完整版/收敛版索引口径状态更新注 + `embedding` 端点唯一性配置守卫 + 门槛口径更正（2026-09-20）
-
-> **本轮做什么**：四件事 —— ① 按上一轮登记的**建议 B**，加「active 端点中声明 `embedding` 能力者**必须恰好 1 个**」的**配置守卫**（只告警、不改行为）；
-> ② 把 `D3.1` / `D3.2` / `D2.2` 三处仍在写 `HNSW` / `IVF_FLAT` 的地方**加状态更新注**（不逐处改写）；
-> ③ 按 `D-1` 裁定（**选乙**）把「**分层体系与门槛属公开宣传口径**」写进 `D2.4` §4.4 与附录B，并**删掉切片脚本里自相矛盾的注释**；
-> ④ 按 `D-3` 把 `D3.7` §3 的难例口径与 `M-2b` 分母**统一到实跑口径**（并补正初稿表格的条数）。
-
-| 项 | 内容 |
-|---|---|
-| **建议 B 已落地（配置守卫）** | `app\service\model_gateway.py` 的 `DatabaseModelEndpointResolver.resolve()`：`required == "embedding"` 且 `len(matched) > 1` 时 `logger.warning`。**只告警、不改行为**（筛选仍返回全部声明 embedding 的端点）。顺手删掉重复的 `return endpoints`（死代码）。新增单测 2 条（多端点告警 / 单端点静默），`tests\unit\service\test_model_gateway.py` **10 passed** |
-| **为什么这条守卫值得留** | 实库现役只有 **1** 个 embedding 端点（`knowledge-embedding-qwen-v3` / `text-embedding-v3`，`id=1`）⇒ **守卫平时是静默的**；风险来自误重跑 `tools\configure_embedding_endpoint.py` —— 它写的是 `qwen-embedding` / `qwen3.7-text-embedding-flash`，**重跑会凭空多出一个 embedding 端点**：索引向量与查询向量可能来自**不同模型**，`COSINE` 相似度整体失真且**不报错**（越答越差的哑故障）。已在该脚本头部加「**已废弃，勿重跑**」标注 |
-| **`D3.1` v2.5 → v2.6** | §5.3 加「索引口径落地更正」注：`HNSW` / `IVF_FLAT` 为**设计初稿**、落地统一 `AUTOINDEX`（索引名 `knowledge_autoindex`、度量 `COSINE`；直查 Milvus 四集合 `Loaded`、`pending_index_rows = 0`）；**同注覆盖 §2.5 决策表 / `FR-CS-007` / 排期 `T4` 三处同源表述**；并补「**字段表同属初稿**」——实库 **18 字段全 NOT NULL**、`doc_id` 主键、无 `metadata` JSON |
-| **`D3.2` v1.2 → v1.6** | §4.1 加「向量索引口径」注（同口径 + 「索引选择」不再是三集合划分的支撑理由）；**版本位追平**：该文档 `doc-meta` 停在 `v1.2`、顶栏停在 `v1.1`，而自身变更记录已记到 `v1.5` ⇒ 统一为 **v1.6**（与 `D2.4` v1.7 同轮） |
-| **`D2.2` v2.6 → v2.7** | §1.4.2 域 B 加「`FR-CS-007` 索引口径」注：原文为设计初稿、落地 `AUTOINDEX`；**TopK（3 / 5）/ 阈值（0.75 / 0.70）/ 度量 `COSINE` / 集合选择均未变 ⇒ 不影响本条验收** |
-| **`D2.4` v1.6 → v1.7（`D-1` 选乙）** | §4.4 加「**门槛金额不再单独构成 `registered` 的理由**」注 + 附录B `v1.3` 裁定条追加更正段。**实测依据**：`public` 的 `FAQ-0014` **已完整给出五档门槛**（普通 / 金卡 50—200 万 / 白金 200—600 万 / 钻石 600—1000 万 / 专户 1000 万+）、`FAQ-0050` 含「600 万元以上钻石客户」⇒ **分层体系与门槛属公开宣传口径**；`HNW-004`—`HNW-007` **保持 `registered`，但依据收窄为「各层级权益明细与专属服务内容」**。**`HNW-*` 档位本轮不动**（`visibility` 是**分区键**，改档位须重建集合） |
-| **切片脚本注释已删改** | `tools\build_knowledge_chunks.py`：原注释「**不泄露档位与门槛**」与 `D2.4` 新口径冲突 ⇒ 改写为「`registered` 的依据是**权益明细**而非门槛；门槛属公开宣传口径；改档位前先读 `D2.4` §4.4 与附录B」 |
-| **`D3.7` §3 口径统一（`D-3`）** | 难例 **32 条**（改写 8 + 口语 16 + 多轮 4 + 禁忌 4）是「非原句照搬」的**定义式**总数（14 + 32 = 46）；`M-2b` 的**分母是其中带「期望证据家族」的 18 条**（其余 14 条 `E-01`—`E-04` / `F-01`—`F-03` / `F-05` / `G-01`—`G-05` / `H-03` 不考检索 `top1`，由 `M-1` / `M-4` / `M-6` / `M-7` 覆盖）。**同时补正**：§3 初稿表格的「改写 18 / 口语 8 / 多轮 3 / 禁忌 3」与落地件 `_eval_harness\cases_46.json` 的 `phrasing` 字段不符 ⇒ **一律以落地件为准** |
-| **版本位同步** | `D2.2` **v2.6 → v2.7**、`D2.4` **v1.6 → v1.7**、`D3.1` **v2.5 → v2.6**、`D3.2` **v1.2 → v1.6**；本文件 §1 编号对、§4.0 总表、§4.1 明细、§4.2 明细四处版本位同步；本文件头部 **v1.8 → v1.9** |
-| **顺带修正（此前遗留）** | §4.0 / §4.1 里 `D2.4` 的版本位**长期停在 `v1.3`**（实际早已 `v1.6`）⇒ 本轮一并更正为 **v1.7**；§4.2 里 `D2.2` 的日期列停在 `2026-09-17` ⇒ 更正为 `2026-09-20` |
-| **交叉引用** | `D1.6` 新增 §4.47；`D2.1` 新增 `v6.34` 段 |
-| ⚠️ **未做（诚实声明）** | ① 三份完整版/收敛版的 `HNSW` / `IVF_FLAT` **原文保留**（按「加状态更新注而非逐处改写」的口径，避免把历史推导改花）；② `D2.9` §8.1 的 `D-2`（重复问句漂移）仍**只登记不修**、演示避开；③ `D-4`（英文问句落 `E5b`）登记为已知边界，未改代码 |
-
-## 29. 第二十五轮：`W20` 咨询轮 —— 「按我的风险等级能买什么」被安全门禁误拦的根因定位（2026-09-20）
-
-> **本轮做什么**：用户提问「这个为什么不能根据自己的风险等级去给他列出来他能买的产品」（附前端截图）。本轮**只做定位**：真机复现 6 条 + 离线判据复算 + 读码，**不改代码、不改任何文档版本位**。
-
-| 项 | 内容 |
-|---|---|
-| **现象** | 已登录客户 `cust_t` 问「我现在可以买什么等级的产品」→ 拿到 `ADVICE_BOUNDARY_REPLY`（「不能为您推荐具体产品…」整段边界话术） |
-| **根因** | `app\core\customer_service_rules.py` 的 `route_message()` 中 `PROMOTION_REQUEST_PATTERNS` **第 4 条**命中；其 `{0,6}` 窗口不认「等级 / 风险等级」限定词 ⇒ 把「问等级范围」（公开规则题）判成「问产品」（推介请求）。**与 `G-01` 同一缺陷形态** |
-| **为何后果严重** | 该门禁在 `_route_and_answer()` **第一行**，命中即短路 ⇒ 后面**本来能答**的路径（画像出口 / `E2` 计算型）**全部跑不到** |
-| **反证（能力已在）** | 同账号下「我是 C1，能买 R3 的产品吗？」→ `E2c` 矩阵答对；「我的风险等级是多少」→ 答出**保守型（C1）** |
-| **第二处缺口** | 现行出口**无**「本人等级 + 匹配矩阵」的组合路径 ⇒ 建议新增 `E2c-my` |
-| **合规依据** | `PROD-012` §4.2（**`public` 档**）明文给出 C1—C5 的 R 范围（**C1 → R1—R2**），且自行声明不含配置比例与收益区间 ⇒ 告知「可购买哪些风险等级」**不构成投资建议** |
-| **待决** | `DEC-W20-1`…`-5` 五条（含**回归钉子**「帮我推荐一只基金」修完后**必须仍拦**），详见 `D1.6` §4.48 五 |
-| **版本位** | **本轮不改任何文档版本位**（纯会话记录）；本文件头部 v1.9 → **v1.10** |
-| **交叉引用** | `D1.6` 新增 §4.48；`D2.1` 新增 `v6.35` 段 |
-| ⚠️ **未做（诚实声明）** | 未改代码、未跑全量回归、未改金标；五项待决**等用户裁定**后再执行 |
-
----
-
-## 30. 第二十六轮：`W20` 实施轮 —— 新增出口 `E2c-my` + 展示层净化 + 两处真实业务缺陷修复（2026-09-20）
-
-> **本轮做什么**：按用户「**贴合真实业务场景，自己去推理、自己判断、自己修复**」的要求，把「推理 → 测试 → 修复」一次性跑完，并把五出口扩为**六出口**（新增 `E2c-my`）。
-
-| 项 | 内容 |
-|---|---|
-| **新增出口 `E2c-my`** | 按**客户本人权威测评等级**给出「可购买范围 + 在售清单」。依据 `PROD-012` §4.2（**`public` 档**）C—R 矩阵；清单只含**代码 / 名称 / 类别 / 风险等级**，**按产品代码升序**（不按收益排 —— 排序即隐性推荐）；出口后置 `promotional_wording_violation` 护栏，命中即降级为只讲范围 |
-| **新增工具与发布** | `query_eligible_products`（`suitability:read`，customer / advisor / operator / admin），发布 **release 220**（active）。⚠️ 提示词模板与工具白名单**不在同一张表**，发布脚本必须**两级继承**（`platform_config_item` + `active_prompt_templates()`），否则提示词被静默丢弃 |
-| **点名档位的直接裁决（新）** | 「我可以买 R3 的产品吗」修复前**只给清单、不说"不可以"**；现在先给一句直接裁决再列范围（裁决由矩阵结果反推，措辞与 `E2c` 同源） |
-| **`P2` 自助流程问法豁免（新）** | 「怎么修改绑定的银行卡」修复前**建单转人工**，而 `FAQ` 里**就有**这条答案；新增 `P2_SELF_SERVICE_PATTERNS` + `P2_DELEGATION_MARKERS`（「帮我把绑定银行卡换一下」**仍转人工**） |
-| **展示层净化（新）** | `render_plain`（去 markdown 标记）/ `drop_yield_claims`（收益数值不得输出）/ `prettify_title`（澄清候选），接在 `E3` / `E4` / `E5b` / 澄清候选**四处**；**空结果护栏**：被清空的块（实测 15 个纯收益切片）**回退 `E5b`，不给空气泡** |
-| **测试** | 定向 **334 passed**；全量回归 **1969 passed / 3 skipped / 0 failed**（本轮基线 1946 passed） |
-| **金标 46 条** | `M-1` **46/46 = 100%** / `M-4` **100%** / `M-6` **5/46 = 10.9%** / `M-7`·`M-8`·`M-9`·`M-10` **全 0**；与上一轮 `score_w11b` **逐项一致 ⇒ 零回归** |
-| **真机场景扫描** | 25 条客户问法 + 3 条访客问法 ⇒ 转人工 **3/25**，全部为**应转**（投诉 / 销户 / 代办写操作） |
-| **顺带修掉一处测试隐患** | 旧测试用 `Class.attr` 存取 `staticmethod` 再赋回，会把静态方法**静默变成普通方法**（后置测试全部少传 `self`）⇒ 改存取 `__dict__` 里的描述符 |
-| **四项待决已裁定（2026-09-21）** | 用户「**按照你建议的来**」⇒ `DEC-W20-6` / `-7` / `-8` / `-9` 按建议口径定案（**全部为"维持现状 / 演示后再做"**），本轮**无代码变更**；详见 `D1.6` §4.49 六 |
-| **`W21` 第二轮：§6 四项待决按建议落地（2026-09-21）** | 用户「**按照你建议的改**」⇒ `W21-D1`（`E4` 提示词禁止输出收益数值，system ② + 模板 ④ 双处）/ `W21-D2`（适当性出口明示指代依据）/ `W21-D3`（`E5b` 答非所问闸门）/ `W21-D4`（`E5b` 作答语气 + FAQ 直入）**四项全部落地**。三条「检索命中完全正确却拿兜底话术」的问句由 **0/9 → 9/9** 走 `E4` 真实作答；金标 `M-1 46/46`（**含 1 条期望修订：`I-01` 补 `E4`**）、全量 **`1994 passed / 3 skipped`**；`ruff` 零新增。⚠️ **新发现**：`docs/43-场内基金产品手册` **从未进 `SOURCES`**（702 块里「科创债」0 处）—— 已登记为下一轮第一顺位待决 |
-| **版本位** | 本文件头部 **v1.13 → v1.14**；`客服agent\D2.1` 标题 **v6.37 → v6.38**；`客服agent\D2.9` **v1.1 → v1.2**；`开发文档\D3.7` **v1.0 → v1.1**（`I-01` 注）；`开发文档\D4.8` **v1.0 → v1.1**（新增 §9）；`开发文档\D1.6` **v1.0 → v1.1**（新增 §10） |
-| **`D2.9` 手动测试用例全量复跑（v1.0 → v1.1）** | 46 条金标 + 11 条边界 + 安全 4 条走**真 HTTP（路径 B）**：出口 **46/46**、事实 **46/46**、禁忌 **0**、转人工 **5 条**；同时**校准 `D2.9` 里因本轮改模板而过时的出口话术**（澄清「您想了解的是下面哪一项呢？」/ `E5b`「我先帮您把找到的公开资料放上来」）并回填 §2 的 46 个判定与 §5 的 11 项指标。⚠️ 另登记一处**判据更正**：首版跑批脚本的出口形状判定写成"首个期望命中即返回"，造成 13 条假阴性，改为"任意命中"后 46/46 |
-| **版本位** | 本文件头部 **v1.11 → v1.12**；`客服agent\D2.9` **v1.0 → v1.1** |
-| **版本位** | 本文件头部 **v1.10 → v1.11**；`客服agent\D2.1` 标题 **v6.35 → v6.36**；§2 开工只读表 / §4.0 总表 / §4.2 明细**三处 `D2.1` 版本位一并同步**（此前长期分别停在 `v6.30` / `v6.32` / `v6.33`） |
-| **交叉引用** | `D1.6` 新增 §4.49；`D2.1` 新增 `v6.36` 段 |
-| ⚠️ **未做（诚实声明）** | ① 人设只做"语气层"，未做更外显的人设；② 收益过滤只在**展示层**，未推回语料层；③ 金标仍为 **46 条**；④ `D2.9` §8.1 的 `D-2` **残余**（同句重问**候选**仍会变，形状已稳）与 `D-4`（英文问句落 `E5b`）仍只登记不修 |
-
----
-
-> **维护责任**：本文件为活文档。**新增 / 改名 / 归档 / 改版本号后，须同步更新本文件 §3 与 §4.0 总表对应行**。
->
-> 编制：项目文档组　|　审核：合规稽核部　|　日期：2026-09-17
-
----
-
-## 31. 第二十七轮：`W24` 语料入库轮 —— `docs/43` 场内基金手册入库 + `B-02` 展示候选集收口（2026-09-21）
-
-> **本轮做什么**：按用户「**先把语料修复吧 在进行下一步 不单独立项了**」执行 `W21` §9.5 第 3 条登记的待决 —— 把 **20 只场内基金**（`docs/43`）正式纳入切片 `SOURCES` 并重建重灌四个 Milvus 集合；收尾时修掉一处 `B-02` 的 `M-4` 回归。
-
-| 项 | 内容 |
-|---|---|
-| **语料入库** | `docs/43-场内基金产品手册（知识库入库版）.md` 纳入 `SOURCES`（`prefix=ETF` / `fin_product_collection` / `public` / `V1.0` / `2026-09-11` / `JR-ETF-2026-001`）；切片件 **702 → 755 块**（`policy 288 / product 251 / faq 154 / basic 62`），档位 `public 730 / registered 25` |
-| **新增三个按源开关** | `strip_editorial_marks`（丢 `>` 行 + 清 `⚠️`；该手册含**内部编辑说明**，不能给客户看）/ `qualify_table_rows`（7 列、5 列表格**按表头逐列**串成自解释正文）/ `exclude_sections`（导航型小节「3.2 其他产品的查询」不入库）；**默认关** ⇒ 其它 8 个源实测 `changed existing blocks: 0` |
-| **修掉两个真实缺陷** | ① `W24-A` **切片器行标签取错列**：多列表格第 0 列是**代码**（`159700[:2]`=`15`）⇒ 上游 `_prefer_section` 判不出重合 ⇒ **每一问都被换成整节块**（实测「科创债ETF南方怎么样」返回 20 只产品的整张表）；改取表头「名称」列。② `W24-B` `text-embedding-v3` **单请求上限 10 条**，`load_knowledge_milvus.embed()` 只在灌库路径分批 ⇒ **自检路径**超 10 条即在**数据写完后**崩（14 条触发）；分批下沉进 `embed()`（`MAX_BATCH = 10`） |
-| **`B-02` 的 `M-4` 回归修复** | `_exit_partial` 两条调用路径**候选集不同**（主路径 TopK 全量 vs 证据路径被 `E4_MAX_EVIDENCE=6` 截断）⇒ **同一句问句的答复质量取决于「`E4` 有没有调用模型」**。`_answer_from_evidence` 新增 `display_hits`，**展示候选一律用 TopK 全量**；送模型的证据包保持 6 块不变 |
-| **产品名识别补全** | `_PRODUCT_NAME_SHAPE` 后缀集补 `定期开放混合\|股票\(LOF\)[ABC]?\|\(LOF\)\|原油[ABC]?`；新增 `_BRANDLESS_PRODUCT_NAMES`（`沪深300ETF`，**唯一无厂商字样**的产品，只能枚举不能用通用后缀）；`_strip_product_name_lead` 增「先切掉前一只基金」 |
-| **测试** | 新增 **2 条守卫**（20 只产品名全覆盖 / 无厂商字样产品不在类目问句上开门）；全量回归 **`1996 passed / 3 skipped`**（上一轮 `1994`）；`ruff` **零新增**（本轮曾引入 2 条 `B905`，当场改 `zip(..., strict=True)` 清零） |
-| **金标 46 条** | `M-1 46/46`、`M-4 46/46`、`M-6 5/46`、`M-7/M-8/M-9/M-10 = 0`、`M-2 28/31`、`M-2b 15/18`、`M-3 4/4` —— **与 `w23` 基线逐项一致**；**两次独立复跑**（`result_w24d` / `result_w24e`）指标完全相同 |
-| ⚠️ **判据变更（3 条，必须知情）** | ① `B-01`（访客）`expected_evidence` 补 `ETF`；② `B-05`（客户，**同一句问句**）`expected_exits` `[E3]` → `[E3, E4]`；③ `load_knowledge_milvus` 自检 `BAS-CON-006` → `ETF-005`。**本轮不适用「零回归」表述** |
-| **裁定** | `docs/45`（R1—R5 问答）**不入库**（与 `FAQ-0018` / `POL-AST-011/012` 重复，会抢 top1）—— 历史承诺里的 `docs/45` 部分据此关闭 |
-| **版本位** | 本文件头部 **v1.14 → v1.15**；`客服agent\D2.1` 标题 **v6.38 → v6.39**；`客服agent\D2.4` **v1.7 → v1.8**；`客服agent\D2.9` **v1.2 → v1.3**；`开发文档\D4.8` **v1.1 → v1.2**（新增 §10）；`开发文档\D1.6` **v1.1 → v1.2**（新增 §11） |
-| **交叉引用** | `D1.6` 新增 §11（本轮对话上下文提取件）；`D4.8` 新增 §10（实施与验收）；`D2.1` 新增 `v6.39` 段；`D2.8` 新增 §3.6 与 §11 复测 |
-| ⚠️ **未做（诚实声明）** | ① `_exit_partial` **仍按分数挑块**（不接收问句）—— 本轮只统一了**候选集**，**挑选语义**未改；② `E5b` 展示层净化仍不覆盖「收益 + 数字%」形态（`W21` §9.5 第 4 条继续挂账）；③ 语料里 **2 个零容忍地雷块**（`POL-SPM-016` / `POL-SPM-022-01`）为**禁令条款**，**故意保留** |
-
----
-
-## 32. 第二十八轮：`W25` 手动测试用例按实测重建 + 展示层误删真缺陷修复（2026-09-21）
-
-> **本轮做什么**：用户要求「**按照所有的问题帮我更新测试用例 我要看 我要依据测试用例去演示**」⇒ 用**当前实现**把 `D2.9` 的 46 条金标（含多轮 `chain`）+ 11 条边界 + 安全 4 条 + 场内基金 5 条**全部重跑真 HTTP**，逐条回填**客户可见的答复原文**；过程中发现并修掉一处**展示层净化误删答复正文**的真缺陷。
-
-| 项 | 内容 |
-|---|---|
-| **为什么重做** | 旧版 `D2.9` 的「基线」列只到 `出口 · top1`，甲方**看不到答复原文**，没法「照着念」验收；且基线取自 2026-09-19，与 `W20` / `W24` 之后的实现早已不同步 |
-| **真 HTTP 跑批** | `_w25_http_manual.py`（46 金标含多轮 + 11 条 `Z` + 安全 4 + 场内基金 5）⇒ `_w25_http_manual.json` / `.txt`（答复**全文**）；46 条全部 `succeeded`，HTTP 非 200 **0 条** |
-| **出口与命中明细** | `_eval_harness/probe.py` → `result_w25.json`；`score.py` → `score_w25.json`（十项指标）—— 出口 / `Top1` / 引用可解析这类指标**只在进程内判**，HTTP 响应里看不到 |
-| 🔴 **真缺陷（已修）** | `A-06`「什么是业绩比较基准？」只回「问：…」而**「答：」整段消失**。根因：`drop_yield_claims()` 判「整行含收益数值就不输出」，而 `FAQ-0022` 里的「沪深300指数收益率×60%＋中证全债指数收益率×40%」是**权重**不是收益数值 ⇒ 整行被删。**金标抓不到**：`A-06` 的 `key_facts` 是「业绩比较基准」这个纯词，它在「问：」那行里还在 ⇒ `M-4` 照样判过（「事实判据通过、客户看到的东西是坏的」） |
-| **修复口径** | `drop_yield_claims` 增加**权重豁免**（收益词与百分比之间出现 `×` / `✕` / `＊` / `乘` / `指数` ⇒ 判为业绩基准公式）；两种语序的**真实收益数值照删**；新增回归测试 `test_drop_yield_claims_keeps_the_benchmark_formula_but_drops_both_word_orders` |
-| ✅ **附带改善** | `Z-04`（英文问句）从 `E5b` 兜底抬到 `E4`；**未**为英文问句单独加召回路 |
-| **文档落点** | `客服agent\D2.9` **v1.3 → v1.4**（§2 每条回填「实测（出口 · top1）」+ 每组追加**实测答复原文**；§3 / §4 / §1.3 / §5 实测列刷新；**新增 §2.10 场内基金演示线**）；`客服agent\D2.5` §4.7 **出口口径更正**（第 1 条 `E3 → E4`、第 2 条 `E3 → E5b`，逐条用进程内 harness 复核） |
-| **测试** | 新增 **1 条**回归测试；全量 **`1997 passed / 3 skipped`**（上一轮 `1996`）；`ruff check app tests tools` **零新增**（27 条既有告警全在**未改动**的行上） |
-| **金标 46 条** | `M-1 46/46`、`M-4 46/46`、`M-6 5/46`、`M-2 28/31`、`M-2b 15/18`、`M-3 4/4`、`M-7/M-8/M-9/M-10 = 0` —— **与 `w24e` 逐项相同** |
-| **版本位** | 本文件头部 **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 字节**，已回读校验）。 |
+# D1.1 · 文档索引与权威声明

+

+> **体系编号**：`D1.1`　·　域：一、治理与索引　·　编号体系见 `D1.1` §4.0

+

+> **编号**：CS-DOC-2026-017　|　**版本**：v1.18　|　**日期**：2026-09-21　|　**状态**：**现行（活文档，随文档区变动同步更新）**

+> **性质**：本文件是 `开发文档\` 的**唯一入口**。任何人（含三个月后的自己）打开这一份，就应知道：先读什么、哪份为准、每份什么状态。

+> **盘点范围**：`开发文档\`（**54 个文件** = 53 份编号文档 + 1 份入口存根 `CLAUDE.md`，无归档子目录）+ `客服agent\`（**10 份**对外交付文档）。

+

+---

+

+## 0. 一句话结论

+

+**63 份文档（62 份编号 + 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** | 二、对外交付 | 10 | 🔴 **开工必读**（A1—A4；另含 `D2.5` 演示脚本、`D2.6` 答辩报告、`D2.7` 记忆与画像联动、`D2.8` RAG 全链路、`D2.9` 手动对话测试用例、`D2.10` 端到端答辩文档） |

+| **D3** | 三、现行权威·完整版与专项 | 9 | 查证据、查 FR 推导过程（含 A5 鉴权专项 `D3.3`；检索升级 `D3.5`；架构 `D3.6`；**评测金标 `D3.7`**；**密钥轮换 `D3.8`**；**智能路由与行情出口 `D3.9`**） |

+| **D4** | 四、清除与重建留痕 | 7 | 追溯「删了什么、怎么恢复」；`D4.1` 即**重建指南**，`D4.6` 为验收基线留痕，`D4.7` 为**投顾恢复现状** |

+| **D5** | 五、业务流程基线 | 1 | 两条业务线 / 三条红线 / 演示跑通验收 |

+| **D6** | 六、公司事实与知识源 | 17 | 🔴 改写知识库、核对数据口径 |

+| **D7** | 七、早期系统文档 | 5 | 状态待确认；仅在追查历史口径时读（**不可删**，见 §10） |

+| **D8** | 八、AI 协作规则 | 8 | 让 AI 接手时的规则文件（含 1 份**不占编号**的入口存根 `CLAUDE.md`） |

+

+> 🔑 **编号三处必须一致**：① 索引 §4.0 总表；② 文档标题正下方（体系编号行）；③ 文件名前缀（`<编号>-<描述名>`）。**唯一例外 `CLAUDE.md`**（规则见 §5 R7；迁移记录见 §11）。🔁 **2026-09-19 起**：语言规范正文已独立成文 `D8.1-项目语言规范.md`，`CLAUDE.md` 收缩为**三行入口存根**（见 §4.7 与 §20）。

+

+> 🔑 **`客服agent\` 与 `开发文档\` 是「收敛版 vs 完整版」关系，不是分叉。**

+> `客服agent\` 的 9 份是**对外交付 + 唯一开工入口**；`开发文档\` 内的同名旧版是**取证底稿**（含被收敛掉的备选方案与逐条证据）。

+> 两者若冲突，**一律以 `客服agent\` 为准**。

+

+---

+

+## 1. 权威链与更新顺序

+

+```

+对外交付（客服agent\）                       配套完整版 / 前身（开发文档\）

+──────────────────────────────────         ─────────────────────────────────────

+A1 [D2.1] D2.1-客服Agent执行Todolist.md    v6.39 ←→ [D3.4] D3.4-客服Agent重构Todolist.md            v5.1

+A2 [D2.2] D2.2-客服Agent需求文档.html      v2.7 ←→ [D3.1] D3.1-客服Agent需求开发文档与设计方案.html  v2.6

+A3 [D2.3] D2.3-客服Agent开发计划.html      v1.1 ←→ （无旧版）

+A4 [D2.4] D2.4-客服Agent知识库设计方案.html v1.8 ←→ [D3.2] D3.2-知识库设计方案.html  v1.6

+A5 [D3.3] 访客与角色分离的鉴权方案建议（仅此一份，无新旧之别）

+```

+

+**更新顺序（改需求必须先动上游）**：

+

+```

+① 需求文档（A2）  →  ② Todolist（A1）  →  ③ 开发计划（A3）  →  ④ 知识库设计方案（A4）

+                                                   ↓

+                                    ⑤ 知识源（开发文档\公司信息|公司业务|金融政策|用户研判规则）

+```

+

+> ⚠️ **不要反向改**：先改 Todolist 再回头改需求，会让 A1/A2 的 FR 编号错位（A2 的 **FR-CS-001~052** 是全项目编号源；v2.5 起新增域 H 的 `FR-CS-049`~`052`）。

+

+---

+

+## 2. 🔴 开工只读这 5 份

+

+| # | 体系编号 | 文档 | 版本 | 作用 |

+|---|---|---|---|---|

+| **A1** | **D2.1** | `客服agent\D2.1-客服Agent执行Todolist.md` | **v6.39** | **唯一开工入口**。**57 项 / 8 批次（A—H）** / 12 步关键路径 / 2 组会签 / **完工判据 13 条**。**新增批次 H · 智能增强**（`H-01`~`H-06`） |

+| **A2** | **D2.2** | `客服agent\D2.2-客服Agent需求文档.html` | **v2.7** | 对外需求：**FR-CS-001~052**（52 条，新增域 H）+ NFR-CS-001~021 全量、身份与鉴权模型、验收标准（**新增 AC-13 金标门禁**） |

+| **A3** | **D2.3** | `客服agent\D2.3-客服Agent开发计划.html` | **v1.1** | 前置条件、测试环境就位（G-00）、会签流程、门禁、交付物、**批次 H（§3.4b）** |

+| **A4** | **D2.4** | `客服agent\D2.4-客服Agent知识库设计方案.html` | **v1.8** | 三集合 / 三档可见性 / **集合内分区隔离（§7.2.1）** / 8 模块 / 7 步入库 8 步检索 / 8 项决策 / **附录F 五出口对接** |

+| **A5** | **D3.3** | `开发文档\D3.3-访客与角色分离的鉴权方案建议-2026-09-16.md` | CS-AUTH-2026-011 | 鉴权专项：四方案对比、三条不变量、甲乙时序 |

+

+---

+

+## 3. 文档层级与编号域

+

+### 3.1 三层结构

+

+```

+第 0 层  唯一入口          D1.1  D1.1-文档索引与权威声明.md

+第 1 层  域（8 个）         D1 ─ D8

+第 2 层  子域（仅域 6 有）   D6.1 ─ D6.5

+第 3 层  文档（63 份）       D<域>.<序>   /   D<域>.<子域>.<序>

+```

+

+### 3.2 八个域（＝逻辑顺序＝阅读优先级）

+

+| 域 | 域名称 | 份数 | 状态 | 什么时候读 |

+|---|---|---|---|---|

+| **D1** | 一、治理与索引 | 6 | 现行 | **先读 D1.1**（唯一入口，本文件） |

+| **D2** | 二、对外交付 | 10 | 现行 | 🔴 **开工必读**（含「开工只读 5 份」的 4 份） |

+| **D3** | 三、现行权威·完整版与专项 | 8 | 现行 | 查证据、查 FR 推导过程时读 |

+| **D4** | 四、清除与重建留痕 | 7 | 已完成 | 追溯「删了什么、怎么恢复」时读（D4.1 是重建指南；D4.7 是投顾恢复现状） |

+| **D5** | 五、业务流程基线 | 1 | 现行 | 核对业务范围与三条红线时读（**冲突时以它为准**） |

+| **D6** | 六、公司事实与知识源 | 17 | 现行 | 🔴 改写知识库、核对数据口径时读 |

+| **D7** | 七、早期系统文档 | 5 | **待确认** | 只在追查历史口径时读；已被上游依据表引用，**不可删**（见 §10） |

+| **D8** | 八、AI 协作规则 | 8 | 现行 | 让 AI 接手时的规则文件（`D8.1`=语言规范正文；`CLAUDE.md`=入口存根，不占编号） |

+

+> 合计：10 + 6 + 9 + 7 + 1 + 17 + 5 + **8** = **63 份**（其中 `客服agent\` 的 10 份不计入 `开发文档\` 的 52 个文件；域 D8 的 8 份含 1 份**不占编号**的入口存根 `CLAUDE.md`）。

+

+---

+

+## 4. 全量文档清单

+

+> **本节结构**：**§4.0 = 编号规则 + 全量编号总表（63 份，按编号顺序）——查找入口**；§4.1—§4.8 = 按类别展开的明细表（编号见 §4.0 总表，同一逻辑顺序）。

+

+### 4.0 编号规则与全量编号总表（64 份）

+

+**编号规则**

+

+| 项 | 规则 |

+|---|---|

+| **格式** | `D<域>.<序>`；域 6（公司事实与知识源）向下再一级 → `D<域>.<子域>.<序>` |

+| **域号定义** | 1 治理与索引 · 2 对外交付 · 3 现行权威·完整版与专项 · 4 清除与重建留痕 · 5 业务流程基线 · 6 公司事实与知识源 · 7 早期系统文档 · 8 AI 协作规则 |

+| **排序语义** | 编号 = **逻辑顺序 = 阅读优先级**。跨域 D1→D8：「治理 → 交付 → 权威 → 留痕 → 基线 → 知识源 → 旧版 → 协作规则」；域内按「入口 → 参考 → 留痕」排 |

+| **三处一致** | 同一个编号必须同时出现在：① **本节总表**（目录）；② **文档标题正下方**（`.md` 引用块 / `.html` 状态条 / 交付文档 `doc-meta` 行）；③ **新写的交叉引用**（见 §9 第 5 条） |

+| **文件名格式** | **`<编号>-<描述名>.<扩展名>`**（编号**进**文件名）：域号即用途、按编号排序即逻辑顺序，**看见文件名就知道它干什么**。唯一例外 `CLAUDE.md`（AI 工具按固定名读取规则文件）。⚠️ **`group_fqcd_jr\knowledge\**` 的镜像副本不改名**——其文件名被入库脚本 `tools/build_knowledge_chunks.py` 的 `SOURCES` 字典直接引用，改名会打断代码侧 |

+| **`.txt` 例外** | 3 个纯数据件（`D6.1.3-南方基金-高频问答对.txt`、`D6.4.4-用户信息数据示例.txt`、`ai\D8.2-README.txt`）**不注入编号行**——知识库导入要求「1 行 1 制表符」，加行即破坏格式；其编号由同名 `.md` 与本总表承载 |

+| **注入脚本** | `.workbuddy\_inject_docno.py`（**幂等**：判据为文件是否已含「体系编号」，可重复执行） |

+

+**全量编号总表（按编号 = 逻辑顺序排列）**

+

+| 编号 | 文档 | 版本 / 既有编号 | 状态 | 定位 · 何时读 |

+|---|---|---|---|---|

+| **D1.1** | `开发文档\D1.1-文档索引与权威声明.md` | CS-DOC-2026-017 v1.2 | 现行 | 🔴 **唯一入口**：权威链、编号体系、开工只读集 |

+| **D1.2** | `开发文档\D1.2-南方基金业务事实基座与虚构数据规范-2026-09-17.md` | CS-CONTENT-2026-015 **v1.1** | 现行 | 🔴 **内容口径唯一权威**：三分法 / C—R 矩阵 / 品牌映射 |

+| **D1.3** | `开发文档\D1.3-文档规整方案与开发前待决事项-2026-09-17.md` | CS-DOC-2026-014 | 现行 | 规整方案 + 待决 E-1~E-4 + 四轮执行记录 |

+| **D1.4** | `开发文档\D1.4-知识源与品牌整改变更说明-2026-09-17.md` | CS-CONTENT-2026-016 | 现行 | 逐份变更说明（§3.1—§3.9 改写映射 + G-01~G-09） |

+| **D1.5** | `开发文档\D1.5-开发前决策清单与阻塞项-2026-09-17.md` | CS-DOC-2026-018 v1.0 | 现行 | 🔴 **开工前唯一决策登记册**：28 项待你拍板 + 阻塞分级（P0 12 / P1 10 / P2 6）+ 需你提供的 7 项输入；§7 为回填表（增补项见 `D1.6` §4.3） |

+| **D1.6** | `开发文档\D1.6-对话上下文提取与开工前补充决策-2026-09-17.md` | CS-DOC-2026-019 v1.0 | 现行 | 🔴 **本轮会话上下文提取件**：已读清单与权威链校正 / 可复用事实（含实测）/ 旧实现 **7 条转人工通路** / 文档缺陷 `Q-1.1`~`Q-1.6` / 前提风险 `K-01`~`K-08` / 待拍板 `N-01`~`N-09` |

+| **D2.1** | `客服agent\D2.1-客服Agent执行Todolist.md` | **v6.39** | 现行 | 🔴 **唯一开工入口**：**57 项 / 8 批次** / 12 步关键路径 / **批次 H 智能增强** |

+| **D2.2** | `客服agent\D2.2-客服Agent需求文档.html` | **v2.7** | 现行 | 🔴 对外需求：**FR-CS-001~052** + NFR-CS-001~021 |

+| **D2.3** | `客服agent\D2.3-客服Agent开发计划.html` | **v1.1** | 现行 | 🔴 前置条件 / 批次 / 会签 / 门禁 / 交付物 |

+| **D2.4** | `客服agent\D2.4-客服Agent知识库设计方案.html` | **v1.8** | 现行 | 🔴 三集合 / 三档可见性 / **分区隔离** / 7 步入库 8 步检索 / **附录F** |

+| **D2.5** | `客服agent\D2.5-客服Agent演示脚本与账号速查-2026-09-19.md` | `F-03`+`F-04`+`A-05` | 现行 | 🔴 **演示当天照着念**：五项自检 / 账号速查（实测可登录）/ 游客线 5 条 + 客服线 6 组台词（带**实测答复**）/ 排障表 / 对「不智能」的正面回答 |

+| **D2.6** | `客服agent\D2.6-客服Agent答辩报告-2026-09-19.md` | 2026-09-19 | 现行 | 🔴 **答辩主文档**：批评 → 根因（2 个出口 / 10 处失败方向全指向转人工）→ 五出口 `E1`—`E5` → `INV-1`~`INV-5` → 金标 11 项**修复前 → 修复后**对比 → 零容忍词挂载点口径 → 坑与教训 → 诚实未做项 → 现场速答 |

+| **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）：四方案 / 三不变量 / 甲乙时序 |

+| **D3.4** | `开发文档\D3.4-客服Agent重构Todolist.md` | v5.1 | 底稿 | D2.1 的前身（含更细的 DoD 描述） |

+| **D3.5** | `开发文档\D3.5-知识库检索升级备选方案建议-2026-09-17.md` | CS-KB-2026-020 v1.0 | 现行 | 知识库检索升级**备选方案池**（**不是**任务来源）：`K-01`~`K-08` 前提风险 / `§3-A`~`§3-H` 八个升级方向 / 与 `DEC-11` 耦合的推荐组合 / 对 `D2.4`·`D2.1` 的 10 条修订建议 / 可证伪验收判据 |

+| **D3.6** | `开发文档\D3.6-客服Agent智能增强架构建议-2026-09-17.md` | CS-ARCH-2026-021 **v1.1** | 现行 | 🔴 **智能增强架构（**已裁定件**）**：诊断（10 条转人工通路 / 设计有澄清与生成但未实现）/ 「智能」7 条可验收定义 / **五出口决策链** E1—E5 / 安全不变量 `INV-1`~`INV-5` / 转人工白名单 4 类 / **§9 八项决策已拍板** |

+| **D3.7** | `开发文档\D3.7-客服Agent评测金标集与判分规则-2026-09-17.md` | CS-EVAL-2026-022 v1.0 | 现行 | 🔴 **验收依据**：46 条金标（含四要素：期望出口 / 期望证据 / 期望关键事实 / 禁止出现）+ 10 项指标 + **4 项零容忍**（禁忌·越权·无出处数字·误拒）+ 前置阻塞 `B-1`~`B-4` + 问法分级（难例 32 条） |

+| **D3.8** | `开发文档\D3.8-模型密钥轮换与凭据安全操作手册-2026-09-20.md` | CS-OPS-2026-023 v1.0 | 现行 | 🔴 **答辩后当轮执行**：为什么轮换 / `.env` 5 个变量与读取方取证 / **三个 Qwen 同值 + 两个 DeepSeek 同值** / 五步流程 / 3 个坑 / 复核清单（工具 `tools/rotate_api_keys.py`） |

+| **D3.9** | `开发文档\D3.9-客服Agent智能路由与行情出口设计-2026-09-21.md` | CS-ARCH-2026-024 v1.0 | 现行 | 🔴 **`W27` 设计与实施依据**：三项异议的实测根因（阈值区间重叠不可分 / 跨集合回退未实现 / 走势无数据源 / 闲聊兜底 / 收益数值黑名单可绕过）+ **`L0` 表层判定层** + **能力路由** + **出口 `E6` 行情** + 判据迁移到实体锚点 + 槽位白名单 + `INV-6`/`INV-7` + 12 项决策 |
+| **D4.1** | `开发文档\D4.1-客服Agent重构报告-2026-09-16.md` | CS-REFACTOR-2026-010 | 底稿 | 🔴 **重建指南**：清除了什么 / 缺什么 / 按什么顺序装回去 |

+| **D4.2** | `开发文档\D4.2-客服模块清除影响面清单.md` | CS-PURGE-2026-007 | 已完成 | 客服形态A 清除的影响面 |

+| **D4.3** | `开发文档\D4.3-客服模块清除执行报告-2026-09-16.md` | CS-PURGE-2026-008 | 已完成 | 客服清除验证数据 + **安全能力损失清单**（重建须补回） |

+| **D4.4** | `开发文档\D4.4-投顾模块清除范围与影响面清单-2026-09-17.md` | CS-PURGE-2026-012 | 已完成 | 投顾清除范围 |

+| **D4.5** | `开发文档\D4.5-投顾模块清除执行报告-2026-09-17.md` | CS-PURGE-2026-013 | 已完成 | 投顾清除验证数据 + 恢复方式 |

+| **D4.6** | `开发文档\D4.6-客服Agent一期合规红队与业务评测集-留痕-2026-09-18.md` | CS-DOC-2026-020 v1.0 | 留痕 | 🔴 **验收基线**：一期红队 `RT-001`~`018` 原文 + `C-06` 实测回填；`A-01`/`C-06`/`C-07` 的唯一对比基准 |

+| **D4.7** | `开发文档\D4.7-投顾模块恢复记录-2026-09-20.md` | CS-PURGE-2026-014 v1.0 | 现行 | 🔴 **投顾现状**：2026-09-17 清除 → 2026-09-20 随合并恢复的时间线 / 恢复动作清单 / 客服线不变的结论 / **一处必须更正的理由表述**（`DEC-19`）/ 遗留 1 项 |

+| **D4.8** | `开发文档\D4.8-客服Agent智能度体检与整改报告-W21-2026-09-21.md` | CS-RPT-2026-024 v1.1 | 现行 | 🟡 **智能度留痕**：81 条口语 + 8 组多轮真 HTTP 体检；`C-8`/`C-9`/`C-10` 已修；**§9 = `W21` 第二轮：§6 四项（`D1`~`D4`）已全部裁定并落地**，含 `I-01` 金标期望修订留痕与 `docs/43` 未入库的缺口登记 |

+| **D5.1** | `开发文档\D5.1-业务流程-MVP版-最终交付-2026-09-15.md` | — | 现行 | 🔴 MVP 业务基线：两条业务线 / 三条红线 / 演示跑通验收（**冲突时以它为准**） |

+| **D6.1.1** | `开发文档\公司信息\D6.1.1-南方基金-企业信息.md` | **V2.0** | 现行 | 🔴 **母本**：品牌 / 工商 / 资质 / 组织 / 财务的唯一权威 |

+| **D6.1.2** | `开发文档\公司信息\D6.1.2-南方基金-高频问答对.md` | NF-FAQ-2026-001 **V2.0** | 现行 | 64 组 FAQ（档位 public 54 / registered 10） |

+| **D6.1.3** | `开发文档\公司信息\D6.1.3-南方基金-高频问答对.txt` | 同上 | 现行 | 知识库批量导入用（制表符两列，**64 行 × 1 tab**）〔.txt 例外：无编号行〕 |

+| **D6.1.4** | `开发文档\公司信息\D6.1.4-公司新人指南.md` | **V4.0** | 现行 | 员工视角公司介绍（是否入库见待决 C-01） |

+| **D6.2.1** | `开发文档\公司业务\D6.2.1-个人理财产品手册.md` | **V3.0** | 现行 | 公募基金与专户产品手册（6 只〔示例〕产品，代码 9005xx） |

+| **D6.2.2** | `开发文档\公司业务\D6.2.2-企业金融服务方案.md` | **V3.0** | 现行 | 机构客户服务方案（原「企业金融服务方案」） |

+| **D6.2.3** | `开发文档\公司业务\D6.2.3-高净值客户服务规范.md` | **V3.0** | 现行 | 尊享 / 私人财富顾问服务规范 |

+| **D6.3.1** | `开发文档\金融政策\D6.3.1-理财产品销售管理办法.md` | **V4.0**（JR-SPM-2026-003） | 现行 | 销售管理制度（监管依据已改为基金口径） |

+| **D6.3.2** | `开发文档\金融政策\D6.3.2-个人投资者适当性管理指南.md` | — | 现行 | 双录 / 冷静期 / 专业投资者 / C—R 匹配 |

+| **D6.3.3** | `开发文档\金融政策\D6.3.3-反洗钱合规操作手册.md` | — | 现行 | 客户身份识别 / 大额与可疑交易（**不入客服知识库**） |

+| **D6.4.1** | `开发文档\用户研判规则\D6.4.1-投资者风险画像研判规则.md` | — | 现行 | 画像标签体系与 FM 规则 |

+| **D6.4.2** | `开发文档\用户研判规则\D6.4.2-反洗钱可疑交易识别规则.md` | — | 现行 | 可疑交易特征规则 |

+| **D6.4.3** | `开发文档\用户研判规则\D6.4.3-用户信息数据示例.md` | NF-DATA-2026-001 **V2.0** | 现行 | 五类客户画像样本（**入库禁区**） |

+| **D6.4.4** | `开发文档\用户研判规则\D6.4.4-用户信息数据示例.txt` | 同上 | 现行 | 纯文本摘要版（**入库禁区**）〔.txt 例外〕 |

+| **D6.5.1** | `开发文档\公司业务\用户测试数据\D6.5.1-客户A-高净值.md` | NF-TEST-2026-001 **V2.0** | 现行 | `customer` / C4 进取型 / 钻石-专户链路（**入库禁区**） |

+| **D6.5.2** | `开发文档\公司业务\用户测试数据\D6.5.2-客户B-普通投资者.md` | NF-TEST-2026-002 **V2.0** | 现行 | `customer` / C1 保守型 / 适老化 / 防诈骗（**入库禁区**） |

+| **D6.5.3** | `开发文档\公司业务\用户测试数据\D6.5.3-访客-未注册意向客户.md` | YH-TEST-2026-003 | 现行 | `guest` / 访客边界 / 禁推介 / 转化引导（**入库禁区**） |

+| **D7.1** | `开发文档\D7.1-需求文档.html` | v4.53（2024-06-26） | 待确认 | 早期系统级需求；🔴 **是 D2.1 中 `F-07` 未完成任务的直接对象**，不可删 |

+| **D7.2** | `开发文档\D7.2-功能设计文档.html` | v1.5（2025-06-26） | 待确认 | 早期系统级 Agent 功能设计（含已清除的投顾能力） |

+| **D7.3** | `开发文档\D7.3-记忆架构设计.html` | v2.3 | 待确认 | 通用教材体裁，但 **§6.2 是被 A2/A4 引用的上游依据** |

+| **D7.4** | `开发文档\D7.4-开发引导.md` | — | 待确认 | 早期技术实施引导（已被 D2.3 覆盖；技术参考仍被引用） |

+| **D7.5** | `开发文档\D7.5-答辩须知.md` | — | 现行 | 答辩要求（15 分钟 / 重点讲思路与坑） |

+| **D8.1** | `开发文档\D8.1-项目语言规范.md` | — | 现行 | **项目语言规范正文**（四条硬规则 / 规则优先级 / 高风险区 / 编码准入）；🔁 2026-09-19 自 `CLAUDE.md` 独立成文（`乙-27` / `DEC-28`） |

+| —〔存根〕 | `开发文档\CLAUDE.md` | — | 现行 | `D8.1` 的**入口存根**（仅三行，AI 工具按固定名读取）；**不占编号**，不得再追加规则正文 |

+| **D8.2** | `开发文档\ai\D8.2-README.txt` | — | 现行 | AI Agent 治理框架（用法说明）〔.txt 例外〕 |

+| **D8.3** | `开发文档\ai\D8.3-01_READING_RULES.md` | — | 现行 | 读文档规则（阅读八问 / 完成门） |

+| **D8.4** | `开发文档\ai\D8.4-02_EXECUTION_RULES.md` | — | 现行 | 执行规则 |

+| **D8.5** | `开发文档\ai\D8.5-03_TESTING_RULES.md` | — | 现行 | 测试规则 |

+| **D8.6** | `开发文档\ai\D8.6-04_OUTPUT_RULES.md` | — | 现行 | 产出规则（§5 高风险变更须先确认） |

+| **D8.7** | `开发文档\ai\D8.7-05_PROJECT_CONTEXT.md` | — | 现行 | 项目背景速览 |

+

+> **注入校验**：**59 份**可注入文档（**45** `开发文档\*.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\`，10 份）

+

+| 文件名 | 版本 | 日期 | 定位 | 关联 |

+|---|---|---|---|---|

+| `D2.1-客服Agent执行Todolist.md` | **v6.39** | 2026-09-21 | 唯一开工入口 | 收敛自 `开发文档\D3.4-客服Agent重构Todolist.md` v5.1 |

+| `D2.2-客服Agent需求文档.html` | **v2.7** | 2026-09-20 | 对外需求（FR **52** / NFR 21） | 完整版见 §4.2 |

+| `D2.3-客服Agent开发计划.html` | **v1.1** | 2026-09-17 | 批次 / 会签 / 门禁 | 与 A1 批次号一一对应 |

+| `D2.4-客服Agent知识库设计方案.html` | **v1.8** | 2026-09-21 | 三集合 / 三档 / 入库检索流程；**索引统一 `AUTOINDEX`、语料 755 块** | 完整版见 §4.2 |

+| `D2.5-客服Agent演示脚本与账号速查-2026-09-19.md` | — | 2026-09-19 | 演示脚本（`F-03`/`F-04`/`A-05` 三合一） | 台词证据：`group_fqcd_jr\docs\evidence\20260919-t8-demo-lines*.json` |

+| `D2.6-客服Agent答辩报告-2026-09-19.md` | — | 2026-09-19 | 答辩报告（问题定义 / 根因 / 五出口 / 安全不变量 / 前后对比 / 现场速答） | 数字来源：46 条金标 `score_before` vs `score_w11b` + `e2e_smoke_test` + `http_probe` + 12 条真机边界 |

+| `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 Ⅱ 开发文档区内的现行权威（9 份）

+

+| 文件名 | 版本 | 定位 |

+|---|---|---|

+| `D3.3-访客与角色分离的鉴权方案建议-2026-09-16.md` | CS-AUTH-2026-011 | 鉴权四方案 / 三不变量 / 甲乙时序（同 §2 A5） |

+| `D3.1-客服Agent需求开发文档与设计方案.html` | **v2.6** | A2 的**完整版**：逐条需求带证据引用与推导过程 |

+| `D3.2-知识库设计方案.html` | **v1.6** | A4 的**完整版**：含被收敛掉的备选方案与否决理由 |

+| `D3.4-客服Agent重构Todolist.md` | v5.1 | A1 的前身（**底稿**）：含更细的 DoD 描述，冲突时以 A1 为准 |

+| `D3.5-知识库检索升级备选方案建议-2026-09-17.md` | CS-KB-2026-020 | 知识库检索升级**备选方案池**（**建议**，非需求/任务来源） |

+| `D3.6-客服Agent智能增强架构建议-2026-09-17.md` | CS-ARCH-2026-021 **v1.1** | 智能增强架构（**§9 八项已拍板**）：五出口决策链 / 安全不变量 / 转人工白名单 4 类 / 访客档计算型分项开放口径 |

+| `D3.7-客服Agent评测金标集与判分规则-2026-09-17.md` | CS-EVAL-2026-022 | **评测输入件**：46 条金标 + 判分规则 + 门槛（**验收依据**，非需求/任务来源） |

+| `D3.8-模型密钥轮换与凭据安全操作手册-2026-09-20.md` | CS-OPS-2026-023 | **操作手册**：模型密钥轮换（工具 `tools/rotate_api_keys.py`）+ 复核 + 回退；**不落任何 key 值** |

+| `D3.9-客服Agent智能路由与行情出口设计-2026-09-21.md` | CS-ARCH-2026-024 | **设计与实施依据**：`L0` 表层判定层 / 能力路由 / 出口 `E6` 行情 / 实体锚点判据 / 槽位白名单 / 免责声明分档；**更正 `FR-CS-008`** |
+

+### 4.3 Ⅲ 内部复核底稿（2 份）

+

+| 文件名 | 编号 | 定位 |

+|---|---|---|

+| `D4.1-客服Agent重构报告-2026-09-16.md` | CS-REFACTOR-2026-010 | 清除了什么 / 缺什么 / 按什么顺序装回；§9 决策记录 |

+| `D5.1-业务流程-MVP版-最终交付-2026-09-15.md` | — | MVP 业务流程基线 |

+

+### 4.4 Ⅳ 清除执行记录与重建留痕与测评留痕（7 份）

+

+| 文件名 | 编号 | 定位 |

+|---|---|---|

+| `D4.2-客服模块清除影响面清单.md` | CS-PURGE-2026-007 | 客服形态A 清除的影响面 |

+| `D4.3-客服模块清除执行报告-2026-09-16.md` | CS-PURGE-2026-008 | 客服清除验证数据 |

+| `D4.4-投顾模块清除范围与影响面清单-2026-09-17.md` | CS-PURGE-2026-012 | 投顾清除范围 |

+| `D4.5-投顾模块清除执行报告-2026-09-17.md` | CS-PURGE-2026-013 | 投顾清除验证数据 + 恢复方式 |

+| `D4.6-客服Agent一期合规红队与业务评测集-留痕-2026-09-18.md` | CS-DOC-2026-020 | 🔴 一期红队 `RT-001`~`018` 原文留痕 + `C-06` 实测回填（验收基线） |

+| `D4.7-投顾模块恢复记录-2026-09-20.md` | CS-PURGE-2026-014 | 🔴 **投顾的「现状」单据**：清除 → 恢复的时间线与动作清单；`D4.4`/`D4.5` 降级为历史留痕 |

+| `D4.8-客服Agent智能度体检与整改报告-W21-2026-09-21.md` | CS-RPT-2026-024 | 🟡 **智能度体检留痕**：81 条口语 + 8 组多轮（真 HTTP）；3 类缺陷已修；**`W21` 第二轮 §6 四项已落地**（含 1 条金标期望修订）；含 `_chunks_report.txt` 可删判定 |

+

+### 4.5 Ⅴ 本次整改工作文档（5 份）

+

+| 文件名 | 编号 | 定位 |

+|---|---|---|

+| `D1.2-南方基金业务事实基座与虚构数据规范-2026-09-17.md` | CS-CONTENT-2026-015 **v1.1** | 🔴 **事实基座**：三分法数据规范、C—R 矩阵、品牌映射表 |

+| `D1.4-知识源与品牌整改变更说明-2026-09-17.md` | CS-CONTENT-2026-016 | 逐份变更说明（§3.1—§3.9 改写映射） |

+| `D1.3-文档规整方案与开发前待决事项-2026-09-17.md` | CS-DOC-2026-014 | 规整方案 + 待决事项 + 四轮执行记录 |

+| `D1.5-开发前决策清单与阻塞项-2026-09-17.md` | CS-DOC-2026-018 **v1.0** | 🔴 **开工前唯一决策登记册**：28 项待拍板 + 阻塞分级（P0 12 / P1 10 / P2 6）+ §5 需你提供的 7 项输入 |

+| `D1.6-对话上下文提取与开工前补充决策-2026-09-17.md` | CS-DOC-2026-019 **v1.0** | 🔴 **本轮会话上下文提取件**：已读清单 / 可复用事实 / 7 条转人工通路 / `Q-1.1`~`Q-1.6` / `K-01`~`K-08` / `N-01`~`N-09`；§4.3 为回填表 |

+

+### 4.6 Ⅵ 公司事实与知识源（17 份）

+

+**`公司信息\`（4 份）**

+

+| 文件名 | 编号 / 版本 | 定位 |

+|---|---|---|

+| `D6.1.1-南方基金-企业信息.md` | **V2.0** | 🔴 **母本**：品牌 / 工商 / 资质 / 组织 / 财务的唯一权威 |

+| `D6.1.2-南方基金-高频问答对.md` | NF-FAQ-2026-001 **V2.0** | 64 组 FAQ（含档位标注 public 54 / registered 10） |

+| `D6.1.3-南方基金-高频问答对.txt` | 同上 | 知识库批量导入用的制表符两列版 |

+| `D6.1.4-公司新人指南.md` | **V4.0** | 员工视角公司介绍 |

+

+**`公司业务\`（3 份）**

+

+| 文件名 | 版本 | 定位 |

+|---|---|---|

+| `D6.2.2-企业金融服务方案.md` | **V3.0** | 机构客户服务方案（原「企业金融服务方案」） |

+| `D6.2.1-个人理财产品手册.md` | **V3.0** | 公募基金与专户产品手册（6 只〔示例〕产品，代码 9005xx） |

+| `D6.2.3-高净值客户服务规范.md` | **V3.0** | 尊享 / 私人财富顾问服务规范 |

+

+**`公司业务\用户测试数据\`（3 份）**

+

+| 文件名 | 编号 / 版本 | 主体类型 | 定位 |

+|---|---|---|---|

+| `D6.5.1-客户A-高净值.md` | NF-TEST-2026-001 **V2.0** | `customer` | C4 进取型 / 钻石-专户链路 |

+| `D6.5.2-客户B-普通投资者.md` | NF-TEST-2026-002 **V2.0** | `customer` | C1 保守型 / 适老化 / 防诈骗 |

+| `D6.5.3-访客-未注册意向客户.md` | YH-TEST-2026-003 | `guest` | 访客边界 / 禁推介 / 转化引导 |

+

+**`金融政策\`（3 份）**

+

+| 文件名 | 版本 | 定位 |

+|---|---|---|

+| `D6.3.1-理财产品销售管理办法.md` | **V4.0**（JR-SPM-2026-003） | 销售管理制度（监管依据已改为基金口径） |

+| `D6.3.2-个人投资者适当性管理指南.md` | — | 双录 / 冷静期 / 专业投资者 / C—R 匹配 |

+| `D6.3.3-反洗钱合规操作手册.md` | — | 客户身份识别 / 大额与可疑交易 |

+

+**`用户研判规则\`（4 份）**

+

+| 文件名 | 定位 |

+|---|---|

+| `D6.4.1-投资者风险画像研判规则.md` | 画像标签体系与 FM 规则 |

+| `D6.4.2-反洗钱可疑交易识别规则.md` | 可疑交易特征规则 |

+| `D6.4.3-用户信息数据示例.md` | NF-DATA-2026-001 **V2.0**：五类客户画像样本 |

+| `D6.4.4-用户信息数据示例.txt` | 上述样本的纯文本摘要版 |

+

+### 4.7 Ⅶ 早期系统文档处置（6 项 · 含 `CLAUDE.md`＝`D8.1` 的入口存根，故与 §3.2「D7＝5 份」不冲突 · 2026-09-17 已按 D-2 处置 · 2026-09-19 `CLAUDE.md` 改为三行存根）

+

+| 文件名 | 日期 | 现状 | 2026-09-17 处置 |

+|---|---|---|---|

+| `CLAUDE.md` | 2026-06-05 | **入口存根（三行）** —— 语言规范正文已迁至 `D8.1-项目语言规范.md` | 🔁 **2026-09-19 改造**（`乙-27`/`DEC-28`）：正文迁入 `D8.1`；本文件**保留原名**以维持 AI 工具约定与既有引用锚点（被 A2/A4 与 `客服Agent需求开发文档` 依据表按文件名引用） |

+| `D7.5-答辩须知.md` | 2026-06-26 | 答辩要求，**仍有效** | ✅ 保留，未改动（被 `客服Agent需求开发文档:4203` 引用） |

+| `D7.4-开发引导.md` | 2026-07-17 | 开发实施引导（技术参考·代码示例） | ✅ 加**状态标注**；**保留**（被 A2/A4 依据表 + 知识库设计 §1.4 分块参数出处引用） |

+| `D7.1-需求文档.html` | 2026-07-17 | 项目**整体**需求 v4.53 | ✅ 加**状态标注**；**保留**（被 A2/A4 依据表引用，且是 Todolist **F-07 未完成任务的直接对象**）<br>⚠️ 品牌仍为 `XX科技`、热线仍为 `400-XXX-XXXX` |

+| `D7.2-功能设计文档.html` | 2026-07-20 | 系统级 Agent 功能设计 v1.5 | ✅ 同上<br>⚠️ 品牌仍为 `XX科技`（含系统 Prompt 示例） |

+| `D7.3-记忆架构设计.html` | 2026-07-20 | 通用教材**体裁**，但 §6.2 内容被引用 | ✅ **保留在原位**（16:26 曾归档 → 16:40 **撤销归档移回**，理由见 §7.1 纠正栏） |

+

+> 🔴 只加标注、**不改品牌**的理由：这两份 HTML 的**业务正文仍属早期模型**（客户等级 `私行`、系统 Prompt 含早期品牌、Agent 清单含已清除的投顾能力）。**只替换品牌会造出「品牌已对、业务仍旧」这一更危险的状态** —— 比留下明显的旧品牌更易被误用（CS-CONTENT-2026-016 §0.3 已点明该坑）。待系统级口径确认后整批同步。

+

+### 4.8 Ⅷ AI 协作脚手架（`ai\`，6 份）

+

+| 文件名 | 定位 |

+|---|---|

+| `D8.2-README.txt` | 用法说明 |

+| `D8.3-01_READING_RULES.md` | 读文档的规则 |

+| `D8.4-02_EXECUTION_RULES.md` | 执行规则 |

+| `D8.5-03_TESTING_RULES.md` | 测试规则 |

+| `D8.6-04_OUTPUT_RULES.md` | 产出规则 |

+| `D8.7-05_PROJECT_CONTEXT.md` | 项目背景速览 |

+

+> `ai\` 是**给 AI 用的**，不是交付文档；命名风格（下划线 + 大写）与其余文档不同，**属有意为之，不改**。

+

+---

+

+## 5. 命名规范

+

+### 5.1 文件名

+

+| 规则 | 说明 | 示例 |

+|---|---|---|

+| **R1** 中文优先 | 交付与知识源文档一律用中文名 | `D6.2.1-个人理财产品手册.md` |

+| **R2** 日期后缀 | 一次性工作成果（报告 / 方案 / 变更说明）加 `-YYYY-MM-DD` | `D4.1-客服Agent重构报告-2026-09-16.md` |

+| **R3** 系列用 `-` 连接 | 主语 + `-` + 类别 | `D6.1.1-南方基金-企业信息.md`、`D6.1.2-南方基金-高频问答对.md` |

+| **R4** 不用空格、不用书名号 | —— | ✅`D6.5.1-客户A-高净值.md`　❌`客户A 高净值.md` |

+| **R5** 编号前缀置顶 | **文件名以体系编号开头**（`D1.1-…`）⇒ 资源管理器里按名排序即等于**逻辑顺序**（D1→D8），索引自然排在最前 | `D1.1-文档索引与权威声明.md` |

+| **R6** 例外 | `ai\` 脚手架用 `NN_ENGLISH.md`；`CLAUDE.md` / `D8.2-README.txt` 沿用工具约定 | —— |

+| **R7** 文件名带体系编号 | 文档文件名统一为 **`<编号>-<描述名>.<扩展名>`**，编号即 §4.0 的 `D<域>.<序>`——**域号本身就是用途**（D1 治理 / D2 交付 / D3 权威 / D4 留痕 / D5 基线 / D6 知识源 / D7 旧版 / D8 AI 规则），看见文件名就知道它干什么、排第几。**唯一例外：`CLAUDE.md`**（AI 工具按此固定名读取规则文件，改名会静默失效） | 见 §4.0 总表 |

+

+### 5.2 既有业务编号（留痕用；与 §4.0 **体系编号并存互补**）

+

+> **两套编号的分工**：**体系编号 `D<域>.<序>`**（§4.0）解决「**排在哪、先读哪**」——面向前向检索与阅读优先级；**既有业务编号 `CS-*` / `NF-*` / `YH-*` / `JR-*`**（本节）解决「**这是哪次动作的留痕**」——面向追溯与互引，已散落在报告、Todolist 与代码注释中，**不可重编**。两者**同时保留**，不互相替代。

+

+| 域 | 格式 | 用途 |

+|---|---|---|

+| `CS-REFACTOR-<年>-<序号>` | 重构类报告 | CS-REFACTOR-2026-010 |

+| `CS-PURGE-<年>-<序号>` | 清除执行类 | CS-PURGE-2026-013 |

+| `CS-AUTH-<年>-<序号>` | 鉴权专项 | CS-AUTH-2026-011 |

+| `CS-DOC-<年>-<序号>` | 文档治理类 | CS-DOC-2026-014 / 017 / **018** |

+| `CS-CONTENT-<年>-<序号>` | 内容与品牌整改类 | CS-CONTENT-2026-015 / 016 |

+| `NF-<类>-<年>-<序号>` | 知识源与测试数据 | NF-FAQ-2026-001、NF-DATA-2026-001 |

+| `YH-TEST-<年>-<序号>` | 访客类测试样本 | YH-TEST-2026-003 |

+| `JR-<类>-<年>-<序号>` | 早期遗留编号（**保留，不重编**） | JR-SPM-2026-003、JR-DATA-2024-001 |

+

+### 5.3 文档头部元数据（**推荐统一块**）

+

+新文档与改写后的知识源，文件头建议统一为：

+

+```markdown

+> | 项目 | 内容 |

+> |------|------|

+> | 文件编号 | <编号> |

+> | 版本号 | **V<主>.<次>**（含变更摘要） |

+> | 更新日期 | YYYY-MM-DD |

+> | 编制 / 审核部门 | <部门> |

+> | 定位 | <一句话说明这份文档解决什么问题> |

+> | 关联文档 | <编号或文件名> |

+```

+

+> 已采纳该块的文件：`D6.1.1-南方基金-企业信息.md`、`D6.1.2-南方基金-高频问答对.md/.txt`、`D6.1.4-公司新人指南.md`、`D6.2.2-企业金融服务方案.md`、`D6.2.1-个人理财产品手册.md`、`D6.2.3-高净值客户服务规范.md`、`D6.4.3-用户信息数据示例.md`、`D6.5.1-客户A-高净值.md`、`D6.5.2-客户B-普通投资者.md`、`D6.5.3-访客-未注册意向客户.md`。

+

+### 5.4 状态标注口径

+

+| 状态 | 含义 | 对待方式 |

+|---|---|---|

+| **现行** | 与当前口径一致，可据此工作 | 按权威链顺序更新 |

+| **底稿** | 结论已进现行文档，本身只作证据 | **只读不改** |

+| **已完成** | 记录一次性动作（清除 / 执行） | 只读，供追溯 |

+| **已归档** | 使命结束，移到 `_archived_docs_20260917\` | 不读 |

+| **待确认** | 状态未定，需人工决策 | 见 §8 |

+

+---

+

+## 6. 命名偏差清单与「暂不改名」决策

+

+🔴 **重要前提**：本区文档按**完整路径 + 行号**互引（如 `group_fqcd_jr\app\...\customer_service.py:193-206`、`docs/33 §1.2`、`开发文档\D4.1-客服Agent重构报告-2026-09-16.md:209`）。

+**任何改名或移动都会批量打断引用** —— 且 `开发文档\` 已推送至远程分支。

+

+| # | 偏差 | 是否改 | 理由 |

+|---|---|---|---|

+| N-1 | 根目录 13 份带日期后缀、5 份不带（如 `CLAUDE.md`、`D7.5-答辩须知.md`） | **不改** | 均为**已互引文件**，改名即断链；且"带日期 = 一次性成果 / 不带 = 长期文档"本身已是可读的隐含规则 |

+| N-2 | `D6.4.3-用户信息数据示例.md` 与 `.txt` 同名并存 | **不改** | 设计如此：`.md` 为人读画像，`.txt` 为纯文本摘要版，服务于不同消费方 |

+| N-3 | `D3.1-客服Agent需求开发文档与设计方案.html` 一名字含两类文档 | **不改** | 已被 A2、CS-REFACTOR-2026-010、多个 HTML 按名称引用；拆名风险大于收益 |

+| N-4 | `ai\D8.3-01_READING_RULES.md` 等下划线大写风格 | **不改** | 脚手架文件，遵循 AI 工具约定，与交付文档本非同类 |

+| N-5 | 早期编号 `JR-*`（`JR-SPM-2026-003`、`JR-DATA-2024-001`）与新 `NF-*` 体系并存 | **不改** | 重编号会改变 `理财销售管理办法` 等文件的自引编号；在新文档中统一用 `NF-*` 即可，旧编号**自然淘汰** |

+| N-6 | 4 份知识源目录名（`公司信息\`/`公司业务\`/`金融政策\`/`用户研判规则\`）粒度不完全对齐（业务 vs 政策 vs 规则） | **不改** | 已与 `tools\build_knowledge_chunks.py` 的扫描路径、以及 A4 知识库设计的集合划分绑定；改名会同时打断文档与代码两侧引用 |

+| N-7 | ~~`00-` 前缀~~ → **文件名编号前缀 `D<域>.<序>-`** | **已执行（第六轮）** | 46 份已改名、引用已全量迁移；`CLAUDE.md` 为例外。详见 §11 与 D1.3 §11 |

+

+> **结论**：第三～五轮**零物理移动、零改名**；**第六轮已推翻**（编号进文件名，46 份改名，见 §11.2）。规整 = **索引 + 状态标注 + 命名规范 + 统一编号**，而非搬文件。

+

+---

+

+## 7. D-2 / D-3 / D-4 执行记录（2026-09-17 · 第三轮）

+

+> **用户指令**：「除了 D5，其他全都按照你建议的来」 ⇒ **D-2 / D-3 / D-4 执行，D-5 明确跳过。**

+

+### 7.1 ✅ D-2 早期系统文档（已执行）

+

+| 文件 | 处置 | 结果 |

+|---|---|---|

+| `CLAUDE.md` | 保留；**2026-09-19 改为三行存根**（正文迁 `D8.1`，见 §4.7 与 §20） | ✅ |

+| `D7.5-答辩须知.md` | 保留，未改动 | ✅ |

+| `D7.4-开发引导.md` | 顶部加状态横幅「已被现行开发计划覆盖 · 开工勿依据」 | ✅ |

+| `D7.1-需求文档.html` | `<main>` 内加状态标注块（品牌待同步 / 业务口径待复核 / 说明为何不做「只改品牌」/ 指向权威入口） | ✅ |

+| `D7.2-功能设计文档.html` | 同上 | ✅ |

+| `D7.3-记忆架构设计.html` | **~~归档~~ → 撤销归档、已移回原位**（16:26 归档 → 16:40 移回） | ✅ 60,881 字节，位置 `开发文档\D7.3-记忆架构设计.html` |

+

+> 🔴 **纠正（2026-09-17 16:40）**：本条原为「归档到 `_archive\`」，前提是「通用教材，与项目**无直接引用关系**」。**该前提被证伪** —— A2《D2.2-客服Agent需求文档.html》§0.2 上游依据表 与 A4《D2.4-客服Agent知识库设计方案.html》§0.2/§1.8.3 **均把 `D7.3-记忆架构设计.html` v2.3（§6.2 `customer_id` 为必填身份标识）列为上游依据**（FR-CS-042 的裁决理由即出自此处）。

+> ⇒ 已**撤销归档**：文件移回 `开发文档\`，`_archive\` 目录已删。教训：**「像不像项目文档」不足以下判据，必须按文件名反查引用**。

+

+🔴 **关键决策（对原建议的收紧）**：`D7.1-需求文档.html` / `D7.2-功能设计文档.html` **只标注、不改品牌**。

+理由：两份文档的**业务正文仍属早期模型**（客户等级枚举含 `私行`、系统 Prompt 写死 `你是XX科技的智能财富管家`、Agent 清单含已清除的投顾能力）。**只替换品牌会造出「品牌已对、业务仍旧」的状态——比留下明显的旧品牌更危险**，因为旧品牌一眼可辨、而"品牌已对"会让人误以为口径已同步。

+

+> ⚠️ 因此这两份文档内**仍有旧品牌值**（`D7.1-需求文档.html` 约 8 处 + 热线占位符 1 处；`D7.2-功能设计文档.html` 约 5 处）。这是**有意为之**，不是遗漏。

+

+### 7.2 ✅ D-3 `admin` 角色投顾域权限（已执行）

+

+**先只读核查 → 再清**，核查推翻了我原先的判断：

+

+| 项 | 原判断 | 实测 |

+|---|---|---|

+| 条数 | 「15 条」 | admin 持有 **16 条**（库内），另 3 条（9066-9068）种子定义存在但库中未建 ⇒ 排除集合取 **19 条** |

+| 是否有消费者 | 「投顾功能已全删，**任何角色上都不会被调用**」 | ❌ **错。**`app/service/profile_governance_service.py` 与 `app/service/product_governance_monitor_service.py` **仍存活**，分别要求 `profile-governance:read/review`（9027/9028）与 `product-governance:read/review/sync`（9041-9043） |

+

+🔴 **`admin=True` 不是旁路**：`app/service/authorization_service.py:31-34` 先判 `permission in context.permissions`，再判角色是否含 admin ⇒ 删掉绑定会让**保留中的端点直接 403**。

+

+处置：

+- **删除 16 条**（9020-9026、9029-9034、9057-9059）—— 无任何消费者，纯投顾清除残留。

+- **保留 5 条**（9027/9028、9041-9043）—— 有存活消费者。

+- **不删 `sys_permission` 定义行**（保新旧环境 schema 一致 + `check_permission_coverage.py` 仍需对账）。

+- **同步改种子脚本** `tools/seed_test_rbac.py`：新增 `ADVISOR_DOMAIN_PERMISSION_IDS`（19 个）并把 `ADMIN_PERMISSIONS` 由「全量元组」改为「全量 − 投顾域」⇒ 离线核算 admin **59 → 44**。

+- 备份：`.workbuddy\backups\d3_20260917_rbac_before.sql`（`sys_role_permission` / `sys_permission` / `sys_role` / `sys_user_role` 的 INSERT 集）。

+

+**验证结果**：`admin 43`（59 − 16）、`customer 18`、`risk_operator 10`、`operator 2`；残留投顾域 **0 行**；5 条保留项 **全部在位**。

+

+### 7.3 ✅ D-4 代码侧品牌残留（已执行，含一处纠正）

+

+| # | 位置 | 改动 | 状态 |

+|---|---|---|---|

+| 1 | `app/service/agent/governance.py:47` | `CUSTOMER_SERVICE_HOTLINE`：`15936583816` → **`400-889-8899`**（并补注释说明「脱敏放行」语义与两侧必须同值） | ✅ |

+| 2 | `tools/seed_compliance_baseline.py:98-101` | 两条话术（`TPL_TRANSFER_HUMAN` / `TPL_SYSTEM_BUSY`）：热线 → `400-889-8899`；服务时间 `工作日 09:00-18:00` → **每日 7:00—22:00**（对齐 CS-CONTENT-2026-015 v1.1 真值） | ✅ |

+| 3 | `app/static/portal/employee-operations/promotion/promotion.js:29` | `南方基金管理有限公司` → **`南方基金管理股份有限公司`**（缺「股份」） | ✅ |

+| 4 | ~~`tools/build_knowledge_chunks.py` 品牌白名单~~ | 🔴 **纠正：该白名单在代码里并不存在。**`build_knowledge_chunks.py` 全文只有 `assert_no_duplicate_contents` 一个守卫；「四查 / 品牌白名单（含 `南方财富`+`nanfangwm.com`）」只写在**文档**里（`D4.1-客服Agent重构报告-2026-09-16.md:209`、Todolist B-01），**属"文档声称已实现、代码未实现"**（即 CS-CONTENT-2026-016 §4 的 G-01）。⇒ **无可改之代码**；正确的新白名单值 = `南方基金` + `nffund.com`，**待 B-01 实现时使用**（属代码工作，未做） | ⚠️ 转登记 |

+

+**验证**：三个 `.py` 全部 `py_compile` 通过；全仓复查 `15936583816` / `南方基金管理有限公司` / `400-826-9518`，剩余命中**均为合法处**（脱敏测试样本号码、`_docbuilder.py` 替换规则表、测试 fixture 输入、本次改动注释）。

+**DB 侧无同步项**：`agent_reply_template` 表当前 **0 行**，`sys_permission` 亦无品牌字段。

+

+### 7.4 ⏭ D-5 前端品牌面（**本轮跳过**）

+

+用户明确「除了 D5」。**未做**：`app\static\portal\**` 24 文件（18 个 `index.html` 的 `<title>`、`app-shell.js:64`、`brandmark.svg` 的 `aria-label`、`products.js` / `product-detail.js` 的 `document.title`）+ 风控 5 处（`risk_analysis_service.py:27`、`risk_agent.py:1/192/364`、`employee-risk\dashboard\index.html:80/139`、`risk_scan_scheduler.py:173`）。

+

+---

+

+## 8. 遗留与待决

+

+> 🔴 **本节全部事项已并入 `D1.5-开发前决策清单与阻塞项-2026-09-17.md`（唯一决策登记册，编号 `DEC-01`~`DEC-28`）。** 本节保留原编号（`D-5`~`D-8`）以便追溯，交叉映射见 `D1.5 §1.1`；拍板后回填 `D1.5 §7`。

+

+| # | 事项 | 我的建议 | 影响 |

+|---|---|---|---|

+| **D-5** | 前端 24 份 + 风控 Agent 5 处曾用 `南方财富`（G-02 / G-05） | ✅ **2026-09-18 已执行**（`C-05` 品牌面清零）；🔴 **2026-09-20 复查发现 2 处残留** —— 投顾组分支带回的 `employee-advisor/dashboard/index.html` 与 `customer/advisor-plans/index.html` 的 `<title>`（`W12` 合并引入），**已于 `W13` 按 `DEC-27` 修正**；全仓 `app\` 复查 = 0 处 | ✅ 已闭环 |

+| **D-6** 🆕 | **系统名不统一**（母本曾用「智能财富管家系统」） | ✅ **2026-09-19 已执行**（`乙-25`）：母本 `D6.1.1` / `D6.1.4` 与 `D6.5.x` / `D6.4.3` 已统一为「**南方基金·智能服务系统**」；本轮复查 `开发文档\公司信息|公司业务` = **0 处**。剩余命中全部为**合法语境**：① 变更说明（`D1.2`/`D1.4`/`D1.5`）；② **早期文档**（`D7.1`/`D7.2`/`D7.4`）—— 按 §4.7「只标注不改品牌」裁定**有意保留**；③ 仓库 `docs\` / `_flows\`（另一套编号空间） | ✅ 已闭环 |

+| **D-7** 🆕 | **B-01 语料入库门禁（四查）并未实现** | ✅ **已实现**：`tools\knowledge_corpus_gate.py`（品牌白名单为 `南方基金` + `nffund.com`，旧值进了**黑名单**；单测 `tests\unit\tools\test_knowledge_corpus_gate.py`） | ✅ 已闭环 |

+| — | ~~`_chunks.jsonl` 未重灌库；`开发文档\` 的仓库副本未同步~~ | ✅ **均已闭环**：三集合已于 2026-09-18 `drop` 重建重灌（`DEC-29`「不用旧数据，全部用新数据」）；`开发文档\`（50 份）+ `客服agent\`（24 份）已于 2026-09-20 随 `bc61d5c` **入库并与权威副本逐字节一致**（`D1.6` §4.38） | ✅ 已闭环 |

+

+> ⚠️ **D-5 / D-7 属前端与代码改动**；本轮已按指令完成 D-2/D-3/D-4（其中 D-4 含 3 处代码改动）。

+

+---

+

+## 9. 引用约定（**新文档一律遵守**）

+

+1. **引用其他文档——三级优先**：① **体系编号**（`D2.2 §1.6.1`、`D4.1`）——**新写的引用一律用这一级**，因为它与 §4.0 总表一处定义、全局可解析；② 既有业务编号（`CS-CONTENT-2026-015 §4.2`）——用于追溯历史留痕；③ 文件名——仅在**代码注释、脚本路径、生成件**里必须用文件名时使用。**绝不用行号**（行号会随编辑漂移）。

+2. **引用代码**：用 `仓库内相对路径:行号`（如 `app\service\knowledge_search_service.py:138-154`）。

+3. **引用需求**：用 `FR-CS-0xx` / `NFR-CS-0xx`；引用任务用 `A-01` / `G-03` 等 Todolist 编号。

+4. **旧值与新值对照**：文档中**允许出现旧值**（`XX科技` / `南方科技` / `南方财富` / `nanfangwm.com` / `400-XXX-XXXX`），但**仅限**「修订说明」「禁止清单」「变更说明」三类上下文，且必须紧邻新值。其余位置出现旧值即为缺陷。

+5. **编号 ↔ 文件名双向可解析**：任何人看到 `D6.1.1` 应能在 §4.0 总表查到 `开发文档\公司信息\D6.1.1-南方基金-企业信息.md`；反之，看到文件名也应能查到编号（总表按编号排序，文件名可检索）。**新增文档必须同时登记两处**：文件内标题下方 + §4.0 总表。

+

+---

+

+## 10. 可删性核查（2026-09-17 · 第四轮）

+

+> **用户指令**：「把我这个文件夹里你觉得没用的文档都清除，只需要留下协助开发的文档。」

+> 🔴 **核查结论：`开发文档\` 43 份中，没有可以安全删除的文档。** 每一份要么是开发输入，要么被上游依据表或编号引用——**删任何一份都会打断别人的依据链**。

+

+### 10.1 逐项核查证据

+

+| 候选（"看起来没用"） | 结论 | 证据 |

+|---|---|---|

+| `D7.4-开发引导.md` | ❌ 不可删 | A2/A4 §0.2 依据表列为技术参考；`D3.2-知识库设计方案.html` **§7.5「决策 4：分块策略」** 的分块参数明写「取自 `D7.4-开发引导.md` §1.4」；`D7.1-需求文档.html` 内 5 处链接指向它 |

+| `D7.1-需求文档.html` | ❌ 不可删 | A2/A4 依据表列为「需求条目与验收标准的原始出处」；🔴 **它是 Todolist `F-07` 未完成任务的直接操作对象**（修复其 24 个失效目录锚点）——删了该任务将无法完成 |

+| `D7.2-功能设计文档.html` | ❌ 不可删 | A2/A4 依据表列为「§2.2 意图分类 / §2.3 生成约束 / §8.1 `rag_search` 工具契约」出处 |

+| `D7.3-记忆架构设计.html` | ❌ 不可删 | A2/A4 依据表列为「§6.2 `customer_id` 为必填身份标识 → 据此排除『虚拟访客账号』方案」的上游依据（`FR-CS-042` 的裁决理由即出自此处） |

+| `D7.5-答辩须知.md` | ❌ 不可删 | `D3.1-客服Agent需求开发文档与设计方案.html` **附录E「参考资料索引」** 引用为「演示要求（15 分钟、重点讲思路与坑）」 |

+| `CLAUDE.md` + `ai\` 6 份 | ❌ 不可删 | `客服Agent需求开发文档:483/489/3822` 依赖其 Rule Priority 与「阅读完成门」；`ai\D8.3-01_READING_RULES.md:126` 亦引用 `CLAUDE.md`。🔁 2026-09-19 起规则正文在 `D8.1`，本文件为存根 ⇒ **仍不可删**：文件名本身是引用锚点 |

+| `D5.1-业务流程-MVP版-最终交付-2026-09-15.md` | ❌ 不可删 | A2/A4 依据表列为「三条红线 / 演示跑通为唯一验收方式」出处；`客服Agent需求开发文档:489` 明文规定「与《业务流程 MVP 定稿》冲突，**以 MVP 定稿为准**」 |

+| 4 份清除留痕（CS-PURGE-2026-007 / 008 / 012 / 013） | ❌ 不可删 | `D3.4-客服Agent重构Todolist.md:19`、`客服Agent重构报告:6`、`tools/seed_test_rbac.py:198` 按编号引用；删则引用悬空 |

+| `知识源与品牌整改变更说明`（CS-CONTENT-2026-016） | ❌ 不可删 | `南方基金业务事实基座与虚构数据规范:357` 引用为「每处修改的原因与影响范围」 |

+| `文档规整方案与开发前待决事项`（CS-DOC-2026-014） | ❌ 不可删 | 本索引 §4.5 / §7 引用；内含 E-1~E-4「已授权待发令」 |

+| 17 份知识源 + 测试数据 | ✅ 开发输入 | 灌库、业务口径、E2E 验证 |

+| 本索引 | ✅ 唯一入口 | —— |

+

+### 10.2 结论与替代做法

+

+**本轮不做删除。** 「只留协助开发的文档」这个目标由 **分类（§3）+ 状态标注（§4.7）+ 开工只读 5 份（§2）** 达成，而不是靠删文件——本区文档按「**文件名 + 编号**」互引（§9），删任何一份都会打折别人的依据链。

+

+若仍要物理瘦身，唯一不破坏引用的方式是**移动而非删除**（移入 `开发文档\_archive\`），但代价有三：① 路径型引用（如 §7.5 的 `开发文档\D4.5-投顾模块清除执行报告-2026-09-17.md`）失效；② `_archive\` 目录本身会被后续盘点再认作「待归档」；③ **本区**已于 2026-09-20 入库**（`group_fqcd_jr\开发文档\` / `group_fqcd_jr\客服agent\`，见 `D1.6` §4.38）

+

+> 🔴 **本轮最重要的教训**：判断一份文档「有没有用」**不能凭体裁**（"像通用教材"「像过程记录」），**必须按文件名反查引用**。本轮因此发现了 `D7.3-记忆架构设计.html` 被误归档（§7.1 纠正）、以及 5 份「看起来没用」的文档其实全部被上游依据表引用。

+

+---

+

+## 11. 编号体系落地记录（第五、六轮）

+

+### 11.1 第五轮：建立体系编号

+

+| 位置 | 落地 |

+|---|---|

+| 目录 | **§3 文档层级与编号域** + **§4.0 编号规则与全量编号总表**（第五轮 47 行；第六轮加入 `D1.5` 后为 **48 行**；第八轮加入 `D1.6`、`D3.5`、`D3.6`、`D3.7` 后为 **52 行**，见 §11.2 与 §12） |

+| 文档标题 | 44 份在标题正下方加「体系编号」行（`.md` 引用块 36 / `.html` 状态条 5 / 交付文档 `doc-meta` 3） |

+| 引用 | §9 第 1 条三级优先（体系编号 → 既有业务编号 → 文件名）+ 第 5 条「编号↔文件名双向可解析」 |

+| 校验 | `.workbuddy\_verify_docno.py` → **47/47 通过**；`.txt` 例外件未被污染 |

+

+### 11.2 第六轮：编号进文件名（**推翻**第五轮「不改名」的判断）

+

+用户要求「文件名带号，以区分每份文档干什么」⇒ 文件名统一为 **`<编号>-<描述名>.<扩展名>`**，**域号本身就是用途**。

+

+| 项 | 结果 |

+|---|---|

+| 重命名 | **46 份**（`开发文档\` 42 + `客服agent\` 4） |

+| 🔴 唯一例外 | **`CLAUDE.md` 保留原名** —— AI 工具按固定名读取规则文件，改名会**静默失效**。🔁 2026-09-19 起其内容收缩为三行存根，规则正文见 `D8.1-项目语言规范.md`（§20） |

+| 引用迁移 | **55 个文件**改写（正文 / `<a href>` / 依据表 / `_build\_spec_*.json` 的 `out_file`） |

+| 注入行 | 41 处改为「编号体系见 `D1.1` §4.0」（**不写路径**，再改名也不失效） |

+| 备份 | `.workbuddy\backups\rename_20260917_devdocs.zip`（64 文件 / 812,649 B） |

+| 脚本 | `.workbuddy\_rename_docs_with_no.py`（迁移）、`.workbuddy\_verify_rename.py`（复核） |

+

+### 11.3 🔴 关键区分：**母本改名，镜像不改名**

+

+`tools/build_knowledge_chunks.py` 的 `SOURCES` 字典键指向 **`group_fqcd_jr\knowledge\**` 的镜像副本**（`company/企业信息.md` 等），**不是** `开发文档\` 里的母本。

+⇒ **改名母本不打断代码；改名镜像才会。** 故 `开发文档\公司信息\D6.1.1-南方基金-企业信息.md`（母本，带编号）与 `knowledge/company/企业信息.md`（镜像，原名）**并存**，对应关系由 §4.0 总表维护。

+

+### 11.4 未同步（遗留）

+

+| # | 事项 | 说明 |

+|---|---|---|

+| 1 | `group_fqcd_jr\开发文档\`（40 份） | 陈旧仓库副本，**旧名 + 旧内容**，未同步（叠加在 §8 的 **D-8** 上） |

+| 2 | `group_fqcd_jr\客服agent\` | 同上 |

+| 3 | `group_fqcd_jr\docs\**` / `_flows\**` 的历史引用 | 属历史记载，**有意不改** |

+| 4 | `客服agent\_build\` 的脚手架文件名 | 非文档，保持原名；其内容已随迁移更新 |

+

+---

+

+## 12. 第八轮：会话上下文提取、知识库升级、智能增强架构与评测金标登记（2026-09-17）

+

+| 编号 | 文档 | 既有编号 | 性质 · 作用 |

+|---|---|---|---|

+| **D1.6** | `开发文档\D1.6-对话上下文提取与开工前补充决策-2026-09-17.md` | CS-DOC-2026-019 **v1.0** | **会话上下文提取件**：回答「开工前还需你决策什么」——在 `D1.5` 的 28 项之外补登 `N-01`~`N-09`；并给出旧实现 **7 条转人工通路**的代码取证、6 处文档缺陷 `Q-1.1`~`Q-1.6`、8 项前提风险 `K-01`~`K-08` |

+| **D3.5** | `开发文档\D3.5-知识库检索升级备选方案建议-2026-09-17.md` | CS-KB-2026-020 **v1.0** | **知识库专项建议（备选方案池）**：`§3-A`~`§3-H` 八个升级方向（含代价与适用条件）+ 推荐组合 + 对 `D2.4`/`D2.1` 的 10 条修订建议 + 可证伪验收判据 |

+| **D3.6** | `开发文档\D3.6-客服Agent智能增强架构建议-2026-09-17.md` | CS-ARCH-2026-021 **v1.1** | 🔴 **智能增强架构（已裁定件）**：① 诊断——`handle()` **10 处**失败方向全部指向转人工；② 旧设计 §4 **本就写了**「多命中应组织语言」与澄清标记，**实现从未落地**；③ 「智能」7 条可验收定义；④ **五出口决策链** `E1`—`E5`；⑤ 安全不变量 `INV-1`~`INV-5` 与转人工白名单 4 类；⑥ **§9 八项决策已于 2026-09-17 拍板** |

+| **D3.7** | `开发文档\D3.7-客服Agent评测金标集与判分规则-2026-09-17.md` | CS-EVAL-2026-022 **v1.0** | 🔴 **评测输入件（验收依据）**：46 条金标 / 问法分级（难例 32 条）/ 10 项指标 + 4 项零容忍 / 判分规则 / 前置阻塞 `B-1`~`B-4` / 实测回填表；**核心口径：白名单外"正确地转人工"也判不合格** |

+

+| 项 | 本轮落地 |

+|---|---|

+| 盘点范围 | `开发文档\` 44 → **48 份**；全量 **52 份**（＋`客服agent\` 4 份） |

+| §3.1 / §3.2 / §4.0 | 域一 5 → **6**；域三 4 → **7**；总表补 `D1.6`、`D3.5`、`D3.6`、`D3.7` 四行（总表 **52 行**） |

+| §4.2 / §4.5 | 开发文档区现行权威 3 → **7 份**；本次整改工作文档 4 → **5 份** |

+| **第八轮 · 下游回灌**（2026-09-17） | **四份交付文档已按 `D3.6` 的裁定同步**（`D1.1` §1 规定的上游优先顺序：需求 → 执行 → 计划 → 知识库）：`D2.2` **v2.4 → v2.5**（`FR-CS-003` 澄清 / `FR-CS-008` 分级回退 / `FR-CS-023` 转人工白名单 **三条重写** + 新增 **§1.4.8 域 H**（`FR-CS-049`~`052`）+ 新增 **`AC-13`** + **§1.6.3 修正**（`public` 删除「产品参数与费率」））；`D2.1` **v5.2 → v5.3**（新增 **批次 H · 智能增强 6 项** + 完工判据 **13 条**）；`D2.3` **v1.0 → v1.1**（新增 **§3.4b 批次 H**）；`D2.4` **v1.2 → v1.3**（**§7.2.1 集合内分区隔离** + 附录A/B/D/F + 取消 `over-fetch`） |

+| 三处一致 | 两份新文档的「体系编号」行均位于标题正下方（`D1.6` / `D3.5`），与本总表一致；§9 第 5 条「新增文档必须同时登记两处」已满足 |

+| 本文件版本 | **v1.1 → v1.2**（同步 §4.0 总表 `D1.1` 行的版本标注） |

+

+## 13. 第九轮：两份完整版对齐（`D3.1` v2.4 / `D3.2` v1.2，2026-09-17）

+

+> **本轮做什么**：把 `开发文档\` 的两份**完整版**（`D3.1` / `D3.2`）从「收敛前的旧口径」对齐到 `客服agent\` 的**现行收敛版**（`D2.2` **v2.5** / `D2.4` **v1.3**），并**在源头闭环**两处此前登记为「待确认」的跨文档缺陷（`Q-08` / `Q-09`）。本轮**只改文档，不写代码**。

+

+| 项 | 本轮落地 |

+|---|---|

+| **`D3.1` v2.3 → v2.4** | 标题 / 侧栏 / 文档元信息 → 南方基金·智能服务系统；新增 **§1.4.8 域 H**（`FR-CS-049`~`052`）并重写 `FR-CS-003` / `FR-CS-008` / `FR-CS-023` / `FR-CS-033`；新增 **§3.12 五出口与智能增强落地映射**；§3.3.5 改为**分级回退**（`E5a`/`E5b`/`E5c` + 不得跨档位）；§3.7.1 触发条件 → **白名单 4 类**；§5.3 / §5.5.1 `visibility` 由「标量字段 + 倒排索引」改为 <strong>NOT NULL 分区键（分区裁剪）</strong>；§7.3 新增 `A8` / `A9` 验收；§6.5.1 品牌字段「示例实际值」全表更新 |

+| **`D3.2` v1.1 → v1.2** | 标题 / 文档元信息 → 南方基金·智能服务系统；**§4.2 三档表重写**（`public` 删除「产品参数、费率、起购金额」，`registered` 补「全部产品参数」，实现方式 → 分区键 + 分区裁剪）；§4.2 判断记录 3 改为「服务等级门槛公开 / 产品要素门槛不公开」；附录D「over-fetch」→ **v1.2 起取消**并加分区行；附录E 同步 `D3.1` **v2.4** |

+| **缺陷 `Q-08` 闭环** | 档位口径定案 **`public` 54 / `registered` 10**（合计 64）。源头 `D6.1.2` §四 已订正：`public` 名单**补回 Q15、移出 Q33**，`registered` 保持逐条列明的 10 条并加 Q33 从严说明，另增「变动前后口径」对账段（**V1.0 = 55 / 9 成员不同，勿再引用**）。`D2.2` / `D2.4` / `D3.1` / `D1.4` §3.6 已同步为 54 / 10 |

+| **缺陷 `Q-09` 闭环** | 「39 组版 FAQ」在母本**已不存在**——`D3.1` 附录D/E 与 `D3.2` §4.1 / §4.5 / 附录B 的相关行已删除，FAQ 集合**只登记 64 组一份**（`D6.1.3`）；规模预估按 64 条重算（FAQ 64 + 产品 155—220 + 政策 190—250 = **约 410—535 块**，`D3.2` §4.5 / §8.1 / 附录D 与 `AC-02` 四处一致） |

+| **新增待决 `T-11`** | `D3.2` §12.1 补登 **`T-11`**：FAQ `Q14`（客户分层门槛）与 `Q43`（专户门槛）含数值门槛，严格套用判据应归 `registered`；现行按「服务等级标准 / 适当性规则属公开信息」保留 `public`。**若改判，两档将由 54 / 10 变为 52 / 12**（须同步 5 份文档） |

+| **行号引用清理** | §10.1 中两处**行引用**（原 `D3.2:1557`、`D3.1:4203`）因完整版行数变动已失效，按 §9 第 1 条改为**体系编号 + 章节**引用 |

+| 🔴 **构建脚本已过期（勿重跑）** | `客服agent\_build\` 下的 `_docbuilder.py` + `_body_requirements.html` / `_body_kb.html` / `_body_plan.html` / `_shell_*.html` / `_spec_*.json` 是 `D2.2`/`D2.3`/`D2.4` 的**一次性生成器**，其正文源与锚点**均已滞后于交付件**（`D3.1` 的标题/品牌/侧栏在 v2.4 已改，`_body_kb.html` 仍为 39 组 ≠ 64 组、`public` 仍含「产品参数」）。**重新执行 `python _docbuilder.py` 会覆盖并回退全部现行口径**——交付件以 `客服agent\*.html` 为准，如需重建须先同步 `_build\` 源与锚点。详见 `客服agent\_build\README-已过期-请勿重新生成.txt` |

+| 本文件版本 | **v1.2 → v1.3**（同步 §4.0 总表与 §4.2 的 `D3.1` / `D3.2` 版本标注） |

+

+---

+

+> 🔴 **`D3.5` 不是需求、也不是任务来源**：它是**备选方案池**。其中任何一项要落地，都必须先按 §1 的顺序修订上游（`D2.2` 需求 → `D2.4` 设计 → `D2.1` 任务），再同步 `D1.5` / `D1.6` 的回填表。

+

+## 14. 第十轮：`D3.2` / `D2.4` / `D2.2` 的「倒排索引 → 分区键」残留清理（2026-09-17）

+

+> **背景**：第九轮把两份**完整版**（`D3.1` / `D3.2`）对齐到「集合内分区键 + 分区裁剪」口径，但该口径**只在部分章节落地**——`D3.2` / `D2.4` / `D2.2` 的其余章节仍**同时**陈述「`visibility` 建 `INVERTED` 倒排索引」与「`PARTITION KEY`」，构成**同字段双机制的自相矛盾**；`D2.4` / `D2.2` 的 §5.4 / §8.3 / §9 / §11 / 附录 A / 附录 C 甚至仍把 `over-fetch ×3` 当作**现行实现**（而二者各自的 `v1.3` / `v2.5` 修订行**已声明取消**）。本轮**只改文档，不写代码**，把三份文档的**正文**与各自的**修订行**对齐。

+

+| 项 | 本轮落地 |

+|---|---|

+| **`D3.2` 语义修补（`v1.2` 内，不改版本号）** | ① §5.3 字段表 `visibility` 由「`INVERTED`（倒排） + `NOT NULL` + `PARTITION KEY`」改为 **`PARTITION KEY`（分区键） + `NOT NULL`**；② §5.3 集合创建代码块由 `col.create_index("visibility", {"index_type": "INVERTED"})` 改为 `is_partition_key=True` + `ensure_partition()` + 只建向量索引；③ §5.3 选型对照表 §5.1 术语表 / §5.1 链路 / §7 技术前提 / §7.2 选型 / §8.2 性能分解 / §8.3 优化手段 / §9 启动自检 / §10.5 指标 / §11.1 测试矩阵 / `AC-01` / 附录 A 共 **14 处**同步（13 处逐点替换 + §5.3 集合创建代码块整段重写）。**依据**：`D3.1` §5.5.1 已定「分区键由引擎管理，无需再为 `visibility` 建倒排索引」——保留 `INVERTED` 会误导实现，并在评审时被读成方案不确定 |

+| **`D3.2` §8.3 重复行合并** | 优化手段表原有「① `visibility` 建倒排索引」与「② `visibility` 声明为 partition key」两行**同义重复**（第九轮改造遗留），合并为一行并顺延编号（**6 项 → 5 项**） |

+| **`D2.4` 对齐（`v1.3` 内，不改版本号）** | §1 术语表 / §5.1 链路 / §5.4 设计点表（补「（历史）」标记） / §5.4 检索代码块（`limit=top_k * OVERFETCH_FACTOR` → `partition_names=sorted(allowed)`） / §5.5 判断表 / §7.3 步骤 / §8.2 性能 / §8.3 优化手段（**6 项 → 5 项**） / §8.4 测试矩阵 / §9 启动自检 / §10 配置（`VISIBILITY_OVERFETCH_FACTOR=3` → `VISIBILITY_PARTITION_KEY=visibility`） / §11 指标 / `AC-01` / 验收脚本一 / `RK-16` / 附录 A / 附录 C / §12.1 `T-08` / §12.3 `J-04` 共 **27 处** |

+| **`D2.2` 对齐（`v2.5` 内，不改版本号）** | ① `FR-CS-033` **重写**为「档位隔离走集合内分区裁剪（`v2.5` 重写，替代 over-fetch）」；② `FR-CS-032` 由「强制拼装**过滤表达式**」改为「强制拼装**分区裁剪范围**」；③ 附录术语 `over-fetch` 加「🔴 `v2.5` 已取消」；④ `AC-01` / 验收脚本一 / `RK-16` / `T-08` / `J-05` 同步，共 **9 处**；⑤ §0.4 `v2.5` 行补第 ⑦ 条；⑥ 文末「需求文档 v2.4」→ **v2.5**（版本停滞） |

+| **校验（本轮实跑）** | 四份 HTML 均通过项目自带 `verify_html_doc.py`：标签闭合 / 锚点有效 / 围栏成对 / 无占位残留（`D2.2` 1084 行、`D2.4` 1751 行、`D3.1` 4549 行、`D3.2` 2544 行）；`_consistency.py` 重跑：**TOC 失效 0**，四文档交叉引用 **7/7 ✅** |

+| 🆕 **新增待决 `N-10`** | `D3.2` §12.1 的 **`T-11`**（客户分层门槛 / 合格投资者门槛的**档位归属**）**是否同步登记进 `D2.4` §12.1**——`D2.4` 现只有 `T-01`—`T-10`，`T-11` 号位**空闲**。不补，则「`D3.2` 镜像 `D2.4`」这一说法**在待决项上不成立**。**建议：补登** |

+| 🆕 **新增待决 `N-11`** | **`T-nn` 跨文档撞号**：`D3.1` §5.6 的 `T-11` 是「金融行业基础信息的知识源」、`D3.2` §12.1 的 `T-10` 是「数据库表结构现状 / `fin_knowledge_meta`」，而 `D3.2` / `D2.4` 的 `T-11` 是「门槛档位归属」——**不同文档的同号是不同事项**。现行体系已确认 `T-nn` **按文档独立编号**（`D1.5` §3 即按此映射 `D2.2 T-nn` ↔ `D2.4 T-nn`），故**不构成缺陷**；仅当要求 `D2.1` 的「`T-01`~`T-11`」行文在三份文档间**严格同构**时才需各自顺延。**非功能影响，可低优先处理** |

+| 🆕 **发现（本轮未改）· `_consistency.py` 的核对清单已过期** | 该脚本 §二 的「关键事实」仍按 **`功能需求 48 条` / `51 项`** 等旧值匹配（`D2.2` `v2.5` 已把功能需求 **48 → 52 条**、功能域 **7 → 8**），因此其「`0 = 遗漏`」列会**误报遗漏**。**建议**：把 `FACTS` 清单同步到 `v2.5` 口径后再作为门禁使用，否则不宜据其下结论 |

+| 🆕 **发现（本轮未改）· `group_fqcd_jr\` 内的旧命名镜像** | 代码仓 `group_fqcd_jr\开发文档\` 与 `group_fqcd_jr\客服agent\` 存有**旧命名镜像** 20 份（`知识库设计方案.html` / `客服Agent知识库设计方案.html` 等，最后写入 2026-09-17 11:32—15:14），`over-fetch` 残留**最高 35 处**、`倒排` **22 处**。经 `git ls-files -- 开发文档 客服agent` 核对：**该两目录未被 git 跟踪**（0 条命中），属工作区遗留物，**不随提交外发**。**建议**：归档进 `.workbuddy\backups\` 或删除，避免演示时误开旧版 |

+

+---

+

+## 15. 第十一轮：`DEC-19` 记忆口径裁定与 `Q-1.8` 闭环（2026-09-18）

+

+> **背景**：`D2.2` §1.7 范围表与附录第 12 项写「客户侧长期 / 画像记忆**亦关闭**」，与 `D3.1` §3.5 三层权限表的「中期只读」冲突；且 `D2.2` **自身**的主体模型（客户可查「自己的画像与风评」）、`FR-CS-024`（转人工摘要含**画像关键标签**）、`D3.1` §3.5.2 适当性过滤三处**都要求画像可读**。按字面执行「亦关闭」会同时废掉这三处功能。

+

+| 项 | 本轮落地 |

+|---|---|

+| **裁定（`DEC-19`）** | 由「是否关闭」改为**三分口径**，裁为 **(a)**：**短期会话记忆＝开（读 / 写）／ 长期记忆召回（`memory_unit` / `user_facts`）＝关 ／ 画像＝客户侧字段级只读（仅 `risk_level` / `customer_level`，供确定性规则）且禁止注入生成上下文**；客服**不写**画像、**不产生**画像候选 |

+| **`D2.2` 同步** | §1.7 范围表行重写；附录第 12 项拆为「长期记忆召回」并明确关闭；第 18 项画像候选由「可产生（待确认后开启）」改为**关闭**；**新增第 21 项**「画像字段级读取」；表后新增澄清 callout（三件独立的事） |

+| **`D3.1` 同步** | §3.5 中期行改为「**字段级只读**（仅两个字段）+ 禁止注入生成上下文」；长期行拆为「知识侧只读 / 记忆侧不召回 / 图谱不读」三支；§3.5 新增 design callout 说明拆分口径 |

+| **`D1.5` 同步** | `DEC-19` 三处（登记册 §4 / 详表 §5 / 简表 §7）改为三分口径，并标记 ✅ 已裁定 (a) 与完整理由链 |

+| **缺陷登记** | `D1.6` §3.3 新增 **`Q-1.8`**（本轮已闭环）；C 类计数 7 → **8**，§3.3 标题与 §0 汇总表同步；§4.4 决策单 `乙-20` 标记 ✅ 已定 (a) |

+| **校验（本轮实跑）** | 改动后重跑项目自带 `verify_html_doc.py`：**`D2.2` 1086 行 / `D3.1` 4550 行，均通过**（标签闭合 / 锚点有效 / 围栏成对 / 无占位残留）；`_consistency.py` 重跑：**TOC 失效 0**，四文档交叉引用 **7/7 ✅** |

+

+---

+

+## 16. 第十二轮：甲类受理、模型选型核对与 `K-01` 修正（2026-09-18）

+

+> **本轮做什么**：① 受理甲类 6 项输入（两把模型 key + 四类授权）；② 就「嵌入 / 生成模型选哪个」给出结论（依据为**读码 + 读证据文件**，**非实测**）；③ 确立**密钥落点规则**；④ **修正 `K-01`** 的推断。**本轮未写任何代码、未连库、未起 Milvus。**

+

+| 项 | 本轮落地 |

+|---|---|

+| **甲类受理** | `D1.6` §4.4 甲类 6 行全部标记 ✅ 已定（甲-4 答辩约 **2026-09-19**；甲-6 一次性授权，但本轮明确「**先不要开发**」⇒ **发令暂缓**）；`D1.6` §6「需要你提供的输入」6 项同步为已满足 |

+| **模型结论（嵌入）** | **不另选**：沿用底座已登记的 `qwen3.7-text-embedding-flash`（见 `tools\configure_embedding_endpoint.py`）。理由：**换模型＝换向量维度＝已灌数据全部作废**；维度仍须 `E-3` 实测（`DEC-01`） |

+| 🔴 **高价值纠正** | 嵌入端点的 `secret_ref` 是 **`env:QWEN_EMBEDDING_API_KEY`**，**不是** `DASHSCOPE_API_KEY`——只配后者时症状是「**没有可用的模型端点**」，与病因无关，排查方向被带偏。`DASHSCOPE_API_KEY` **另有用途**（推广图 `wan2.2-t2i-flash`），故**同一把 key 建议同时写两个变量名**。另确认 `app\core\config.py` 的 `load_dotenv(override=False)` 已把 `.env` 注入 `os.environ`，密钥写 `.env` **有效** |

+| **模型结论（生成）** | **不另选**：沿用库内 `status='active'` 的产线端点；`.env.example` 的离域默认模型为 `deepseek-v4-flash`（`OFFSITE_DEEPSEEK_MODEL`） |

+| 🔴 **`K-01` 修正** | `docs\evidence\knowledge-collections.json` 显示三集合**已含 `visibility` 字段**（`fin_faq_collection` 125 / `fin_policy_collection` 297 / `fin_product_collection` 214 ＝ **636** 行）⇒ `K-01`「现有 schema 很可能无 `visibility`」的推断**不成立**。`N-07` 的实质随之变为「**重判档位 + 补灌 `registered` 行**」，而非「加字段重建」 |

+| 🔴 **本轮新发现** | ① `knowledge\_chunks.jsonl` **617** 行**全部 `public`**（`registered 0`）⇒ 档位隔离**有字段、无数据**，`AC-11` / `A8` 的双向验证**必然失败**；② FAQ 集合 **125** 行 vs 交付口径「FAQ 64 组」**待对账**；③ 向量**维度仍未确定**（证据只给 Milvus 类型码 `101`），`D3.1` 的 `dim=1024` 与 `settings.EMBEDDING_DIM` 两处口径需一并收口 |

+| **密钥落点规则** | 密钥**只落** `group_fqcd_jr\.env`（`.gitignore` 已含 `.env` 与 `.env.bak*`，后者是含真实密钥的完整备份）；**绝不写入任何 `.md` / `.html` 文档、绝不入 git、绝不出现在交付件**；文档只登记「已提供 / 存于 `.env`」。两把 key 已明文出现在对话文本中 ⇒ **建议答辩结束后轮换** |

+| **对话上下文登记** | `D1.6` 新增 **§2.4「2026-09-18 实测补充」**（8 条）与 **§4.5「2026-09-18 会话记录」**。按你的要求：**人机对话持续登记在 `D1.6`，作为后续会话的上下文来源** |

+| **未做（诚实声明）** | 未写代码；未连 MySQL / Milvus；**未写 `.env`**（等你解除「先不要开发」）；本轮**未改 HTML**，故未重跑 `verify_html_doc.py` |

+

+---

+

+## 17. 第十三轮：零容忍词去留诊断与三层联动冲突检查（2026-09-18）

+

+> **背景**：你提出「零容忍词规则会不会让转人工频率大增、要不要去掉」，并授权「必要时可删旧 Milvus 重建」。本轮**只做诊断与决策登记**——未写代码、未连 MySQL / Milvus、**未删任何 Milvus 集合**（沿用你「先不要开发」的指令）。

+

+| 项 | 本轮结论 |

+|---|---|

+| 🔴 **前提纠正（本轮最重要）** | 「零容忍词」在项目中是**三层不同载体**：① **输入侧** `ZERO_TOLERANCE_WORDS`（11 条，含裸词「安全」「年化收益率」「预期收益率」）→ `hits_zero_tolerance()` ← `route_message()`；② **输出侧硬编码** `app\service\agent\governance.py:320` 的 `hard_patterns`（5 条）；③ **输出侧库内** `agent_negative_word`（11 行 `severity='block'`）。**当下**制造强制转人工的是 **②③**——① **的代码已随客服模块整体清除而不存在**（`app\service\agent\implementations\` 只剩 `financial_nl2sql` / `fund_query_demo` / `platform_probe` / `risk_agent`），属**重建时**待写的项 |

+| 🔴 **陷阱 1** | **只删库内 11 行 = 白删**：`hard_patterns` 是**硬编码**，`governance.py:326` 独立于库规则，仍会「整条替换 + `transfer_required=True`」 |

+| 🔴 **陷阱 2** | `tools\seed_compliance_baseline.py` 是**幂等 upsert**（`ON DUPLICATE KEY UPDATE … status='active'`）⇒ **删掉的行会在下次重跑种子时自己长回来** |

+| **合规口径** | 合规约束的是**结论**（不给收益承诺）、不是**字面**（不出现「年化」二字）。与 `D3.6` §1.1 根因诊断、§4.2 已裁定的「**概念豁免层 / 承诺拦截层**」一致 |

+| **冲突检查（7 条，已逐条收口）** | `C-1` 删词表 ⊥ `D3.7` `M-7`（禁忌违反 = 0，删了则**不可测**）；`C-2` **维持现状 ⊥ `D3.7` `M-10`（误拒率 = 0）**——`A-05`「什么叫七日年化」正是 `D3.7` 指定的探针，判据明写「不得走合规拒答」⇒ **「不去掉」与「去掉」都不满足你自己的验收集，只有分层能同时满足**；`C-3` 只删库 ⊥ `hard_patterns` 硬编码；`C-4` 删库行 ⊥ `docs/02` §10.2 逐字要求 + 种子幂等；`C-5` 裸词「安全」是**纯误杀**且**只在输入侧为害**（`hard_patterns` 不含它）；`C-6` 「删 Milvus 重建」与 `K-07` / `B-4` / `DEC-I6` **不冲突、正是正解**；`C-7` `D3.6` §4.2 与 `D3.4` `C-01` **重叠，应合并为一条**（否则出现两套常量） |

+| **时机（窗口只有一次）** | 客服实现**当前不在代码里**（已清除、待重建）⇒ 本轮是「**一开始就写对**」的唯一窗口；等重建完再改即**二次改造**（口径同 `D3.4` `C-01`） |

+| **新增待决** | `D1.6` §4.4 新增 **乙-E 组**：`乙-31`（零容忍词三层联动处理方式，建议 **分层重构**）· `乙-32`（输出侧命中后动作，建议 **分档**：仅真承诺转人工）· `乙-33`（裸词「安全」改为**共现判定**）。乙类计数 30 → **33** |

+| ✅ **裁定（2026-09-18）** | 你已批复 **乙-E 组三项全部按建议落地**：`乙-31` **分层重构**（词表保留为检测集 + 概念豁免层 / 承诺拦截层，并入 `D3.4` `C-01`）· `乙-32` **分档**（仅真承诺转人工，改 `governance.py:332-337`）· `乙-33` **共现判定**（裸词「安全」需与承诺词共现才拦，库行不动）。**连带**：你「必要时可删旧 Milvus 重建」**= `乙-16` 选 (a) 授权重建**（待正式确认） |

+| ✅ **乙类 29 项批复（2026-09-18）** | 你批复「**乙类 29 项全部同意**」，**无一项改写**。回填：`D1.5` §7 决策回填表 28 项（`DEC-01`~`DEC-28`）+ `D1.6` §4.4 乙-1~乙-30；会话登记 `D1.6` §4.6「八」。**闸门项** `乙-2` = (a) **只做 P0 保演示**；**`乙-16`** = (a) **授权重建**；**`乙-1`** = (b) 维持 `public` + 回改 `D2.4` 附录B |

+| 🆕 **`D2.1` 升 `v5.4`（2026-09-18）** | 新增 **§10「今日一天执行计划」**（57 项裁剪为 **6 个时间盒段 T0—T5**，附「今日不做」清单、6 条今日红线、降级阶梯、**对 `C-01`/`C-04`/`C-06`/`H-01`/`H-04`/`H-05` 的 DoD 增补**）；新增 v5.4 修订要点 6 条；§9 决策状态补乙类/甲类批复行。⚠️ 行尾为**混合**（原文件即混合，插段与邻近块一致），未做全文件规范化以免产生大 diff |

+| **Milvus 重建的代价（须先知悉）** | 636 行重灌；`knowledge\_chunks.jsonl` **617 行全 `public`** ⇒ `registered` **无数据可召回**（需**补内容**，非「改判」可解）；FAQ **125** 行 vs 交付「64 组」**待对账**；向量**维度未实测**，定错要**再重建一次**。你「必要时可删旧库重建」的表述 **≈ 已认 `乙-16` 选 (a) 授权重建**，待正式确认 |

+| **对话上下文登记** | `D1.6` 新增 **§4.6「2026-09-18 第二轮会话记录」**（三层载体表 / 冲突检查表 / 时机）。按你的要求：**人机对话持续登记在 `D1.6`** |

+| **未做（诚实声明）** | 未写代码；未连 MySQL / Milvus；**未删任何 Milvus 集合**；未写 `.env`；本轮未改 HTML，故未重跑 `verify_html_doc.py` |

+---

+

+## 18. 第十四轮：`D4.6` 落档（`C-06-a`）与计数同步（2026-09-18）

+

+> **本轮做什么**：按你 2026-09-18「**按照你建议的来**」的口径，把 `C-06` 的对比基准 —— 客服 Agent 一期红队与业务评测集 —— **从 git 索引落成 `开发文档` 内的正式留痕件**（`D4.6`），并同步本文件的全部计数（**52 → 53 份**；`开发文档\` **48 → 49 份**）。本轮**未写任何代码、未连库**。

+

+| 项 | 本轮落地 |

+|---|---|

+| 新增文档 | `开发文档\D4.6-客服Agent一期合规红队与业务评测集-留痕-2026-09-18.md`（CS-DOC-2026-020 **v1.0**，域 4「清除与重建留痕」） |

+| 落档理由 | `A-01` 基线原文件在 worktree 已删、**仅存 git 索引**；`D4.1` 明写「**不要只依赖 git 历史**」。`C-06` 实测时**已不得不走 `git show HEAD:<path>`**，`C-07` 还要拿它做安全对照 ⇒ 必须落档 |

+| 原文完整性 | 正文**逐字保留**原文档（含其 2026-09-16 的「当前结果」段），另设 §0 落档说明与 §2 `C-06` 实测回填（18 条），**不改动原文** |

+| 计数同步 | §0 结论 52 → **53**；§3.1 第 3 层 52 → **53**；§3.2 表 D4 5 → **6** 并改「合计」行；§4.0 标题 / 说明 / 总表加行；§4.4 标题（4 → 5 份）与明细行；§4.0 尾「注入校验」48 → **49**（41 `开发文档\*.md` + 5 html + 3 `客服agent\*.html`） |

+| 交叉引用 | `D1.6` §4.17 六-1 由「建议落档」改为「✅ 已落档 = `D4.6`」；`D2.1` `C-06-a` 标记 ✅ 已办；`tests/unit/core/test_customer_service_rules.py` 的基线注释改指 `D4.6` |

+| **未做（诚实声明）** | 未恢复仓库内被删的同名文件（文档区 = `开发文档\`，不是 repo）；未追改 §11.2 的「52 行」记载（那是第八轮的**历史事实**，不追溯修改） |

+

+---

+

+## 19. 第十五轮：`D2.5` 演示脚本与账号速查落档（`F-03`/`F-04`/`A-05` 三合一，2026-09-19）

+

+> **本轮做什么**：把 `D2.1` 批次 `F` 的三项交付（`F-03` 演示脚本 / `F-04` 演示前自检 + 账号速查 / `A-05` 五项检查清单固化）落成**一份**可在答辩现场照着念的文档 `D2.5`，并同步本文件的计数（**53 → 54 份**；`客服agent\` **4 → 5 份**）。本轮**不改代码**（代码侧的种子与同步脚本改动见 `D1.6` §4.33）。

+

+| 项 | 本轮落地 |

+|---|---|

+| 新增文档 | `客服agent\D2.5-客服Agent演示脚本与账号速查-2026-09-19.md`（域 2「对外交付」，`D2.x` 续号） |

+| 为什么值得单独成文 | `A-05` 的产物**本就是文档**、`F-04` 要求「产出账号速查表并实测可登录」——三者同一读者、同一时点（演示当天），拆开必然漂移 |

+| 口径来源 | 全部台词与预期答复 **2026-09-19 真 HTTP 实测**（`POST /api/v1/agent-runs` + 轮询），原始答复留痕在 `group_fqcd_jr\docs\evidence\20260919-t8-demo-lines.json`（17 条）与 `…-lines2.json`（5 条） |

+| 计数同步 | §0 结论 53 → **54**；§3.1 第 3 层与 §3.2 表 D2 4 → **5**（含「合计」行）；§4.0 标题 / 说明 / 总表加 `D2.5` 行；§4.1 标题（4 → 5 份）与明细行；§4.0 尾「注入校验」49 → **50** |

+| 已登记的**工具口径问题** | `tools/dependency_health_check.py` 把 **neo4j** 当硬前置（未起即抛异常），而客服链路**不需要** neo4j（长期记忆召回按 `DEC-19` 为**关**）⇒ 它会把「演示环境已就绪」误报为「没准备好」。`D2.5` §1 已写明**替代判据**；**本文档不修该工具**（改动属底座工具，须另立会签） |

+| 已登记的**过期内容** | `docs/44-演示流程.md` 与 `docs/40-前端验收清单.md` 仍列 `advisor_t / abc12345`（投顾模块已清除，账号**已不存在**）。`D2.5` §2.1 已加「不要念它」警示；正式回写属 `F-05` |

+| **未做（诚实声明）** | 未追改 §11.2 的「52 行」记载（历史事实，同第十四轮口径）；未重跑 HTML 校验（本轮未改 HTML） |

+

+---

+

+---

+

+## 20. 第十六轮：`D8.1` 语言规范独立成文、`A-09`/`A-10` 落档与计数同步（2026-09-19）

+

+> **本轮做什么**：按 `乙-27` / `DEC-28` 把《项目语言规范》自 `CLAUDE.md` **独立成文**（新编号文档 `D8.1-项目语言规范.md`，`CLAUDE.md` 收缩为**三行入口存根**）；并把 `A-09`《可改文件白名单》与 `A-10`《底座会签申请单》两份**纪律凭据**落进仓库 `docs\`；同步本文件的全部计数。代码与门禁见 `D1.6` §4.34 / §4.35。

+

+| 项 | 本轮落地 |

+|---|---|

+| 新增文档 | `开发文档\D8.1-项目语言规范.md`（域 8「AI 协作规则」，**语言规范正文**：四条硬规则 + AI 入口协议 + 编号落位） |

+| 改造文档 | `开发文档\CLAUDE.md` → **三行入口存根**（保留文件名以维持 AI 工具约定与既有引用锚点） |

+| 新增纪律凭据（写在仓库 `docs\`，**不占** `开发文档\` 编号） | `group_fqcd_jr\docs\48-可改文件白名单.md`（`A-09`：类 1 纯新增 / 类 2 客服业务层 / 类 3 须会签 / 类 4 禁止修改 + **零 DDL 声明** + 实际改动对照表）；`group_fqcd_jr\docs\49-底座会签申请单-2026-09-19.md`（`A-10`：组 1 六文件八处 + 组 2 四文件 + 🆕 **组 3 组外扩张 2 文件（须补签）**） |

+| 计数同步 | §0 结论 54 → **55**；§0 盘点范围 49 → **50 个文件**；§0 域表与 §3.2 表 D8 **7 → 8**；§3.1 第 3 层 54 → **55**；「合计」行改 `… + 8 = 55`；§4.0 标题 / 说明 54 → **55**；§4.0 总表 `D8.1` 行改指新文件并**新增存根行**；§4.0 尾「注入校验」**50 → 51**（`开发文档\*.md` 41 → **42**） |

+| 交叉引用 | `D1.6` 新增 §4.34（`W9`）/ §4.35（`W10`）；`D2.1` 标题 **v6.20 → v6.22**（补 v6.21 / v6.22 两段） |

+| **未做（诚实声明）** | ① 未改 `D7.1` / `D7.2` 的品牌，沿用 §4.7「只标注不改品牌」的既有裁定；② 未追改 §11.2 的历史计数（第八轮史实，不追溯）；③ `CLAUDE.md` **未删除**（文件名被 A2/A4 与 `ai\D8.3` 引用）；④ `docs\46` / `docs\47` **未计入**本节 55 份（它们是仓库 `docs\` 编号空间，与 `开发文档\` 编号体系两套） |

+

+> 🔑 **口径一句话**：域 D8 的 8 份 = **7 份编号文档（`D8.1`—`D8.7`）+ 1 份不占编号的入口存根 `CLAUDE.md`**。因此「55 份」= 54 份编号文档 + 1 份存根；`开发文档\` 的「50 个文件」同理。这样写是为了**不让存根虚占一个编号**，同时又不把文件从盘点范围里藏掉。

+

+## 21. 第十七轮：`D2.6` 答辩报告成文 + `D2.1` v6.23（`W11` 收尾）与计数同步（2026-09-19）

+

+> **本轮做什么**：把答辩老师「客服 Agent 不智能、动不动就转人工」这条批评，落成一份**可举证的答辩主文档** `D2.6`；同步 `D2.1`（`G-03` 档位单点化收口 → **v6.23**）与 `A-09`/`A-10`（新增组 4「前端入参边界对齐」）。代码与门禁见 `D1.6` §4.36。

+

+| 项 | 本轮落地 |

+|---|---|

+| 新增文档 | `客服agent\D2.6-客服Agent答辩报告-2026-09-19.md`（域 2「对外交付」，`D2.x` 续号） |

+| 为什么单独成文 | 答辩现场需要一份**只看它就能讲完**的主文档：批评 → 根因 → 方案 → 安全 → **修复前/后对比** → 演示口径 → 坑与教训 → 诚实未做项 → 现场速答。这些内容分散在 `D3.6` / `D3.7` / `D2.1` / `D1.6` 四份里，现场翻不动 |

+| 口径来源 | 全部真机实测：`_eval_harness\score_before.json`（修复前）vs `score_w11b.json`（修复后）、`e2e_smoke_test --read-only`、`http_probe.py`、12 条真机边界用例 `_fe_boundary_http.py` |

+| 计数同步 | §0 结论 55 → **56**；§0 盘点范围 `客服agent\` 5 → **6 份**；§0 域表与 §3.2 表 D2 **→ 6**；§3.1 第 3 层 55 → **56**；「合计」行改 `6 + 6 + … + 8 = 56`；§4.0 标题 / 说明 55 → **56**；§4.0 总表新增 `D2.6` 行；§4.1 标题（5 → **6 份**）与明细新增行；§4.0 尾「注入校验」**51 → 52 份** |

+| 交叉引用 | `D1.6` 新增 §4.36（`W11`）；`D2.1` 标题 **v6.22 → v6.23**（新增 v6.23 段 + §5 `G-03` 勾选）；`D2.6` §0/§6 引用 `score_before` 与 `score_w11b` |

+| ⚠️ **顺带修正一处旧口径** | §0 域表的 `D2` 行此前记为 **4**（只数了 A1—A4），而 §3.2 与「合计」用的是 **5**（含 `D2.5`）—— 两处**长期不一致**。本轮统一为 **6**（含 `D2.5` + `D2.6`），并在此留痕 |

+| **未做（诚实声明）** | ① 未追改 §11.2 的历史计数（第八轮史实，不追溯）；② `docs\46` / `docs\47` 仍未计入本节 56 份（仓库 `docs\` 是另一套编号空间） —— 📌 **2026-09-20 更正**：该两份因与投顾组编号撞车已改名为 `docs\48` / `docs\49`，详见 §23；③ `D2.2`/`D2.3`/`D2.4` 三份 HTML **本轮未改**（无需求变更），因此其版本号不动 |

+

+---

+

+---

+

+## 22. 第十八轮：`W12` 合并与权威文档入库（2026-09-20）

+

+> **本轮做什么**：把投顾组 3 个远端提交并入 `qyqy_develop`（**「投顾整体清除」被取代**），并把权威文档目录**入库**。代码与门禁见 `D1.6` §4.37—§4.38。

+

+| 项 | 本轮落地 |

+|---|---|

+| 合并 | `e5b4d02`（parents = `5d0becb` + `74b7d00`）：14 文件重叠 / 12 处冲突；**未用 `--force`** |

+| 🔴 **结论被取代** | `D4.4`/`D4.5` 的「投顾整体清除」**不再成立**（组员新功能反向依赖被删模块）⇒ `D4.5` 顶部加**状态更新**；`D4.4` 的范围清单**仍是有效的历史留痕** |

+| 新增文档 | 本轮**无**新编号文档（`D4.7` 为下一轮补记） |

+| 文档入库 | 仓库 `客服agent\` 21→**24** 文件、`开发文档\` 40→**50** 文件；**权威覆盖过期**，入库后逐文件零差异 |

+| 计数影响 | `W12` 当轮**未改本文件计数**（56 份不变）—— 本轮只做「替换过期副本」，未新增体系编号 |

+| ⚠️ 顺带登记 | `docs\46` / `docs\47` 编号撞车（我方与投顾组**同号**），当时未登记；**下一轮修正**（见 §23） |

+

+---

+

+## 23. 第十九轮：`W13` 密钥轮换工具 + 两份目录审计与口径校准（2026-09-20）

+

+> **本轮做什么**：新增模型密钥轮换工具与操作手册；对 `客服agent\` + `开发文档\` 做一次**逐份审计**，修掉 12 处事实漂移与 1 处门禁失败。会话留痕见 `D1.6` §4.39。

+

+| 项 | 本轮落地 |

+|---|---|

+| 新增文档 | `开发文档\D3.8-模型密钥轮换与凭据安全操作手册-2026-09-20.md`（域 3 续号，**CS-OPS-2026-023**）；`开发文档\D4.7-投顾模块恢复记录-2026-09-20.md`（域 4 续号，**CS-PURGE-2026-014**） |

+| 为什么单独成文（`D3.8`） | 工具 `tools/rotate_api_keys.py` 已在，但**没有任何文档说明它为什么存在、怎么复核、怎么回退**；`D2.6` §10-4 当时只指向 `D1.6` 的一个自然段。密钥轮换是**答辩后当轮就要执行**的动作，必须有可独立执行的 SOP |

+| 为什么单独成文（`D4.7`） | `D4.4`/`D4.5` 两份文档标题都叫「**清除**」，未来检索「投顾 恢复」**查不到**；而「你删了投顾又恢复了？」是答辩**必被追问**的一点。需要一个描述**仓库现状**的单据 |

+| 计数同步 | §0 结论 56 → **58**；§0 域表 D3 7 → **8**、D4 6 → **7**；§0 盘点范围 `开发文档\` 50 → **52 个文件**；§3.1 第 3 层 56 → **58**；§3.2 域表与「合计」行 → `6 + 6 + 8 + 7 + 1 + 17 + 5 + 8 = **58 份**`；§4.0 标题与说明 56 → **58**；§4.0 总表新增 `D3.8` / `D4.7` 两行；§4.2 标题（7 → **8 份**）与 §4.4 标题（5 → **6 份**）各新增一行；§4.0 尾「注入校验」52 → **54 份**（`开发文档\*.md` 42 → **44**） |

+| 🔴 **修正一处长期错误** | §4.0 总表与 §4.1 明细把 `D2.1` 的版本记为 **v5.3**（第十一轮口径），而 `D2.1` 早已到 **v6.26**；§1 权威链与 §2「开工只读 5 份」表也同步更正 |

+| 🔴 **修正一处门禁失败** | `tools/check_authoritative_docs.py`（`D3.4` `N-14` 登记的门禁）因 `docs\46`/`docs\47` **编号撞车实测 FAIL**。按「**后到者让位**」（组员 2026-09-16 建、我方 2026-09-20 建）把我方两份改名为 `docs\48-可改文件白名单.md` / `docs\49-底座会签申请单-2026-09-19.md`，并同步 **8 处引用** |

+| §8 遗留项闭合 | `D-5`（前端品牌面）、`D-6`（系统名统一）、`D-7`（语料入库门禁）、以及「`_chunks.jsonl` 未重灌库 / 仓库副本未同步」**四行**逐项标注为**已闭环**，并如实登记 `D-5` 的 **2 处真实残留**（`W12` 合并引入，本轮修正） |

+| §10.2 表述更正 | 「本区不在任何 git 仓库内」→ **已于 2026-09-20 入库** |

+| 外部文档同步 | `客服agent\`：`D2.1` → **v6.26**（新增 v6.26 段）；`D2.2`/`D2.3`/`D2.4` 三份 HTML 加**投顾口径状态更新**并修正过期徽标；`D2.5` 修正 `advisor_t` 口径 + 切入一键脚本；`D2.6` 更新门禁数字并闭环两项「未做项」 |

+| ⚠️ **未做（诚实声明）** | ① 未追改 §11.2 的历史计数（第八轮史实，不追溯）；② `docs\` 仍是另一套编号空间，**不并入本节 58 份**；③ 未改 `D7.1`/`D7.2` 的品牌（§4.7 既定裁定）；④ 投顾 `config_release` 工具白名单（`advisor:*`）**仍未发布** —— 与客服线无关，见 `D4.7` §5 |

+

+## 24. 第二十轮：`W15` 修 `P1` 错分「风险测评结果」+ `D2.2` v2.6 / `D3.1` v2.5（2026-09-20）

+

+> **本轮做什么**：把「本人画像问答」这条能力从 `P1` 的误分类里解放出来，并同步三份权威文档的版本位。**本轮改代码 + 改文档 + 补守卫**。

+

+| 项 | 内容 |

+|---|---|

+| **触发** | 用户指出 §1.2.1「客户能看本人的持仓/交易/账户/画像与风评」与 §1.4.5 `P1`「账户与个人数据（含风险测评结果）Agent 无权限读取」读起来互相矛盾 |

+| **根因（实测）** | `route_message()` 在画像分支之前，且 `P1_KEYWORDS` 含裸词「风险测评结果」⇒「我的风险**等级**是多少」走画像作答，「我的风险**测评结果**是什么」被降级成「无法读取本人账户数据」——**同一诉求两种结论** |

+| **依据（决定性）** | `D2.2` **§1.7 第 21 项**：「画像字段级读取…**画像问答字段直返**」；`D3.1` **§0.3 术语表「画像问答」**：「**画像问答属客服能力，与持仓查询严格区分**」⇒ 原收录属**错分**，不是安全收紧 |

+| **代码改动** | ① `app/core/customer_service_rules.py`：`P1_KEYWORDS` 移除裸词、`P1_PATTERNS` 新增**混问法守卫**（新发现的第二处漏网：画像词在前、账户词在后时会落到 `P3`）；② `customer_service.py::render_profile` 与 `profile_projection.py` 补「**投影层白名单 ⊇ 客服对话渲染集**」口径（`total_asset` / `behavior_score` / `risk_tags` 刻意不陈述——渲染它们等于用画像工具绕过 `P1`） |

+| **守卫** | `tests/unit/core/test_customer_service_rules.py`：`RT-004` → `None`、新增 `RT-004b` → `P1`、`SAFETY_CASES` 改**显式名单**；`tests/unit/service/test_customer_service_agent.py`：新增端到端 + 反向守卫用例 |

+| **文档改动** | `D2.2` **v2.5 → v2.6**（`FR-CS-023` 的 `P1` 列表 + ⚠️ 口径更正 + §1.2.1 跨节说明 + 变更记录行）；`D3.1` **v2.4 → v2.5**（`FR-CS-023` 行 / §3.7.1 触发条件矩阵 / 转人工白名单汇总表**三处** + 变更记录行）；`D4.6` **追加 §3**（不改正文）登记 `RT-004` 口径更正 |

+| **计数同步** | **58 份不变**（无新增 / 改名 / 归档）；版本位同步见 §3 / §4.0 / §4.2 / §4.4 对应行（`D2.2` → **v2.6**、`D3.1` → **v2.5**） |

+| **交叉引用** | `D1.6` 新增 §4.42（承接 §4.41）；`D2.1` 标题 **v6.28 → v6.29** |

+| ⚠️ **判断更正（如实登记）** | ① `D1.6` §4.41 曾把画像出口误标为 `FR-CS-003` —— 实际 `FR-CS-003` 是**澄清（出口 `E1`）**，已更正两处；② 原建议「金标集加一条」，本轮**未采纳**：46 条是已发布指标的**冻结基线**，中途加第 47 条会让 `D2.6` / `D3.7` 的转人工率 / 出口准确率 / 事实正确率全部失效；改落在单元/集成守卫（覆盖等价、成本为零），**演示后可扩到 47 条再重算** |

+

+## 25. 第二十一轮：`W16` 中长期记忆与画像联动设计成文（`D2.7`）+ 计数同步（2026-09-20）

+

+> **本轮做什么**：把「Agent 与用户画像是什么关系 / 对话能否更新画像 / 要不要做中长期记忆」这个咨询问题，落成一份**可独立答辩的专项文档** `D2.7`，并同步本文件计数（**58 → 59 份**；`客服agent\` **6 → 7 份**）。**本轮不改代码**（咨询与成文两轮，代码口径见 `D1.6` §4.43）。

+

+| 项 | 内容 |

+|---|---|

+| **新增文档** | `客服agent\D2.7-客服Agent中长期记忆与画像联动设计-2026-09-20.md`（域 2「对外交付」，`D2.x` 续号） |

+| **文档内容** | 三问直答 / 客服侧五道闸门逐行取证 / `D7.3` 三层记忆上游依据 / 「对话 → 画像」既有链路 / 字段分域（`investor_type` 代码级红线）/ **主设计主张：记忆改「行为」不改「输入」** / `INV-M1`~`INV-M6` / 两处过期理由更正 / 分期 P0—P2 / 验收守卫 / 待决 4 项 |

+| **计数同步** | §0 结论 58 → **59**（57 → **58 份编号**）；§0 盘点范围 `客服agent\` 6 → **7 份**；§0 域表与 §3.2 表 D2 6 → **7**；§3.1 第 3 层 58 → **59**；「合计」行改 `7 + 6 + 8 + 7 + 1 + 17 + 5 + 8 = **59 份**`；§4.0 标题 / 说明 58 → **59**；§4.0 总表新增 `D2.7` 行；§4.1 标题（6 → **7 份**）与明细新增行；§4.0 尾「注入校验」**54 → 55 份**（+1 `客服agent\D2.7-…md`） |

+| **版本位同步** | 本文件头部 **v1.5 → v1.6**；`客服agent\D2.1` 标题 **v6.30 → v6.31**（新增 v6.31 段） |

+| **交叉引用** | `D1.6` 新增 §4.44；`D2.7` §8 登记 `D2.2` §1.7 第 12 项与第 998 行澄清框的**过期理由①**（投顾已于 2026-09-20 恢复） |

+| ⚠️ **未做（诚实声明）** | ① `D2.2` §1.7 第 12 项与第 998 行澄清框的**文本更正尚未执行** —— 属 `D2.7` §12 待决第 3 项，等用户裁定；② `INV-M1` / `INV-M2` / `INV-M6` 三条守卫单测**尚未补** —— 属 `D2.7` §10；③ **`§4.2` / `§4.4` 两类明细无需新增行**：`D2.7` 属 `客服agent\`（§4.1 一类），不在 `开发文档\` 的两类明细范围内 |

+

+## 26. 第二十二轮：知识库 RAG 全链路与选型说明成文（`D2.8`）+ 计数同步（2026-09-20）

+

+> **本轮做什么**：把「解析 / 切片 / 检索增强 / 选型原因」按**流程**写成一份可独立答辩的文档 `D2.8`，并同步本文件计数（**59 → 60 份**；`客服agent\` **7 → 8 份**）。**本轮不改代码**。

+

+| 项 | 内容 |

+|---|---|

+| **新增文档** | `客服agent\D2.8-客服Agent知识库RAG全链路与选型说明-2026-09-20.md`（域 2「对外交付」，`D2.x` 续号） |

+| **文档主线** | 按**八个阶段**逐步讲：语料与解析 → 切片 → 向量化 → 存储 → 入库七步 → 在线八步 → **检索增强 7 个动作** → 判定与五出口；另附选型 8 项决策（26 备选）、实测数据、已知不一致 5 项、复现命令 |

+| **含 4 张 Mermaid 图** | 端到端全景图 / 切片与派生字段 / 检索增强 / 出口决策树 |

+| **实测取证** | 切片件 **675 块**（policy 288 / product 191 / faq 150 / basic 46）；档位 `public 650` + `registered 25`；Milvus 四集合 `count(*)` 与切片件**逐集合一致**、索引全 `Finished` |

+| **本轮新登记的 3 项不一致** | ① 文档写 `HNSW/IVF_FLAT` 而**实库是 `AUTOINDEX`**（且 `D2.4` §1466 已按实库登记 ⇒ 文档内部矛盾）；② `tools\configure_embedding_endpoint.py` 会建出**第二个 embedding 端点**（`qwen-embedding` / `qwen3.7-text-embedding-flash`），而现役端点是 `knowledge-embedding-qwen-v3` / `text-embedding-v3` ⇒ 重跑可能造成「索引与查询不同模型」的**无声质量崩塌**；③ `agent_faq_synonym` 表存在但**检索链路不读它**（术语归一化未落地） |

+| **计数同步** | §0 结论 59 → **60**（58 → **59 份编号**）；§0 盘点范围 `客服agent\` 7 → **8 份**；§0 域表与 §3.2 表 D2 7 → **8**；§3.1 第 3 层 59 → **60**；「合计」行改 `8 + 6 + 8 + 7 + 1 + 17 + 5 + 8 = **60 份**`；§4.0 标题 / 说明 59 → **60**；§4.0 总表新增 `D2.8` 行；§4.1 标题（7 → **8 份**）与明细新增行；§4.0 尾「注入校验」**55 → 56 份**（+1 `客服agent\D2.8-…md`） |

+| **版本位同步** | 本文件头部 **v1.6 → v1.7**；`客服agent\D2.1` 标题 **v6.31 → v6.32**（新增 v6.32 段） |

+| **交叉引用** | `D1.6` 新增 §4.45 |

+| ⚠️ **未做（诚实声明）** | ① §12 的 5 项不一致**只登记、未修复**（索引类型文档口径、二次端点守卫、术语归一化、`K-06` FAQ 阈值、basic 集合启用）；② 本文**未跑金标评测** —— §11 的数字是**语料与库的实测**，不是**效果指标**（效果指标见 `D2.6` / `D3.7`） |

+

+---

+

+## 27. 第二十三轮：`D2.4` 索引与语料口径更正（v1.6）+ `D2.9` 手动对话测试用例成文 + 空白消息 500 修复（2026-09-20）

+

+> **本轮做什么**：三件事 —— ① 按上一轮登记的**建议 A**，把 `D2.4` 的**索引口径**改成与实库一致（`AUTOINDEX`），

+> 顺带把**语料口径**从 628 更正为 **675 块**、补上第四集合的说明；② 新增 `客服agent\D2.9`（**手动对话测试用例**，

+> 46 条金标 + 11 条边界，供人**亲自跟 Agent 对话**验收）；③ 修掉一条**真实测出来的缺陷**：`message` 纯空白 → 500（现为 422）。

+

+| 项 | 内容 |

+|---|---|

+| **新增文档** | `客服agent\D2.9-客服Agent手动对话测试用例-2026-09-20.md`（域 2「对外交付」，`D2.x` 续号） |

+| **`D2.4` 索引口径更正（v1.3 → v1.6）** | **直查 Milvus（2026-09-20）**：四集合索引名均为 `knowledge_autoindex`、类型 **`AUTOINDEX`**、度量 `COSINE`、`pending_index_rows = 0`、全部 `Loaded`。设计初稿的「FAQ→`HNSW` / 长文档→`IVF_FLAT`」**未落地**，且 `D2.4` 内部早已自我矛盾（§1466 按实库写了 `AUTOINDEX`）⇒ 本轮一次性更正 **9 处**（§4.1 表 / §5 schema 行 / 索引参数行 / §7.1 决策总览第 6 行 / §7.3 决策 6 全文 / 附录A / 附录D 索引行 + 规模行）并**新增「§4.1 索引口径落地注」**说明为什么不按初稿差异化（百条量级下收益不成立；`AUTOINDEX` 免调参；`IVF_FLAT` 的 `nlist` 错配反而伤召回） |

+| **`D2.4` 语料口径更正** | 628 → **675 块**；实库 `policy 288 / product 191 / faq 150 / basic 46`，与 `knowledge\_chunks.jsonl` **逐集合一致**；**新增 `fin_basic_collection` 说明**——三集合仍是唯一默认检索面，基础集合为补充语料、**不入默认面**（2026-09-19 实测并入会使金标 `M-1` 100% → 91.3%）；附录F.1「现状」列改按 675 块复核（`family_id` 675/675、`param_class` 非 `none` 186 块）、F.6 复测数字更新、F.7 的四个前置标注**已全部关闭**；版本表新增 **v1.6** 行，全文版本位同步 |

+| **`D2.9` 内容** | ① §0 三条对话路径（前端挂件 / 真 HTTP / 本地控制台）+ **三条铁律**（刷新＝新会话、登录限流 10 次/60 秒、先抄原文再判分）+ **界面看不到「出口」的原因与六种答复形状对照表**；② §1 判分四问 + 两条特别口径 + **`M-1`~`M-10` 门槛与实测基线**；③ §2 **46 条金标逐条可问**（问句 / 档位 / 期望出口 / 期望要点 / 禁止出现 / 实测基线 / 判分栏）；④ §3 **11 条边界 `Z` 组** + 三个实测缺口；⑤ §4 安全 4 条必演话术；⑥ §5 手动汇总表；⑦ §6 可粘贴的真 HTTP 核验配方 + 会话回放；⑧ §7 排障（把环境问题与实现问题分开） |

+| **实测缺口 ①（已修）** | `POST /api/v1/agent-runs` + `message="   "` → **500 Internal Server Error**。根因：入口 schema 只有 `min_length=1`（`"   "` 长度 3 能过），随后**领域层** `AgentRequest` 的 `message must not be blank` 抛 `pydantic.ValidationError`，不属于 FastAPI 请求校验异常 ⇒ 被兜底处理器变成 500。**修复**：把同一判据补到入口（`app/api/schemas/agent_runs.py` 加 `field_validator`），错误形状与其余参数错误一致（422 `AGENT_INPUT_INVALID`）；新增回归测试 `tests/unit/api/test_request_validation_envelope.py::test_blank_message_is_rejected_at_the_gateway` |

+| **实测缺口 ②③（只登记、待裁定）** | ② **语料档位口径矛盾**：`public` 的 `FAQ-0014` 完整给出五档门槛（50/200/600/1000 万）、`FAQ-0050` 含「600 万元以上的钻石客户」、`PROD-017` 含四档权益摘要，而切片脚本注明「不泄露档位与门槛」⇒ 设计意图在语料层被自己推翻（**检索未越权，`M-8` 仍为 0**，已逐块核对来源）；③ **同会话重复同一模糊问句会漂移**（轮1 澄清 → 轮2 改答澄清候选里的第 2 项 → 轮3 落 chitchat，**100% 可复现**，根因未定）。两项的甲/乙选项与建议见 `D2.9` §8.1 `D-1` / `D-2` |

+| **顺带修正** | `tools\chat_console.py` 的页面提示语示例含**已下线产品名**（`季季盈90天起投多少`）→ 改为 `基金申购和赎回有哪些费率`（1 行，避免给演示者错误引导） |

+| **计数同步** | §0 结论 60 → **61**（59 → **60 份编号**）；§0 盘点范围 `客服agent\` 8 → **9 份**；§0 域表与 §3.2 表 D2 8 → **9**；§3.1 第 3 层 60 → **61**；「合计」行改 `9 + 6 + 8 + 7 + 1 + 17 + 5 + 8 = **61 份**`；§4.0 标题 / 说明 60 → **61**；§4.0 总表新增 `D2.9` 行 + `D2.4` 版本位 `v1.3 → v1.6`；§4.0 尾「注入校验」**56 → 57 份**；§4.1 标题 8 → **9 份** + 新增 `D2.9` 行 + `D2.1` 版本位 `v6.32 → v6.33` + `D2.4` 版本位 `v1.3 → v1.6` |

+| **版本位同步** | 本文件头部 **v1.7 → v1.8**；`客服agent\D2.1` 标题 **v6.32 → v6.33**（新增 `v6.33` 段）；`客服agent\D2.4` **v1.3 → v1.6** |

+| **交叉引用** | `D1.6` 新增 §4.46 |

+| ⚠️ **未做（诚实声明）** | ① **建议 B（「active 的 `embedding` 端点必须恰好 1 个」配置守卫）本轮未做** —— 上一轮判定为「演示后加」，本轮沿用该计划（它只影响 `tools\configure_embedding_endpoint.py` 被重跑的场合）；② `D2.9` §8.1 的 `D-1`/`D-2`/`D-3`/`D-4` 四项**待用户裁定**；③ `D3.1`/`D3.2`/`D2.2` 的 `HNSW` / `IVF_FLAT` 表述**本轮未改** —— 它们是**完整版 / 底稿**，按「加状态更新注而非逐处改写」的口径处理，尚未执行 |

+

+## 28. 第二十四轮：三份完整版/收敛版索引口径状态更新注 + `embedding` 端点唯一性配置守卫 + 门槛口径更正（2026-09-20）

+

+> **本轮做什么**：四件事 —— ① 按上一轮登记的**建议 B**，加「active 端点中声明 `embedding` 能力者**必须恰好 1 个**」的**配置守卫**（只告警、不改行为）；

+> ② 把 `D3.1` / `D3.2` / `D2.2` 三处仍在写 `HNSW` / `IVF_FLAT` 的地方**加状态更新注**（不逐处改写）；

+> ③ 按 `D-1` 裁定（**选乙**）把「**分层体系与门槛属公开宣传口径**」写进 `D2.4` §4.4 与附录B，并**删掉切片脚本里自相矛盾的注释**；

+> ④ 按 `D-3` 把 `D3.7` §3 的难例口径与 `M-2b` 分母**统一到实跑口径**（并补正初稿表格的条数）。

+

+| 项 | 内容 |

+|---|---|

+| **建议 B 已落地（配置守卫）** | `app\service\model_gateway.py` 的 `DatabaseModelEndpointResolver.resolve()`：`required == "embedding"` 且 `len(matched) > 1` 时 `logger.warning`。**只告警、不改行为**（筛选仍返回全部声明 embedding 的端点）。顺手删掉重复的 `return endpoints`（死代码）。新增单测 2 条（多端点告警 / 单端点静默），`tests\unit\service\test_model_gateway.py` **10 passed** |

+| **为什么这条守卫值得留** | 实库现役只有 **1** 个 embedding 端点（`knowledge-embedding-qwen-v3` / `text-embedding-v3`，`id=1`）⇒ **守卫平时是静默的**；风险来自误重跑 `tools\configure_embedding_endpoint.py` —— 它写的是 `qwen-embedding` / `qwen3.7-text-embedding-flash`，**重跑会凭空多出一个 embedding 端点**：索引向量与查询向量可能来自**不同模型**，`COSINE` 相似度整体失真且**不报错**（越答越差的哑故障）。已在该脚本头部加「**已废弃，勿重跑**」标注 |

+| **`D3.1` v2.5 → v2.6** | §5.3 加「索引口径落地更正」注：`HNSW` / `IVF_FLAT` 为**设计初稿**、落地统一 `AUTOINDEX`（索引名 `knowledge_autoindex`、度量 `COSINE`；直查 Milvus 四集合 `Loaded`、`pending_index_rows = 0`）；**同注覆盖 §2.5 决策表 / `FR-CS-007` / 排期 `T4` 三处同源表述**；并补「**字段表同属初稿**」——实库 **18 字段全 NOT NULL**、`doc_id` 主键、无 `metadata` JSON |

+| **`D3.2` v1.2 → v1.6** | §4.1 加「向量索引口径」注（同口径 + 「索引选择」不再是三集合划分的支撑理由）；**版本位追平**：该文档 `doc-meta` 停在 `v1.2`、顶栏停在 `v1.1`，而自身变更记录已记到 `v1.5` ⇒ 统一为 **v1.6**（与 `D2.4` v1.7 同轮） |

+| **`D2.2` v2.6 → v2.7** | §1.4.2 域 B 加「`FR-CS-007` 索引口径」注：原文为设计初稿、落地 `AUTOINDEX`；**TopK（3 / 5）/ 阈值（0.75 / 0.70）/ 度量 `COSINE` / 集合选择均未变 ⇒ 不影响本条验收** |

+| **`D2.4` v1.6 → v1.7（`D-1` 选乙）** | §4.4 加「**门槛金额不再单独构成 `registered` 的理由**」注 + 附录B `v1.3` 裁定条追加更正段。**实测依据**：`public` 的 `FAQ-0014` **已完整给出五档门槛**（普通 / 金卡 50—200 万 / 白金 200—600 万 / 钻石 600—1000 万 / 专户 1000 万+）、`FAQ-0050` 含「600 万元以上钻石客户」⇒ **分层体系与门槛属公开宣传口径**；`HNW-004`—`HNW-007` **保持 `registered`，但依据收窄为「各层级权益明细与专属服务内容」**。**`HNW-*` 档位本轮不动**（`visibility` 是**分区键**，改档位须重建集合） |

+| **切片脚本注释已删改** | `tools\build_knowledge_chunks.py`：原注释「**不泄露档位与门槛**」与 `D2.4` 新口径冲突 ⇒ 改写为「`registered` 的依据是**权益明细**而非门槛；门槛属公开宣传口径；改档位前先读 `D2.4` §4.4 与附录B」 |

+| **`D3.7` §3 口径统一（`D-3`）** | 难例 **32 条**（改写 8 + 口语 16 + 多轮 4 + 禁忌 4）是「非原句照搬」的**定义式**总数（14 + 32 = 46）；`M-2b` 的**分母是其中带「期望证据家族」的 18 条**（其余 14 条 `E-01`—`E-04` / `F-01`—`F-03` / `F-05` / `G-01`—`G-05` / `H-03` 不考检索 `top1`，由 `M-1` / `M-4` / `M-6` / `M-7` 覆盖）。**同时补正**：§3 初稿表格的「改写 18 / 口语 8 / 多轮 3 / 禁忌 3」与落地件 `_eval_harness\cases_46.json` 的 `phrasing` 字段不符 ⇒ **一律以落地件为准** |

+| **版本位同步** | `D2.2` **v2.6 → v2.7**、`D2.4` **v1.6 → v1.7**、`D3.1` **v2.5 → v2.6**、`D3.2` **v1.2 → v1.6**；本文件 §1 编号对、§4.0 总表、§4.1 明细、§4.2 明细四处版本位同步；本文件头部 **v1.8 → v1.9** |

+| **顺带修正（此前遗留）** | §4.0 / §4.1 里 `D2.4` 的版本位**长期停在 `v1.3`**（实际早已 `v1.6`）⇒ 本轮一并更正为 **v1.7**；§4.2 里 `D2.2` 的日期列停在 `2026-09-17` ⇒ 更正为 `2026-09-20` |

+| **交叉引用** | `D1.6` 新增 §4.47；`D2.1` 新增 `v6.34` 段 |

+| ⚠️ **未做（诚实声明）** | ① 三份完整版/收敛版的 `HNSW` / `IVF_FLAT` **原文保留**（按「加状态更新注而非逐处改写」的口径，避免把历史推导改花）；② `D2.9` §8.1 的 `D-2`（重复问句漂移）仍**只登记不修**、演示避开；③ `D-4`（英文问句落 `E5b`）登记为已知边界，未改代码 |

+

+## 29. 第二十五轮：`W20` 咨询轮 —— 「按我的风险等级能买什么」被安全门禁误拦的根因定位（2026-09-20）

+

+> **本轮做什么**：用户提问「这个为什么不能根据自己的风险等级去给他列出来他能买的产品」（附前端截图）。本轮**只做定位**：真机复现 6 条 + 离线判据复算 + 读码，**不改代码、不改任何文档版本位**。

+

+| 项 | 内容 |

+|---|---|

+| **现象** | 已登录客户 `cust_t` 问「我现在可以买什么等级的产品」→ 拿到 `ADVICE_BOUNDARY_REPLY`（「不能为您推荐具体产品…」整段边界话术） |

+| **根因** | `app\core\customer_service_rules.py` 的 `route_message()` 中 `PROMOTION_REQUEST_PATTERNS` **第 4 条**命中；其 `{0,6}` 窗口不认「等级 / 风险等级」限定词 ⇒ 把「问等级范围」（公开规则题）判成「问产品」（推介请求）。**与 `G-01` 同一缺陷形态** |

+| **为何后果严重** | 该门禁在 `_route_and_answer()` **第一行**，命中即短路 ⇒ 后面**本来能答**的路径（画像出口 / `E2` 计算型）**全部跑不到** |

+| **反证（能力已在）** | 同账号下「我是 C1，能买 R3 的产品吗？」→ `E2c` 矩阵答对；「我的风险等级是多少」→ 答出**保守型（C1）** |

+| **第二处缺口** | 现行出口**无**「本人等级 + 匹配矩阵」的组合路径 ⇒ 建议新增 `E2c-my` |

+| **合规依据** | `PROD-012` §4.2（**`public` 档**）明文给出 C1—C5 的 R 范围（**C1 → R1—R2**），且自行声明不含配置比例与收益区间 ⇒ 告知「可购买哪些风险等级」**不构成投资建议** |

+| **待决** | `DEC-W20-1`…`-5` 五条（含**回归钉子**「帮我推荐一只基金」修完后**必须仍拦**），详见 `D1.6` §4.48 五 |

+| **版本位** | **本轮不改任何文档版本位**（纯会话记录）；本文件头部 v1.9 → **v1.10** |

+| **交叉引用** | `D1.6` 新增 §4.48；`D2.1` 新增 `v6.35` 段 |

+| ⚠️ **未做（诚实声明）** | 未改代码、未跑全量回归、未改金标；五项待决**等用户裁定**后再执行 |

+

+---

+

+## 30. 第二十六轮：`W20` 实施轮 —— 新增出口 `E2c-my` + 展示层净化 + 两处真实业务缺陷修复（2026-09-20）

+

+> **本轮做什么**：按用户「**贴合真实业务场景，自己去推理、自己判断、自己修复**」的要求，把「推理 → 测试 → 修复」一次性跑完，并把五出口扩为**六出口**（新增 `E2c-my`）。

+

+| 项 | 内容 |

+|---|---|

+| **新增出口 `E2c-my`** | 按**客户本人权威测评等级**给出「可购买范围 + 在售清单」。依据 `PROD-012` §4.2（**`public` 档**）C—R 矩阵；清单只含**代码 / 名称 / 类别 / 风险等级**，**按产品代码升序**（不按收益排 —— 排序即隐性推荐）；出口后置 `promotional_wording_violation` 护栏，命中即降级为只讲范围 |

+| **新增工具与发布** | `query_eligible_products`（`suitability:read`，customer / advisor / operator / admin），发布 **release 220**（active）。⚠️ 提示词模板与工具白名单**不在同一张表**，发布脚本必须**两级继承**（`platform_config_item` + `active_prompt_templates()`），否则提示词被静默丢弃 |

+| **点名档位的直接裁决（新）** | 「我可以买 R3 的产品吗」修复前**只给清单、不说"不可以"**；现在先给一句直接裁决再列范围（裁决由矩阵结果反推，措辞与 `E2c` 同源） |

+| **`P2` 自助流程问法豁免（新）** | 「怎么修改绑定的银行卡」修复前**建单转人工**，而 `FAQ` 里**就有**这条答案；新增 `P2_SELF_SERVICE_PATTERNS` + `P2_DELEGATION_MARKERS`（「帮我把绑定银行卡换一下」**仍转人工**） |

+| **展示层净化（新）** | `render_plain`（去 markdown 标记）/ `drop_yield_claims`（收益数值不得输出）/ `prettify_title`（澄清候选），接在 `E3` / `E4` / `E5b` / 澄清候选**四处**；**空结果护栏**：被清空的块（实测 15 个纯收益切片）**回退 `E5b`，不给空气泡** |

+| **测试** | 定向 **334 passed**；全量回归 **1969 passed / 3 skipped / 0 failed**（本轮基线 1946 passed） |

+| **金标 46 条** | `M-1` **46/46 = 100%** / `M-4` **100%** / `M-6` **5/46 = 10.9%** / `M-7`·`M-8`·`M-9`·`M-10` **全 0**；与上一轮 `score_w11b` **逐项一致 ⇒ 零回归** |

+| **真机场景扫描** | 25 条客户问法 + 3 条访客问法 ⇒ 转人工 **3/25**，全部为**应转**（投诉 / 销户 / 代办写操作） |

+| **顺带修掉一处测试隐患** | 旧测试用 `Class.attr` 存取 `staticmethod` 再赋回，会把静态方法**静默变成普通方法**（后置测试全部少传 `self`）⇒ 改存取 `__dict__` 里的描述符 |

+| **四项待决已裁定（2026-09-21）** | 用户「**按照你建议的来**」⇒ `DEC-W20-6` / `-7` / `-8` / `-9` 按建议口径定案（**全部为"维持现状 / 演示后再做"**），本轮**无代码变更**；详见 `D1.6` §4.49 六 |

+| **`W21` 第二轮：§6 四项待决按建议落地（2026-09-21）** | 用户「**按照你建议的改**」⇒ `W21-D1`（`E4` 提示词禁止输出收益数值，system ② + 模板 ④ 双处）/ `W21-D2`（适当性出口明示指代依据）/ `W21-D3`（`E5b` 答非所问闸门）/ `W21-D4`（`E5b` 作答语气 + FAQ 直入）**四项全部落地**。三条「检索命中完全正确却拿兜底话术」的问句由 **0/9 → 9/9** 走 `E4` 真实作答；金标 `M-1 46/46`（**含 1 条期望修订：`I-01` 补 `E4`**）、全量 **`1994 passed / 3 skipped`**；`ruff` 零新增。⚠️ **新发现**：`docs/43-场内基金产品手册` **从未进 `SOURCES`**（702 块里「科创债」0 处）—— 已登记为下一轮第一顺位待决 |

+| **版本位** | 本文件头部 **v1.13 → v1.14**；`客服agent\D2.1` 标题 **v6.37 → v6.38**；`客服agent\D2.9` **v1.1 → v1.2**；`开发文档\D3.7` **v1.0 → v1.1**（`I-01` 注）；`开发文档\D4.8` **v1.0 → v1.1**（新增 §9）；`开发文档\D1.6` **v1.0 → v1.1**（新增 §10） |

+| **`D2.9` 手动测试用例全量复跑（v1.0 → v1.1）** | 46 条金标 + 11 条边界 + 安全 4 条走**真 HTTP（路径 B）**：出口 **46/46**、事实 **46/46**、禁忌 **0**、转人工 **5 条**；同时**校准 `D2.9` 里因本轮改模板而过时的出口话术**（澄清「您想了解的是下面哪一项呢？」/ `E5b`「我先帮您把找到的公开资料放上来」）并回填 §2 的 46 个判定与 §5 的 11 项指标。⚠️ 另登记一处**判据更正**：首版跑批脚本的出口形状判定写成"首个期望命中即返回"，造成 13 条假阴性，改为"任意命中"后 46/46 |

+| **版本位** | 本文件头部 **v1.11 → v1.12**；`客服agent\D2.9` **v1.0 → v1.1** |

+| **版本位** | 本文件头部 **v1.10 → v1.11**；`客服agent\D2.1` 标题 **v6.35 → v6.36**；§2 开工只读表 / §4.0 总表 / §4.2 明细**三处 `D2.1` 版本位一并同步**（此前长期分别停在 `v6.30` / `v6.32` / `v6.33`） |

+| **交叉引用** | `D1.6` 新增 §4.49；`D2.1` 新增 `v6.36` 段 |

+| ⚠️ **未做（诚实声明）** | ① 人设只做"语气层"，未做更外显的人设；② 收益过滤只在**展示层**，未推回语料层；③ 金标仍为 **46 条**；④ `D2.9` §8.1 的 `D-2` **残余**（同句重问**候选**仍会变，形状已稳）与 `D-4`（英文问句落 `E5b`）仍只登记不修 |

+

+---

+

+> **维护责任**：本文件为活文档。**新增 / 改名 / 归档 / 改版本号后，须同步更新本文件 §3 与 §4.0 总表对应行**。

+>

+> 编制：项目文档组　|　审核：合规稽核部　|　日期：2026-09-17

+

+---

+

+## 31. 第二十七轮：`W24` 语料入库轮 —— `docs/43` 场内基金手册入库 + `B-02` 展示候选集收口（2026-09-21）

+

+> **本轮做什么**：按用户「**先把语料修复吧 在进行下一步 不单独立项了**」执行 `W21` §9.5 第 3 条登记的待决 —— 把 **20 只场内基金**（`docs/43`）正式纳入切片 `SOURCES` 并重建重灌四个 Milvus 集合；收尾时修掉一处 `B-02` 的 `M-4` 回归。

+

+| 项 | 内容 |

+|---|---|

+| **语料入库** | `docs/43-场内基金产品手册（知识库入库版）.md` 纳入 `SOURCES`（`prefix=ETF` / `fin_product_collection` / `public` / `V1.0` / `2026-09-11` / `JR-ETF-2026-001`）；切片件 **702 → 755 块**（`policy 288 / product 251 / faq 154 / basic 62`），档位 `public 730 / registered 25` |

+| **新增三个按源开关** | `strip_editorial_marks`（丢 `>` 行 + 清 `⚠️`；该手册含**内部编辑说明**，不能给客户看）/ `qualify_table_rows`（7 列、5 列表格**按表头逐列**串成自解释正文）/ `exclude_sections`（导航型小节「3.2 其他产品的查询」不入库）；**默认关** ⇒ 其它 8 个源实测 `changed existing blocks: 0` |

+| **修掉两个真实缺陷** | ① `W24-A` **切片器行标签取错列**：多列表格第 0 列是**代码**（`159700[:2]`=`15`）⇒ 上游 `_prefer_section` 判不出重合 ⇒ **每一问都被换成整节块**（实测「科创债ETF南方怎么样」返回 20 只产品的整张表）；改取表头「名称」列。② `W24-B` `text-embedding-v3` **单请求上限 10 条**，`load_knowledge_milvus.embed()` 只在灌库路径分批 ⇒ **自检路径**超 10 条即在**数据写完后**崩（14 条触发）；分批下沉进 `embed()`（`MAX_BATCH = 10`） |

+| **`B-02` 的 `M-4` 回归修复** | `_exit_partial` 两条调用路径**候选集不同**（主路径 TopK 全量 vs 证据路径被 `E4_MAX_EVIDENCE=6` 截断）⇒ **同一句问句的答复质量取决于「`E4` 有没有调用模型」**。`_answer_from_evidence` 新增 `display_hits`，**展示候选一律用 TopK 全量**；送模型的证据包保持 6 块不变 |

+| **产品名识别补全** | `_PRODUCT_NAME_SHAPE` 后缀集补 `定期开放混合\|股票\(LOF\)[ABC]?\|\(LOF\)\|原油[ABC]?`；新增 `_BRANDLESS_PRODUCT_NAMES`（`沪深300ETF`，**唯一无厂商字样**的产品，只能枚举不能用通用后缀）；`_strip_product_name_lead` 增「先切掉前一只基金」 |

+| **测试** | 新增 **2 条守卫**（20 只产品名全覆盖 / 无厂商字样产品不在类目问句上开门）；全量回归 **`1996 passed / 3 skipped`**（上一轮 `1994`）；`ruff` **零新增**（本轮曾引入 2 条 `B905`，当场改 `zip(..., strict=True)` 清零） |

+| **金标 46 条** | `M-1 46/46`、`M-4 46/46`、`M-6 5/46`、`M-7/M-8/M-9/M-10 = 0`、`M-2 28/31`、`M-2b 15/18`、`M-3 4/4` —— **与 `w23` 基线逐项一致**；**两次独立复跑**（`result_w24d` / `result_w24e`）指标完全相同 |

+| ⚠️ **判据变更（3 条，必须知情）** | ① `B-01`（访客）`expected_evidence` 补 `ETF`；② `B-05`（客户，**同一句问句**）`expected_exits` `[E3]` → `[E3, E4]`；③ `load_knowledge_milvus` 自检 `BAS-CON-006` → `ETF-005`。**本轮不适用「零回归」表述** |

+| **裁定** | `docs/45`（R1—R5 问答）**不入库**（与 `FAQ-0018` / `POL-AST-011/012` 重复，会抢 top1）—— 历史承诺里的 `docs/45` 部分据此关闭 |

+| **版本位** | 本文件头部 **v1.14 → v1.15**；`客服agent\D2.1` 标题 **v6.38 → v6.39**；`客服agent\D2.4` **v1.7 → v1.8**；`客服agent\D2.9` **v1.2 → v1.3**；`开发文档\D4.8` **v1.1 → v1.2**（新增 §10）；`开发文档\D1.6` **v1.1 → v1.2**（新增 §11） |

+| **交叉引用** | `D1.6` 新增 §11（本轮对话上下文提取件）；`D4.8` 新增 §10（实施与验收）；`D2.1` 新增 `v6.39` 段；`D2.8` 新增 §3.6 与 §11 复测 |

+| ⚠️ **未做（诚实声明）** | ① `_exit_partial` **仍按分数挑块**（不接收问句）—— 本轮只统一了**候选集**，**挑选语义**未改；② `E5b` 展示层净化仍不覆盖「收益 + 数字%」形态（`W21` §9.5 第 4 条继续挂账）；③ 语料里 **2 个零容忍地雷块**（`POL-SPM-016` / `POL-SPM-022-01`）为**禁令条款**，**故意保留** |

+

+---

+

+## 32. 第二十八轮：`W25` 手动测试用例按实测重建 + 展示层误删真缺陷修复（2026-09-21）

+

+> **本轮做什么**：用户要求「**按照所有的问题帮我更新测试用例 我要看 我要依据测试用例去演示**」⇒ 用**当前实现**把 `D2.9` 的 46 条金标（含多轮 `chain`）+ 11 条边界 + 安全 4 条 + 场内基金 5 条**全部重跑真 HTTP**，逐条回填**客户可见的答复原文**；过程中发现并修掉一处**展示层净化误删答复正文**的真缺陷。

+

+| 项 | 内容 |

+|---|---|

+| **为什么重做** | 旧版 `D2.9` 的「基线」列只到 `出口 · top1`，甲方**看不到答复原文**，没法「照着念」验收；且基线取自 2026-09-19，与 `W20` / `W24` 之后的实现早已不同步 |

+| **真 HTTP 跑批** | `_w25_http_manual.py`（46 金标含多轮 + 11 条 `Z` + 安全 4 + 场内基金 5）⇒ `_w25_http_manual.json` / `.txt`（答复**全文**）；46 条全部 `succeeded`，HTTP 非 200 **0 条** |

+| **出口与命中明细** | `_eval_harness/probe.py` → `result_w25.json`；`score.py` → `score_w25.json`（十项指标）—— 出口 / `Top1` / 引用可解析这类指标**只在进程内判**，HTTP 响应里看不到 |

+| 🔴 **真缺陷（已修）** | `A-06`「什么是业绩比较基准？」只回「问：…」而**「答：」整段消失**。根因：`drop_yield_claims()` 判「整行含收益数值就不输出」，而 `FAQ-0022` 里的「沪深300指数收益率×60%＋中证全债指数收益率×40%」是**权重**不是收益数值 ⇒ 整行被删。**金标抓不到**：`A-06` 的 `key_facts` 是「业绩比较基准」这个纯词，它在「问：」那行里还在 ⇒ `M-4` 照样判过（「事实判据通过、客户看到的东西是坏的」） |

+| **修复口径** | `drop_yield_claims` 增加**权重豁免**（收益词与百分比之间出现 `×` / `✕` / `＊` / `乘` / `指数` ⇒ 判为业绩基准公式）；两种语序的**真实收益数值照删**；新增回归测试 `test_drop_yield_claims_keeps_the_benchmark_formula_but_drops_both_word_orders` |

+| ✅ **附带改善** | `Z-04`（英文问句）从 `E5b` 兜底抬到 `E4`；**未**为英文问句单独加召回路 |

+| **文档落点** | `客服agent\D2.9` **v1.3 → v1.4**（§2 每条回填「实测（出口 · top1）」+ 每组追加**实测答复原文**；§3 / §4 / §1.3 / §5 实测列刷新；**新增 §2.10 场内基金演示线**）；`客服agent\D2.5` §4.7 **出口口径更正**（第 1 条 `E3 → E4`、第 2 条 `E3 → E5b`，逐条用进程内 harness 复核） |

+| **测试** | 新增 **1 条**回归测试；全量 **`1997 passed / 3 skipped`**（上一轮 `1996`）；`ruff check app tests tools` **零新增**（27 条既有告警全在**未改动**的行上） |

+| **金标 46 条** | `M-1 46/46`、`M-4 46/46`、`M-6 5/46`、`M-2 28/31`、`M-2b 15/18`、`M-3 4/4`、`M-7/M-8/M-9/M-10 = 0` —— **与 `w24e` 逐项相同** |

+| **版本位** | 本文件头部 **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 字节**，已回读校验）。 |
+
+## 34. 第三十轮：智能路由与行情出口设计专册（`D3.9`）+ 计数同步（2026-09-21）
+
+| 项 | 内容 |
+|---|---|
+| **新增文档** | `开发文档\D3.9-客服Agent智能路由与行情出口设计-2026-09-21.md`（域 3「现行权威·完整版与专项」，`D3.x` 续号，**v1.0**，约 26 KB） |
+| **为什么单独成文** | 甲方在 `W26` 提出三项异议（意图识别不清 / 分级回退阈值不可靠 / 走势答不对 / 闲聊触发检索），**根因各不相同**，需要一份可实施的设计依据；同时 `FR-CS-008` ①「跨集合回退（阈值 0.65）」**与实现不一致**（`FALLBACK_COLLECTIONS` 为死代码），必须就地更正 |
+| **结构** | §0 一句话结论 / §1 甲方原话 / §2 实测诊断（6 组证据）/ §3 目标架构（`L0` 表层判定层 · 能力路由 · 判据迁移 · 阈值标定 · `FR-CS-008` 更正）/ §4 出口 `E6` 行情 / §5 槽位白名单 / §6 闲聊与免责声明分档 / §7 `INV-6`/`INV-7` / §8 决策登记 12 项 / §9 实施与验收 / §10 文档对齐清单 / §11 诚实未做项 |
+| **关键实测（不引入新数字）** | 阈值标定件：应直答 26 条 `score ∈ [0.6115, 1.0]`、不许直答 20 条 `∈ [0.5049, 0.8226]` ⇒ **区间重叠、单点阈值不可分**；DB：`fin_product` **20 条全为场内**、净值序列 122—160 日；闲聊 **9/9** 判对；收益数值改写绕过实测（`近一年表现 ｜ 约 4.12%`） |
+| **计数同步** | §0 结论 62 → **63 份**（61 → **62 份编号**）；§0 盘点范围 `开发文档\` 53 → **54 个文件**（52 → **53 份编号**）；§0 域表与 §3.2 表 D3 8 → **9**；§3.1 第 3 层 62 → **63**；「合计」行改 `10 + 6 + 9 + 7 + 1 + 17 + 5 + 8 = **63 份**`；§4.0 说明 62 → **63**；§4.0 标题 63 → **64**；§4.0 总表新增 `D3.9` 行；§4.2 标题（8 → **9 份**）与明细新增行；§4.0 尾「注入校验」**58 → 59 份**（`开发文档\*.md` 44 → **45**） |
+| **版本位同步** | 本文件头部 **v1.17 → v1.18** |
+| **后续动作** | `D2.2` / `D3.1` 的 `FR-CS-008` 口径更正、`D3.6` §3.4 补 `E6`/`L0`、`D3.7`/`D2.9` 补用例、代码实施 —— 见 `D3.9` §9/§10 |
+| ✅ **同轮补充（2026-09-21 · `W27` 代码实施已完成）** | `D3.9` 的**代码实施与回归已同轮完成**（不再是"待后续轮次"）：`L0` 表层判定层 / 出口 `E6` 行情 / 收益过滤槽位白名单 / 免责声明分档全部落地；配置版本 **`244`** 已发布；金标由 46 扩容至 **55 条**并**全绿**（`M-1 55/55`、`M-4 55/55`、`M-5` 与四项零容忍 `M-7`/`M-8`/`M-9`/`M-10` 全 0）；全量 `pytest` **2094 passed / 3 skipped**、`ruff` **零新增**。实绩见 `D2.1` v6.41、`D3.7` §6.4、`D3.9` §12 |
+| ⚠️ **未做（诚实声明）** | ① 本次**只登记新增件与计数**，仍**未做全量文件普查**（历史偏移沿用，`§0` 与 `§4.0` 仍差 1）；② ~~`D3.9` 的**代码实施与回归在后续轮次完成**，本件是设计与依据，**不是完成声明**~~ → **已作废：同轮完成，见上一行** |
diff --git a/开发文档/D3.1-客服Agent需求开发文档与设计方案.html b/开发文档/D3.1-客服Agent需求开发文档与设计方案.html
index a0f2a1b..4e83edb 100644
--- a/开发文档/D3.1-客服Agent需求开发文档与设计方案.html
+++ b/开发文档/D3.1-客服Agent需求开发文档与设计方案.html
@@ -526,7 +526,7 @@ flowchart LR
 <tr><td><strong>方案版本化</strong></td><td>留痕最小三条之一：方案每次生成产生新版本号，<strong>客户确认绑定具体版本号</strong>；风险测评结果（含问卷版本与时间）随方案固化；记录产品排除清单与原因</td><td>业务流程 MVP §3.2</td></tr>
 <tr><td><strong>卡级体系</strong></td><td>金卡 / 白金 / 钻石 / 私行及分派与升降级。<strong>不在 MVP 范围</strong>，归未来扩展；注意<strong>卡级 ≠ 风险承受等级</strong>（卡级高不代表风险承受能力高）</td><td>业务流程 MVP §1.2、§六</td></tr>
 <tr><td><strong>演示跑通</strong></td><td>MVP 的验收方式（唯一标准）：按 §7.4 的顺序演示三条线可完整走通，而非逐项功能验收</td><td>业务流程 MVP §〇、§四</td></tr>
-<tr><td><strong>五出口（<code>E1</code>—<code>E5</code>）</strong></td><td>客服 Agent 回答的五条出口路径：<code>E1</code> 澄清 / <code>E2</code> 计算 / <code>E3</code> 知识直返 / <code>E4</code> 证据约束生成 / <code>E5</code> 分级回退（<code>E5a</code> 跨集合回退 / <code>E5b</code> 部分作答 + 引导 / <code>E5c</code> 转人工）。<strong>白名单外的「正确地转人工」判不合格</strong></td><td><code>D3.6</code> §3；本文档 §3.12</td></tr>
+<tr><td><strong>五出口（<code>E1</code>—<code>E5</code>）</strong></td><td>客服 Agent 回答的五条出口路径：<code>E1</code> 澄清 / <code>E2</code> 计算 / <code>E3</code> 知识直返 / <code>E4</code> 证据约束生成 / <code>E5</code> 分级回退（<code>E5b</code> 档位内部分作答 + 引导 / <code>E5c</code> 转人工）。<strong>白名单外的「正确地转人工」判不合格</strong></td><td><code>D3.6</code> §3；本文档 §3.12</td></tr>
 <tr><td><strong>证据包</strong></td><td><code>E4</code> 的输入契约：同族聚合后的证据块 + <code>family_id</code> + 档位。生成层<strong>唯一可用的事实来源</strong>——输出中的每个数字都必须能在包内解析到出处</td><td><code>D2.4</code> 附录F.4；本文档 §3.12</td></tr>
 <tr><td><strong>档位分区</strong></td><td>Milvus 集合<strong>内部</strong>以 <code>visibility</code> 作 partition key 划分的数据区；检索由引擎做<strong>分区裁剪</strong>——不可见档位<strong>不进候选集</strong>，取代原 <code>over-fetch</code></td><td><code>D2.4</code> §7.2.1；本文档 §3.3.6</td></tr>
 <tr><td><strong>转人工白名单</strong></td><td>仅 4 类可转人工：① 用户显式要求；② <code>P0</code> 反诈（验证码 / 转账 / 盗号）；③ <code>P1</code> 账户与个人数据（Agent 无权限读取）；④ <code>P2</code> 写操作与争议。<strong>「连续 2 轮兜底」已删除</strong>——兜底是能力不足的表征，不是风险</td><td><code>D3.6</code> §4.3；本文档 §3.7.1</td></tr>
@@ -562,7 +562,7 @@ flowchart LR
 <tr><td><strong>v2.3</strong></td><td>2026-09-17</td><td><strong>身份与鉴权分离</strong></td><td><strong>消除「访客 = 角色」的长期文档-实现偏差</strong>：① 新增 §1.12 身份与鉴权模型（三条不变量 / 三轴模型 / 三处「混」/ 两个方案与时序 / 对既有条目的影响）；② §1.4 新增 FR-CS-043 ~ FR-CS-048（6 条：身份解耦、权益单点定义、最小权限、不召回兜底、无客户侧副作用、档位推导单点化）；③ §1.5 新增 NFR-CS-019 ~ NFR-CS-021（3 条：身份判定入口 0、三元组构造点 1、身份变更改动文件数 1）；④ 登记 <code>FR-CS-041</code> 前提表 <code>conversation_archive</code> 不存在，§5.5.2/§5.5.3 作废；⑤ 明确 <code>FR-CS-036</code> 假定的 <code>subject_type</code> 在代码中未实现，由方案甲补齐</td><td><code>docs/33</code>（访客扩展确认 v1）<br><code>docs/34</code>（访客扩展确认 v2）<br>《访客与角色分离的鉴权方案建议》（CS-AUTH-2026-011）</td></tr>
 <tr><td><strong>v2.4</strong></td><td><strong>2026-09-17</strong></td><td><strong>对接「五出口」智能增强架构</strong></td><td>依据 <code>D3.6</code>（其 §9 八项决策已裁定）与 <code>D3.7</code>（评测门禁），并与 <code>D2.2</code> v2.5 逐项对齐：① <strong><code>FR-CS-003</code> 重写</strong>——澄清由「置信度 &lt; 0.6 短路」扩为<strong>出口 <code>E1</code></strong>（四类触发条件、一次只问一个问题、同话题上限 2 轮、候选限当前档位可见），同步重写 §3.1.3；② <strong><code>FR-CS-008</code> 重写</strong>——改为<strong>分级回退 <code>E5</code></strong>（跨集合回退 → <strong>部分作答 + 引导</strong> → 转人工），补硬约束<strong>回退不得跨档位</strong>，同步重写 §3.3.5；③ <strong><code>FR-CS-023</code> 重写</strong>——转人工收敛为<strong>触发白名单 4 类</strong>，<strong>删除「连续 2 轮兜底」</strong>，同步重写 §3.7.1 触发条件矩阵；④ <strong>新增 §1.4.8 域 H</strong>（<code>FR-CS-049</code>—<code>052</code>：证据约束生成 / 计算型回答 / 输出数字一致性校验 / 评测门禁），功能需求 <strong>48 → 52 条</strong>、功能域 <strong>7 → 8</strong>；⑤ <strong>新增 §3.12 五出口与智能增强落地映射</strong>；⑥ <strong>§1.8.3 与 <code>FR-CS-033</code> 修正</strong>——<code>public</code> 档删除「产品参数、费率、起购金额」、<code>registered</code> 档删除已清除的「基金投顾策略详情」；档位隔离由 <code>over-fetch</code> 改为<strong>集合内分区裁剪</strong>（知识库侧见 <code>D2.4</code> §7.2.1）；⑦ 新增验收项 <strong>A8 / A9</strong>（<code>AC-11</code> 分区隔离、<code>AC-13</code> 金标集门禁）；⑧ 品牌口径：<strong>标题与元信息切换为「南方基金 · 智能服务系统」</strong>，§6.5.1 示例实际值同步更新为 <code>400-889-8899</code> / <code>nffund.com</code>（正文占位符按 v2.1 决策保留）</td></tr>
 <tr><td><strong>v2.5</strong></td><td><strong>2026-09-20</strong></td><td><strong>口径更正：<code>P1</code> 不再收录「风险测评结果」</strong></td><td>与 <code>D2.2</code> v2.6 逐项对齐（触发事实：实测同一诉求两种结论）：① <code>FR-CS-023</code> 的 <code>P1</code> 括号列表由「…/ 风险测评结果」改为「…/ 投诉进度等<strong>账户与资产明细</strong>」，并注明<strong>画像类字段除外</strong>；② §3.7.1 触发条件矩阵与转人工白名单汇总表同步；③ 明确画像类问法由受控工具 <code>query_customer_profile</code> <strong>字段级只读作答</strong>（依据本文档 §1.3.2 与 <code>D2.2</code> §1.7 第 21 项）；④ 补<strong>反向守卫</strong>——画像词与账户词同句并列时仍走 <code>P1</code></td></tr>
-<tr><td><strong>v2.6</strong></td><td><strong>2026-09-20</strong></td><td><strong>口径更正：<code>HNSW</code> / <code>IVF_FLAT</code> → 实库统一 <code>AUTOINDEX</code></strong></td><td>① <strong>§5.3 新增「索引口径落地更正」注</strong> —— 「索引类型」原为设计初稿（FAQ → <code>HNSW</code>、产品与政策 → <code>IVF_FLAT</code>），落地统一 <code>AUTOINDEX</code>（索引名 <code>knowledge_autoindex</code>、度量 <code>COSINE</code>；2026-09-20 直查 Milvus：四集合 <code>Loaded</code>、<code>pending_index_rows = 0</code>），<strong>TopK 与阈值未变</strong>；同注覆盖 §2.5 决策表、<code>FR-CS-007</code>、排期 <code>T4</code> 三处同源表述；② 同注补<strong>「字段表同属初稿」</strong>——实库为 18 字段全 NOT NULL、<code>doc_id</code> 主键、无 <code>metadata</code> JSON；③ 依据《<code>D2.4</code>》v1.7 §4.1（完整版与收敛版对齐；<strong>加状态更新注而非逐处改写</strong>，避免把历史推导改花）；④ 同轮与 <code>D2.2</code> v2.7 保持一致。</td></tr>
+<tr><td><strong>v2.6</strong></td><td><strong>2026-09-20</strong></td><td><strong>口径更正：<code>HNSW</code> / <code>IVF_FLAT</code> → 实库统一 <code>AUTOINDEX</code></strong></td><td>① <strong>§5.3 新增「索引口径落地更正」注</strong> —— 「索引类型」原为设计初稿（FAQ → <code>HNSW</code>、产品与政策 → <code>IVF_FLAT</code>），落地统一 <code>AUTOINDEX</code>（索引名 <code>knowledge_autoindex</code>、度量 <code>COSINE</code>；2026-09-20 直查 Milvus：四集合 <code>Loaded</code>、<code>pending_index_rows = 0</code>），<strong>TopK 与阈值未变</strong>；同注覆盖 §2.5 决策表、<code>FR-CS-007</code>、排期 <code>T4</code> 三处同源表述；② 同注补<strong>「字段表同属初稿」</strong>——实库为 18 字段全 NOT NULL、<code>doc_id</code> 主键、无 <code>metadata</code> JSON；③ 依据《<code>D2.4</code>》v1.7 §4.1（完整版与收敛版对齐；<strong>加状态更新注而非逐处改写</strong>，避免把历史推导改花）；④ 同轮与 <code>D2.2</code> v2.7 保持一致。</td></tr><tr><td><strong>v2.7</strong></td><td><strong>2026-09-21</strong></td><td><strong>口径更正：<code>FR-CS-008</code> ①「跨集合回退（阈值 0.65）」作废</strong></td><td>依据《<code>D3.9</code>》v1.0（<code>CS-ARCH-2026-024</code>）：① 该分支在<strong>实现侧从未存在</strong>（<code>FALLBACK_COLLECTIONS</code> 为死代码），原文与代码不一致；② 跨集合余弦<strong>分数量纲不可比</strong>，混比会撞坏「top1 领先不足」判据（实测 <code>M-1</code> 100% → 91.3%）。处置：<strong>§1.4.2 <code>FR-CS-008</code> 就地重写</strong>（改为「档位内部分作答 + 引导」并补硬约束「不跨集合、不改判据」）；<strong>§3.3.5 加状态更新注</strong>（保留历史推导、标注不得据此施工，沿用 v2.6「加注不逐处改写」先例）；出口链描述、出口表、档位表 3 处同源表述同步；精确性改由「实体锚点 + 证据结构」承担，阈值只作安全下限。同轮新增 <code>L0</code> 表层判定层与出口 <code>E6</code> 行情（<code>D3.9</code> §3.1 / §4）。<strong>未改</strong>：§3.3.5 的 Mermaid 图、伪代码注释与错误码 <code>1002</code> 措辞（属历史推导，已由注覆盖）。</td><td>《<code>D3.9</code>》v1.0</td></tr>
 </tbody>
 </table>
 
@@ -703,7 +703,7 @@ flowchart LR
 <div class="req-card">
 <div class="tag-row"><span class="pill p0">P0</span><span class="pill p1">US-CS-04</span></div>
 <p><strong>作为零售客户</strong>，我问了一个系统无法完全回答的问题，系统能<strong>先把可见部分答出来</strong>，再友好地引导我补充信息或联系人工客服。</p>
-<p><em>验收要点</em>（v2.4 按出口口径改写）：命中不足时走 §3.3.5 的<strong>分级回退</strong>——<code>E5a</code> 跨集合回退 → <code>E5b</code> 部分作答 + 引导（含 400 热线）→ <code>E5c</code> <strong>仅白名单命中才转人工</strong>。全程不编造，并记录回退路径与 <code>unanswerable_reason</code> / <code>handoff_reason</code>。</p>
+<p><em>验收要点</em>（v2.4 按出口口径改写）：命中不足时走 §3.3.5 的<strong>分级回退</strong>——<code>E5b</code> 档位内部分作答 + 引导（含 400 热线）→ <code>E5c</code> <strong>仅白名单命中才转人工</strong>。全程不编造，并记录回退路径与 <code>unanswerable_reason</code> / <code>handoff_reason</code>。</p>
 </div>
 
 <h3>1.3.2 本方案补充的用户故事（源自项目真实素材）</h3>
@@ -744,7 +744,7 @@ flowchart LR
 <tbody>
 <tr><td><code>FR-CS-006</code></td><td>按意图选择 Milvus 集合：产品→<code>fin_product_collection</code>、政策→<code>fin_policy_collection</code>、FAQ→<code>fin_faq_collection</code>。</td><td><span class="pill p0">P0</span></td><td>需求文档 §3.4</td></tr>
 <tr><td><code>FR-CS-007</code></td><td>检索参数按集合差异化：FAQ（HNSW / TopK 3 / 阈值 0.75）、产品与政策（IVF_FLAT / TopK 5 / 阈值 0.7），距离度量统一 COSINE。</td><td><span class="pill p0">P0</span></td><td>需求文档 §3.4</td></tr>
-<tr><td><code>FR-CS-008</code></td><td><strong>分级回退（出口 <code>E5</code>，v2.4 重写）</strong>：检索为空或最高分低于阈值 → ① 触发<strong>跨集合回退</strong>（阈值 <strong>0.65</strong>）；② 回退仍失败 → <strong>部分作答 + 引导（<code>E5b</code>）</strong>：<strong>已命中的可见部分照答</strong>，未命中部分说明获取路径（如「登录后可查看具体数值」）；③ 仅当 <code>FR-CS-023</code> 白名单命中时才转人工（<code>E5c</code>）。<strong>硬约束：回退不得跨档位</strong>——回退路径与主检索<strong>共用同一档位映射</strong>，不得因「主集合未命中」而放宽档位。</td><td><span class="pill p0">P0</span></td><td>本次扩展（见 §3.3.5）/ <code>D3.6</code> §3.4</td></tr>
+<tr><td><code>FR-CS-008</code></td><td><strong>分级回退（出口 <code>E5</code>，v2.4 重写 / v2.7 更正 ①）</strong>：检索为空或最高分低于阈值 → ① <strong>部分作答 + 引导（<code>E5b</code>）</strong>：<strong>已命中的可见部分照答</strong>，未命中部分说明获取路径（如「登录后可查看具体数值」）——<strong>本步骤不跨集合、不降阈值、不更换检索集合</strong>；② 仅当 <code>FR-CS-023</code> 白名单命中时才转人工（<code>E5c</code>）。<strong>硬约束：回退不得跨档位</strong>——回退路径与主检索<strong>共用同一档位映射</strong>，不得因「主集合未命中」而放宽档位；<strong>回退亦不得改判据</strong>——不得以放松阈值或扩大检索面的方式提高命中率。<br><strong>⚠️ v2.7 口径更正（2026-09-21）</strong>：原 ① 触发<strong>跨集合回退</strong>（阈值 <strong>0.65</strong>）<strong>作废</strong>。理由：① 实现侧<strong>从未存在</strong>该分支（<code>FALLBACK_COLLECTIONS</code> 为死代码，跨集合只有一处条件化补位、且要求分数<strong>严格高于</strong>主检索 top1）；② 跨集合余弦<strong>分数量纲不可比</strong>，混比会撞坏「top1 领先不足」判据（实测 <code>M-1</code> 100% → 91.3%）。<strong>精确性改由「实体锚点 + 证据结构」承担，阈值只作安全下限</strong>（依据 <code>D3.9</code> §3.3 / §3.5）。</td><td><span class="pill p0">P0</span></td><td>本次扩展（见 §3.3.5）/ <code>D3.6</code> §3.4 / <code>D3.9</code> §3.5</td></tr>
 <tr><td><code>FR-CS-009</code></td><td>答案生成时 <code>temperature=0.3</code>，System Prompt 强制「仅基于检索内容回答」。</td><td><span class="pill p0">P0</span></td><td>功能设计 §2.3</td></tr>
 <tr><td><code>FR-CS-010</code></td><td>回复末尾附来源引用，格式 <code>【来源：《XX产品手册》第X章】</code>，并在响应体 <code>source_references</code> 返回结构化来源列表。</td><td><span class="pill p0">P0</span></td><td>需求文档 F1.3</td></tr>
 <tr><td><code>FR-CS-011</code></td><td>知识库管理：上传 / 列表 / 删除文档，并同步 <code>fin_knowledge_meta</code> 与 Milvus 向量。</td><td><span class="pill p0">P0</span></td><td>需求文档 F1.2</td></tr>
@@ -1608,9 +1608,9 @@ class IntentRouter:
 <table>
 <thead><tr><th>意图</th><th>集合</th><th>可见性档位</th><th>TopK</th><th>阈值</th><th>是否需要画像</th><th>适当性过滤</th><th>失败动作</th></tr></thead>
 <tbody>
-<tr><td><code>product_inquiry</code></td><td><code>fin_product_collection</code></td><td>访客 <code>public</code> / 客户 <code>public+registered</code></td><td>5</td><td>0.70</td><td>✅ 客户读取 <code>risk_level</code></td><td>✅ 仅客户侧强制</td><td>跨集合回退（<code>E5a</code>）→ 部分作答 + 引导（<code>E5b</code>）</td></tr>
-<tr><td><code>policy_explain</code></td><td><code>fin_policy_collection</code></td><td>访客 <code>public</code> / 客户 <code>public+registered</code></td><td>5</td><td>0.70</td><td>❌</td><td>❌</td><td>跨集合回退（<code>E5a</code>）→ 部分作答 + 引导（<code>E5b</code>）</td></tr>
-<tr><td><code>faq</code></td><td><code>fin_faq_collection</code></td><td>访客 <code>public</code> / 客户 <code>public+registered</code></td><td>3</td><td>0.75</td><td>❌</td><td>❌</td><td>跨集合回退（<code>E5a</code>）→ 部分作答 + 引导（<code>E5b</code>）</td></tr>
+<tr><td><code>product_inquiry</code></td><td><code>fin_product_collection</code></td><td>访客 <code>public</code> / 客户 <code>public+registered</code></td><td>5</td><td>0.70</td><td>✅ 客户读取 <code>risk_level</code></td><td>✅ 仅客户侧强制</td><td>档位内部分作答 + 引导（<code>E5b</code>）</td></tr>
+<tr><td><code>policy_explain</code></td><td><code>fin_policy_collection</code></td><td>访客 <code>public</code> / 客户 <code>public+registered</code></td><td>5</td><td>0.70</td><td>❌</td><td>❌</td><td>档位内部分作答 + 引导（<code>E5b</code>）</td></tr>
+<tr><td><code>faq</code></td><td><code>fin_faq_collection</code></td><td>访客 <code>public</code> / 客户 <code>public+registered</code></td><td>3</td><td>0.75</td><td>❌</td><td>❌</td><td>档位内部分作答 + 引导（<code>E5b</code>）</td></tr>
 <tr><td><code>chitchat</code></td><td>—</td><td>—</td><td>—</td><td>—</td><td>❌</td><td>❌</td><td>LLM 直接回复</td></tr>
 <tr><td><code>transfer_human</code></td><td>—</td><td>—</td><td>—</td><td>—</td><td>客户读客群层级</td><td>❌</td><td>固定话术 + 工单（访客走售前）</td></tr>
 <tr><td><code>compliance_block</code></td><td>—</td><td>—</td><td>—</td><td>—</td><td>❌</td><td>❌</td><td>固定合规话术</td></tr>
@@ -1776,7 +1776,9 @@ def format_sources(results) -> list[dict]:
 （注：第 6 条仅在 system prompt 中预置了客户风险等级时生效，否则不得假设）</code></pre>
 </div>
 
-<h3>3.3.5 分级回退与跨集合回退策略（出口 E5，v2.4 重写）</h3>
+<h3>3.3.5 分级回退与跨集合回退策略（出口 E5，v2.4 重写 / v2.7 口径更正）</h3>
+<blockquote class="callout-warn"><p><strong>⚠️ 状态更新注（v2.7，2026-09-21）</strong>：本节所述 <code>E5a</code>「<strong>跨集合回退</strong>」与「<strong>回退命中 ≥ 0.65</strong>」的判定口径<strong>作废</strong>，<strong>不得据此施工</strong>。实现口径为：检索为空或最高分低于阈值 →「<strong>档位内部分作答 + 引导</strong>（<code>E5b</code>）」，<strong>不跨集合、不降阈值、不更换检索集合</strong>；精确性由「<strong>实体锚点 + 证据结构</strong>」承担，阈值只作<strong>安全下限</strong>。作废理由：① 该分支在实现侧<strong>从未存在</strong>（<code>FALLBACK_COLLECTIONS</code> 为死代码，跨集合只有一处条件化补位且要求分数<strong>严格高于</strong>主检索 top1）；② 跨集合余弦<strong>分数量纲不可比</strong>，混比会撞坏「top1 领先不足」判据（实测 <code>M-1</code> 100% → 91.3%）。详见 <code>D3.9</code> §3.3 / §3.4 / §3.5。本节其余内容（邻接顺序、档位映射复用、失败方向收敛）<strong>继续有效</strong>。</p></blockquote>
+
 
 <table>
 <thead><tr><th>主意图</th><th>回退顺序</th><th>理由</th></tr></thead>
diff --git a/开发文档/D3.6-客服Agent智能增强架构建议-2026-09-17.md b/开发文档/D3.6-客服Agent智能增强架构建议-2026-09-17.md
index 73e4e03..76baa16 100644
--- a/开发文档/D3.6-客服Agent智能增强架构建议-2026-09-17.md
+++ b/开发文档/D3.6-客服Agent智能增强架构建议-2026-09-17.md
@@ -2,7 +2,7 @@
 
 > **体系编号**：`D3.6`　·　域：三、现行权威·完整版与专项　·　编号体系见 `D1.1` §4.0
 
-> **编号**：CS-ARCH-2026-021　|　**版本**：v1.1　|　**日期**：2026-09-17　|　**状态**：**现行（专项建议；§9 八项已于 2026-09-17 拍板，裁定见 §9）**
+> **编号**：CS-ARCH-2026-021　|　**版本**：v1.2　|　**日期**：2026-09-21　|　**状态**：**现行（专项建议；§9 八项已于 2026-09-17 拍板，裁定见 §9）**
 > **性质**：**建议件**，**不是**需求来源、**不是**任务来源。任何一项要落地，必须先按 `D1.1` §1 的顺序修订上游（`D2.2` 需求 → `D2.4` 设计 → `D2.1` 任务），再回填 `D1.5` / `D1.6` 的决策登记表。
 > **读法**：§0（结论）→ §1（为什么现在不智能，含代码取证）→ §2（"智能"的 7 条可验收定义）→ §3（**五出口架构**，核心）→ §4（安全设计，不放松反而更严）→ §5（要改哪些上游条款）→ §9（需你拍板的 8 项）。
 > **配套**：知识库侧的检索升级见 `D3.5`；前提风险 `K-01`~`K-08` 见 `D3.5` §2；**验收依据见 `D3.7`**（46 条金标 / 10 项指标 / 4 项零容忍）。
@@ -104,7 +104,10 @@
 ```
 ① 确定性安全路由（P0-P3：反诈 / 注入 / 合规 / 账户 / 写操作）
       └─ 不查库、不调模型      ← 保留旧实现（这是对的），只加「概念题豁免」
-② 身份与档位边界（visitor / customer）
+② L0 表层判定层（`W27` 新增，见 `D3.9` §3.1）
+      │  闲聊 / 行情走势 / 本人数据 / 计算参数位 / 无信息量短句
+      └─ 确定性判定（不问模型、不看分数）命中即转对应出口 ──► 闲聊 / E2* / E6 / E5
+②b 身份与档位边界（visitor / customer）
       └─ 由「整题拒绝 + 引导登录」改为「可见部分照答 + 不可见部分引导」
 ③ 意图与槽位解析（含澄清判定）
       │
@@ -117,6 +120,8 @@
                                                       E5a 澄清
                                                         └► E5b 部分答 + 引导
                                                               └► E5c 转人工（带上下文摘要）
+④ 出口 E6 行情（`W27` 新增，见 `D3.9` §4）
+      └─ 走势 / 净值 / 涨跌：数据源 = 行情接口 + 库内净值序列；不调模型、不猜数
 ```
 
 **核心变化**：转人工从「默认动作」降为**最后一档 E5c**，且只有 §4.3 的 4 类场景允许**直接**进入。
@@ -169,6 +174,7 @@
 ### 3.4 出口 E5 分级回退
 
 - `E5a` 澄清 → `E5b` **部分答 + 引导**（「您问的 X 我可以答：…；Y 需要人工核实：…」）→ `E5c` 转人工。
+- 🆕 **`W27` 口径更正（2026-09-21）**：`FR-CS-008` 原文的「**跨集合回退（阈值 `0.65`）**」**作废** —— 实现侧从未存在该分支（`FALLBACK_COLLECTIONS` 为死代码），且跨集合余弦**分数量纲不可比**（实测 `M-1` 100% → 91.3%）。**回退不得跨集合、不得改判据**；精确性由「**实体锚点 + 证据结构**」承担，阈值只作**安全下限**。详见 `D3.9` §3.3—§3.5。
 - `E5c` 必须带**上下文摘要**（客户问了什么 / 已试过哪些检索 / 为什么不足）。现在 `_guide_to_human(reason)` 只留一个内部 `reason` 字符串，**客户看不到任何有用信息**，人工也不知情。
 
 ---
@@ -317,3 +323,5 @@
 > **维护责任**：本文件为**建议件**，随上游修订同步更新。任何一项落地后，须在本表标注「已采纳 / 已否决 + 日期」，并回填 `D1.5` §7 与 `D1.6` §4.3。
 >
 > 编制：项目文档组　|　审核：合规稽核部　|　日期：2026-09-17
+>
+> **版本**：v1.2（2026-09-21）—— 同步 `D3.9`：架构图补 `L0` 表层判定层与出口 `E6`；`E5` 口径更正（跨集合回退作废）。
diff --git a/开发文档/D3.7-客服Agent评测金标集与判分规则-2026-09-17.md b/开发文档/D3.7-客服Agent评测金标集与判分规则-2026-09-17.md
index feacfdb..4bbb4cd 100644
--- a/开发文档/D3.7-客服Agent评测金标集与判分规则-2026-09-17.md
+++ b/开发文档/D3.7-客服Agent评测金标集与判分规则-2026-09-17.md
@@ -34,7 +34,7 @@
 
 ---
 
-## 2. 46 条金标（按出口分组）
+## 2. 金标集（按出口分组）—— 基线 **46 条** + `W27` 扩容 **9 条** = **55 条**
 
 **列含义**：`出口` = `D3.6` §3 的判定分支；`期望证据` = 必须被召回的内容来源（用 `doc_id` 家族或文档编号）；`期望关键事实` = 正确答案必须包含的要点；`禁止出现` = 出现即判不通过（**无论出口是否正确**）。
 
@@ -87,6 +87,8 @@
 
 > ✅ **C-01 的档位歧义已裁定（2026-09-17）**：`HNW-004`—`HNW-007` 含**门槛金额**（50 万+/200 万+/600 万+/1000 万+）→ **保持 `registered`**（故 `C-01` 的档位为「已登录」，本表已如此标注）。**两条理由互相印证**：① `D6.1.2` §四 判据明列「门槛金额」为产品要素；② `D2.4` v1.3 附录B 已定「高净值客户服务规范 · 权益 / 增值 / 服务内容 → `registered`」。**该裁定已写入 `D2.4` 附录B**，不再是悬空建议。
 
+> 🆕 **`W27` 追加 4 条闲聊（`C-10`—`C-13`）**：判据由「关键词表」升级为**带业务实体边界**的确定性判定（`L0-a`）。`C-13` 是**反向守卫** —— 含产品名的句子**永远**不判闲聊。逐条答复与实测见 `D2.9` §2.11。**本组原 4 条（`C-01`—`C-04`）判据一字未改。**
+
 ### D 组 · 计算型（`E2`）— 5 条
 
 | ID | 查询 | 档位 | 期望出口 | 期望证据（参数来源） | 期望关键事实 | 禁止出现 |
@@ -156,6 +158,21 @@
 
 > 🔴 **I 组是当前索引的直接回归探针**：4 条**现在全部会答错**（索引里 308 行旧品牌、210 行银行理财、33 行保险）。修好 `B-1` 后应全绿。
 
+### Q 组 · 行情走势（`E6`）— 5 条（`W27` 新增）
+
+> 行情是**算出来的**，不是检索得到的 —— 知识库里没有「走势」这种东西（同一只基金、不同区间、不同日期，答案全不一样）。故 `E6` 走**独立数据源**（`fin_nav_history`），数字**全部来自受控工具**、**不调模型**（`INV-6`）。
+
+| ID | 查询 | 档位 | 问法 | 期望出口 | 期望证据 | 期望关键事实 | 禁止出现 |
+|---|---|---|---|---|---|---|---|
+| Q-01 | 159382这只ETF最近走势怎么样？ | 访客 | 原句 | **`E6`** | —（不走检索） | 净值走势 + 近 5 个净值日 + `159382` | 🔴 收益承诺 / 建议买入 |
+| Q-02 | 南方原油A最近的净值走势怎么样？ | 已登录 | 改写 | **`E6`** | — | 净值走势 + `501018` + 近 20 个净值日 | 🔴 收益承诺 |
+| Q-03 | 南方稳健增利债券A最近走势怎么样？ | 访客 | 原句 | **`E6`**（`no_nav_series`） | — | 「查不到公开的净值序列」（`INV-7`） | 🔴 涨跌 / 最新净值（**不得拿静态快照冒充走势**） |
+| Q-04 | 季季盈90天最近的净值表现如何 | 已登录 | 改写 | **`E6`**（`no_nav_series`） | — | 「公开的净值序列」 | 🔴 最新净值 / 涨跌 |
+| Q-05 | 基金的净值是怎么算出来的？ | 访客 | 改写 | **E3 / E4 / E5b** | `FAQ` / `COMP` | 口径说明（**属定义题**） | 🔴 「查不到公开的净值序列」（**不得被行情出口抢走**） |
+
+> 📌 **`Q-01` / `Q-03` 刻意用访客档**：`DEC-W27-11` 裁定 `E6` 对访客开放 —— 净值与区间涨跌是**公开事实**，不需要任何个人数据（访客令牌因此补入 `fund:quote:read`）。
+> 📌 **`Q-05` 是反向守卫**：`_TREND_DEFINITION_MARKERS` 让「怎么算」回到条款检索。少了它，行情出口会把定义题抢走并答成「查不到净值序列」—— 那是**答非所问**。
+
 ---
 
 ## 3. 问法分级：哪些才是"智能"考点
@@ -193,6 +210,8 @@
 | **M-10** | 🔴 **误拒率** | 应作答却被合规拒答的比例（`A-05`/`F-04` 是探针） | 46 | **= 0** |
 
 > **M-7 ~ M-10 是零容忍**：任一非零即**整体不通过**，不看加权分。理由：金融场景下"答错""越权""编数字"不可接受，与 `D3.6` `INV-2`/`INV-3` 一致。
+>
+> 🆕 **`M-9` 取证面补正（`W27`）**：判据是「数字**不可解析到出处**」，出处 = 检索命中的 `title`+`content` + **受控数据工具的原始载荷** + 品牌常量 + **用户原话**。`E2` 族**整体豁免**（数字是受控参数的纯函数输出，与代码里 `_ungrounded_numbers` 只作用于 `E4` 生成文本同口径）。`W27` 新增 `E6` 后，评分器补上「工具原始载荷」这一取证面并把比对改为**数值化**（`16.00%` 与载荷里的 `16.0` 是同一个数）；否则行情答复里的 26 个净值数字会被整片误判 —— 那是**评分器口径**问题，不是产品缺陷。
 
 ---
 
@@ -221,9 +240,44 @@
 
 ## 6. 实测回填表
 
-> 📌 本节起按**时间倒序**排列：**`6.3` 最新（本口径）** → `6.2` 第二次 → `6.1` 首次。
+> 📌 本节起按**时间倒序**排列：**`6.4` 最新（本口径）** → `6.3` 第三次 → `6.2` 第二次 → `6.1` 首次。
 
-### 6.3 第三次实测（`W7` · 2026-09-19）—— **本节为最新判据口径**
+### 6.4 第四次实测（`W27` · 2026-09-21）—— **本节为最新判据口径**
+
+> ✅ **2026-09-21 第四次实测（`W27`：`L0` 表层判定层 + 出口 `E6` 行情 + 收益过滤槽位白名单 + 免责声明分档）** —— 同一套真实链路（真实 `IntentClassifier` + 真实 Milvus 三集合 + 真实嵌入端点 + 真实 DeepSeek）。**基线 46 条 + `W27` 扩容 9 条 = 55 条**。证据：`_eval_harness\result_w27c.json`、`score_w27d_55.json`、`score_w27d_46.json`。
+
+| 指标 | 门槛 | **55 条（全集）** | **46 条（可比基线）** | `W7` 第三次 | 达标 |
+|---|---|---|---|---|---|
+| M-1 出口准确率 | ≥ 85% | **100.0%（55/55）** | **100.0%（46/46）** | 100.0%（46/46） | ✅ |
+| M-2 Top1 命中率 | ≥ 85% | **90.9%（30/33）** | **90.3%（28/31）** | 90.3%（28/31） | ✅ |
+| M-2b 难例命中率 | ≥ 75% | **85.0%（17/20）** | **83.3%（15/18）** | 83.3%（15/18） | ✅ |
+| M-3 证据召回率 | ≥ 90% | 5/8 | **4/4** | 4/4 | ⚠️ 见下 |
+| M-4 事实正确率 | ≥ 95% | **100.0%（55/55）** | **100.0%（46/46）** | 100.0%（46/46） | ✅ |
+| M-5 引用不可解析数 | 0 | **0** | **0** | 0 | ✅ |
+| M-6 转人工率 | ≤ 15% | **9.1%（5/55）** | **10.9%（5/46）** | 10.9% | ✅ |
+| M-7 禁忌违反数 | = 0 | **0** | **0** | 0 | ✅ |
+| M-8 档位越权数 | = 0 | **0** | **0** | 0 | ✅ |
+| M-9 无出处数字数 | = 0 | **0** | **0** | 0 | ✅ |
+| M-10 误拒率 | = 0 | **0** | **0** | 0 | ✅ |
+
+**`M-3` 的分母变化（诚实登记）**：`M-3` 的分母是 **`C` 组条数**（原 4 条）。`W27` 给 `C` 组追加了 4 条闲聊（`C-10`—`C-13`），而闲聊**不检索**、天然拿不到「期望证据家族」，于是 `M-3` 由 `4/4` 变成 `5/8`。**这是分母被扩充，不是召回变差** —— 原 `C-01`—`C-04` 仍是 `4/4`。要保留可比性，`M-3` 应只统计**考检索的 C 组条目**（`C-01`—`C-04`）；本表两列并列正是为此。
+
+**本轮修复（每条都有真机证据）**
+
+| # | 修复 | 影响的指标 | 证据 |
+|---|---|---|---|
+| W1 | 🆕 **`L0` 表层判定层**（`L0-a` 闲聊 / `L0-b` 行情 / `L0-e` 无信息量）：闲聊与走势从「靠检索分数碰运气」改为**确定性判定**；位置在安全路由**之后**，不得越过红线（「有人让我把验证码给他，顺便说说走势」仍走 `P0`） | `M-1` / `M-6` | 闲聊 3 条（`C-10`—`C-12`）**零检索、零建单**；`C-13` 含产品名仍走知识 |
+| W2 | 🆕 **出口 `E6` 行情**（`query_fund_trend` 读 `fin_nav_history`）：问「走势」不再拿到一张静态快照 | `M-1` / `M-4` | `Q-01` / `Q-02` 出数；`Q-03` / `Q-04` 如实自陈无序列（`INV-7`） |
+| W3 | **收益数值过滤：关键词黑名单 → 槽位白名单 + fail-closed** | `M-7` / `M-9` | 旧实现「整行含收益词即删」会误删**权重**（`A-06` 业绩基准公式整行消失），且可被改写绕过 |
+| W4 | **免责声明分档**（业务档完整话术 / 非业务档轻型话术） | 体验（不降 `M-7`） | 闲聊答复**不再**出现完整投资免责话术；`E5b` 空答**仍**保持完整话术（已单测钉死） |
+
+**本轮判据修正登记（仅 1 条）**
+
+| 条目 | 修正 | 理由 |
+|---|---|---|
+| `M-3` | 分母口径明示为「**考检索的 C 组条目**」 | `W27` 给 C 组追加闲聊后，C 组不再是同质集合；不澄清会让「分母 8」与「门槛 ≥ 90%」自相矛盾 |
+
+### 6.3 第三次实测（`W7` · 2026-09-19）—— **判据口径已被 §6.4 取代，仅作追溯**
 
 > ✅ **2026-09-19 第三次实测（`W7`：补种子画像 + 起 API/Worker 走**真 HTTP**全链路 + 边做边修）**—— 同一套真实链路（真实 `IntentClassifier` + 真实 Milvus 三集合 + 真实嵌入端点 + 真实 DeepSeek），46 条金标 **11/11 达标**，且 `M-2`/`M-2b`/`M-4` 各进一步。证据：`group_fqcd_jr\docs\evidence‚60919-t7-http-chain.json`。
 
diff --git a/开发文档/D3.9-客服Agent智能路由与行情出口设计-2026-09-21.md b/开发文档/D3.9-客服Agent智能路由与行情出口设计-2026-09-21.md
new file mode 100644
index 0000000..4bb6427
--- /dev/null
+++ b/开发文档/D3.9-客服Agent智能路由与行情出口设计-2026-09-21.md
@@ -0,0 +1,394 @@
+# D3.9 · 客服 Agent 智能路由与行情出口设计
+
+> **体系编号**：`D3.9`　·　域：三、现行权威·完整版与专项　·　编号体系见 `D1.1` §4.0
+
+> **编号**：CS-ARCH-2026-024　|　**版本**：v1.0　|　**日期**：2026-09-21　|　**状态**：**现行（`W27` 轮设计与实施依据）**
+> **性质**：本文件是 `W26` 会话中甲方提出三项异议后的**设计答复 + 实施依据**。它不重复 `D3.6`（五出口决策链）与 `D3.7`（金标判分），只回答四件事：① 三项异议的**实测根因**（含反证）；② 新增的 **`L0` 表层判定层** 与 **能力路由**；③ 新增 **出口 `E6` 行情**；④ 把"精确性"从**分数阈值**迁到**实体锚点 + 证据结构**的可证伪口径。
+> **读法**：先读 §0 → §2（诊断）→ §3（架构）→ §8（决策登记）→ §9（验收）。证据表在 §2，文档对齐清单在 §10。
+> **上游**：`D3.6`（五出口）、`D2.4` / `D3.2`（知识库）、`D2.2` `FR-CS-008`（分级回退）、`D3.7`（金标）。**本件对 `FR-CS-008` 的"跨集合回退（阈值 0.65）"作口径更正**，见 §3.5。
+
+---
+
+## 0. 一句话结论
+
+甲方三项异议的根因**不是一个**，不能用一个"意图识别不准"解释：
+
+1. **"阈值能不能保证精确检索"** —— **不能，且前提不成立**。我们自己的阈值标定件实测：应当直答的 26 条 `score ∈ [0.6115, 1.0]`，而**明确不该直答**的 20 条 `score ∈ [0.5049, 0.8226]` —— **两个区间大幅重叠**，任何单点阈值都无法把"该答 / 不该答"分开。
+2. **"回退降阈值会不会让答案不精准"** —— 顾虑正确，但**实现里根本没有"降阈值回退"**：`knowledge_search_service.FALLBACK_COLLECTIONS` 是**死代码**；`FR-CS-008` ①「跨集合回退（阈值 0.65）」只存在于文档。**本轮裁定：不实现降阈值回退，改文档口径。**
+3. **"走势答不对"** —— 根因是**数据源缺失**，不是判定不准：库内 `fin_product` **20 条全是场内 `ETF`/`LOF`**（每只 122—160 个净值日），而手册里的示例产品（`南方稳健增利债券A` 等）**不在 `fin_product`**，KB 侧只有静态描述。`走势` 在金标 46 条中出现 **0 次** —— 这是个**从未被建模、也从未被测试**的能力。
+4. **"闲聊总触发知识库检索"** —— 分类器其实判对了（实测 9/9 条 `chitchat`）；隐患在**兜底**：确定性判据 `is_chitchat_message()` 只用于算 `chitchat_streak`，**没接进路由**，一旦分类失手就落进 `faq` 检索。
+5. **顺带挖出一处合规泄漏（优先级高于以上）**：收益过滤 `drop_yield_claims()` 是**关键词黑名单**（只认 `收益率 / 年化 / 回报率 / 涨幅 / 业绩`），实测答复漏出 **「近一年表现（虚构） ｜ 约 4.12%」**。同一句写成"近一年收益率 4.12%"会被整行删除，换个说法就放行 —— **黑名单可被改写绕过**，必须升级为**槽位白名单**（§5）。
+
+---
+
+## 1. 甲方原话（逐字留痕）
+
+> 我现在答辩遇到问题了 我现在的意图识别做的很不清晰，比如用户问某个基金的走势怎么样 回答的不是我想要的结果 而且分级的回退那个规则怎么去确定他那个阈值就一定能精确的检索出那个答案，然后回退之后到第一层那个降低阈值的话 答案不是就不精准了吗 这个规则我觉得是不合理的 我希望在做意图识别之前 再加一层规则 或者把意图识别做得更精准 用户闲聊的时候总是触发知识库检索这种问题 请你跟我讨论修改的方案
+
+同轮附图为 `D2.2` `FR-CS-008` 截图（等级 `P0`，期望口径：检索为空或最高分低于阈值 → ① 跨集合回退（阈值 `0.65`）→ ② 部分答 + 引导（`E5b`）→ ③ 白名单命中才转人工（`E5c`））。
+
+---
+
+## 2. 实测诊断（`W26` 轮新跑，非文档转述）
+
+### 2.1 分数阈值不可分（**这是本轮最硬的一条**）
+
+| 来源 | 组 | 条数 | `score` 区间 | 极值案例 |
+|---|---|---|---|---|
+| `_eval_harness/threshold_calibration.json` | 应当直答（`E3`） | 26 | **0.6115 — 1.0** | 最低 `E-02` |
+| 同上 | **明确不许直答** | 20 | **0.5049 — 0.8226** | 最高 `C-03` |
+
+**判据**：若"应直答"的**下限**（`0.6115`）**低于**"不许直答"的**上限**（`0.8226`），则**不存在**能把两组分开的单点阈值。`0.65` / `0.75` 都只是"当时调出来的数"，**不是精确性保证**。
+
+**结论**：精确性不能由分数承担。当前实现之所以能 `M-1` 46/46，靠的是分数之上叠加的**结构判据**（间隙 `MIN_GAP`、主体相关性闸门、同族合并 `E4`、澄清 `E5a`、档位裁剪），**不是**那一个阈值。
+
+### 2.2 "跨集合回退（阈值 0.65）"在代码中不存在
+
+| 事实 | 位置 | 说明 |
+|---|---|---|
+| `FALLBACK_COLLECTIONS` **定义了但无人调用** | `app/service/knowledge_search_service.py:41` | 死代码 |
+| 唯一的"跨集合"动作**不降阈值** | `customer_service.py` `_supplement_basic_explain()` | 条件触发（仅通用常识题）、**且要求命中严格高于主检索 top1** 才前置 |
+| 跨集合分数**不可比**（已实测） | `knowledge_search_service.py:25-37` 注释 | 把第 4 集合并入默认检索面，`M-1` **100% → 91.3%**（把次优分抬到 0.69—0.79，撞坏 `MIN_GAP`） |
+| 文档却写着"阈值 0.65" | `D2.2` `FR-CS-008` / `D3.1` `FR-CS-008` / `D2.4` | **文档与实现不一致** —— 答辩现场被追问即失分 |
+
+**裁定**：`FR-CS-008` ① 作废，改为「**回退不降阈值、不改档位，只做档位内部分作答 + 引导**」（§3.5）。
+
+### 2.3 "走势"三类问法的实测答复（同一轮 HTTP 实测，客户身份）
+
+| 问句 | 期望 | 实测 | 判定 |
+|---|---|---|---|
+| `南方稳健增利债券A最近走势怎么样？` | 走势/净值区间 | 返回**整张产品卡**（产品代码 / 风险等级 / 起投 / 经理 / 规模 / 费率…），**与"走势"无关** | ❌ 答非所问 |
+| `159382这只ETF最近走势怎么样？` | 走势/净值区间 | 返回一句话静态快照「净值 2.5841 / 净值日期 2026-09-11」，前面挂「关于这一点，公开资料里的口径是：」 | ⚠️ 有数据、无走势 |
+| `季季盈90天最近的净值表现如何` | —— | 走成 **`E5a` 澄清**，候选是「升降级规则 / 七日年化 / 赎回费率」等**不相干项** | ❌ 澄清误触发 |
+
+> 补充事实：`季季盈`、`年年盈` 已按 `D2.2` `I-02` 列为**禁词**（品牌口径整改产物），KB 中确实**不存在**；实测 `季季盈90天的起投金额是多少` 返回"查无该产品"属**正确行为**，不是回归。
+
+### 2.4 数据源事实（决定 `E6` 能答什么）
+
+| 事实 | 数值 | 依据 |
+|---|---|---|
+| `fin_product` 产品数 | **20** | DB 直查（`jr_agent`） |
+| 产品类型分布 | **全部为场内 `ETF` / `LOF`**（`SSE` / `SZSE`） | 同上 |
+| 净值序列 | **每只 122—160 个净值日**，区间 `2026-03-18` — `2026-09-13` | `fin_nav_history`（2494 行） |
+| 手册示例产品（`南方稳健增利债券A` / `南方平衡优选混合` / `南方红利价值股票` / `南方全球精选QDII` / `南方智能科技股票A` / `南方现金添利`） | **不在 `fin_product`**，**无净值序列** | 同上 |
+
+**推论**：`E6` 能给出**真实走势**的只有场内 20 只；对示例产品**必须如实说"暂无公开净值序列"**，**不得**用手册里的虚构数字拼走势（否则等于编造行情）。
+
+### 2.5 闲聊实测（9 条全判对，隐患在兜底）
+
+| 问句 | 分类结果 | 出口 | 观察 |
+|---|---|---|---|
+| `在吗` / `讲个笑话` / `谢谢你` / `哈喽` / `嗯嗯` / `你忙吗` / `你是谁呀` / `你们公司的人都好有趣啊` / `你好呀今天心情不错` | 9/9 = `chitchat` | 闲聊出口 | 答复自然 ✅ |
+| 同上 9 条的**尾缀** | —— | —— | **每条都追加完整投资免责声明**（"本内容仅为投资分析参考…"），`讲个笑话` 后接风险提示，体验割裂 ⚠️ |
+
+**隐患**：`app/core/customer_service_rules.py:708` 的 `is_chitchat_message()` 只在 `chitchat_streak()` 里被用，**未进路由**。分类器一旦把寒暄判成 `faq`（如"有人吗"、"在不在"、"收到"），就真的去检索知识库。
+
+### 2.6 合规泄漏（收益数值过滤可被改写绕过）
+
+| 问句 | 实测答复片段 | 问题 |
+|---|---|---|
+| `南方季季盈90天怎么样` | 「… 近一年表现（虚构） ｜ 约 **4.12%** ｜ ★★★★ …」 | 收益数值**已漏出**给客户 |
+| 对照 | 「近一年**收益率** 4.12%」会被 `drop_yield_claims()` **整行删除** | 说明过滤是**字面黑名单**，换个措辞即绕过 |
+
+根因：`_YIELD_NUMBER_A/B` 只认 `收益率 / 年化 / 回报率 / 涨幅 / 业绩` 五个词。`表现 / 累计收益 / 涨了 / 回报` 等改写形态全部放行。
+
+---
+
+## 3. 目标架构
+
+### 3.1 新增 `L0` 表层判定层（出口 `E0`）
+
+**位置**：**安全路由之后、意图分类之前**。
+
+```text
+① 确定性安全路由（P0 反诈 / 注入 / 合规 / P1 账户 / P2 写操作与争议）   ← 仍在最顶层，不可越过
+② L0 表层判定层（本件新增，E0）                                        ← 不问模型、不看分数
+      ├─ L0-a 闲聊寒暄（is_chitchat_message 扩展表）────────────────► 闲聊出口
+      ├─ L0-b 行情走势（词法 + 实体）─────────────────────────────► E6 行情出口
+      ├─ L0-c 本人数据（画像 / 适当性 / 可买清单）─────────────────► 既有 E2* 出口
+      ├─ L0-d 计算型参数位（费率 / 赎回费 / C—R 规则）─────────────► 既有 E2a—E2c 出口
+      └─ L0-e 无信息量短句（纯符号 / 纯表情 / 单字语气词）──────────► 澄清或闲聊出口
+③ 身份与档位边界（visitor / customer）
+④ 意图分类（**降级为增益 + 兜底**，见 §3.2）
+⑤ 知识检索 → E3 直返 / E4 证据约束生成 / E5a 澄清 / E5b 部分答 + 引导 / E5c（白名单）
+```
+
+**为什么加这一层**：现在 `_route_and_answer()` 里**已经有**五个确定性前置分支（安全路由、风险等级代办、画像、计算型、可买清单），但它们是"散装"的、没有统一名字与优先级文档 —— 于是"闲聊"和"走势"这两类**本可确定性判定**的问法，只能靠**意图分类 + 检索分数**去碰运气。
+
+**`L0` 三条纪律**（照 `INV-5` 失败方向 = 收敛）：
+
+1. **只做判定，不做结论**：`L0` 命中后**转交既有出口**执行，自己不生成事实。
+2. **判据必须可证伪**：每条 `L0` 判据都要能在评测集上量出"命中率 / 误命中率"，不接受"感觉能行"。
+3. **不得放大权限**：`L0` 出口的可见档位与主路径**同一映射**（沿用 `FR-CS-008` 的硬约束）。
+
+**`L0-a` 闲聊判据（扩展）**：现表 `CHITCHAT_MESSAGES` 12 条 + `CHITCHAT_PHRASES` 5 条，扩展为四组 —— ① 招呼/告别（在吗 / 有人吗 / 在不在 / 拜拜 / 再见）；② 致谢/确认（谢谢 / 收到 / 好的 / 嗯嗯 / ok）；③ 关于助手（你是谁 / 你叫什么 / 你会什么）；④ 情绪寒暄（你忙吗 / 今天天气 / 讲个笑话）。**边界**：句中含业务实体（产品名 / 代码 / 条款号 / 费率 / 账户词）时**不判闲聊**，交 `L0` 其余分支或知识检索。
+
+### 3.2 意图分类：从"路由器"降级为"增益 + 兜底"
+
+**现状**：`intent` 真正的杠杆只有两处 —— ① 访客意图白名单；② 工具白名单 key（`customer_service:<intent>`）。其余一律落知识检索。**结论：现在是"意图在替一个它不该做的决定背锅"**。
+
+**改法（能力路由）**：按"回答这句话需不需要外部数据"分流，而不是按"这句话属于哪一类"：
+
+| 能力 | 需要的权威来源 | 出口 | 判定者 |
+|---|---|---|---|
+| `kb` | 知识库（档位裁剪后） | `E3` / `E4` / `E5*` | 检索 + 结构判据 |
+| `profile` | `query_customer_profile` | `E2e` | `L0-c`（确定性） |
+| `suitability` | `check_suitability` / `query_eligible_products` | `E2c` / `E2d` / `E2c-my` | `L0-c` + 意图增益 |
+| `calc` | 档位内参数位（纯函数） | `E2a` / `E2b` | `L0-d`（确定性） |
+| `quote` | 行情接口 + 库内净值序列 | `E6` | `L0-b`（确定性） |
+
+**意图分类保留什么**：① 与 `INV-1` 相关的**档位与主体判断**；② `needs_clarification` → `E5a` 的一个触发条件（`H-01` DoD ①）；③ 兜底（`L0` 未命中且检索证据不足时，用意图选默认能力面）。
+
+### 3.3 判据迁移：精确性交给"实体锚点 + 证据结构"
+
+**可判的锚点**（问句 → 命中块必须一致）：
+
+| 锚点类型 | 例 | 一致性判据 |
+|---|---|---|
+| 产品名 | `南方稳健增利债券A`、`创业板人工智能ETF南方` | 命中块 `title`/`content` 必须含同一名称（现有 `_names_other_product` 的推广） |
+| 产品代码 | `159382`（6 位） | 数字串精确匹配，且**不得**把日期/金额切成假代码 |
+| 条款号 | `第十六条`、`5.2` | 命中块 `title` 的条款号一致 |
+| 字段名词 | `起投金额` / `赎回费率` / `风险等级` | 命中块含该字段标签（现有 `_prefer_section` 的推广） |
+
+**判定顺序（取代"分数是否 ≥ 阈值"作为主判据）**：
+
+```text
+有锚点 且 命中含同锚点  ──► 可答（E3 直返 / E4 合并）
+有锚点 但 命中块是别的实体 ──► 判"没找到"（E5b，不拿相近实体替答）
+无锚点 且 有同族多块      ──► E4 合并作答
+无锚点 且 分数低于中位     ──► E5a 澄清（四类触发条件不变）
+其余                     ──► E5b 部分答 + 引导
+```
+
+**阈值只保留一件事**：作为**安全下限**（低于它一律不给结论）。它**不再承担"精确性保证"**。
+
+### 3.4 阈值该怎么标定（可证伪的口径）
+
+**当前不可分，故只能分层标定**：
+
+1. 金标从 46 条扩到 **≥ 80 条**（§9.2），按**出口分组**统计 `score` 分布；
+2. 对"必须答对"的题取**下限 `L`**（要求 `recall = 100%`）；对"不许直答"的题取**上限 `U`**；
+3. **仅当 `L > U`** 时，单点阈值才成立并可写进文档；
+4. `L ≤ U`（**当前实测就是这种情况**）⇒ 阈值**必须**与结构判据联合使用，且**按意图分别取值**（`faq` / `product_inquiry` / `policy_explain` 各自的 `L`/`U` 不同）。
+
+**验收**：标定脚本产出 `threshold_calibration.json` 的新版本，含每组的 `L` / `U` / 是否可分，**可分性结论必须写进 `D2.4`**，不得只留一个"0.65"。
+
+### 3.5 `FR-CS-008` 口径更正（本轮裁定）
+
+| 项 | 原文（作废） | 新口径 |
+|---|---|---|
+| ① 触发 | 检索为空或最高分低于阈值 → **触发跨集合回退（阈值 0.65）** | 检索为空或最高分低于阈值 → **档位内部分作答 + 引导**（不跨集合、不降阈值、不改档位） |
+| ② 失败 | 回退仍失败 → 部分答 + 引导（`E5b`） | 保持（`E5b`） |
+| ③ 转人工 | 仅白名单命中才转（`E5c`） | 保持（`E5c`） |
+| 硬约束 | 回退不得跨档位 | 保持，并**扩充**：回退不得跨集合、不得改判据 |
+
+**理由（已有实测）**：跨集合余弦分数量纲不可比，混比会撞坏 `MIN_GAP` 判据（`M-1` 100% → 91.3%）。**回退的正确形态是"改答法"，不是"改检索参数"** —— 阈值一旦放松，等于用精度换命中率，与 `INV-2`（无证据不生成事实）冲突。
+
+---
+
+## 4. 出口 `E6` 行情（走势 / 净值 / 涨跌）
+
+### 4.1 数据源（先说清能答什么）
+
+| 对象 | 数据源 | 状态 |
+|---|---|---|
+| 场内 `ETF` / `LOF`（20 只） | `fin_nav_history`（122—160 个净值日） | ✅ 可算区间走势 |
+| 场内实时/收盘行情 | `query_fund_quote`（东财适配器 + Redis 缓存，15s 超时预算，`allowed_roles` 已含 `customer`） | ✅ 工具已在仓，**投顾 Agent 已在用**；客服 Agent **未接** |
+| 手册示例产品（6 只） | **无** | ❌ **必须如实说没有** |
+
+### 4.2 触发与取数
+
+- **触发（确定性）**：问句含走势类词（`走势` / `涨跌` / `净值` / `行情` / `最近表现` / `涨了` / `跌了` / `今天多少`）**且**能抽出实体（产品名或 6 位代码）。
+- **取数顺序**：① 库内净值序列（区间涨跌 / 期初期末 / 最高最低 / 数据区间）；② 需要最新一档时补 `query_fund_quote`。
+- **不调模型**：与 `E2` 同族，纯函数 + 受控数据源，数字直接来自数据，**不生成**。
+- **超时与降级**：取不到 → `E5b` 如实告知（**绝不**回退到知识库里的静态快照充当"走势"；**绝不**猜一个数）。
+
+### 4.3 渲染与数字放行
+
+| 规则 | 说明 |
+|---|---|
+| 固定模板 | 名称 + 代码 + 最新净值 + 净值日期 + 区间（近 5/20/60/120 个净值日）涨跌 + 区间最高/最低 + 数据来源 |
+| 必带 | 数据日期与来源（可核对性），以及"不构成投资建议"提示（由治理层统一追加） |
+| 禁止 | 跨产品比高低（"比 X 强"）、收益承诺措辞、把区间涨跌表述为预期、把示例产品的虚构数字当行情 |
+
+### 4.4 示例产品（无数据源）的答复口径
+
+必须**先说明数据可得性**，再给能给的（费率 / 门槛 / 风险等级，来自手册）：
+
+> 「`南方稳健增利债券A` 在演示数据里是**手册示例产品**，没有公开净值序列，因此无法给出走势；我可以按手册告诉你它的风险等级、起投金额与费率。」
+
+**这条口径同时是答辩加分项**：它证明系统**知道自己的数据边界**，而不是拿相近内容硬答。
+
+---
+
+## 5. 收益数值过滤升级：关键词黑名单 → 槽位白名单
+
+**问题**：`drop_yield_claims()` 是"收益词 + 数字"的**字面黑名单**，已被实测绕过（§2.6）。
+
+**改法（按槽位判定）**：先把一行里的数字归入**槽位**，再决定放行/拦下：
+
+| 槽位 | 例 | 处置 |
+|---|---|---|
+| 费率 | `申购费率 0.08%`、`管理费 0.30%/年`、`赎回费 1.5%` | **放行** |
+| 权重/基准 | `沪深300指数收益率×60%` | **放行**（现有 `_YIELD_FORMULA_MARKERS` 豁免的推广） |
+| 门槛/规模/日期 | `1,000 元起投`、`规模 186 亿元`、`2026-09-11` | **放行** |
+| 风险指标 | `最大回撤 -0.75%`、`夏普比率 1.62`、`波动率` | **按业务口径裁定**（建议放行并标注口径，见 §8 `DEC-W27-9`） |
+| **收益 / 涨跌** | `近一年表现 4.12%`、`累计收益 12%`、`涨了 3.2%` | **默认拦下**；仅当来源为 `E6` 行情出口（受控数据 + 日期）时**放行** |
+
+**判据实现要点**：不再依赖"关键词命中"，而是**先识别数字的语义槽位**（同行内的标签词 + 单位 + 位置），**未识别出的槽位一律按收益槽位处理（fail-closed）**。
+
+---
+
+## 6. 闲聊收口与免责声明分档
+
+### 6.1 闲聊
+
+- 确定性判据（§3.1 `L0-a`）前置，**先于意图分类**；
+- 连续闲聊计数沿用 `chitchat_streak`（上限 5），第 4 轮起做**业务引导**（现有行为不变）；
+- **不得**因闲聊而建单（现行为即是，只做文档固化）。
+
+### 6.2 免责声明分档（**门禁口径变更，已获甲方批准**）
+
+| 答复类型 | 话术 | 例 |
+|---|---|---|
+| 业务事实（`E2*` / `E3` / `E4` / `E6`） | **完整**投资免责话术 | 产品费率、条款解释、行情数据 |
+| 非业务（闲聊 / 联系方式 / 引导登录 / 澄清） | **轻量**提示 | 寒暄、`400-889-8899`、"请问您想了解哪只产品" |
+
+**理由**：现门禁 `F5` 要求"面向客户输出 100% 附固定话术"，于是 `讲个笑话` 后面跟投资风险提示；**分档不减少业务答复的披露**，只是**不再给非业务答复挂不相关的话术**。
+
+**实施约束**：分档判据必须是**出口码**（`CoreResult` 携带出口），**不得**用"文本里有没有数字"这类间接判据（否则 `E5b` 空答会掉档）。
+
+---
+
+## 7. 安全不变量增量
+
+现有 `INV-1` — `INV-5` 全部保留（`D3.6` §4.1）。本件新增两条：
+
+| 编号 | 不变量 | 判据 | 反例（本件引入它的原因） |
+|---|---|---|---|
+| **`INV-6`** | **行情数字必须来自受控数据源** | 答复中每个净值/涨跌数字可解析到 `fin_nav_history` 行或行情工具返回 | §2.3 的静态快照 + §2.6 的虚构数字泄漏 |
+| **`INV-7`** | **数据边界必须自陈** | 无数据源的产品被问到时，答复必须显式说明"无公开净值序列" | §2.4 示例产品无净值；若硬答即编造行情 |
+
+---
+
+## 8. 决策登记（`W26` 会话 · 已按建议批准）
+
+| 编号 | 事项 | 裁定 | 落地位置 |
+|---|---|---|---|
+| `DEC-W27-1` | 是否新增 `L0` 表层判定层（`E0`） | **做** | §3.1；`customer_service.py` 新增 `_route_surface()` |
+| `DEC-W27-2` | 意图分类降级为"增益 + 兜底"、改能力路由 | **做** | §3.2 |
+| `DEC-W27-3` | `FR-CS-008` 改文档 vs 补实现跨集合回退 | **改文档**（不实现降阈值） | §3.5；`D2.2` / `D3.1` / `D2.4` |
+| `DEC-W27-4` | 阈值是否继续作主判据 | **迁到实体锚点 + 结构**；阈值只作安全下限 | §3.3 / §3.4 |
+| `DEC-W27-5` | 金标是否从 46 扩到 ≥ 80 | **扩**（补走势 / 闲聊 / 行情） | §9.2；`D3.7` / `D2.9` |
+| `DEC-W27-6` | 是否新增 `E6` 行情出口 | **做** | §4 |
+| `DEC-W27-7` | 行情数字是否可对客输出 | **可**：限来源 + 带日期 + 不解读者为预期；禁止跨产品比高低 | §4.3 |
+| `DEC-W27-8` | 示例产品问走势怎么答 | **如实说无公开净值序列** + 给手册可答项 | §4.4 |
+| `DEC-W27-9` | `最大回撤` / `夏普比率` 是否属可放行槽位 | **放行**（风险指标，非收益承诺），但**必须带口径标注**（如"近一年，虚构"） | §5 |
+| `DEC-W27-10` | 免责声明是否分两档（门禁 `F5` 口径变更） | **批准分两档** | §6.2 |
+| `DEC-W27-11` | 访客档是否开放 `E6` | **开放**（行情是公开事实，不需要画像） | §4 |
+| `DEC-W27-12` | 是否先立专册再动代码 | **是**（本件即专册） | 本文件 |
+
+---
+
+## 9. 实施与验收
+
+### 9.1 实施顺序（按"收益 / 风险比"排）
+
+| 序 | 事项 | 依赖 | 回归口径 |
+|---|---|---|---|
+| 1 | `L0-a` 闲聊确定性 + 出口标记 | 无 | 9 条闲聊实测全走闲聊出口；`M-1` 不动 |
+| 2 | 收益过滤**槽位白名单** | 无 | 旧黑名单用例全过；新增"近一年表现 4.12%"必须被拦 |
+| 3 | 实体锚点闸门（产品名 / 代码 / 条款号 / 字段名） | 无 | `M-1` / `M-4` 不得下降 |
+| 4 | `E6` 行情出口（库内净值序列） | 工具白名单 | 新增行情用例全过；无数据源产品如实答复 |
+| 5 | 免责声明分档 | 出口码 | 业务答复仍 100% 带完整话术 |
+| 6 | 阈值分层标定 + `threshold_calibration.json` 新版 | 金标扩容 | 输出可分性结论 |
+
+### 9.2 金标扩容（`D3.7` / `D2.9`）
+
+新增用例组（建议 **≥ 12 条**）：行情走势 `Q-01`—`Q-05`（场内代码 / 产品名 / 无数据源示例产品 / 区间词 / 无实体）、闲聊寒暄 `C-10`—`C-13`（招呼 / 致谢 / 关于助手 / 含业务词不判闲聊）、判据迁移 `A-11`—`A-13`（有锚点不一致必须判没找到）。
+
+### 9.3 验收（DoD）
+
+1. `M-1` / `M-4` **不低于**改造前（46/46）；四项零容忍**保持 0**；
+2. `E6` 类答复中**每个数字**可解析到 `fin_nav_history` 或行情工具（`INV-6`）；
+3. 无数据源产品被问到 → 答复含"无公开净值序列"（`INV-7`）；
+4. 闲聊答复**不出现**完整投资免责话术；
+5. 收益数值泄漏用例（§2.6）**被拦**；
+6. 全量 `pytest` 通过（基线 1997 passed / 3 skipped），`ruff` 零新增。
+
+---
+
+## 10. 文档对齐清单（本件生效后必须同步）
+
+| 文档 | 改动 |
+|---|---|
+| `D2.2` `FR-CS-008` | 删除"跨集合回退（阈值 0.65）"，改为"档位内部分作答 + 引导"；硬约束补"不跨集合、不改判据" |
+| `D3.1` `FR-CS-008` | 同上（完整版口径一致） |
+| `D2.4` / `D3.2` | 补"阈值分层标定 + 可分性结论"；说明第 4 集合不进默认检索面的实测依据（已有，需与之对齐新表述） |
+| `D3.6` §3.4 | `E5` 口径与新表述对齐；出口表补 `E6` 与 `L0` |
+| `D3.7` / `D2.9` | 补行情 / 闲聊 / 判据迁移用例 |
+| `D2.1` | 新增 `W27` 执行条目 |
+| `D1.1` | 登记本件；计数与「合计」行同步 |
+
+---
+
+## 11. 诚实未做项（本轮声明）
+
+1. **未做全量文件普查**：`D1.1` 的历史计数偏移（`§0` 与 `§4.0` 长期差 1）**沿用不追改**；
+2. **未引入跨集合分数归一/重排**：`E6` 走独立数据源，不回退到第 4 集合；
+3. **场外真实基金无行情源**：`fin_product` 只有场内 20 只，示例产品无法给走势（属数据边界，非实现缺陷）；
+4. **`E6` 区间口径**：按**净值日个数**（5/20/60/120）而非自然日，文档与答复统一写明；
+5. **阈值可分性**：§3.4 给出的方法需在金标扩容后**重跑一次**才能给出最终结论 —— 金标已扩容至 **55 条**（见 §12），但**阈值仍未重标**，故本条**依然未做**；
+6. **实体锚点闸门只落到 `E6`**：§3.3 的「判据由阈值迁到实体锚点」本轮只实现了行情侧（`_trend_entity` 三级取实体），**知识出口（`E3`/`E4`）侧的锚点闸门未做** —— 这也是金标扩容只加 9 条（`Q-01`—`Q-05` / `C-10`—`C-13`）而非 12 条的原因：`A-11`—`A-13` 考的就是这条未实现的判据。
+
+---
+
+## 12. 实施与验收实绩（`W27` · 2026-09-21 同轮完成）
+
+> 📌 本节是**闭环记录**：§1—§11 是设计与依据，本节记录"真的做完了没有、量出来是多少"。证据全部是可复算的落盘文件。
+
+### 12.1 落地清单
+
+| 项 | 落地物 | 状态 |
+|---|---|---|
+| `L0` 表层判定层 | `_route_surface()`（`L0-a` 闲聊 / `L0-b` 行情 / `L0-e` 无信息量）+ `app/core/exit_codes.py` 出口码注册表 | ✅ |
+| 出口 `E6` 行情 | `app/service/fund_trend_service.py`（`summarize_trend()` 纯函数 + 工具）+ `query_fund_trend` 注册（`fund:quote:read`，含 `visitor`） | ✅ |
+| 收益过滤升级 | `drop_yield_claims()` 重写为**入口闸 × 槽位白名单**、fail-closed | ✅ |
+| 免责声明分档 | `governance.review_output()` 按 `exit_code` 分档；模板 `TPL_DISCLAIMER_LIGHT` 已入库 | ✅ |
+| 访客权限面 | `VISITOR_PERMISSIONS` 补 `fund:quote:read`；`query_fund_quote` 的 `allowed_roles` **不含 visitor**（逆向守卫单测） | ✅ |
+| 发布配置 | 版本 **`244`**（`cs-tools-75813de45421`）已激活；`customer_service:faq` 派生继承 + 追加 | ✅ |
+
+### 12.2 验收（`§9.3` DoD 逐条对账）
+
+| DoD | 结论 | 证据 |
+|---|---|---|
+| 1. `M-1`/`M-4` 不低于改造前（46/46）；四项零容忍保持 0 | ✅ **`M-1 55/55`、`M-4 55/55`**；`M-7`/`M-8`/`M-9`/`M-10` **全 0**；46 条可比基线**逐项不变** | `_eval_harness\score_w27d_55.json` / `score_w27d_46.json` |
+| 2. `E6` 类答复中每个数字可解析到 `fin_nav_history` 或行情工具（`INV-6`） | ✅ `M-9` = 0（评分器取证面已含**工具原始载荷** + 数值化比对） | `D3.7` §4 / §6.4 |
+| 3. 无数据源产品被问到 → 答复含「无公开净值序列」（`INV-7`） | ✅ `Q-03` / `Q-04` 实测命中 | `result_w27c.json` |
+| 4. 闲聊答复不出现完整投资免责话术 | ✅ 闲聊 3 条只附**轻型**话术；业务档仍附**完整**话术（单测钉死） | `test_governance_disclaimer.py`（45 条） |
+| 5. 收益数值泄漏用例（§2.6）被拦 | ✅ 槽位白名单生效；`A-06` 权重豁免（不再误删整行） | `test_customer_service_rules.py`（194 条） |
+| 6. 全量 `pytest` 通过、`ruff` 零新增 | ✅ **2094 passed / 3 skipped**；`ruff` 余 5 条与 `HEAD` 逐条对应（仅行号平移） | 仓库根实测 |
+
+### 12.3 金标从 46 扩到 55
+
+| 组 | 条数 | 说明 |
+|---|---|---|
+| `Q` 组 · 行情走势（`E6`） | +5（`Q-01`—`Q-05`） | `Q-01`/`Q-03` 走**访客档**（`DEC-W27-11`）；`Q-05` 是**反向守卫**（定义题不得被行情出口抢走） |
+| `C` 组 · 闲聊收口（`L0-a`） | +4（`C-10`—`C-13`） | `C-13` 是**反向守卫**（含产品名 ⇒ 永不判闲聊） |
+
+逐条答复原文见 `D2.9` §2.11；判据表见 `D3.7` §2 `Q` 组与 `C` 组补注。
+
+### 12.4 实施中发现并修掉的真缺陷
+
+1. 🔴 **`risk_level` 类型假设错误**：`fund_trend_service` 原本写 `int(product.risk_level)`，而 `fin_product.risk_level` 存的是字符串 `'R4'` ⇒ 冒烟当场抛 `ValueError`。改为与 `public_product_service` 同口径的 `str(...)`，并加回归测试钉住；
+2. 🔴 **发布被代码上限挡住（422）**：`admin_service` 的校验是**子集**判断而非数量上限（见 §8 决策 `W27` 条 8），`query_fund_trend` 漏进 `definition.allowed_tools` ⇒ 配置发布直接被拒。已补入并加单测钉子；
+3. 🟡 **评分器取证面偏窄**：`M-9` 只看 Milvus 命中，会把行情答复里的 26 个净值数字整片误判成「无出处数字」（**评分器口径**问题，非产品缺陷）。已补「工具原始载荷」取证面 + 数值化比对；
+4. 🟡 **探针缺权限点**：进程内探针的合成上下文漏了 `fund:quote:read`，会让 `E6` fail-closed（表现成「行情功能坏了」）。已补，并在注释里写明理由。
+
+### 12.5 本轮诚实未做项（与 §11 呼应）
+
+1. 知识出口（`E3`/`E4`）侧的**实体锚点闸门**未做 —— 故 `A-11`—`A-13` 未成集；
+2. **阈值未重标**（§3.4 的方法只在文档里）；
+3. `M-3` 分母未改（只明示口径为「考检索的 C 组条目」）；
+4. `D1.1` §0 与 §4.0 的历史计数偏移（差 1）仍沿用不追改。
+