 张胜宇
|
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 |
|
|
张胜宇
|
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 |
|
|
张胜宇
|
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 |
|
|
张胜宇
|
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 |
|
|
张胜宇
|
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 |
|