lzf_0626
9eebf9627f
记忆召回：按 sys_customer_assignment 归属定范围，不再把员工号当客户号
## 修的是什么
`governance.recall()` 把 `int(context.user_id)` 当客户号用。后果有两个，
方向相反但都致命：
1. **员工身份（风控／投顾／运营／管理员／system）恒空** —— 员工不是客户，
那是个不存在的客户号；日志只说 "empty"，看不出是"设计如此"还是"记忆坏了"。
2. **越权陷阱** —— 员工号与客户号同号段（演示数据里客户 9001-9020、
员工 9002/9020 并存）。`int(user_id)` 一旦与真实客户号重合，就会把
**陌生客户的长期记忆读进来并注入提示词**，且不报错、看起来正常。
同一个问题在代码里还有另外两处**各自判断**、口径互不一致：
`BaseAgent.recall_memory()` 要求"每条记忆 customer_id == context.user_id"
（否则抛"越过客户范围"），`review_output()` 的引用校验只认同一条件。
## 怎么修的
新增 `app/core/memory_scope.py` 作为**唯一判定口径**，三处共用：
- 客户身份（customer / authenticated_user）：**只读自己**，分配表里有别行也不读别人；
- 员工身份：**只读 `sys_customer_assignment` 分配给自己**的客户
（`context.customer_ids`，由 `IdentityRepository.load_context()` 读入）；
归属未维护 ⇒ **失败关闭**，并在日志里点名"归属未维护"，与"库里确实没有记忆"区分开；
- 访客：无（上游已拦）。
细节约定：
- 归属客户按客户号**升序**召回、单次上限 `MAX_RECALL_CUSTOMERS=10`
—— 升序是为了确定性（同一身份每次取同一批，不随数据库返回顺序漂移），
上限是为了别把成百上千条他人记忆塞进一个提示词；
- 跨客户合并后按置信度降序、`(客户号, uuid)` 兜底排序，最多 10 条；
- 员工同时持有多个归属客户的记忆时，`memory_context_text()` **逐行标注客户号**
并把提示词改成"多个客户的长期事实" —— 否则模型会把 A 客户的事实当成 B 客户的。
单一客户时保持原格式（客户身份的提示词与改动前逐字相同）；
- 引用校验与范围守卫都改用同一口径：员工引用**归属客户**的记忆不再被判成伪造引用；
引用**非归属客户**的记忆即便被塞进 memories 也照样拦下。
## 验证（真实身份链路 + 生产召回装配）
`IdentityRepository.load_context` → `PlatformGovernance.recall`（含 Milvus 语义通道）：
- 身份展开：roles=('advisor',)、customer_ids=('9001',)（sys_customer_assignment
里唯一那行 9020→9001）、可读范围 (9001,)；
- **修复前** `recall(int(user_id)=9020)` → **0 条**；
- **修复后** `recall(按归属)` → **2 条**（客户9001：进取型 / 约三年）；
- 边界：客户身份 9001 可读范围 (9001,)；无归属员工 9002 = ()（失败关闭，
且**没有**把 9002 当客户号）；未分配时的 9020 = ()。
测试：`pytest tests/unit tests/contract` → **1445 passed, 2 skipped, 1 failed**
（1432 + 新增 13；唯一失败是组员正在改的投顾页面，与记忆链路无关）。
新增用例：`tests/unit/core/test_memory_scope.py`（8 条，含"员工号不得被当成客户号"
的反例断言）、`tests/unit/service/test_agent_governance.py`（+5 条：归属召回／
无归属失败关闭且不碰数据库／客户只读自己／引用校验／越界守卫）。
## 遗留（已在 AGENTS.md 与文档里写明，未自行实施）
风控扫描这条线**仍读不到记忆**：它是唯一消费召回内容的地方
（`risk_agent.py:224`），而扫描上下文是 user_id="0"/roles=("system",) 且无归属行。
根因是**顺序问题**：召回发生在 handle() 之前，上下文里没有"本次目标客户"这个概念。
出路有两条：① 给风控专员补 sys_customer_assignment 行（运维动作，立即可用）；
② 在 RequestContext 加显式的 target_customer_id 并校验它落在归属集合内
（推荐，但属跨线协议改动，等确认）。
文档：docs/演示用/记忆召回恒空-根因与修复-2026-09-14.md 新增 §五（含 §5.4 遗留说明）、
AGENTS.md 新增"记忆可读范围只有一个判定口径"易错点，并按 2026-09-14 复测更新测试基线。
2026-09-14 21:33:16 +08:00
..
2026-09-14 20:35:46 +08:00
2026-09-14 21:33:16 +08:00
2026-09-14 21:26:03 +08:00
2026-09-14 00:30:06 +08:00
2026-09-13 23:51:45 +08:00
2026-09-14 21:33:16 +08:00
2026-09-14 18:24:24 +08:00
2026-09-14 21:26:03 +08:00
2026-09-09 21:55:37 +08:00
2026-09-13 15:56:54 +08:00