merge: fix opencode model switching runtime refresh

.project-docs/20-architecture/module-map.md

@@ -18,7 +18,9 @@
 | `src/pages/Chat/OpencodeChatPanel.tsx` | AI 编程 Agent 选择、首次 session 创建、per-Session 模型选择、prompt 提交与消息/压缩混合时间线 | 页面模型选择器与 `/models` / `/model` 共用 OpenCode Session 切换动作；伙伴模型只作为新 Session 默认值，选中 Session 只投影自己的 run error |
 | `src/lib/opencode-session-state.ts` | OpenCode 会话消息与上下文压缩时间线的规范化、hydration 和事件归并 | 压缩 UI identity 不变；native Part/event identity 用于回放去重，completed 状态不可降级 |
 | `src/stores/opencode.ts` | OpenCode runtime、session、消息缓存、per-Session 模型/提交/启动确认与压缩生命周期 | Session 列表 hydration 恢复当前模型；每个 Session 独立持有 model/run/error/queue，10 秒 run-token watchdog 只终止对应 Session 且不自动重放；`session.compacted` 只完成压缩项，真实 idle 才释放 run 队列 |
-| `electron/api/routes/opencode.ts` | Main-owned OpenCode Session 模型切换、execution acceptance、provider/runtime freshness 与项目 Agent 门禁 | Session 模型切换调用 OpenCode native endpoint，不写 provider/伙伴配置；message/command/summarize 共用 bounded manager FIFO，普通执行路径不自动 restart/reload/dispose |
+| `electron/opencode/client.ts` | Makelore 内部 OpenCode DTO 与固定 runtime HTTP wire contract | 内部 `{ providerID, modelID }` 在 Session 模型切换边界映射为 OpenCode 1.18.9 `ModelRef` 的 `{ providerID, id }`；runtime 升级时复核 schema |
+| `electron/opencode/provider-config.ts` | Main-owned OpenCode provider/env 配置构建 | 托管本地 AI proxy 在 owned fresh runtime 启动时使用当前进程 Host API token；持久化旧 token 不得覆盖本次 runtime 已注入值 |
+| `electron/api/routes/opencode.ts` | Main-owned OpenCode Session 模型切换、execution acceptance、provider/runtime freshness 与项目 Agent 门禁 | Session 模型切换调用 OpenCode native endpoint，不写 provider/伙伴配置；fresh runtime 已生效 proxy token 的持久化不标记 stale，attached/unknown 与不确定写入仍 fail closed；message/command/summarize 共用 bounded manager FIFO，普通执行路径不自动 restart/reload/dispose |
 | `electron/opencode/project-agent-runtime.ts` | 项目 Agent 逐 id desired/applied 内容状态、runtime generation provenance、live registry acceptance 与配置 mutation 串行化 | owned fresh generation 中首次出现的唯一 id 可在 live `/agent` 暴露后应用；同 id 编辑、删除后重建及 attached/unknown generation 仍 fail closed，用户修改的 retired Agent 文件不得被删除 |
 | `electron/opencode/runtime-config-readiness.ts` | manager + generation scoped provider/runtime stale latch | timeout/partial persistence 保持 sticky uncertain 状态；只有成功显式 apply 后的合格 fresh generation 可解除，迟到 lease 不能改写 readiness |
 | `electron/api/routes/ai-proxy.ts` | Main-owned 模型代理、凭据边界与上游响应投影 | 仅对明确上游分组饱和做终止态兼容投影，通用限速保持 `429` |
@@ -79,4 +81,4 @@
 
 ## Last Updated
 
-2026-08-20
+2026-08-21