共享记忆同步 #504 关闭口径：迁移归属与复核条件

- decision-log 2026-09-24 条目补充：#504 以 Reviewed/Won't Fix 关闭，跟踪交回迁移侧，复核与重新打开条件见 #504 关闭评论
- pitfalls 同条目处理口径补上 #504 关闭状态与重新打开路径

docs/project-memory/shared-memory/decision-log.md

@@ -9333,7 +9333,7 @@ CI 上 `background_agent_runtime_recovers_stale_running_before_pending_task` 在
 ## 2026-09-24 AGC 项目快照「换号后整项目重传」的根因与迁移约束（客户端索引修复未落地）
 
 - 背景：AGC 客户端在项目打开期间把本地工程增量上传到 OSS，判定依据是 `<AppData>/project-snapshots/<projectId>/index.json`。该文件整份只保存一个账号的基线，同步前用 `previous.user_id == session.user_id` 判等，不等就换成空基线；而远端对象键第一段正是 `userId`，于是换号被等价成「本机没有基线」。issue #504 的真机复现（CDP attach dev 客户端 + 点「春卷冲刺」）：账号 A 留下的基线与当前账号不匹配 → 一次性重传 2311 个文件，约 3 分钟、2311 次 `POST /api/agc/project-snapshots/files`，其中 2306 次服务端 HEAD 命中纯白跑；同窗口内 `/api/runtime/frontend-config`、`/api/llm/models`、`/api/profile/recharge-center` 在服务端 200 且 ≤61ms 的情况下被客户端报 15s 超时（同进程 IPC 被重传压垮），并触发 #490 的「检查失败」钉死。本机 6 个索引文件里有 4 个不同 `userId`，09-23 19:47、09-23 20:47、09-24 10:57 三次同形态全量重传。
-- 结论（本条目只固化根因，不定架构）：客户端基线分桶的实现已完成并验证，但**未合入 master**——这条链路正被「数据与 IO 往后端挪」的架构迁移覆盖，落地在客户端本地索引上会与该迁移形成两套实现。实现保留在分支 `fix/api-timeout`（commit `3be8e40bc`），对应 PR #505 已按迁移方向关闭；迁移完成后若该问题仍在，可直接复用该分支或重开 PR。
+- 结论（本条目只固化根因，不定架构）：客户端基线分桶的实现已完成并验证，但**未合入 master**——这条链路正被「数据与 IO 往后端挪」的架构迁移覆盖，落地在客户端本地索引上会与该迁移形成两套实现。实现保留在分支 `fix/api-timeout`（commit `3be8e40bc`），对应 PR #505 已按迁移方向关闭；issue #504 随之以 `Reviewed/Won't Fix` 关闭，跟踪交回迁移侧（复核与重新打开条件写在 #504 的关闭评论里）。迁移完成后若该问题仍在，可直接复用该分支或重开 PR。
 - 迁移必须保留的约束（不随实现位置改变）：① 基线只能按 `(userId, projectId)` 两元组归属，远端对象键第一段就是 `userId`，换号后旧基线对新账号无效，任何新设计都不能跨账号共用或互相覆盖；② 任何一次同步只要清单/清单写入没有成功，就绝不能推进基线，否则下一轮立刻退化为整项目重发（这条已在 #504 上验证）；③ 本机扫描与读文件无法上移，服务端拿不到用户磁盘，`扫描 + 读字节 + 发字节` 必须留在客户端，「差异判定」才是可上移到后端的那一层。
 - 分层（回应「是否涉及协议层」）：本次改动只碰本地持久化格式（`index.json` schema）与一个 native-only 诊断视图的字段（`read_local_project_snapshot_state` 的 `baselineCount` / `baselinePresent`），**没有触碰客户端↔服务端的路由 / DTO / 对象键 / 清单结构**，即不涉及协议层。若差异判定上移到后端，新增的 `manifest/diff` 交互才是协议层变更，需要按规范单独定义。
 - 边界：不新增路由、不改服务端、不改公开契约；索引是 AppData 私有文件、不进项目目录；分支上的实现只影响 `project_snapshot/index.rs`、`mod.rs`、`tests.rs`，删改范围可控。