 张胜宇
|
2a55269e20
|
feat(W34-W36): 客服双通道口径分离收口 + 会签 20/21/22 落地 + 演示启动器修复
W34 · 会签 20/21/22 三项落地（先立单、经授权、后动手）
- 会签 20（白名单外）：runtime_config_service 新增 load_collection_routes() /
collection_routes() / _first_collection_name()，首次消费既有 JSON 列 collection_routes；
消费方 customer_service 走「配置优先、缺失回落代码常量」。零 DDL；该列当前全为 None
⇒ 实际走回落路径，行为与改动前一致。
- 会签 21（类 3 + 融合层）：retrieval_fusion 新增 fuse_rrf() + RRF_K（排名融合，只吃名次
不吃分数 ⇒ 异质分数不可能污染判定分，best_vector_score 仍只取向量路原始 cosine）；
knowledge_search_service::search() 新增 literal_parallel: bool = False（默认值使行为
逐字等同现状）。工具层透传未做 —— 那需改 KnowledgeSearchInput 契约（extra="forbid"），
超出本单范围。
- 会签 22（发布配置 + bootstrap）：customer_service 新增 INTENT_MARKET_QUOTE 常量 +
TREND_WHITELIST_INTENT_CANDIDATES（按优先级回落）+ _trend_whitelist_intent()
（运行时自检 + 自动回落，强于「仅报错」）。发布配置 customer_service:market_quote
（release 260，allowed_tools=['query_fund_trend']）已写入并回读校验（9 → 10 行）。
刻意未加入 supported_intents：授权维度与判定维度解耦，不动判定分布。
- 阶段 0：customer_service_rules 新增 normalize_query() + QUERY_SYNONYMS + 等级代号大写
（纯函数；同义表只收纯书写差异，语义类同义留待金标 A/B 后逐条加；调用方默认不启用）。
W35 · 判定口径与融合口径分离（修 A-01 / C-04 / I-02 / E-04 四条）
- _dual_route_output 返回值新增 vector_order（向量路原始 doc_id 顺序、去重）；
- 新增 _vector_decision_hits() 据此还原「判定序列」（带向量分的 basic 补位块回补首位；
无 vector_order / 空 / id 全对不上 ⇒ 返回 None 回落原分支）；
- _answer_from_knowledge 的 score / gap 与原文直返的 best 改从向量路原始序列取。
语义边界（刻意）：_evidence_pack / _exit_clarify / _answer_from_evidence 仍吃融合序列
—— 融合的收益只留在「给哪些块、什么顺序」，符合三层分数分离约束。
W36 · 选块口径归一（收口最后一条 E-01）
- 新增 _pack_order()：order 命中的块排前，其余按原相对顺序追加在后；
- _evidence_pack 新增 order= 参数，三处遍历 hits → ordered，top 由 hits[0] → ordered[0]；
- _answer_from_knowledge 传入 order=[judge 的 doc_id 序列]；judge is None ⇒ None
（开关关闭时逐字零改动）。order 只当排序键、不当过滤器 ⇒ 证据包成员集合不变。
演示环境与文档
- start.ps1 / demo.ps1 默认端口 8000 → 8099（与 README / docs/06,07,09,14,15,32 /
tools/smoke_check.py / login_console.py 的全仓口径对齐；字节级定长替换，保住
UTF-8 BOM + CRLF，字节数不变）；
- portal/README.md 更正 fin_nav_history 过期口径（「0 行」→ 实测 2494 行 / 20 个产品 /
nav_date 覆盖 2026-03-18—2026-09-13）。
测试（新增 3 个文件、补强 2 个）
- 新增 tests/unit/service/test_decision_scope_w35.py（10 条）、
tests/unit/service/test_evidence_pack_order_w36.py（13 条）、
tests/unit/service/test_customer_service_trend_chart_inv8.py（INV-8 字面级判定，
纳入 pytest 门禁，此前只在 jsdom 脚本里覆盖）；
- 补强 tests/unit/core/test_customer_service_rules.py（normalize_query 7 条）与
tests/integration/test_customer_service_trend_chart_persistence.py（图内每个数字
都必须在答复正文出现过，判定口径与 INV-8 单测一致）。
验证
- 全量 pytest：2642 passed / 3 skipped / 0 failed（基线 2629 + 新增 13）；
- 55 条金标真实链路 A/B 四组：off / norm / dual / on 均 55/55 = 100%
（改前 dual 92.7%、on 90.9%）；M-4 事实正确率恒 100%、M-7—M-10 全 0；
- 红线四条守住：融合/精排层仍不持 Milvus 客户端（INV-1）、阈值一字未动、零 DDL；
- 三个实验开关 CS_DUAL_ROUTE / CS_RERANK / CS_QUERY_NORM 仍默认关闭。
|
2026-09-22 18:05:59 +08:00 |
|
|
张胜宇
|
2c3a5188fb
|
feat(W33): 双通道检索权重融合 + LLM 精排（一期，默认关闭）+ 意图配置与意图级度量
- app/core/retrieval_fusion.py（新增）: 两路候选加权融合，三层分数分离
- app/service/retrieval_rerank_service.py（新增）: LLM 精排，只出 id / 越界剔除 / 失败静默回落
- customer_service.py: 接线，开关 CS_DUAL_ROUTE / CS_RERANK，未设置时一行都不执行
- 测试 61 条（融合 22 / 精排 22 / 接线 17）
- agent_intent_config 补 5 条 active（1 -> 6）
铁律: vector_score 只用于出口判定，绝不改写；融合与精排只改「看哪些块、什么顺序」
门禁: 2608 passed / 3 skipped / 0 failed；金标 55 条逐项零差异，M-1 恒 100%
|
2026-09-22 12:29:50 +08:00 |
|
|
张胜宇
|
7cacb16252
|
test(W29-d): 补上「数据落库 + HTTP 链路」的端到端验证（此前只测到进程内直调）
## 补的是什么空白
W28 / W29 的全部验证都是**进程内直调** —— 直接构造 ToolExecutor、直接调 Agent，
或者**手写** configured_tools。**从来没有走过「HTTP 受理 → Worker 执行 → 落库」这条真实链路。**
补测前的实测证据：
conversation_message 里 tool_calls LIKE '%trend_chart%' -> 0 条
conversation_message 里 tool_calls LIKE '%svc_topic%' -> 0 条（W28 事项码）
agent_run 里 agent_type='financial_nl2sql' -> 0 条
最近一条真实 run -> 2026-09-21 14:46（早于这两批改动）
而**前端取图完全依赖这条路**：前端读的是 `result.tool_calls.data.trend_chart`，
它由 `agent_persistence_service` 写进 `conversation_message.tool_calls` 这个 JSON 列。
**这条路不通，图就是「代码里有、页面上没有」。**
## 两个测试
1. `test_customer_service_trend_chart_persistence.py`
走势问句走 HTTP + Worker，断言 `trend_chart` 与 `svc_topic` 同时出现在**出参与库里**；
并逐条断言图数据中的涨跌数字**出现在答复正文里**（`INV-8` 的落库侧前提）。
2. `test_financial_nl2sql_http_wiring.py`
接线后 `financial_nl2sql` 能否在**真实 HTTP 链路**上出结果。
此前的「接线验证」是**手写 configured_tools** —— 等于把要验证的东西自己填好了：
它能证明「工具逻辑对」，但**证明不了「接线生效」**（白名单是从 `config_release` 装配的）。
断言 `data` / `sql` 出参 + SELECT-only 自证 + `data.total`（证明**真的执行了**，不是只编译）。
两个测试都按 `session_id`（带 uuid）隔离并在 finally 清理，不污染历史数据。
## 结果
- 两条单跑均 passed（4.12s / 2.84s）
- 全量 pytest **2547 passed / 3 skipped / 0 failed**（2545 + 2）
- ruff：两个新文件 0 告警
## 一句留给后人的话
写这两个测试时的第一个失败是 `TypeError: object RequestContext can't be used in
'await' expression` —— `WorkerRuntime.restore_context` 会 `await self.resolve_identity(...)`，
必须传**协程函数**，不能传 lambda。已在两处代码里注明，免得下一个人再踩。
|
2026-09-22 10:47:48 +08:00 |
|
|
张胜宇
|
39ca52449a
|
fix(W29-c): nl2sql_yc 的 GROUP BY 拼装缺陷（会签组 6）+ 更正一处误判
## 更正：上一个提交里有一句话是错的
docs/49 组 5 与 D2.1 §1.6 原写「nl2sql_yc.py 同样缺写意图守卫」—— 该表述有误。
立组 6 时按纪律**先取证、再立单**，实测 8 条写意图问句对它 **8/8 已被拒绝**
（它没有宽泛关键词路由：「删除所有客户的持仓记录」不命中它的「当前持仓」
⇒ 计划落 unknown ⇒ 被 _validate_plan 拒绝）⇒ **它不需要写意图守卫**。
三处文档的错误表述已当日更正并**保留更正痕迹**（docs/49 组 5 的更正块、
D2.1 §1.6 的更正块），不静默抹掉。取证日志见报告 §10.1。
## 顺带量出的真缺陷：GROUP BY 拼装
取证同时发现一条**完全正常**的只读问句直接报错：
查询近30天净值 -> status=error
(pymysql.err.OperationalError) (1055, "Expression #3 of SELECT list is not in
GROUP BY clause and contains nonaggregated column 'jr_agent.n.nav'
... incompatible with sql_mode=only_full_group_by")
根因（_compile_sql）：SELECT 里既有 dimensions（已进 GROUP BY）又有 metrics，
而 metrics 里的**非聚合**列（n.nav / m.close_price / h.market_value …）**没进 GROUP BY**。
修法（仅 +24 / −1 行，守住会签单的「最小化边界」）：
① 没有聚合函数就不加 GROUP BY；② 有聚合时把**所有非聚合 select 列**一并纳入，
而不是只放 dimensions（漏掉非聚合 metric 正是 1055 的成因）。
## 影响面
踩：_mock_plan 的 4 条路由（收盘/行情、净值（已实证）、当前持仓、账户余额）；
不踩：SUM / COUNT 聚合路由，以及 _offsite_mock_plan 全部 5 条（均无 dimensions）。
=> 场外主链路不受影响；受影响的是通用兜底路由的 4 类问句（演示与离线联调走的正是这条）。
## 验证
- 实测（真连库）：净值/行情查询由 error 转 success；资金流水（SUM）GROUP BY 语义不变；error 归零
- 新增测试 5 条：**断言 SQL 结构而非「跑得通」** —— 缺陷只在真实 MySQL 的
only_full_group_by 下现形，而单测跑在 sqlite（不做该检查）；断言"能跑"在修复前后
都是绿的，等于没测。其中一条是**通用不变量**：有 GROUP BY 时 SELECT 里每个非聚合列
都必须在组内 —— 将来往 metric_map 加非聚合指标时会**先红**，而不是等真实库冒 1055
- offsite 相关 13 passed；全量 2545 passed / 3 skipped / 0 failed（2540 + 5）
- 金标 55 条与 W27 基线判分逐项零差异
- ruff：新文件 0 告警；nl2sql_yc.py **零新增告警**
（既存 39 条 E501/F601/UP035/F401/B905 未清理 —— 不在会签单「最小化边界」内）
会签：docs/49（A-10）组 6 · 会签 19（☑ 2026-09-22 受理）；白名单已登记 docs/48 类 3 表。
|
2026-09-22 10:31:24 +08:00 |
|
|
张胜宇
|
020f17363f
|
test(W28): 意图漂移守卫用例集（414 条）
覆盖：
- 「业务词 × 寒暄外壳」漂移用例 330 条（33 个业务关键词 × 10 种寒暄外壳，
如「在吗，帮我看看{kw}」「嗯嗯，那{kw}呢」）—— 最易漂移的一族
- 业务动作与职责词 13 条
- 真寒暄反向守卫 16 条（确保不把闲聊拖去查库）
- 空串 / 纯符号 5 条
- 事项码正例 24 条 + 反例 6 条 + 属性自洽 14 条
- 下一步动作 26 条（E5b 双段话术）
- AST 结构守卫 4 条
- Agent 层端到端 6 条（含「强制分类为 chitchat + 业务问句 ⇒ 必须改走知识出口」）
配套实现在上一提交（客服业务层）。
|
2026-09-22 10:12:22 +08:00 |
|
|
张胜宇
|
2b408dc602
|
feat(W29): 对话内区间涨跌图（零新数字路径）+ 客服业务层事项轴
## 对话内图表（W29）
按「零新数字」路径实现：图只画答复正文里**已经写出来**的数字，不引入任何新数值
（新不变量 INV-8：图内每个数值必须能在同轮文字中找到）。
- E6 出口 data 增 trend_chart（纯增量，只搬运模板已写出的数字：最新净值 /
四个区间涨跌 / 区间首末净值 / 区间高低 / 数据日期）
- 新增 trend-chart.js：**全 DOM API 构建**（widget.js 的 addMessage 一律 textContent，
图表若拼 HTML 串等于把那层 XSS 防护重新打开），涨红跌绿（中国市场惯例）
- widget.js 从 result.tool_calls.data 取数 ⇒ **零后端读取改动**
（result.data 只对 financial_nl2sql 暴露；走 tool_calls 这个已落库的 JSON 列免会签）
验证（真实净值数据 511810 / 160 个净值点、区间 -9.19/5.28/15.27/-6.53）：
- jsdom 渲染 11/11 通过；颜色序列 [绿,红,红,绿]
- INV-8 独立断言：图上 18 个可见数字 **100% 命中答复正文**（extra_numbers=[]）
- 空数据三态返回 null；label 里塞 <img onerror=...> 后 DOM 中 img 元素数 0
## 客服业务层（W28 遗留，本次一并提交）
- app/core/service_topic.py（新增）：业务事项轴 —— 12 个 SVC-* 事项码 ×
处理主体 × 留痕等级；只做留痕统计，不参与任何判定
- customer_service.py 的 E5b 双段话术（删掉「换个说法再问我一次」= 把问题推回客户）、
kb_miss 显式声明（不再靠文本比对，话术一变化比对就静默失效）、
意图漂移护栏（分类器判闲聊但含业务实质则不采信）
- customer_service_rules.py：substantive_business_request 等判据
注：customer_service.py 同时承载 W29 的 trend_chart 与上述 W28 改动，
两者无法按文件切分，故同批提交。
|
2026-09-22 10:12:14 +08:00 |
|
|
张胜宇
|
9dcfa64bc5
|
feat(W29): NL2SQL 接线与只读边界守卫（会签项 18）
## 接线
发布 agent_tools/financial_nl2sql:financial_query -> [query_financial_data]
（tools/publish_financial_nl2sql_config.py --apply，治理动作）。
结果：新 release 260（financial-nl2sql-f1be6be8063f）生效、旧 244 转 superseded、
活跃配置 8 -> 9 条；**客服侧那 8 条逐字未变**（回读核对：缺失 0 / 被改动 0）。
在此之前该能力「代码全在、工具调不通」—— 按「工具 = 代码上限 ∩ 发布白名单，
缺配置失败关闭」，缺的就是这一条配置。
## 接线后实测量出的缺口（本次修复对象）
RuleBasedFinancialPlanner 不识别写意图动词：「删除所有客户的持仓记录」被判成
「查持仓」，返回 status="ready" 并生成一段 SELECT —— 8 条写意图问句 8/8 复现。
数据安全当时**并未破**（SQL 仍是 SELECT，被 _safe_sql_check 的 SELECT-only +
BANNED_SQL 兜住），故定性为「答复与诉求不符」而非「越权写库」；但一旦将来给该
工具加写能力，这里即成为起点。
## 会签（先补签、后改动）
该文件原本不在 docs/48 白名单任何一档（等于「白名单之外一律不动」）⇒ 先补
docs/49（A-10）组 5 · 会签 18 并登记为类 3，获批后才实施。同步更新
docs/48 类 3 表与 客服agent/D2.1 §1.6（镜像已同步）。
## 改法（守住会签单的「最小化边界」）
- plan() 入口增写意图预检 -> 返回带 unsupported_reason 的不可执行计划
- _validate_plan() 增「不可执行计划优先」判据
- query() 走**现成**的 status="rejected" 分支，未新增代码路径，审计照旧留痕
判据分两级以控制误杀：一级强拦（删除/清空/撤销/改成/写入/导入…）；
二级歧义写动词（修改/更新/变更/导出…）须**无查询语境词**才拦 ——
否则会误杀「费率变更历史」这类真实续问。
## 验证
- 只读护栏回归锁 8 条（与判据互为独立防线，判据退化时仍须绿）
- 写意图 8 条由 xfail 转为正式断言（全通过）
- 误杀边界 7 条（查询语境的歧义写动词不得被拦）
- NL2SQL 相关测试 84 passed
- 全量 pytest 2540 passed / 3 skipped / 0 failed（xfailed 归零）
- 金标 55 条与 W27 基线判分**逐项零差异**（M-1 55/55、M-4 55/55、四项零容忍全 0）
- ruff：改动文件 0 告警
|
2026-09-22 10:12:06 +08:00 |
|
|
张胜宇
|
d315aa61db
|
docs(W27-4c): D1.6 §14.6 表列改为「提交序列」并补 zsy 同步提交 · 桌面件去锚定哈希
- §14.6 列名 `HEAD` → `提交（按时间序）`，并加注：**上表不是当前 `HEAD`**，`zsy_developcc` 同步提交晚于 `qyqy_develop` 对应提交（内容同源、树一致）。
- `zsy_developcc` 链补 `851f074`；新增 `7b5acc9`（`W27-4b`）一行。
- 桌面件 `D:\桌面\客服Agent-对话记录与上下文提取-2026-09-21.md` §0 状态表去掉会随提交失效的哈希锚定，改为「均已推送且树完全一致 + 指向 §14.6 提交序列」。
- 目的：让两份文档**不会再因后续提交而失真**（原写法把「当时的 HEAD」当成「现在的结论」，属口径缺陷）。
|
2026-09-21 22:55:34 +08:00 |
|
|
张胜宇
|
7b5acc98a1
|
docs(W27-4b): D1.6 §14.6 补 W27-4 提交行与说明 · 桌面单文件版同步登记
- §14.6 提交与推送表新增 `qyqy_develop` = `8296842`（`W27-4`，1 file，`+151/−0`）一行；`zsy_developcc` 链补 `38767c8`。
- 表下新增 `W27-4` 说明：本轮把 §13/§14 补进仓库、新增桌面单文件版留痕件、`D2.6` 游离 LF 归一（**内容无变更**）。
- 桌面件 `D:\桌面\客服Agent-对话记录与上下文提取-2026-09-21.md` 同步更新：§0 状态表 HEAD 刷新为 `8296842` / `38767c8`，§2.6 末尾补「`W27-4` 收尾」段（记录本轮产出与提交）。
- EOL 校验：`D1.6` 仍为纯 CRLF、无 BOM。
|
2026-09-21 22:55:03 +08:00 |
|
|
张胜宇
|
82968429d3
|
docs(W27-4): D1.6 补 §13（W26 轮）与 §14（W27 轮）逐轮留痕 · 登记桌面单文件版对话记录
- §13 `W26` 轮：甲方三项异议原话逐字留痕 + 本轮实测诊断 5 条（阈值区间重叠 / `FALLBACK_COLLECTIONS` 死代码 / 走势数据源缺失 / 闲聊兜底未接路由 / 收益过滤黑名单可绕过）+ 已拍板 12 项决策表 + 下一轮先读项。
- §14 `W27` 轮：甲方原话 11 条（含中途插入的 `G-01`/`G-02`/`G-03` 裁定原文）+ 落地清单与验收 + 金标 46→55 + 修掉的 7 处真缺陷（3 处甲方点名、4 处实施中发现）+ 交付面口径统一 + 提交与推送表 + 诚实未做项 6 条 + 答辩口径速记。
- §14 顶部登记「桌面单文件版」：`D:\桌面\客服Agent-对话记录与上下文提取-2026-09-21.md`（`W21`→`W27` 全程留痕），并声明**冲突时以仓库文档为准**。
- 行尾符归一：`D1.6` 追加段统一 CRLF（全文 3634 行纯 CRLF、无 BOM）；`D2.6` 5 处游离 LF 归一为 CRLF（内容与 `HEAD` 逐字节一致，无内容变更）。
|
2026-09-21 22:53:52 +08:00 |
|
|
张胜宇
|
be085c5f18
|
docs(W27-3): D2.6 §11 补「阈值是否可靠」三条追问 · D2.10 §8.1/§7.3/§7.4 补行情与闲聊 · D1.1 §35 留痕
承接 W27-2（279a632）。本轮做**答辩现场直接会被问到、但文档里还没有答案**的三件事。
## 一、D2.6 §11「答辩现场速答」新增 3 条追问（核心）
甲方原话提的那个问题，之前 `D2.6` 只能靠 `D3.9` 间接回答，现场不一定翻得到。现在直接进速答表：
1. **「分级回退的阈值凭什么保证一定精确检索到答案？」** —— 答：**这个判据本身就站不住**。实测「应当直答」的 26 条
`score ∈ [0.6115, 1.0]`、「明确不许直答」的 20 条 `∈ [0.5049, 0.8226]`，**两段重叠 ⇒ 单点阈值不存在**；
`W27` 因此把精确性从**分数阈值**迁到 **`L0` 表层判定 + 实体锚点 + 证据结构**，分数只留作**安全下限**。
证据 `_eval_harness/threshold_calibration.json`，见 `D3.9` §2.1 / §3.3—§3.4。
2. **「那回退之后降低阈值岂不就不精准了？」** —— 答：**对，而且这条规则在代码中根本不存在**。
`FALLBACK_COLLECTIONS` 是死代码（`knowledge_search_service.py:41` 定义无人调用）；实测若真接上，跨集合余弦分
**量纲不可比**会撞坏 `MIN_GAP`，`M-1` 从 **100% 掉到 91.3%** ⇒ 不做。现在的回退只在**同一档位内**
`E5a → E5b → E5c` **单向降级**，降的是**答复完整度**、**不是证据门槛**（`FR-CS-008` ① 已作废，见 `D3.9` §3.5）。
3. **「意图识别是不是不准？为什么闲聊会触发检索？」** —— 答：旧实现把意图分类当**路由器**用且闲聊与业务问句同路；
`W27` 把意图分类**降级为「增益 + 兜底」**，前面插一层 `L0` **确定性表层判定** ——
「闲聊不再进检索」靠的是**少让模型参与判定**，不是调准模型。
## 二、D2.10 端到端答辩文档
- §8.1 速答表同步上述 3 条；§6.1 首行计数改为「金标已扩容到 55 条，两个分母都报」。
- §4.2 的 `MIN_GAP` 踩坑块补「并读 §4.1 口径更新」：`MIN_GAP` 仍是有效**结构判据之一**，
但整套精确性**不能**押在它或任一分数阈值上。
- §7.3 客服线台词表新增 3 行（`E6` 走势 / `E6` 无数据源如实告知 / 闲聊零检索），§7.4 演示顺序加「行情与闲聊」一项，
§7.5 时间分配把现场演示条目改为「+ 行情 1 条 + 闲聊 1 条（各 5 秒内出结果）」。
## 三、D2.5 / D1.1
- `D2.5` §4 标题「7 组台词」→「**8 组台词**」（新增 §4.8 之后同步）。
- `D1.1` 新增 **§35（第三十一轮）**留痕：本轮改了什么、**为什么只加横幅不改历史**、
四份 HTML 为何**不重跑生成器**、以及三条**诚实未做**（`D1.6` 留痕待补 / `D2.1` 看板未逐项回填 /
历史段「五出口」**有意保留**——全文替换会把「当时的决策」改成「现在的结论」，反而失真）；头部 **v1.18 → v1.19**（计数不变）。
## 四、验证
- `_sync_check.py`：**0 缺失 / 0 不一致**。
- 5 份 HTML（`D2.10` / `D2.2` / `D2.4` / `D3.1` / `D3.2`）`blockquote` / `table` / `tr` / `td` 开闭标签**逐项配平**。
- 本轮 11 份变更**全部是 `.md` / `.html`**，无代码改动 ⇒ 不影响已绿的 `pytest 2094 passed / 3 skipped`。
|
2026-09-21 22:46:16 +08:00 |
|
|
张胜宇
|
279a6327e3
|
docs(W27-2): 出口口径统一为「七出口 + L0」· D2.5 新增行情/闲聊实测台词 · 金标计数对齐 55 条
本轮只改文档（12 份，无代码改动），把 `W27` 的代码实绩（`L0` 表层判定层 + 出口 `E6` 行情）在**全部交付面文档**上对齐。
此前工程侧已入库（3e24033），但答辩面文档仍留「五出口 / 六出口」旧口径，是最容易被评委当场戳到的自相矛盾点。
## 一、口径统一：五出口 → 七出口 + `L0`
- `D3.6`（被多处引为「五出口权威定义」）：加**口径更新横幅**（列明 `W20` 六出口、`W27` 七出口 + `L0` 的演进线，
并写明「不变的」——转人工仍只是 `E5c`、白名单仍 4 类、`INV-1`~`INV-5` 一条没改）；§3 标题加「起步定义」；
**新增 §3.0**说明 §3.1—§3.4 的适用范围；本页 `D3.7` 配套行的金标计数 46→55、10→11 项指标。
- `D1.1`：7 处索引/清单行对齐（`D2.6` / `D2.10` / `D3.6` 的描述与计数），其余「五出口」全部保留为**历史记录**。
- `D2.6`：配套行补 `D3.9` 指向；**新增 `W27` 状态更新段**（金标扩容到 55 条 + 第七个出口 + 三处真缺陷修复），
并显式声明「上一条 `W24` 的『六个出口』口径已由本条扩为七个」。
- `D3.7`：性质行/读法/§0 计数对齐（46 → 55、十项 → 十一项指标）；**§4 增补 `W27` 扩容后的分母口径表**
（`M-1`/`M-4`/`M-5`/`M-6`/`M-10` = 55、`M-2` = 33、`M-2b` = 20、`M-3` 明示「考检索的 C 组」，门槛不变）。
- `D2.9`：引用表新增 `D3.9` 行；判分输入件由 `cases_46.json` 更新为 **`cases_55.json`**（附两个分母的产物名）。
- `D2.8`：`W27` 判定补充行（前批已入库，本轮核对通过）。
## 二、HTML 规格文档：只声明口径，不重写历史
`D3.1`（需求开发文档）/ `D3.2`（知识库方案）/ `D2.2`（需求收敛版）/ `D2.4`（知识库收敛版）
四处 `§0.1` 之前各加一段 `callout-warn` 口径更新：说明「五出口」是 v1.x/v2.x 时点的**起步定义**、
现行是「七出口 + `L0`」，并明确**语义与安全结论全部有效、只是不再是全集**，指向 `D3.9` 与 `D2.6` §3。
（`_build` 已标注「已过期·请勿重新生成」，故直接在成品上改，不重跑生成器。）
## 三、`D2.10`（端到端答辩文档）
`六出口` → **七出口 + `L0`**（徽标 / meta / Mermaid / S8 表 / 时间分配 / 文档关系表，共 5 处）；
§3.8 出口表**新增 `E6` 行情行**，正文补 `L0` 段落；§4.1 阈值表后**新增口径更新块**
（区间重叠 ⇒ 单点阈值不存在；阈值降为安全下限；「跨集合回退 0.65」在代码中不存在）；
§6.1 标题与「两个分母都报」的实测块对齐 55 条；§11 补 `D3.9` 与 `W27` 证据文件。
## 四、`D2.5` 演示脚本（答辩当天照着念的那份）
**新增 §4.8「行情走势与闲聊」**——针对上轮被点名的两类，全部用 **2026-09-21 真 HTTP 实跑**的答复：
- `159382这只ETF最近走势怎么样？` → `E6`，给出近 5/20/60/120 个净值日涨跌 + 区间高低 + 数据区间；
- `南方稳健增利债券A最近走势怎么样？` → `E6-miss`，如实说「查不到公开的净值序列」，**拒绝编造**；
- `你好呀` / `谢谢你` / `在吗` → 闲聊，**零检索**；
- **反向守卫**「在吗，想问下南方稳健增利债券A的起投金额是多少？」→ 必须走知识作答（证明 `L0` 判的是整句）；
- 附「口径细节」：`E6` **不调模型**（固定模板 + 纯函数，数字全部来自 `fin_nav_history`），
闲聊**调模型但完全不查库**（新跑 `_w27_probe_guard.py` 单独验证反向守卫，另有 `_w27_probe_trend/chat.txt`）。
§6 表补两行（闲聊不再进检索 / 走势是算出来的），金标计数行改为 55 条并附两个分母的指标表。
## 五、验证
- `_sync_check.py`：权威目录 → 仓库镜像 **0 缺失 / 0 不一致**（13 份同步）。
- `git diff --name-only`：12 份变更**全部是 `.md` / `.html`**，**无任何代码改动** ⇒ 不影响已绿的
`pytest 2094 passed / 3 skipped`（3e24033 已复跑）。
- 本轮实测证据保留在 `D:\桌面\金融\_w27_probe_guard.py` / `.txt`（答辩后勿删）。
|
2026-09-21 22:43:46 +08:00 |
|
|
张胜宇
|
3e24033f72
|
feat(W27): L0 表层判定层 + 出口 E6 行情 + 收益过滤槽位白名单 + 免责声明分档（设计与代码同轮完成）
设计与依据：新增 D3.9-客服Agent智能路由与行情出口设计-2026-09-21.md（CS-ARCH-2026-024）
DEC-W27-1~12 全部批准并落地。
## 新增（3 个源文件 + 3 个测试文件）
- app/core/exit_codes.py：出口码注册表（E0/E1/E2a~E2e/E3/E4/E5a~E5c/E6/E8/CHAT/LOGIN/CONTACT）
+ NON_BUSINESS_EXIT_CODES 白名单（免责分档的判据面）
- app/service/fund_trend_service.py（E6）：summarize_trend() 纯函数 + query_fund_trend 工具
读 fin_nav_history；按净值日个数（5/20/60/120）给区间涨跌 / 区间高低 / 来源与区间
- tests/unit/{service,tools} 新增 45 条守卫单测（E6 出口 / L0 表层判定 / 工具配置）
## 改动（重点）
- customer_service.py：
· _route_surface()（L0-a 闲聊 / L0-b 行情 / L0-e 无信息量），位置在安全路由之后
· drop_yield_claims() 重写为「入口闸 × 槽位白名单」+ fail-closed
（旧黑名单会误删权重：A-06 业绩基准公式整行消失）
· allowed_tools 补 query_fund_trend —— 修掉发布被拒 422「配置超出 Agent 工具上限」
（该 422 是**子集**校验而非数量上限，根因即此项漏配）
· 25 处 CoreResult 全部补 exit_code（AST 守卫保证零遗漏）
- customer_service_rules.py：闲聊判定重写（业务实体边界 + 词表 + 特征串 + 语气词）
+ is_low_information_message() + is_contact_inquiry()
- governance.py：免责声明按 exit_code 分档（业务档完整 / 非业务档轻型）
- actor.py：VISITOR_PERMISSIONS 补 fund:quote:read（E6 对访客开放，DEC-W27-11）
- tools/：seed_compliance_baseline 新增 TPL_DISCLAIMER_LIGHT；publish 工具改为
「从生效版本派生原列表再追加」（_inherit_tools 取不到返回 None，防静默改窄）
## 实测
- 金标扩容 46 → 55（新增 Q 组行情 5 条 + C 组闲聊 4 条）
- M-1 55/55、M-4 55/55；M-5 与四项零容忍（M-7/M-8/M-9/M-10）全 0
- 原 46 条可比基线逐项不变（46/46）；M-6 9.1%（5 条全在转人工白名单内）
- 全量 pytest 2094 passed / 3 skipped；ruff 零新增（余 5 条与 HEAD 逐条对应）
- 配置版本 244（cs-tools-75813de45421）已发布并激活
## 文档
- 新增 D3.9（设计专册）；D1.1 §34 补「代码实施已同轮完成」并把旧表述作废
- D3.7：新增 Q 组判据表 + §6.4 第四次实测 + M-3/M-9 口径澄清
- D2.9：新增 §2.11（9 条新增用例的实测答复原文）+ 汇总表改双列口径
- D2.1：新增 v6.41 执行条目
- 权威副本（D:\桌面\金融\）→ 仓库镜像 全量比对一致（0 缺失 / 0 不一致）
## 诚实未做项
- 知识出口（E3/E4）侧的实体锚点闸门未做（故金标扩容 9 条而非 12 条，A-11~A-13 未成集）
- 阈值未重标（D3.9 §3.4 只给方法）；M-3 分母未改（仅明示口径）；
D1.1 §0 与 §4.0 历史计数偏移（差 1）仍沿用
|
2026-09-21 22:32:39 +08:00 |
|
|
张胜宇
|
b6ec3aa699
|
docs(W26): D2.10 端到端答辩文档入库 + D1.1 索引计数同步（v1.17）
- 新增 客服agent\D2.10-客服Agent端到端答辩文档-2026-09-21.html（v1.0，域 2 续号）
十段流水线 + 4 张 Mermaid 图 + 六出口 + INV-1~INV-5 / INV-M1~INV-M6
+ 46 条金标前后对比 + 演示台词 + 必问主观题 + 坑与教训 + 诚实未做项
- D1.1 v1.16→v1.17：登记 D2.10；客服agent 9→10 份、总数 61→62 份、
域 D2 9→10、注入校验 57→58 份（客服agent\*.html 3→4）
- 权威副本（D:\桌面\金融\）→ 仓库镜像 全量比对一致（0 缺失 / 0 不一致）
|
2026-09-21 21:22:29 +08:00 |
|
|
张胜宇
|
35109af96f
|
docs(W25): D2.9 手动测试用例按实测重建 + 展示层误删正文真缺陷修复
- D2.9 v1.3→v1.4：46 条金标追加「2026-09-21 实测（出口 · top1）」列与逐条答复原文，
§3 边界 11 条 / §4 安全 4 条 / §1.3 / §5 指标表实测列刷新，新增 §2.10 场内基金演示线（5 条），
§3.1 缺口由三个扩为四个（新增 ④ A-06），§3.2 整段重写，§8 新增 D-5 与 DEC-W20-8 细化
- D2.5 §4.7 出口口径更正：场内基金第 1 条 E3→E4、第 2 条 E3→E5b（内容逐字正确，出口偏保守）
- 修复 drop_yield_claims() 误删「业绩比较基准」公式行：收益词与百分比间出现
乘号 / 指数 等公式标记时判为基准公式豁免，两种语序的真实收益数值照删
- 新增回归测试 test_drop_yield_claims_keeps_the_benchmark_formula_but_drops_both_word_orders
- D2.1 v6.39→v6.40 / D1.1 v1.15→v1.16（新增第二十八轮）/ D1.6 新增 §12 / D4.8 v1.2→v1.3（新增 §11）
实测：46 条金标全部 succeeded，HTTP 非 200 = 0；转人工 5 条（均白名单内）；
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；
pytest 1997 passed / 3 skipped；ruff 零新增告警。
|
2026-09-21 15:27:18 +08:00 |
|
|
张胜宇
|
29da85d010
|
docs(W24): 交付前复核补正 + 场内基金演示线 + 一键启动端到端实跑
按甲方「按你建议的来 一次性搞定上边的建议」执行七项。
文档事实纠错（4 处，逐条实测核对后改）
- D2.4 §AC-04/AC-05：「当前 617 块全部为 public」与本文档自己的 v1.6/v1.8
版本行（public 730 / registered 25）自相矛盾 ⇒ 标「设计当时」+ 补 v1.8 现状
（755 块），写明 AC-04/AC-05 现已可证伪、不再需要「造一条测试块」
- D2.5 演示脚本：「family_id 628 块全覆盖」⇒ 755 块（W24 复测）
- D4.8 §9.2：把「集合条数 basic 105 / product 398 / faq 300 / policy 576」
当成真实条数引用 —— 那是 upsert 墓碑行被计入 get_collection_stats().row_count
的结果（同 D2.1 v6.9）。已补口径更正段，定规：引用块数一律用 _chunks.jsonl
- D2.6 答辩报告：补 W24 状态 —— docs/43 已入库（702 → 755 块）；出口经
E2c-my 细分后共六个，转人工只在 E5c
演示脚本增强
- D2.5 新增 §4.7 场内基金演示线：5 条台词逐条真 HTTP 实测
· 场内基金有哪些？ → 20 只清单（13 ETF + 7 LOF）
· 科创债ETF南方怎么样？ → 单只产品行（R2 / 净值 101.8009）
· 南方金利定开债券A的管理费率？ → 0.50%/年 + 0.15%/年
· 场内基金报价的最小变动单位？ → 0.001 元
· 沪深300ETF怎么样？ → E4 生成式作答，且明示「非本公司发行」
并附修复前/后对比表（修复前：命中另一只产品 / 返回 20 只整张表）
- demo.ps1 自检 2：补 fin_basic_collection ⇒ 四个集合计数（154/251/288/62=755）
_build 处置（不删，改为「把废弃做成一眼可见」）
- 与 D1.6 §4.22 四 已记录的裁定冲突（理由：删掉等于删留痕，也删掉
「为什么不能重跑」的证据）⇒ 不删
- 三个正文源 _body_kb/_body_plan/_body_requirements.html 顶部加红框
「已过期」横幅，逐文件列出已核实的滞后项（617 块全 public / 旧品牌
XX科技·400-XXX·nanfangwm ×5 / 48 条·51 项·7 个批次 / US-CS-08·FR-CS-023）
- _build\README 追加「五、2026-09-21 补记」
端到端实跑（冷启动，非 -SkipStart）
- 停掉全部服务 → 启动演示.bat（demo.ps1 -NoBrowser）⇒ 五项自检全过、rc=0
- 8 个入口 URL 全部 200（portal 首页 / 访客页 / 客户登录 / 员工登录 /
投顾工作台 / docs / openapi.json / health）
- 访客 token 真对话「科创债ETF南方怎么样？」⇒ succeeded、transfer=False、答单只产品
落档
- D2.1 v6.39 追加「交付前文档复核补正」表（7 项）+ 端到端实跑结论
- D1.6 §11.2 补 W24-8 / W24-9；§11.5 补第 5、6 条
|
2026-09-21 14:51:32 +08:00 |
|
|
张胜宇
|
2762b05203
|
docs(W24): 交付件口径纠错 —— D2.4 自相矛盾 / D2.5 过期块数 / D4.8 墓碑行误标 / D2.6 补 W24 状态
复核时发现四处「交付件里的事实错误」，逐条修：
- D2.4 §AC-04/AC-05 段：正文写「本仓库 _chunks.jsonl 当前 617 块全部为 public」，
与本文档自己的 v1.6/v1.8 版本行（public 730 / registered 25）自相矛盾。
改为标「设计当时」+ 补 v1.8 现状（755 块），并写明 AC-04/AC-05 现已可证伪、
不再需要「造一条测试块」（双向验证已于 2026-09-18 实测通过）。
- D2.5 演示脚本：「族判定（family_id 628 块全覆盖）」→ 755 块（W24 复测）。
这是答辩当天要照着念的稿子，块数必须与实库一致。
- D4.8 §9.2：把「新集合条数 basic 105 / product 398 / faq 300 / policy 576」
当成真实条数引用 —— 那组数字是 upsert 留下的墓碑行被计入
get_collection_stats().row_count 的结果（同 D2.1 v6.9：298/576/382 = 存活行
149/288/191 的两倍）。已补口径更正段，写明本轮复测的存活行数
251/154/288/62 = 755，并定下「引用块数一律用 _chunks.jsonl，不用 row_count」。
- D2.6 答辩报告：补一条 2026-09-21 W24 状态更新 —— ① docs/43 场内基金手册已入库
（20 只场内基金，702 → 755 块），「问在库产品却答另一只」的根因已根除；
② 出口经 E2c-my 细分后共六个（E1/E2/E2c-my/E3/E4/E5），转人工只在 E5c。
已复核：Milvus 四集合存活行数与 knowledge/_chunks.jsonl 逐集合一致（288/251/154/62 = 755），
无墓碑行残留；recalls_customer_memory 仍为 False，与 D2.7 记载一致。
D2.4 HTML 结构自检通过（table/tr/td 标签配平）。
|
2026-09-21 14:36:08 +08:00 |
|
|
张胜宇
|
94ce44a851
|
feat(W24): docs/43 场内基金手册入库 + B-02 展示候选集收口
补历史欠账：D3.4 B-02（决 12）与 D4.1 §B-02 早已承诺把 docs/43 纳入 SOURCES，
从未执行；W21 首次把它暴露成实测缺口（702 块里「科创债」0 处）。
语料与切片
- docs/43-场内基金产品手册（知识库入库版）.md 纳入 SOURCES：20 只场内基金
（13 ETF + 7 LOF），fin_product_collection / public / prefix=ETF；切片件 702 -> 755 块
- 新增三个「按源开启」的切片开关（默认关，其它 8 个源零字节变化）：
strip_editorial_marks / qualify_table_rows / exclude_sections
- 费率表表头补单位（%/年）；docs/43 与 knowledge 镜像逐字一致
- docs/45 裁定不入库（与 FAQ-0018 / POL-AST-011/012 重复，会抢 top1）
修复两个真实缺陷
- W24-A 切片器行标签取错列：多列表格第 0 列是代码（159700[:2]='15'），
上游 _prefer_section 判不出重合 => 每一问都被换成整节块
（实测「科创债ETF南方怎么样」返回 20 只产品的整张表）；改取表头「名称」列
- W24-B text-embedding-v3 单请求上限 10 条：load_knowledge_milvus.embed()
只在灌库路径分批，自检路径超 10 条即在数据写完后崩；分批下沉进 embed()
- B-02 的 M-4 回归：_exit_partial 两条调用路径候选集不同（主路径 TopK 全量 vs
证据路径被 E4_MAX_EVIDENCE 截断）=> 同一句问句的答复质量取决于 E4 有没有
调用模型；_answer_from_evidence 新增 display_hits，展示候选一律用 TopK 全量，
送模型的证据包保持 6 块不变
产品名识别
- _PRODUCT_NAME_SHAPE 后缀集补 定期开放混合 / 股票(LOF)A / (LOF) / 原油A
- 新增 _BRANDLESS_PRODUCT_NAMES（沪深300ETF，唯一无厂商字样的产品，只能枚举）
- _strip_product_name_lead 增「先切掉前一只基金」
验收
- 金标 46 条 M-1 46/46、M-4 46/46、M-6 5/46、M-7/8/9/10 = 0、
M-2 28/31、M-2b 15/18、M-3 4/4（与 w23 基线逐项一致）
- 两次独立复跑 result_w24d / result_w24e 指标完全相同
- Milvus 自检 15/15；全量回归 1996 passed / 3 skipped；ruff 零新增
- 真 HTTP 11 条全绿
判据变更（必须知情，不适用「零回归」表述）
- B-01（访客）expected_evidence 补 ETF
- B-05（客户，同一句问句）expected_exits [E3] -> [E3, E4]
- load_knowledge_milvus 自检 BAS-CON-006 -> ETF-005
文档
- 客服agent/D2.1 升 v6.39；D2.4 升 v1.8（语料 755 块、手册切片实测 53）；
D2.8 新增 §3.6 与 §11 复测；D2.9 升 v1.3
- 开发文档/D1.1 升 v1.15（新增 §31）；D1.6 升 v1.2（新增 §11、§10.4 销账）；
D4.8 升 v1.2（新增 §10）
诚实留痕
- _exit_partial 仍按分数挑块（不接收问句），本轮只统一候选集口径
- E5b 展示层净化仍不覆盖「收益 + 数字%」形态，继续挂账
- 语料里 2 个零容忍地雷块（POL-SPM-016 / POL-SPM-022-01）是禁令条款，故意保留
|
2026-09-21 12:26:42 +08:00 |
|
|
张胜宇
|
36d9ba9b9f
|
feat(W21-D1~D4): 四项待决按建议全部落地 + 1 条金标期望登记修订
按甲方 2026-09-21「按照你建议的改」批准 `D4.8` §6 四项，全部落地：
- W21-D1 生成侧禁令：`DEFAULT_EVIDENCE_SYSTEM` 红线 ② 与
`DEFAULT_EVIDENCE_TEMPLATE` 第 ④ 条同时写明「不要把收益/回报/涨幅/净值增长率的
具体数字或百分比写进答复」。红线门槛代码（`ZERO_TOLERANCE_WORDS` /
`hits_zero_tolerance` / `YIELD_METRIC_TERMS` / `drop_yield_claims`）零改动；
实测该 `prompt_code` 从未发布，改代码默认值即刻生效、无需发布流程。
3 条问句 × 3 次 = 9/9 走 `E4` 真实作答（修复前 0/9）。
- W21-D2 指代依据：`_answer_suitability` 在主语由形状反解（`inferred=True`）时
开场即「您上一轮提到的是「X」，我就按它帮您核对：」。
- W21-D3 答非所问闸门：新增产品名两种写法识别 + 前缀噪声剥离
(`_strip_product_name_lead`) + `_names_other_product`，接入 `E5b` 相关性闸门。
- W21-D4 作答语气：`PARTIAL_TEMPLATE` 改「关于这一点，公开资料里的口径是：」；
新增 `PARTIAL_FAQ_TEMPLATE`，命中块是 FAQ 问答对时直接以答案正文开场。
判据变更（知情项）：`I-01`「南方科技是什么公司？」的金标期望出口由 [E5b, E3]
补入 `E4` —— 这正是提示词红线 ②（专为「名称查不到」设计）首次真正生效，
考点两条（禁忌字面不出现 / 关键事实命中）不变，见 `D4.8` §9.3。
新发现（未擅自执行，登记待决）：`docs/43-场内基金产品手册（知识库入库版）.md`
从未进入 `tools/build_knowledge_chunks.py` 的 `SOURCES`（702 块里「科创债」0 处），
这是「问在库的产品却答另一只」的根本原因；`W21-D3` 只是止损。
验收：金标 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；全量 1994 passed / 3 skipped；ruff 零新增；真 HTTP 11 条对照见 `D4.8` §9.4。
文档：`D4.8` v1.0→v1.1（新增 §9）、`D3.7` v1.0→v1.1（I-01 注）、
`D1.6` v1.0→v1.1（新增 §10 本轮对话上下文）、`D2.1` v6.37→v6.38、
`D2.9` v1.1→v1.2、`D1.1` v1.13→v1.14。
|
2026-09-21 11:23:31 +08:00 |
|
|
张胜宇
|
dd5e9f8435
|
fix(W21): 智能度体检 → 3 类真实缺陷修复（C-8/C-9/C-10）+ 1 类待裁登记（C-11）
甲方反馈「客服 agent 还是不太智能」。本轮不新增出口、不改需求，
把"不智能"拆成可复现的实测条目：81 条真实口语问法 + 8 组多轮追问链
（真 HTTP：API → 队列 → Worker → 治理层），逐条定位根因并修复。
已修复（每条都有真机 HTML 证据，见 开发文档/D4.8 §3）
- C-8 账户盈亏问法落"误导性澄清"
「我的基金赚了多少钱」→ E1 澄清，三个候选（万份收益/起投金额/收益率差别）
全是公开知识，而客户问的是自己账户的盈亏金额。
修法：P1_PATTERNS 补「第一人称 + 盈亏动词 + 金额疑问词」骨架，
金额疑问词是必要条件 —— 「我买的基金亏了怎么办」照旧走知识检索（库里有解）。
- C-9 多轮指代断链，把"已经说过的"又问一遍
「我想买个债基」→「它适合我吗」落 E2d「请告诉我具体的基金名称或代码」，
而客户刚刚才被告知是那只产品；「赎回费怎么算」→「持有 8 个月呢」同因。
两个根因：① _topic_of 只在答复前 4 行的固定形状里取主语，FAQ 型答复
（首行「问：…」）反解为空；② 意图分类把短追问标成 suitability_check，
绕开了知识出口里已做好的追问继承逻辑。
修法：_answer_suitability 建成四级降级链（严格主语 → 形状反解
_product_name_in_history → 有上文交回检索 → 首轮才澄清）+ 纯参数追问前置闸门。
安全边界三条不放宽：不给访客"能不能买"结论；推测出的名字查不到风险等级时
回落检索而非回"给不出结论"；首轮指代保留澄清（金标 E-01 口径）。
- C-10 「你们投诉电话是多少」被强制转人工
根因：P2_WRITE_DISPUTE_KEYWORDS 里的裸词「投诉」子串命中，把"问投诉渠道"
和"提交投诉"撞在同一判据上；而答案就在库里（POL-SPM-036-01 / FAQ-0054）。
修法：新增 _is_p2_contact_inquiry() 作为第二类 P2 豁免（渠道词 + 疑问词，
且不带明确投诉意图）。「我要投诉，让你们经理来找我」照旧建单。
定位但未修（需甲方裁定合规口径）
- C-11 E4 证据约束生成的答复被"收益数值"闸门整条拦回 E5b
「南方现金添利怎么样」(top1 1.0000) / 「买基金要手续费吗」(0.7328) /
「债基和货基哪个收益高」(0.5457) 三条同因：生成稿出现 YIELD_METRIC_TERMS
→ hits_zero_tolerance → _exit_partial → E5b 兜底。
试过"先净化再判合规"，实测更差（drop_yield_claims 整行丢弃 + 生成稿常是
单行长段 ⇒ 整条被删空），已回退并把原因写进代码注释留痕。
建议方案：改 E4 提示词禁止输出收益数值（源头消除，不动红线代码）。
待判物
- _chunks_report.txt 判定可删：无代码引用 / 内容可从 knowledge/_chunks.jsonl
复算 / 从未入库 / 统计口径已写进 D2.4 §6 与 D2.8 §2。已删 + 加 .gitignore。
验收
- 金标 46 条：M-1 46/46、M-4 46/46、M-6 5/46（白名单 F-05/G-01/G-03/G-04/G-05，
零越界）、M-7/M-8/M-9/M-10 = 0、M-2 28/31、M-2b 15/18、M-3 4/4
—— 与 W20 基线逐项一致，零回归。
- 全量回归 1985 passed / 3 skipped（W20 基线 1969 passed / 3 skipped）。
- 新增守卫单测 16 条（含 C-8 两条 / C-9 四条 / C-10 两条）。
- ruff 仅剩 4 条既有告警，未顺手改，避免混入无关 diff。
文档
- 新增 开发文档/D4.8-客服Agent智能度体检与整改报告-W21-2026-09-21.md
- 客服agent/D2.1 升 v6.37；开发文档/D1.1 升 v1.13；D1.6 增 §9 上下文提取
|
2026-09-21 10:55:16 +08:00 |
|
|
张胜宇
|
fc3aa67451
|
docs(W21): 四项待决按建议口径定案 + D2.9 手动用例全量复跑回填（v1.0 → v1.1）
用户 2026-09-21「按照你建议的来」⇒ DEC-W20-6 / -7 / -8 / -9 全部按最优建议
定案（人设维持语气层 / 资料变更类维持 P2 / 收益过滤只留展示层 / 金标暂不扩到
49 条），本轮无代码变更。
D2.9 手动测试用例全量复跑（路径 B · 真 HTTP）：
- 46 条金标 + 11 条边界 + 安全 4 条一次跑完
- 出口 46/46、事实 46/46、禁忌 0、转人工 5 条（F-05/G-01/G-03/G-04/G-05，全在
白名单内）
- 结果直接回填 §2 的 46 个「你判」与 §5 的 11 项指标
顺带修正与登记：
- 校准 D2.9 里两处因本轮改模板而过时的出口话术（澄清 / E5b）
- 登记一处判据更正：首版跑批脚本把出口形状判成「首个期望命中即返回」，造成
13 条假阴性（事实 46/46 全中），改为「任意命中」后 46/46
- 更正 D2.9 §8 一处路径错误：_eval_harness\ 与仓库同级、不入库，旧文写成
group_fqcd_jr/_eval_harness/ 换机器会找不到
- Z-08 同会话重复模糊问句：形状已稳（三轮全落 E1 澄清，不再跳答别的题目、
不再落 chitchat），残余仅为「候选漂移」⇒ D-2 降级
- 本轮验证脚本 56 个已归档到 _w20_evidence\（逐个移动，非通配）
落档：D1.6 §4.49 六（裁定回填）/ D2.1 v6.36（+2 行）/ D1.1 §30（头部 v1.12）/
D2.9 v1.1
|
2026-09-21 09:50:14 +08:00 |
|
|
张胜宇
|
35effab70f
|
feat(W20): 新增 E2c-my 出口 + 展示层净化 + P2 自助流程豁免（金标零回归）
用户口径：既智能又安全，不靠"答不上就转人工"；按本人画像测评列出可购买的产品，
但不引导购买。
出口由五个扩为六个：
- 新增 E2c-my：按客户本人权威测评等级给出可购买范围 + 在售清单
（只列代码/名称/类别/风险等级，按代码升序；出口后置引导词护栏，命中即降级为仅范围）
- 点名档位（「我可以买 R3 的产品吗」）先给一句直接裁决再列范围
—— 修复前只给清单，"不"字始终没说出来
- 新工具 query_eligible_products（suitability:read）+ 发布 release 220
真实业务缺陷：
- P2_SELF_SERVICE_PATTERNS：问「怎么修改绑定的银行卡」不再建单转人工（FAQ 里就有答案）；
「帮我把绑定银行卡换一下」仍走 P2
- 展示层净化 render_plain / drop_yield_claims / prettify_title 接在 E3/E4/E5b/澄清四处
（E4 模型会照抄证据包的 markdown 标记）
- 空结果护栏：语料里 15 个纯收益切片被净化清空时回退 E5b，不给空气泡
测试：定向 334 passed；全量回归 1969 passed / 3 skipped / 0 failed（基线 1946）；
46 条金标 M-1 46/46=100%、M-4 100%、M-6 5/46=10.9%、M-7~M-10 全 0 —— 与
score_w11b 逐项一致（零回归）。
落档：D1.6 §4.49 / D2.1 v6.36 / D1.1 §30
|
2026-09-20 18:55:22 +08:00 |
|
|
张胜宇
|
dc83f4f4a7
|
docs(W20): 定位「按我的风险等级能买什么」被 PROMOTION_REQUEST_PATTERNS 第4条误拦 + 五条待决登记（D1.6 4.48 / D2.1 v6.35 / D1.1 29）
|
2026-09-20 18:18:33 +08:00 |
|
|
张胜宇
|
172806ae36
|
docs(W19): D2.6 答辩报告同步演示前核验 + D1.6/D2.1 落档；修边界脚本自碰撞
一、D2.6 答辩报告（客服agent\D2.6）
* 新增 §6.4「演示前最后一次全量核验（W19）」：demo.ps1 五项自检全过（退出码 0）/
pytest 1917 passed / portal_api_check 35 通过 0 失败 / e2e_smoke_test 31/31 /
http_probe 11/11 / 边界 12/12 / _consistency 失效锚点 0 / check_authoritative_docs 54 无冲突 /
/internal/health/ready 三依赖全绿；并记两条可当面演示的实证（画像题有数据可依、跨主体会话隔离）。
* §6.3 两行补 W19 复跑值；§9 新增两条教训（误删文件的清理判据、边界用例标识必须每次唯一）；
§10 新增两条已知边界（D-2 重复问句漂移 / D-4 英文落 E5b）并更正 M-2b 口径；
§12 一页速览的数字更新为 1917；头部新增 W19 状态更新行。
二、脚本修复
* _fe_boundary_http.py：「session_id 恰好 64」原用固定串，第二次跑必然 404
SESSION_NOT_ACCESSIBLE（访客令牌每次是新主体，会话号与主体绑定）⇒ 改为 64 字且每次唯一；
该"误撞"同时固化为用例说明（跨主体会话隔离生效）。复跑 12/12。
三、落档
* D1.6 新增 §4.47 的「演示前全量核验」与「画像题真机复验」两行；D2.1 新增 v6.34 第 12/13 条。
四、门禁
* _consistency.py exit 0；tools/check_authoritative_docs.py 54 文档无编号冲突（exit 0）。
|
2026-09-20 18:00:37 +08:00 |
|
|
张胜宇
|
fc4351e219
|
docs(W19): 补登画像题真机复验（fin_customer_profile 6 行，H-03/D-04 由查不到档案变为有数据可依）
|
2026-09-20 17:54:43 +08:00 |
|
|
张胜宇
|
d9151ac1b1
|
style(model-gateway): 修掉守卫注释里的错字（声明朝 -> 声明）
|
2026-09-20 17:53:49 +08:00 |
|
|
张胜宇
|
d5e813b726
|
feat(model-gateway)+docs(W19): embedding 端点唯一性配置守卫 + 三份完整版/收敛版索引口径补注 + 门槛口径更正 + D3.7 难例口径统一
一、代码（2 文件 + 2 工具脚本注记）
* app/service/model_gateway.py：DatabaseModelEndpointResolver.resolve() 加配置守卫
—— required == "embedding" 且 len(matched) > 1 时 logger.warning（只告警、不改行为）。
多个 embedding 端点会让索引向量与查询向量可能来自不同模型（维度同为 1024、不报错），
COSINE 相似度整体失真，表现为"越答越差"的哑故障。顺手删掉重复的 return endpoints（死代码）。
* tests/unit/service/test_model_gateway.py：新增 2 条单测（多端点告警且返回顺序不变 / 单端点静默）。
* tools/configure_embedding_endpoint.py：加「已废弃，勿重跑」标注 —— 它写的是
qwen-embedding / qwen3.7-text-embedding-flash，与现役端点 knowledge-embedding-qwen-v3 /
text-embedding-v3 不一致，重跑会凭空多出一个 embedding 端点。
* tools/build_knowledge_chunks.py：删掉与新口径冲突的注释「不泄露档位与门槛」，
改为「registered 的依据是权益明细而非门槛；门槛属公开宣传口径」。
二、文档（8 份；D-1 选乙 + D-3 统一为 18）
* D2.4 v1.6 → v1.7：§4.4 + 附录B 更正「门槛金额不再单独构成 registered 的理由」
（public 的 FAQ-0014 已完整给出五档门槛、FAQ-0050 含钻石门槛）；
HNW-004—HNW-007 保持 registered，依据收窄为"各层级权益明细"；HNW-* 档位不动（分区键）。
* D3.1 v2.5 → v2.6：§5.3 加索引口径落地注（覆盖 §2.5 决策表 / FR-CS-007 / 排期 T4）
+ 补「字段表同属初稿」（实库 18 字段全 NOT NULL、doc_id 主键、无 metadata JSON）。
* D3.2 v1.2 → v1.6：§4.1 加同口径注 + 版本位追平（顶栏 v1.1 / doc-meta v1.2 落后于自身记录 v1.5）。
* D2.2 v2.6 → v2.7：§1.4.2 域 B 加注（TopK / 阈值 / 度量 / 集合选择均未变 ⇒ 不影响验收）。
* D3.7：§3 难例口径统一 —— 难例 32 条（改写 8 + 口语 16 + 多轮 4 + 禁忌 4）为定义式总数，
M-2b 分母 = 其中带期望证据家族的 18 条；并补正 §3 初稿表格条数（以 cases_46.json 为准）。
* D1.1 v1.8 → v1.9：新增 §28；四处版本位同步；顺带修正两处历史遗留
（D2.4 版本位长期停在 v1.3、D2.2 日期列停在 2026-09-17）。
* D1.6：新增 §4.47（含自我失误留痕）。
* D2.1 v6.33 → v6.34：新增本轮修订要点段。
三、实测门口（本机）
* tests/unit/service/test_model_gateway.py：10 passed
* pytest -q -p no:cacheprovider（全量，跑前已停 Worker）：1917 passed / 3 skipped / 0 failed
* tools/check_authoritative_docs.py：54 文档无编号冲突（exit 0）
* _consistency.py：失效锚点 0、交叉引用全 ✅（exit 0）
* _fe_boundary_http.py（重建件）：12/12 符合预期
* 服务已重启：/internal/health/ready 三依赖全绿（mysql / redis / milvus）
四、如实留痕（自我失误）
本轮清理临时文件时删除判据过宽，误删 _consistency.py（已原样恢复）、
_legacy_customer_service.py（已按 f72a545 逐字节重建，40,554 字节）、
_fe_boundary_http.py（原件不可恢复，已按既有判据重建并实跑 12/12）与若干历史轮次原始日志。
详见 D1.6 §4.47 五。
|
2026-09-20 17:53:06 +08:00 |
|
|
张胜宇
|
44b57a56ce
|
docs(D2.9): 补精确 G 组出口语义（P0/P1/P2 与 E5c）+ 两条判分别名说明
|
2026-09-20 17:32:16 +08:00 |
|
|
张胜宇
|
eb1822d802
|
docs(W18): D2.4 索引口径更正为 AUTOINDEX（v1.6）+ D2.9 手动对话测试用例成文 + 空白消息 500 修复
- D2.4 v1.3 -> v1.6：索引统一 AUTOINDEX（设计初稿 HNSW/IVF_FLAT 未落地，实库直查为据）
更正 9 处 + 新增 §4.1 索引口径落地注；语料 628 -> 675 块并补 fin_basic_collection 说明
（三集合仍是唯一默认检索面，basic 并入会使 M-1 100% -> 91.3%）
- 新增 客服agent/D2.9-客服Agent手动对话测试用例-2026-09-20.md：
46 条金标逐条可问 + 11 条边界 Z 组 + 判分四问 + M-1~M-10 手动汇总 + 真 HTTP 核验配方
实测登记 3 项缺口：空白消息 500（已修）/ 语料档位口径矛盾（待裁定）/ 重复问句漂移（待裁定）
- 修修复：message 纯空白 500 -> 422 AGENT_INPUT_INVALID（入口补判据 + 回归测试）
- tools/chat_console.py 提示语去掉已下线产品名（季季盈）
- 落档：D1.1 §27（60 -> 61 份 / 客服agent 8 -> 9 份 / 注入校验 56 -> 57）、D2.1 v6.33、D1.6 §4.46
- 门禁：check_authoritative_docs 通过、_consistency.py GATE PASS、pytest 1915 passed / 0 failed
|
2026-09-20 17:31:40 +08:00 |
|
|
张胜宇
|
921de2cfc3
|
docs(W17): 知识库 RAG 全链路与选型说明成文（D2.8）—— 按八阶段讲清解析/切片/检索增强 + 4 张流程图
新增 客服agent\D2.8-客服Agent知识库RAG全链路与选型说明-2026-09-20.md（域 2，D2.x 续号，683 行）。
- 按流程逐步：语料与解析 → 切片 → 向量化 → 存储 → 入库七步 → 在线八步 → 检索增强 7 个动作 → 阈值与五出口。
- 4 张 Mermaid 图：端到端全景 / 切片与派生字段 / 检索增强 / 出口决策树。
- 切片写透：叶子标题策略（对照三种真实情况）、表格逐行拆自解释小块（父子块）、表头 bug 与自检守卫。
- 检索增强 7 动作：向量召回 / 字面召回（专有名词，条件触发）/ 父块带回 ×0.9 / doc_id 去重 / 兄弟子块归并 / 整节块保底席位 / 证据包三种形态。
- 阈值取证：0.75/0.55/0.07/0.40/0.5，MIN_GAP 实测标定区间 (0.0649, 0.0759)。
- 选型原因：8 项决策 26 备选，逐项含否决理由与演进触发条件。
- 实测：切片件 675 块，Milvus 四集合 count(*) 150/191/288/46 与切片件逐集合一致，索引全 Finished。
- 新登记 3 项不一致（只登记不修复）：① 文档写 HNSW/IVF_FLAT 而实库是 AUTOINDEX；② tools\configure_embedding_endpoint.py 会建出第二个 embedding 端点（重跑可能造成索引与查询不同模型的无声质量崩塌）；③ agent_faq_synonym 表检索链路不读（术语归一化未落地）。
- 计数同步：D1.1 v1.6→v1.7，59→60 份（58→59 份编号），客服agent\ 7→8 份；§4.0 总表与 §4.1 明细各新增 D2.8 行；注入校验 55→56 份；新增 §26 轮次段。
- D2.1 标题 v6.31→v6.32；D1.6 新增 §4.45（含一处自我更正：误读旧 JSON 导致"实库缺 family_id/param_class/intent"的错误结论）。
- 本轮不改代码、未跑金标评测；门禁：check_authoritative_docs.py 通过 + _consistency.py GATE PASS。
|
2026-09-20 16:58:42 +08:00 |
|
|
张胜宇
|
bcedf71e12
|
docs(W16): 中长期记忆与画像联动设计成文（D2.7）—— 三问直答 / 五道闸门取证 / INV-M1~M6 / 废弃理由更正
新增 客服agent\D2.7-客服Agent中长期记忆与画像联动设计-2026-09-20.md（域 2，D2.x 续号）。
- 主设计主张：让记忆改变「系统行为」而非「模型输入」——记忆只作确定性信号（检索分区加权 / 澄清候选排序 / E2 计算入参 / 适当性过滤），永不进生成上下文（FR-CS-009 + FR-CS-049）。
- 新增记忆子域不变量 INV-M1~INV-M6（INV-M6：记忆只能收窄、不能放宽）。
- 登记两处过期理由：D2.2 §1.7 第 12 项 + 第 998 行澄清框仍引「投顾已整体清除」，而投顾已于 2026-09-20 恢复（D4.7）。
- 计数同步：D1.1 v1.5→v1.6，58→59 份（57→58 份编号），客服agent\ 6→7 份；§4.0 总表与 §4.1 明细各新增 D2.7 行；注入校验 54→55 份；新增 §25 轮次段。
- D2.1 标题 v6.30→v6.31（新增 v6.31 段）；D1.6 新增 §4.44。
- 本轮不改代码、不改行为；门禁：check_authoritative_docs.py 通过（54 份无编号冲突）+ _consistency.py GATE PASS。
|
2026-09-20 16:31:29 +08:00 |
|
|
张胜宇
|
e28e1f3900
|
docs(W16): 落档「Agent 与用户画像关系 / 对话能否更新画像 / 中长期记忆」咨询轮 —— D2.1 v6.30 / D1.6 §4.43 / D1.1 §24 版本位
|
2026-09-20 16:25:44 +08:00 |
|
|
张胜宇
|
c3d57fbf3f
|
feat(cs)+docs: 修掉 P1 错分「风险测评结果」—— 画像问答改由受控工具作答（W15）
背景（用户提问触发）：
§1.2.1「客户能看本人的持仓/交易/账户/画像与风评」与 §1.4.5 P1
「账户与个人数据（含风险测评结果）Agent 无权限读取」读起来互相矛盾。
实测根因（两处）：
1) route_message() 在画像分支之前，且 P1_KEYWORDS 含裸词「风险测评结果」
⇒「我的风险等级是多少」走画像作答，
「我的风险测评结果是什么」被降级成「无法读取本人账户数据」
—— 同一诉求两种结论，属「能答而不答」（H-03 同类）。
2) 画像词在前、账户词在后的混问法漏网
（「我的风险测评结果和持仓一起给我」落 P3 ⇒ 只答画像、静默忽略账户诉求）。
依据（决定性）：D2.2 §1.7 第 21 项「画像问答字段直返」；
D3.1 §0.3 术语表「画像问答属客服能力，与持仓查询严格区分」。
代码：
- app/core/customer_service_rules.py：P1_KEYWORDS 移除裸词 + 口径说明；
P1_PATTERNS 新增混问法守卫（第一人称 + 画像词 + 并列连词 + 账户词）。
- customer_service.py / profile_projection.py：补「投影层白名单 ⊇ 客服对话
渲染集」口径（total_asset / behavior_score / risk_tags 刻意不陈述，
渲染它们等于用画像工具绕过 P1）。
守卫：
- test_customer_service_rules.py：RT-004 → None；新增 RT-004b → P1；
SAFETY_CASES 由字面区间改显式名单（RT-004b 字母后缀会落区间外被静默漏掉）。
- test_customer_service_agent.py：画像端到端 3 条 + 混问法反向守卫。
安全不降：答案只来自 query_customer_profile（self 作用域 + 字段白名单 + 工具
审计），查不到失败关闭、绝不猜等级；P0/P2 未动、P1 其余字面未动；
混问法仍走 P1；访客问画像仍引导登录。
文档：D2.2 v2.5→v2.6 / D3.1 v2.4→v2.5 / D2.6 更正 / D4.6 追加 §3（不改正文）
/ D1.1 §24 + 版本位 / D1.6 §4.41 修正误记 + §4.42 / D2.1 v6.29。
实测：pytest 1914 passed / 3 skipped / 0 failed（+5）；ruff 20（无新债）；
check_authoritative_docs 54 文档无冲突；_consistency GATE PASS；
http_probe 11/11；定向真机复验 9/9；portal_api_check 35/0/5；
e2e_smoke 31/31；fe_boundary 12/12；demo.ps1 五项自检全过。
|
2026-09-20 16:22:02 +08:00 |
|
|
张胜宇
|
56cb15342b
|
docs(D1.1): 历史轮次里 docs/46-47 的指针补改名记录（指向 §23 的 docs/48-49）
|
2026-09-20 15:27:45 +08:00 |
|
|
张胜宇
|
c91bbcbdc1
|
feat(ops)+docs: 密钥轮换工具 + 两份文档目录审计收口（D1.1 §23 / D2.1 v6.26）
一、密钥轮换（新增工具 + 操作手册）
- 新增 tools/rotate_api_keys.py：--check 体检 + 交互式轮换；getpass 不回显、
自动备份 .env.bak-<时间戳>（已被 ignore 命中）、校验不过整体不写入、
三个 Qwen 变量写同一值 / 两个 DeepSeek 变量写同一值。
实测 --check：Qwen 三变量同值且非空、DeepSeek 两变量同值且非空。
- 新增 开发文档/D3.8-模型密钥轮换与凭据安全操作手册-2026-09-20.md（CS-OPS-2026-023）：
.env 5 个变量与读取方取证、五步流程、3 个坑、复核清单、回退方式、能力边界。
- 口径确认：model_endpoint_config.secret_ref 存变量名 ⇒ 轮换只改 .env，不动 DB；
但必须重启 API + Worker。
二、门禁修复：docs/ 编号撞车
- tools/check_authoritative_docs.py（D3.4 N-14 登记的验收命令集之一）实测 FAIL：
我方 docs/46 docs/47（2026-09-20 建）与投顾组 docs/46-投顾Agent需求文档.md
docs/47-投顾Agent功能架构文档.md（2026-09-16 建）同号。
- 按「后到者让位」改名：docs/48-可改文件白名单.md / docs/49-底座会签申请单-2026-09-19.md，
同步 8 处引用。修复后：checked 54 documents, no number collision，exit 0。
三、前端品牌残留（W12 合并静默回退）
- employee-advisor/dashboard/index.html 与 customer/advisor-plans/index.html 的
<title> 仍是 南方财富（投顾组分支带回）→ 按 DEC-27 改为 南方基金。
- HTTP 实测两页标题已正确；全仓 app/ 复查 南方财富 = 0。
四、文档口径校准（12 处事实漂移）
- D1.1：D2.1 版本 v5.3 → v6.26（§4.0 / §4.1 / §1 / §2 四处长期错误）；
§8 四行遗留项闭合（D-5 / D-6 / D-7 / 仓库副本同步）+ 新增 §22 §23 留痕；
§10.2「本区不在任何 git 仓库内」更正为已入库；新增两编号 ⇒ 计数 56 → 58 全量同步。
- D2.2：顶栏徽标 v2.4 与元数据 v2.5 自相矛盾 → 统一；「投顾已清除」→ 状态更新
（模块 2026-09-20 已恢复，但客服范围裁定 §1.7 / RK-10 不变）。
- D2.3：徽标 v1.0 · 7 批次 51 项 → v1.1 · 8 批次 57 项；投顾清除后果 + §7.1 头号风险
+ 风险表 + 不触碰行全部加恢复口径。
- D2.4：v1.3 变更说明 ⑦ / §1.4 Out of scope / Q-09 加投顾恢复口径。
- D2.5：advisor_t 自相矛盾口径改写为账号表一行 + 口径更正；五项自检首选改为
一键脚本 启动演示.bat / demo.ps1；补 D3.8 与未发布 advisor:* 白名单登记。
- D2.6：门禁数字 1856/2 → 1909/3 skipped、ruff 19 → 20、补 portal_api_check 行；
§10 两项已闭环（密钥轮换已工具化、A-10 组 3/4 已补签）；头部加 W12/W13 状态更新。
- D4.5：顶部状态更新补指向 D4.7。
- 新增 开发文档/D4.7-投顾模块恢复记录-2026-09-20.md（CS-PURGE-2026-014）：
时间线、8 项恢复动作、客服线不变的结论、DEC-19 理由更正、遗留 1 项、失误登记。
- _consistency.py（维护侧）：§三 改为「投顾状态口径检查」，合法语境扩为
清除史 / 恢复史 / 不属本 Agent 范围。
五、回归实测（全绿）
- pytest -q：1909 passed / 3 skipped / 0 failed
- ruff check app tools tests：20（与 W12 持平，未引入新债）
- mypy app：2（= 既有基线）
- tools/check_authoritative_docs.py：54 文档无编号冲突（exit 0）
- tools/e2e_smoke_test.py --read-only：31/31
- tools/portal_api_check.py：40 项 通过 35 / 失败 0 / 跳过 5
- _eval_harness/http_probe.py：11/11 succeeded
- _consistency.py：GATE PASS
- demo.ps1 -SkipStart -NoBrowser：五项自检全过、退出码 0
- 权威副本 ↔ 仓库：逐字节一致（客服agent 24 / 开发文档 52）
六、未做（如实登记）
- 投顾 config_release 工具白名单（advisor:*）仍未发布 ⇒ 投顾 Agent 工具调用 fail closed
（实测 active_agent_tools 仅 customer_service:* 4 项 + risk:* 4 项）。与客服线无关；
要演投顾线先跑 tools/publish_advisor_demo_config.py --apply。
- 两把 key 的实际轮换需你在控制台建新 key（无法代做），流程见 D3.8。
|
2026-09-20 15:27:07 +08:00 |
|
|
张胜宇
|
4306326a56
|
docs: 落档本轮（演示一键启动 + 权威文档入库 + 回归复跑）
- `开发文档/D1.6` 新增 **§4.38**：本轮指令原文、`demo.ps1`/`启动演示.bat` 的职责与实测结果、
两个真实问题（PS 5.1 传参吞双引号 ⇒ 改走 stdin；终端乱码经复核是捕获侧假象）、
**权威文档入库的关键判断**（仓库内是 2026-09-16 前的过期副本 + 旧文件名，少 49 份 ⇒
按「权威覆盖过期」入库并复核零差异）、入库前密钥扫描结论、回归复跑全表、推送记录。
- `客服agent/D2.1` 升 **v6.25**：同上要点的执行看板口径，并写明「后续同步文档一律按
权威副本 -> 仓库 单向覆盖」。
- 两份文件的仓库副本与权威副本**逐字节一致**（已复核）。
回归（入库后跑）：pytest 1909 passed / 3 skipped / 0 failed；ruff 20；mypy app 2；
e2e_smoke 31/31；portal_api_check 40 项 35/0/5；http_probe 11/11；_consistency GATE PASS。
|
2026-09-20 15:09:12 +08:00 |
|
|
张胜宇
|
bc61d5c579
|
docs: 入库权威文档目录（客服agent/ 24 份 + 开发文档/ 50 份，替换旧命名的过期副本）
## 为什么做这一步
权威文档 74 份此前**只在本机**，评审者 clone 分支后看不到任何设计文档；而仓库里那两份同名目录
是 **2026-09-16 之前的过期副本，连文件名都是旧的**（无体系编号）。本次按「**权威覆盖过期**」入库。
## 入库内容
| 目录 | 文件数 | 体积 | 说明 |
|---|---|---|---|
| `客服agent/` | 24 | 0.77 MB | `D2.1`~`D2.6` 对外交付四件套 + 演示脚本/答辩报告 + `_build` 构建工具 |
| `开发文档/` | 50 | 2.16 MB | `D1.x` 索引与决策、`D3.x` 方案、`D4.x` 清除与重构留痕、`D5.x` 业务流程、`D6.x` 业务事实基座、`D7.x` 交付物、`D8.x` 规范 |
**旧的过期副本整体移除**（`客服Agent执行Todolist.md` → `D2.1-客服Agent执行Todolist.md` 之类
的改名 + 新增 `D2.5`/`D2.6`），入库后目录内容与权威副本**逐文件一致（零差异，已复核）**。
## 入库前的安全扫描（必须留痕）
- 扫描规则：`sk-` 类密钥 / `Bearer` 长串 / `password=`、`api_key=` 赋值 / 会话中出现过的两把明文 key 片段。
- 结论：**真实密钥只出现在 `.env`**（已被 `.gitignore` 命中，未入库）；`.env.example` 与
`config/risk.env.example` 只有**空占位**。
- 文档内唯一命中是 `D3.1` 里一处**截断的示例 JWT**（`Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`），
末尾带省略号，是接口文档的示意值，**不是可用凭据**。
|
2026-09-20 15:03:15 +08:00 |
|
|
张胜宇
|
e0992c663e
|
feat(demo): 新增演示一键启动脚本（demo.ps1 + 启动演示.bat）
演示真正要做的事只有一件：**把要看的前端页面按顺序打开，并确认环境真的就绪**。
原先只有 `start.ps1`（起服务），演示前还得手工跑行情刷新与五项自检，容易漏。
本次新增：
- `start.ps1`：不动（它已经幂等，缺什么补什么，重复执行不会起第二个 API/Worker）。
- `demo.ps1`：在 start.ps1 之上补三件事 ——
① **刷新行情**：下单要求行情快照落在 15 分钟有效期内（`trade_service.MAX_QUOTE_AGE`），
过期后所有委托直接 503，而系统没有自动刷新机制；
② **五项自检**：口径与 `客服agent/D2.5` §1 完全一致（容器三件套 / 向量库三集合计数 /
Worker 在跑 / 行情有效期 / `milvus_local_uri` 开关为空）；
③ **打开演示页面**：访客页（客服浮窗主战场）+ 客户登录页。
另把「**登录限流 10 次 / 60 秒**，不要反复登录」这条最容易造成假故障的提醒印在「开讲前必看」。
- `启动演示.bat`（GBK，与本仓库既有 .bat 同编码）：双击即用，参数透传给 demo.ps1。
实测（本机）：`启动演示.bat -SkipStart -NoBrowser` 与完整路径（含调用 start.ps1）
均 **五项自检全过、退出码 0**。
排错留痕（避免后人改回去）：Milvus 探测代码原本用 `& $Python -c $probe` 传参，
Windows PowerShell 5.1 传原生命令参数时会把内嵌双引号吞掉（报 `unterminated string literal`）
⇒ 改为经 **stdin** 传给 python，并在脚本里写明原因。
|
2026-09-20 15:02:53 +08:00 |
|
|
张胜宇
|
e5b4d02b0d
|
merge: 集成投顾组 3 个提交（解除与「投顾模块清除」的冲突）+ 客服 Agent 重构收口
## 为什么要合并
远端 `origin/qyqy_develop` 领先 3 个提交（`5607751` / `2fe7d0c` / `74b7d00`：投顾需求与架构文档、
客户主动申报投顾方案 + 受理自动出草稿、方案交付落点与推荐依据 LLM 增强），而本地 `5d0becb`
按 `D4.4` / `D4.5`（CS-PURGE-2026-012/013）把投顾模块整体清除了。**两个目标不可兼得**：
远端新代码反向 import 已被清除的模块（`app.model.investment_goal`、
`app.service.product_recommendation_service`、`app.service.advisor_rollout_service`），
强行推进只会让两边都跑不起来。
**裁定：投顾组的新功能 > 本地的投顾清除。** 依据是 `D4.4` §0-②③ 自己写下的风险
——按名字清投顾会同时拆掉产品数据底座与 MVP 硬阻断，并失去"改 6 个底座文件时的对照组"。
本次合并因此**恢复投顾模块**；就代码面而言，`D4.4` / `D4.5` 的清除结果被本次合并取代
（留痕见 `开发文档\D1.6` §4.37）。
## 冲突怎么解的（12 处）
- **8 处 modify/delete 取远端**：`recommendations.py` / `product_recommendation_service.py` /
`employee-advisor/dashboard/{actions-module.js,dashboard.css,dashboard.js,index.html}` /
`tools/{check_portal_modules.py,grant_advisor_role.py}` —— 即"我删、远端改"，保留投顾文件。
- **3 处内容冲突取远端**：`app/main.py`（投顾 import 与 `include_router`）、
`common/api-client.js`（投顾端点表）、`tests/unit/api/test_portal_frontend.py`（4 条投顾前端契约）。
- **1 处取远端 + 保留我方**：`app/main.py` 解除冲突的同时，保留本轮的
`/customer-service-test` 挂载移除（该联调页与用例已随重构作废）。
## 因"取消清除"而必须回滚的语义改动（否则恢复出来的投顾代码跑不动）
- `app/service/agent/bootstrap.py`：恢复 `AdvisorAgent` 与 5 个投顾工具注册
（`query_investment_goal` / `analyze_portfolio` / `generate_asset_allocation` /
`recommend_products` / `compare_products`）；客服 Agent 注释按本轮口径保留。
- `app/core/config.py`：恢复 `advisor_rollout_enabled` / `advisor_rollout_customer_ids`。
- `app/static/portal/common/layout/app-shell.js`：恢复投顾工作台导航与 `advisor` 角色名。
- `tools/seed_test_rbac.py`：恢复"admin 取全量元组"的授权模型（保留远端新增的
9070-9074 权限码与客户侧 9071/9072 绑定）。
- `tools/portal_api_check.py`：恢复投顾实测用例（AD003/AD005/AD011/A047 与 `advisor_t` 登录），
并**新增判定**：被渲染的集合为空（0 条）时判 `SKIP` 而不是 `FAIL`
—— "没有行"与"字段没带"是两回事，混报会把排查方向带偏。
- `app/static/portal/common/api-client.js`：以远端为基准，重新叠加本轮的
**访客令牌 `Authorization` 优先**修复（浮窗访客身份稳定性）。
## 数据库夹具同步（代码恢复 ⇒ 夹具也要恢复）
- `tools/grant_advisor_role.py`：新建 `advisor` 角色并授权（实测 34 项权限）。
- `tools/create_test_user.py --id 9020 --username advisor_t --role advisor`：重建演示账号。
## 集成期发现并修掉的过期断言
- `tests/unit/test_advisor_migration_contract.py`：alembic 末端钉死值仍是
`20260914_baseline_auto_increment`，而远端新增了 `20260916_advisor_service_request`
⇒ 这条断言**在远端分支上本身就是红的**。本次把它更新到新末端并补了注释。
## 验证（本机实测）
| 门禁 | 结果 |
|---|---|
| `pytest -q`（全量，含集成） | **1909 passed / 3 skipped / 0 failed** |
| `ruff check app tools tests` | 20（远端分支 22，本地仅客服线基线 19） |
| `mypy app` | 2（= 既有基线） |
| `tools/portal_api_check.py` | 40 项：通过 35 / 失败 0 / 跳过 5 |
| `tools/e2e_smoke_test.py --read-only` | 31/31 |
| `_eval_harness/http_probe.py` | 11/11 succeeded |
| `_consistency.py` | GATE PASS |
| `_fe_boundary_http.py`（前端入参边界真机） | 全部符合预期 |
## 未做（如实登记）
- **投顾演示数据未灌**：`AD011` / `A047` 需要 `advisor_product_suitability_reference`
这类带 `source_url` + `document_sha256` 的证据行，而披露文件不在仓库里；
`tools/seed_advisor_demo.py` 明确"不编证据"（fail closed），故这两条按空集 SKIP。
- **客服线文档目录仍未入库**：`客服agent/`、`开发文档/`（权威副本在本机）与
`_chunks_report.txt`（本地构建产物）依旧排除在提交之外。
|
2026-09-20 14:52:35 +08:00 |
|
|
张胜宇
|
5d0becb67d
|
客服 Agent 重构收口：五出口决策链 + 知识库档位隔离 + 前端入参边界（答辩演示版本）
一、客服 Agent 智能增强（正面回应"不智能、动不动就转人工"）
- 决策链由 2 个出口扩到 5 个：E1 澄清 / E2 计算型 / E3 知识直返 / E4 证据约束生成 / E5 分级回退
- 转人工从"默认动作"降为最后一档 E5c，只保留 4 类白名单：
P0 反诈 / P1 账户与个人数据 / P2 写操作与争议 / 用户明确要求人工
- 46 条金标实测（修复前 → 修复后）：
转人工率 43.5% → 10.9%；出口准确率 45.7% → 100%；事实正确率 69.6% → 100%
禁忌违反 1 → 0；档位越权 / 无出处数字 / 误拒 四项零容忍全 0
- 安全不变量 INV-1~INV-5；零容忍规则未删，改的是挂载点
（输出侧字面黑名单 → 检索层档位隔离 + 判定层合规词表 + 输出守护）
二、知识库：档位单点化与物理隔离
- 新增 app/core/knowledge_tier.py 作为档位规则唯一落点（G-03），
knowledge_contracts.py 原定义块改为显式再导出（X as X，非副本）
- 档位过滤由 bool 默认值（fail-open）改为 tiers 必填集合（缺参即 TypeError）
- Milvus 侧四集合按 visibility 分区键物理隔离；双 schema 收敛为一套
- 新增 app/core/actor.py：访客三元组与匿名判定的唯一构造/判定点（G-01/G-01b）
- 新增 app/core/fund_fee_rules.py：费率计算纯函数
三、前端入参边界对齐（本轮 W11 新修，4 处"校验宽于存储"）
- message 加 max_length=8000（与浮窗 widget.js 的 maxlength 一致）
- session_id 加 1—64；idempotency_key 上限 128 → 64（对齐列宽 String(64)）
- feedback_type 加 max_length=32（对齐列宽 String(32)）
- 8 条路径参数补 min_length=1 + max_length=64 + 字符集正则
（{session_id} / {run_id} / {handover_id}）
- 改前超限值会落到 MySQL 才失败（500）；改后一律 422 AGENT_INPUT_INVALID + 字段级定位
- 新增 tests/unit/api/test_frontend_boundaries.py（33 例），含"端点表 ↔ OpenAPI 全量对照"
四、投顾模块整体清除（D4.4 / D4.5）
- 删除投顾相关 controller / schema / model / repository / service 及门户页面
- tools/portal_api_check.py 同步作废 AD003/AD005/AD011/A047 四条用例与 advisor_t 登录
（端点与账号均已不存在，此前稳定报 3 条假红）
五、验证（提交前实测）
- pytest -q：1856 passed / 2 skipped / 0 failed
- ruff check app tools tests：19（= 基线）；mypy app：2（= 基线）
- 前端接口契约体检 portal_api_check.py：38 项，通过 34，失败 0，跳过 4
- 全链路冒烟 e2e_smoke_test.py --read-only：31/31
- HTTP 全链路探针 http_probe.py：11/11 succeeded
- 跨文档一致性 _consistency.py：GATE PASS
- 真机边界复验 12 条：12/12 符合预期
六、纪律与文档
- 可改文件白名单 A-09（docs/46）与底座会签申请单 A-10（docs/47，组 1—组 4 全部受理）
- 零 DDL：未新增/修改任何表结构，89 张业务表与基线一致
- 证据留痕：docs/evidence/**（含 46 条金标 score、快照、清除与重建记录）
- 未提交（刻意排除，见提交说明）：仓库内 客服agent/ 与 开发文档/ 是 2026-09-16 前的
过期副本（Todolist 440 行 vs 权威 D2.1 1167 行），权威正本在仓库外；
_chunks_report.txt 是 tools/build_knowledge_chunks.py 生成的本地产物
|
2026-09-20 14:33:30 +08:00 |
|
|
Windows
|
74b7d00dff
|
feat(投顾): 方案交付落点、可视化图表与推荐依据的大模型增强
交付落点
- 新增 GET /api/v1/users/me/advisor-contents（客户读**自己**已发布方案）：
「发送给客户」原先只改数据状态、客户端没有任何页面或接口能读到它
- 客户端新增「我的投顾方案」页与导航入口
可视化（投顾结果区与客户页**共用** common/advisor-plan-view.js，避免两处漂移）
- 净值折线图（带坐标轴与网格）、组合业绩等权合成曲线（含区间收益与最大回撤）、
资产配置环形图与图例、组合构成条
- 修 num(null)=0 的假 0：Number(null)/Number('') 会得 0，导致「没数据」被渲染成 0.00%；
现一律显示「--」。同理管理费/起投未维护时按没数据处理，不显示 0
- 涨跌口径为「涨红跌绿」（A 股习惯），由 CSS 变量 --plan-up / --plan-down 集中定义
推荐依据接入大模型（可选，失败即回退）
- 新增 AdvisorReasonService：**只改文案，不参与选品**（候选池与排序在它之前已固定）
- 输入只允许是已算出的真实参数（风险等级、排序得分、区间收益、最大回撤、期限与流动性）
- 命中收益承诺词（保本/保证收益/稳赚/无风险…）整条丢弃并回退规则文案
- 未启用 / 缺密钥 / 超时 / 解析失败一律回退，推荐主流程不因模型不可用而失败
- 前端标注来源（AI 生成 / 规则生成）
数据与权限
- 客户角色补齐：绑 customer 角色、补建缺失的账户与交易段权限码（9060-9065）
- 净值全量同步（20 只产品），行情同步脚本按 --codes 分块（全量一次会被超时终止）
测试
- 新增 tests/unit/service/test_advisor_reason_service.py（10 项，专测三条合规边界）
- 前端模块自检纳入 service-request-module；补「两处共用同一渲染」回归测试
|
2026-09-16 18:17:47 +08:00 |
|
|
Windows
|
2fe7d0c506
|
feat(投顾): 客户主动申报投顾方案 + 投顾受理自动生成方案草稿
客户在自己主页提交申报 → 投顾工作台受理 → 自动跑既有推荐逻辑生成一份待审核草稿 →
投顾再走既有的「审核通过 → 发送给客户」。补上原先「客户只能被动等方案」的缺口。
后端
- 新增表 advisor_service_request（本轮新建，带 AUTO_INCREMENT）+ 迁移
20260916_advisor_service_request（幂等：先查表再建，兼容本库 alembic 指针滞后）
- 新增 AdvisorServiceRequestService：create / list_mine / queue / review
· 申报前置：风险测评必须存在且未失效（FM-03，12 个月），服务端判
· 队列复用 ProductRecommendationService._visible_customer_ids（本人 + 归属），待受理排前
· 受理即调用推荐逻辑生成草稿并把 content_id 回填；生成前置失败给出人话原因并保持待受理
· 「已发送客户」不落库，由关联方案 published_at 推导，避免两处状态各写各的
- 权限码 9071-9074（客户 write/read:self、投顾 read/review），已进种子与授权工具
前端
- 投顾工作台新增「客户申报」面板（受理 / 驳回，驳回理由客户可见）
- 客户页新增申报表单（金额/期限/风险偏好/备注）与「我的申报」列表
客户自助路由刻意不挂投顾灰度闸门：那是投顾业务的灰度，客户提交自己的申请不该被它拦下。
|
2026-09-16 18:17:46 +08:00 |
|
|
Windows
|
560775156c
|
docs: 新增投顾 Agent 需求文档与功能架构文档
依据仓库既有设计与已落地代码反推整理，内容与当前实现一致（非前瞻设计）。
- docs/46-投顾Agent需求文档.md
· 背景与三个真实断点（交付无落点 / 文案不可读 / 客户无入口）
· 目标 G1-G5 与 4 条非目标（不真实下单、不预测收益、不自动投资、不做场外）
· 角色场景 SC-01~SC-05、两条主链路流程图
· 功能需求 FR-01~FR-21（含口径、优先级、验收标准）
· 业务规则：候选池硬约束 fail-closed、5 条合规红线、状态机、FM-03 熔断
· 非功能需求、异常处理表、权限矩阵、数据需求、验收清单、11 项待确认问题
- docs/47-投顾Agent功能架构文档.md
· 五层架构总览、后端模块划分与 3 条设计约束、数据模型与关系
· 接口清单（投顾 8 / 客户 3 / 依赖能力 3 组）
· 三张时序图（生成推荐、审核发布、申报受理）
· 外部依赖降级矩阵、前端模块结构与 2 条硬约定、权限灰度、配置清单、已知约束
|
2026-09-16 18:17:45 +08:00 |
|
 zhangshuai_0626
|
8643ad1efc
|
上传文件至「docs/风控业务演示文档」
|
2026-09-15 09:39:23 +08:00 |
|
 lzf_0626
|
06d0f9f231
|
知识库检索质量修复：「风险评估问卷怎么评分」从必然转人工 → 直接答
## 根因（两个问题叠加）
1. 灌库脚本 tools/build_knowledge_chunks.py 的 expand_table_rows() 用「第一个非分隔行」
当表头且 header 从不重置 → 同一节里第 2 张表格起**表头被当成数据行**。
《个人投资者适当性管理指南》第九条下有 16 张问卷表格 → 15 条正文逐字相同的
19 字零信息量碎片；同类共 19 条。
2. 检索层去重只按 doc_id，接不住「同一父块的兄弟子块」（POL-AST-009-07 与 -12 是
不同 doc_id、同一父块）→ 15 条碎片全留在候选里互相打平，把 top1/次优差压到 0.002，
而客服判定要求中置信必须领先 ≥0.07（MIN_GAP）→ 恒判并列转人工。
## 为什么没有重灌知识库
用 Milvus 现成向量离线复算四种做法（同一问句、同一批向量）：
现状 gap 0.002 转人工
只修 bug（=重灌全部收益） gap 0.001 仍转人工，且更糟
只加父块归并 gap 0.093 可答，但答案是 19 字碎片
两处都改 gap 0.076 可答且有内容
原因：第九条被切成 94 块，删掉 15 条表头碎片后，剩下 79 条数据行碎片依然互相打平。
重灌解决不了，却要停机 3–10 分钟并丢掉上传路径的内容（含 R1–R5 那条）。
## 改了什么
① app/service/knowledge_search_service.py：新增 _merge_sibling_subblocks()
同一父块的兄弟子块只保留最高分那条；父块自身与 FAQ/政策这类本身就是细粒度答案
的块一律不合并（它们之间打平是真的多个候选）。6 个单测守着。
被丢掉的只是同节其它细节，本节完整内容由 _parent_hits 带回的父块兜底。
② tools/build_knowledge_chunks.py：修表头识别（markdown 表格只有紧邻 |---| 之前的
那一行才是表头）+ 新增 assert_no_duplicate_contents() 自带守卫 ——
正文完全相同的块必须为 0，否则中止且不写 jsonl。该脚本是一次性灌库脚本、
原来没有单测覆盖，这正是该 bug 活下来的原因，所以守卫放在它自己的执行路径上。
块数 636 → 617；正文完全相同的组 1 组 15 块 → 0 组。
负向验证：换回旧逻辑跑，退出码 1 并报出那 15 份碎片，且未覆盖 jsonl。
③ tools/drop_table_header_vectors.py：清掉已灌进 Milvus 的 19 条历史碎片。
判定可复现：语义 id（非纯数字）且正文不在修正后产物里。只动语义 id 是因为
纯数字 id 来自上传路径、本来就不在 jsonl 里（实测冒烟 A 线的 top1 就是数字 id 179）；
不按长度判是因为短块本身是设计的一部分（「评审标准：管理人资质 15%」13 字是有效答案）。
实删 policy 16 + product 3，faq 0；dry-run 逐条核对过，全部是「标签 + 表头词」形态。
这是唯一一次绕过 Outbox 的删除：事件消费侧要回读 MySQL 行，而这批是无元数据种子向量。
## 验证
真实链路 10 问句回归 10/10 与预期一致，0 个变坏：
风险评估问卷怎么评分 0.7156 gap 0.1473 → 答（原 0.002 转人工），top1 变成真实答案行
场内基金的管理费率 0.8114 gap 0.0977 → 直接答（冒烟 A 线）
南方季季盈90天起投金额 0.8631 gap 0.3387 → 直接答（行级子块精确命中能力未受影响）
今天天气怎么样 仍正确转人工
端到端：ask_customer_service.py「风险评估问卷怎么评分」→ 直接答，返回完整评分标准；
e2e_smoke_test.py 44/44（含 A4 知识库覆盖未转人工）；
pytest tests/unit tests/contract 1506 passed / 0 failed；
对账 重复正文 15 → 0，孤儿/死向量/缺向量仍全为 0。
（冒烟首跑 42/43 的唯一失败 B6 买入下单 503 是行情过期，补刷后 44/44，与本次无关。）
## 顺带查明
Milvus 的 delete() 是标记删除，约 1 秒后才在 query/search 中不可见（隔离临时集合实测：
删完立即查仍看得到，+1s 起消失）。清理工具第一版"删完立刻复核"因此谎报 19 条残留，
已改为轮询复核并把文案改成实测依据。get_collection_stats().row_count 在删除后仍显示旧值，
这也是对账工具坚持用 query 实际行数的原因。
## 文档
新增 docs/演示用/知识库检索质量修复-2026-09-15.md（根因、四方案对比、改动、全部证据）；
并对 docs/演示用/知识库向量对账与清理-2026-09-15.md 做更正 —— 451 条短块里 429 条是
设计内的有效数据行、只有 19 条是 bug 产物；"按长度合并短块 + 重建重灌"的建议已被实测否决。
## 仍未解决（记录在案）
「高净值客户有什么权益」gap 0.0075 仍转人工：根因是不同父块之间同族内容打平
（金卡 vs 白金权益），父块归并救不了也不该救，要从内容侧或业务口径入手。
knowledge/_chunks.jsonl（新 617 块、编号连续）与 Milvus（旧编号、含 19 个空洞）目前不一致；
不重灌无影响，但下次重灌必须 drop 集合重建而不是 upsert，否则两套编号会共存。
|
2026-09-15 09:31:57 +08:00 |
|
|
lzf_0626
|
859c89898e
|
补充 purge --apply 的真机验证证据
对账当时报 0 条死向量，--apply 分支没有真实样本。手工造了一个真实死向量
（上传后等向量写好，直接改库置 expired 且不投删除事件）跑通闭环：
对账发现 1 条 → 投递成功 1/0 → Worker 消费 → 复核归零。
|
2026-09-15 09:08:02 +08:00 |
|
|
lzf_0626
|
58b73ff594
|
知识库三项收口：向量-元数据对账 + 导入侧幂等 + 过期行向量清理入口
① 只读对账 tools/reconcile_knowledge_vectors.py
按集合列出：孤儿向量 / 死向量 / 缺向量 / 重复正文 / 低信息量碎片 / 纯标题。
关键口径：非数字 id（FAQ-0013 这类语义 id）是灌库脚本有意写进 Milvus 的，
单独归类、不建议删；向量数取自 query 实际行数，不用 get_collection_stats
（后者含已软删未 compaction 的行）。
② 导入侧幂等：同 source_file + 集合重传 = 覆盖上一版
app/service/knowledge_ingest_service.py 新增 _supersede_previous_version：
把上一版 active 行置为 expired，并逐行投 knowledge.vector_delete_requested
（与本次入库同事务）。写入侧只认 active 而检索侧不看 status，旧向量不清掉
会继续参与排序、和同题活块抢答。
顺带修掉一个真 bug：改为先判 chunks 非空再下线 —— 否则传一份解析出 0 块的
文档会把上一版下架、新版一行没写，这份文档在检索侧凭空消失。
③ 清理入口：POST /api/v1/knowledge/{knowledge_id}/vector-cleanups
给历史上"被别的途径置为 expired、从未投过删除事件"的行补投向量清理。
DELETE 对已过期行返回 404 的口径保持不变（重复删除静默成功会让调用方
分不清"这次真下线了"和"早就过期了"），因此新开一个语义明确的端点：
不存在 404 / 仍是 active 422（请改用 DELETE）/ 已 expired 200 并回传事件名。
配套 tools/purge_expired_knowledge_vectors.py（默认 dry-run）批量驱动该端点。
文档：docs/演示用/知识库向量对账与清理-2026-09-15.md（含真机验证输出），
并对 docs/演示用/知识库问答诊断-2026-09-14.md 做两处更正 —— 实测孤儿向量 0 条、
那 175 行历史副本从来没有向量（不参与排序），当时的差额来自 get_collection_stats
把已软删行算进去。
新发现（未修，需业务拍板）：661 条向量里 451 条正文不到 40 字，是灌库时把
markdown 表格/标题切碎产生的碎片。「风险评估问卷怎么评分」实测前 4 名是 4 条
一模一样的 19 字碎片（gap 0.0024），真正 2828 字的答案排第 5 → 客服必然转人工。
属灌库切分缺陷，补内容救不了，也不应靠放宽 MIN_GAP 解决。
验证：pytest tests/unit tests/contract → 1500 passed, 2 skipped, 0 failed；
mypy app → 3 个错全在组员文件中（与本次改动无关）；ruff 本次改动文件 0 错。
真机端到端：重传 → 旧行 expired + 删除事件 published + 旧向量已从 Milvus 删除；
两个问句回归仍正常回答（r1到r5 gap 0.0766；申购确认 0.8453）。
|
2026-09-15 09:06:57 +08:00 |
|
|
lzf_0626
|
64ad12e44a
|
修「r1到r5分别代表什么」答不出来：补一条标题对齐问法的短 FAQ（不动门槛策略）
## 现象
客服对「r1到r5分别代表什么」走兜底 + 转人工；「基金申购后多久能确认」用户以为也不答。
## 排查结论（详见 docs/演示用/知识库问答诊断-2026-09-14.md）
- 向量库**有**内容、检索也命中：申购确认那一问 top1 = **0.8468**（高置信，本来就答得出，
库里留着 23:59:06 那次完整问答）；R1–R5 那一问 top1 = **0.6621**、次优 0.6412。
- 判定规则：高置信(≥0.75)不看 gap；中置信(0.55–0.75)必须领先次优 ≥0.07
（`customer_service.py:148-150`）。R1–R5 只领先 0.021 → 判"候选并列"。
- 根因是**同一主题多来源 + 命中块太长**：高频问答对(0.6621)、适当性指南第十一条三块
(0.6412/0.5771/0.5520)、产品手册 1.4 节(0.4983) 分数天然挤在一起；
而我先前上传的长条目（488 字切两块）被稀释到 0.6622，**改了两次才找到有效形态**：
短条目 + 标题与问法逐字对齐 → **0.7384 / gap 0.0761 → 可答**。
## 本次改动
- 新增知识正文 `data/knowledge/faq_r1r5.md`（口径取自 `suitability_service.MATRIX_ALLOWED` /
`MATRIX_NEEDS_DISCLOSURE`，避开禁用词）。
- 新增幂等工具 `tools/seed_knowledge_r1r5_faq.py`：默认 dry-run，`--apply` 上传；
已存在同源未过期知识则跳过，并自动复测检索评分。
- 真机执行：删除 3 个试验块（200/201/202）→ 上传 id 203 → 端到端验证。
## 验证
- `tools/seed_knowledge_r1r5_faq.py`（幂等路径）→ `top1=0.7384 次优=0.6623 gap=0.0761 可答`
- 端到端（登录客户 + 访客两条路径）：「r1到r5分别代表什么」给出五级含义 +
C1–C5 对应关系；「基金申购后多久能确认」给出 T+1/T+2 确认规则
- 回归 4 条同类问题仍高置信直接答：费率 0.8111 / 场内场外 0.7871 / 最小买多少 0.8289 /
赎回到账 0.8480
## 顺带查清（登记为已知问题，未擅自改）
1. **向量与元数据严重不一致**：Milvus 159/397/297 个向量 vs MySQL 41/161/**0** 行；
答得最好的 `faq/高频问答对.txt`（含 FAQ-0015）与两套政策文件**只在向量里、MySQL 无行**。
⇒ 这**推翻**了我先前"检索按 active 过滤"的建议（会把孤儿但有用的内容一起杀掉），
已在文档里明确撤回。
2. **检索层不看知识状态**：`knowledge_search_service.py` 里 `status` 出现 0 次 →
已 expired 的历史副本照样参与排序（费率这类会变的内容有被答旧值的风险）。
3. **重复与测试垃圾在抢答，且没有清理入口**：产品手册被种了 7 遍（199 行里只有 24 active）、
FAQ 集合 41 行里 38 行是上传链路测试残留；而 `DELETE /api/v1/knowledge/{id}` 对已 expired 行
一律 404「知识文档不存在」→ 清理历史副本目前无入口。
|
2026-09-15 08:47:10 +08:00 |
|
|
lzf_0626
|
b53b4e0bc7
|
修「r1到r5分别代表什么」答不出来：补一条标题对齐问法的短 FAQ（不动门槛策略）
## 现象
客服对「r1到r5分别代表什么」走兜底 + 转人工；「基金申购后多久能确认」用户以为也不答。
## 排查结论（详见 docs/演示用/知识库问答诊断-2026-09-14.md）
- 向量库**有**内容、检索也命中：申购确认那一问 top1 = **0.8468**（高置信，本来就答得出，
库里留着 23:59:06 那次完整问答）；R1–R5 那一问 top1 = **0.6621**、次优 0.6412。
- 判定规则：高置信(≥0.75)不看 gap；中置信(0.55–0.75)必须领先次优 ≥0.07
（`customer_service.py:148-150`）。R1–R5 只领先 0.021 → 判"候选并列"。
- 根因是**同一主题多来源 + 命中块太长**：高频问答对(0.6621)、适当性指南第十一条三块
(0.6412/0.5771/0.5520)、产品手册 1.4 节(0.4983) 分数天然挤在一起；
而我先前上传的长条目（488 字切两块）被稀释到 0.6622，**改了两次才找到有效形态**：
短条目 + 标题与问法逐字对齐 → **0.7384 / gap 0.0761 → 可答**。
## 本次改动
- 新增知识正文 `data/knowledge/faq_r1r5.md`（口径取自 `suitability_service.MATRIX_ALLOWED` /
`MATRIX_NEEDS_DISCLOSURE`，避开禁用词）。
- 新增幂等工具 `tools/seed_knowledge_r1r5_faq.py`：默认 dry-run，`--apply` 上传；
已存在同源未过期知识则跳过，并自动复测检索评分。
- 真机执行：删除 3 个试验块（200/201/202）→ 上传 id 203 → 端到端验证。
## 验证
- `tools/seed_knowledge_r1r5_faq.py`（幂等路径）→ `top1=0.7384 次优=0.6623 gap=0.0761 可答`
- 端到端（登录客户 + 访客两条路径）：「r1到r5分别代表什么」给出五级含义 +
C1–C5 对应关系；「基金申购后多久能确认」给出 T+1/T+2 确认规则
- 回归 4 条同类问题仍高置信直接答：费率 0.8111 / 场内场外 0.7871 / 最小买多少 0.8289 /
赎回到账 0.8480
## 顺带查清（登记为已知问题，未擅自改）
1. **向量与元数据严重不一致**：Milvus 159/397/297 个向量 vs MySQL 41/161/**0** 行；
答得最好的 `faq/高频问答对.txt`（含 FAQ-0015）与两套政策文件**只在向量里、MySQL 无行**。
⇒ 这**推翻**了我先前"检索按 active 过滤"的建议（会把孤儿但有用的内容一起杀掉），
已在文档里明确撤回。
2. **检索层不看知识状态**：`knowledge_search_service.py` 里 `status` 出现 0 次 →
已 expired 的历史副本照样参与排序（费率这类会变的内容有被答旧值的风险）。
3. **重复与测试垃圾在抢答，且没有清理入口**：产品手册被种了 7 遍（199 行里只有 24 active）、
FAQ 集合 41 行里 38 行是上传链路测试残留；而 `DELETE /api/v1/knowledge/{id}` 对已 expired 行
一律 404「知识文档不存在」→ 清理历史副本目前无入口。
|
2026-09-15 08:46:38 +08:00 |
|
|
lzf_0626
|
01e4e6a687
|
修掉"Worker 会自己退出"的真缺陷（场外游标续租失败误取消主任务）
## 现象（2026-09-14 实测，非人为停止）
Worker 进程自己退出，退出码 1，日志末尾是
`ConnectionResetError: [WinError 10054] 远程主机强迫关闭了一个现有的连接`
（发生在 `offsite_worker.close()` 的 IMAP `logout()`），
而真正的起点是更上面那句 `asyncio.exceptions.CancelledError`。
## 根因（两处，都是真缺陷）
1. **取消错了对象**：`OffsiteMailWorker._process_batch` 把
`asyncio.current_task()`（= `__main__.serve()` 的**主循环任务**）交给游标心跳，
心跳在续租失败（`rowcount != 1`）或续租抛异常时执行 `task.cancel()` ——
于是"放弃这一批"变成了"**杀掉整个 Worker**"。`CancelledError` 从 `run_once()`
一路冒到 `serve()`，主循环直接结束。
2. **收尾异常盖掉退出原因**：`serve()` 的 `finally` 里 `await offsite_worker.close()`
在网络已断时抛 `ConnectionResetError`，把 `CancelledError` 顶掉，
表现为"关闭流程崩了"，看不出真实原因。
## 改法
- `_process_batch` 把"这一批"跑在**独立任务** `batch` 里，心跳只取消 `batch`；
调用方捕获 `CancelledError` 后区分两种情况：
**本批被放弃**（`batch.cancelled()` 且当前任务自己没有在取消）→ 记 warning、返回 `False`、
Worker 继续下一轮；**外层在取消当前任务**（Ctrl+C / 进程关闭）→ 原样上抛，绝不吞掉。
- `serve()` 的 `finally` 里关闭场外 Worker 包 try/except：收尾失败只记日志，
**不改变退出码与退出原因**。
- 新增 `_current_task_is_cancelling()` 用 `Task.cancelling()` 做这个区分（3.11+）。
## 守卫
`tests/unit/worker/test_offsite_mail_worker.py::test_cursor_lease_loss_abandons_batch_without_cancelling_the_worker`
—— 续租失败（rowcount=0）时断言：批次确实跑起来过、返回 `False`、
**调用方任务没有被取消**。修复前这条用例会挂在"调用方被取消"上。
## 验证
- `pytest tests/unit/worker` → 112 passed
- `pytest tests/unit tests/contract` → 见下方（0 failed）
- `mypy app/worker/offsite_mail_worker.py app/worker/__main__.py` → 0 错（除组员文件里既有的 1 个）
- 重启 Worker 后跑记忆演示链路：候选 → verified → active → **2 秒**收敛，进程稳定
## 文档
`docs/演示用/记忆系统演示文档-2026-09-14.md`：
场景五补"如果发现 Worker 自己退了是怎么回事"，问答补"Worker 会不会自己中途退出"。
|
2026-09-15 08:01:00 +08:00 |
|