suzmii
3e13a6e407
origin/master = 441be8d62（落后 143 提交）；合并前本分支 HEAD = aeebbee28。
冲突 11 处，按「master 侧是否活跃」分三桶处理。
M 桶（master 改过该文件 → 取 master 版本，不把我们的删除加回去）：
- agent/codex_app_server/mod.rs（master +348/-108）
- agent/codex_app_server/model_catalog.rs（master +38/-18：CatalogSource::Authenticated / source_for_credential / verify_authenticated_source）
- agent/codex_app_server/model_catalog/auth_handoff.rs（modify/delete → 保留 master 版，OAuth 轮换交接）
- agent/codex_cli.rs（master +190/-44）
- agent/codex_app_server/model_catalog/real_tests.rs：我们把该文件裁到 59 行以适配自建的 capture 签名；master 的 model_catalog.rs 恢复 4 参 capture 后取回 master 的 244 行用例，否则 --all-targets 报 2 处 E0061。
D 桶（master 未动过、我们删除的死码 → 保留删除）：
- 合并前已删：patchset.rs、git_inspect.rs、repository_context.rs、generation/pass_artifacts.rs、agent/runtime_models.rs、debug.rs(+debug/debug_drafts.rs) 等。
- process_session/{io,lifecycle,persistence,recovery}.rs 与 process_session/tests/owner_fixture_cleanup.rs → 裁决为「保留删除」：master 在这 4 个文件里只改「死码的错误正文」；实测整棵子树在 AGC 生产构建里 69 条 dead_code、且只被 tests.rs 引用；生产只用到 recovery.rs 的 2 个 shutdown 函数，而那 2 个我们已搬进 process_session/shutdown.rs。
G 桶（双方都改、我们那侧非语义 → 以 master 语义为准，手工合并）：
- agent.rs：取 master 的 claude_code_failure_to_turn_error（改名，codex_app_server/mod.rs:5323 依赖该再导出）；保留我们的模块集合（provider_request_snapshot，去掉 runtime_models 与 dispatch 的再导出）。
- thread_manager/dispatch.rs：master 的 host_dropped_with_detail（panic 详情）+ 我们的 cfg(not(test))/cfg(test) 收口（测试态不读兜底结果，避免 harness 未用变量告警）。
- generation/llm_request.rs：取 master 的 AgentProgressEmitter（其唯一消费方 maybe_generate_platform_art_asset_step 已在我们那侧删除，随之成为残留，交由后续提交处理）。
- process_session/model.rs：master 的 8 处错误正文（WindowsProcessJob 的 last_os_error）**全部落在我们未裁的区间**，逐 hunk 叠加到我们的 382 行版本（结果 406 行；last_os_error 出现次数与 master 版一致，均为 13）。
- process_session/shutdown.rs：把 master 在 recovery.rs 里给 shutdown 广播加的诊断搬进我们的实现（`process_session.shutdown.send_failed processId=… detail=…`；收敛后的 LiveProcessSession 不再有 process_id 字段，进程身份取注册表 key）。
- docs/project-memory/shared-memory/pitfalls.md：两侧各新增一节，两节都保留。
项目记忆目录
本目录只保存可以通过 Git 共享、并且对当前开发仍有效的项目知识。.codex/ 只放 Codex 工具资源，不作为项目知识库。
当前结构
docs/project-memory/
├─ README.md
├─ shared-memory/
│ ├─ project-overview.md
│ ├─ team-conventions.md
│ ├─ development-workflow.md
│ ├─ document-map.md
│ ├─ decision-log.md
│ ├─ pitfalls.md
│ ├─ handoff-template.md
│ └─ 【模板】规范驱动开发主规范与里程碑模板-2026-09-12.md
├─ plans/ # 仅限正在执行的短期计划
└─ todos/ # 仅限仍开放且有退出条件的事项
使用原则
- 开发前先读
AGENTS.md；复杂任务再读 Agent 执行准则、共享记忆和任务对应的当前专题文档。 - 稳定架构、接口、流程和排障边界写入
shared-memory/；同一事实只保留一个当前口径，细节放在权威专题文档。 plans/只保存正在执行、具有明确剩余项和验收门禁的计划；完成或作废后立即删除，稳定结论融合进当前专题或共享记忆。todos/只保存真实开放、有人接手即可执行的事项；每项应写明状态、下一决策点和关闭条件。已退役对象不保留未来 TODO。- 分支、提交、测试轮次和阶段流水账不进入长期记忆；需要追溯时使用 Git 历史。
decision-log.md与pitfalls.md可以直接修改、合并和删除旧条目：被覆盖的决定、退役对象专属说明和重复记录不继续保留；仍有效的风险、兼容约束和未完成事项应保留或融合到当前专题。- 自动验证检查实际代码、配置和行为，不要求决策记录或踩坑记录包含固定措辞，也不强制把同一规则复制到多个记忆文件。
- 若本目录与代码或最新
docs/冲突，以代码和最新专题为准，并在同次变更中修正记忆。 - 禁止写入个人配置、API Key、Token、Cookie、会话记录、认证文件、本地私密路径、构建产物、日志、缓存和数据库 dump。
决策记录格式
以下格式按需使用，简单决策不必凑齐所有字段。
## YYYY-MM-DD 决策标题
- 背景：为什么需要这个决策
- 决策：最终决定是什么
- 影响范围：涉及哪些模块/文档/流程
- 验证方式：如何确认决策仍有效
- 关联文档：相关 PRD、技术文档、提交或 Issue
RAG 索引
本目录是本地 RAG 的高权重索引源，但检索结果只作为候选上下文。索引脚本位于 scripts/rag/；运行时依赖和 .rag/ 数据默认不安装、不提交，启用前需先征得用户确认。