docs: integrate unavailable model switching on main

.project-docs/20-architecture/data-flow.md

@@ -6,6 +6,12 @@ Main 的 `.makelore/conversations.json` schema v2 是 Conversation 标题和归
 
 重命名、归档和恢复经现有 Host API 修改元数据；`conversation.metadata-changed` 在现有 SSE 上只传项目和会话身份，不伪造运行时 generation/seq。Renderer 合并列表刷新、在重连时重新读取列表，并拒绝跨项目或早于本地变更的旧结果。归档不 dispose runtime、不移动 JSONL；Main 阻止归档会话的新 prompt/steer/follow-up 与 fork，保留已接受请求、现有任务、审批与中止能力。
 
+## Code model replacement
+
+用户在现有 Conversation 中明确选择模型后，Main 先校验新选择。若目标尚无 worker，则先持久化新模型并清除失败准备留下的注册缓存，再沿原 session binding 准备 Pi；旧模型已下架不能成为更换模型的前置条件。已崩溃 worker 即使同账号也用新模型重建目标线程，恢复原历史；已有 worker 保留原来的 mutation/uncertainty 门禁。
+
+Provider catalog 的模型不可用错误投影为 `CODING_MODEL_UNAVAILABLE`，界面提示重新选择，不再误报通用运行时不可用。更换模型不会自动选择替代项、重发消息或为修复选择而强制停止运行任务。
+
 ## Cloud knowledge embedding
 
 MakeLore 知识库 → Yuxi 已启用 embedding 目录与知识库/发布快照 → Yuxi 直连供应商 → Milvus 索引或查询。向量费用由平台承担，不进入 one-api/Works Square 模型目录、用户用量、词元点数或智能体金额预算。下述既有受管模型能力链不作为云知识库 embedding 入口；聊天及其他原有网关能力保持。访问资格和实际运行时限仍由云执行检查。