文档:审查报告入库 + 全量校对补注

## 新入库(`docs/演示用/`)

- `代码库全面审查报告-2026-09-14.md`
- `代码修改方案-2026-09-14.md`
- `记忆系统排查报告-2026-09-14.md`
- `记忆系统修复文档-2026-09-14.md`
- `文档一致性审计报告-2026-09-14.md`
- `多Worker接入方案-2026-09-14.md`

## 全量校对(32 个既有文档 + `AGENTS.md`)

跨 39 个文件、**1125 insertions / 148 deletions**。

⚠️ **这批改动同样不是本次会话写的**。我抽样核对过性质:是**实质内容补充**而不是
格式/换行转换。例如 `docs/44-演示流程.md` 新增两条"2026-09-14 补注":

- `启动金融Agent平台.bat` 只在**桌面**上,仓库里只有 `启动平台.bat` 这一份
  (两份由同一个 `tools/make_launcher_bat.py` 产出,改完 `start.ps1` 重跑它一起更新);
- `advisor_t`(9020) 与 `offsite_t`(9006) **不在 `tools/seed_test_rbac.py` 的演示用户里**
  (那里只有 `cust_t`/`risk_t`/`admin_t`/`review_t` 四个),由 `grant_*.py` 系列创建,
  **重跑种子不会重建它们** —— 换机器时这两个账号登录失败,要先查 `sys_user` 有没有这两行,
  而不是查密码。

这两条都是对的地方,与我这一路踩到的现象一致(我确实用到了 `advisor_t`/`offsite_t`)。

**我没有逐字审阅全部 39 个文件**,只抽样确认了改动性质与规模。若其中有需要复核的段落,
请指明文件,我逐处核对。
This commit is contained in:
2026-09-14 20:36:00 +08:00
parent c0e5c80929
commit 36c7a9d8d2
38 changed files with 3604 additions and 138 deletions
@@ -103,6 +103,21 @@ git grep "GraphProjectionWorker(" → 零处实例化
## 三、四个必须对齐的架构分歧
> ✅ **四个分歧均已收口(2026-09-14 复核)**,逐条结论:
>
> | 分歧 | 最终选择 | 落地位置 |
> |---|---|---|
> | 1. 用哪条 outbox | 沿用**主干**那条链(`agent.run_completed → memory.extraction_requested → profile.rebuild_requested`),**不**引入第二套 | `app/worker/runtime.py` 的 handler 字典 |
> | 2. 画像"直接快照"vs"候选→复核→批准" | **两者并存**:主干直接重建快照;候选复核作为**第二条**独立路径(`memory:candidate:confirm`/`memory:candidate:review`),由 PR #7 合入 | `docs/36` §1 |
> | 3. 两套客服 Agent | **放弃 ZSY 那套**,只保留主干的 `CustomerServiceAgent`。ZSY 的**访客身份 / 候选 / 转人工工单**三块能力保留 | `docs/36` §1 |
> | 4. ZSY 落后主干 144 提交 | 按"只取增量"处理,未整体合并 | `docs/36` §1 |
>
> **另外**:`app/infrastructure/neo4j_profile_projection.py`(ZSY 那套**私有** `Preference`/`Goal` 节点投影)
> **未被装配进生产** —— 主干走的是 `ProfileGraphProjectionService`(写**共享** `Tag` 节点,源自 `user_facts`)。
> 两者语义不同,**不要**为了"启用它"而把 `__main__.py` 的装配加回去,那会重新变成两套图投影并存。
>
> **实施细节与验证证据见 `docs/37-记忆投影链路实现说明.md`**;本文下面各节保留原始核对过程。
### 分歧 1:用哪条 outbox 承载"记忆→画像→图"?
- **主干**:`domain_event_outbox` + `profile.rebuild_requested`(**已在 handler 白名单里**,架构师 09-10 接的)
@@ -150,6 +165,8 @@ app/worker/runtime.py、app/service/public_platform_service.py、app/main.py、a
## 四、建议的收口方案(分三步,风险递增)
> ✅ **三步均已执行完成(2026-09-12)**,证据见 `docs/37`;本节保留原始方案供追溯。
### 第 1 步:**只移植两个投影适配器**(低风险、有明确收益)
| 移植什么 | 从哪来 | 落到哪 |