 lzf_0626
|
9490e5043b
|
记忆系统演示文档 + 修掉两处会让演示断链的真问题
## 新增：docs/演示用/记忆系统演示文档-2026-09-14.md
按"操作 → 看到什么 → 这体现什么"写，五个场景（探针看存储 / 记住一件事 / 谁能读谁读不到 /
画像版本与投影 / 停 Worker），每个场景配可复现命令与**实测输出**，另附建议顺序与时长、
六条问答话术、演示前自检清单、受控信号词表摘录。
配套两个新工具（都已实跑）：
- `tools/memory_demo_chain.py`：一键走完"客户说 → 候选 → 客户确认 → 管理员批准 →
记忆与画像自动收敛"，打印演示前后对比（实测 2 秒收敛）。
- `tools/memory_recall_demo.py`：同一客户换六个身份召回，当场看出"客户只读自己 /
员工要权限码+归属 / 运营读不到 / 管理员有权限码但没归属也读不到"。
## 修掉两处会让演示当场断链的问题（都是真机复现的）
1. **候选批准后画像字段不收敛**
`CustomerProfileCandidateService._promote` 只写画像快照、**不投**
`profile.rebuild_requested`，而 `user_facts` 与画像字段是 `ProfileAssemblyService`
的重建链路写的。后果：批准后记忆变 active、快照版本 +1，但**画像字段停在旧值**
（客户说"三年以内"，画像里还是"十年以上"），要等一次无关的重建才收敛 ——
而"客户说完 → 批准 → 画像变了"正是演示主线。
现补一条重建事件（走事件而不是就地重建：本方法所在事务还没提交，
另开 session 看不到刚写入的记忆）。
2. **画像快照的唯一键从来没起作用，而且埋雷**
`uk_profile_snapshot_current` 建在列 `current_customer_id` 上（不是 `is_current`），
但 `ProfileAssemblyService._write_snapshot` 旧行只置 `is_current=False`（不清该列）、
新行**不写**该列（实测 13 行该列全 NULL）。
后果：只要客户**先被重建过一次**，旧 current 行仍占着 `current_customer_id=9001`，
下一次"批准画像候选"就会撞 `Duplicate entry '9001' for key
uk_profile_snapshot_current` → **整次批准 500**（本次实测踩到）。
现按唯一键的真实语义写：清旧行的该列、新行显式写客户号。
（`ProfileGenerationService` / 候选路径本来就是这么写的，只有这一处没对齐。）
## 守卫
新增 `tests/integration/test_profile_snapshot_current_invariant_mysql.py`：
按真实顺序"先重建再批准候选"，断言 ① 只有一条 current 且它占着唯一键、
② 历史版本已归还该列、③ 批准不再 500、④ 批准投出了重建事件。
修复前这条用例会在第 ② 步失败。
## 验证
- `pytest tests/unit tests/contract` → 1490 passed, 2 skipped, 0 failed
- 新增集成用例通过；真机实测演示主线：候选 → verified → active → **2 秒内**
`user_facts` 与 `fin_customer_profile.investment_horizon` 都变成新值
- `mypy tools/memory_demo_chain.py tools/memory_recall_demo.py` → 0 错；ruff 全绿
## 文档
`docs/44-演示流程.md`：配套文档清单与"记忆链路"备选场景都指向新演示文档。
|
2026-09-15 00:55:44 +08:00 |
|