修复配置覆盖层写入失败后的部分更新

提前序列化配置变更并在多文件写入失败时逆序回滚保留单文件保存路径且不增加外部诊断或保存后回读补充覆盖层写入失败回归测试及配置保存文档
2026-09-09 04:34:57 +00:00
parent ff065dbc6c
commit 08c5917490
5 changed files with 77 additions and 3 deletions
@@ -2,6 +2,10 @@

 > 当前口径：本文件保留可复用的排障经验；历史条目的旧路由、旧版本和已删除文档仅作根因背景，不得据此恢复退役入口。当前命令、路由和 schema 以代码与 `docs/README.md` 为准。

+## 2026-09-09 常用设置跨文件保存失败
+
+主配置与 local overlay 的单文件原子写入不能保证整体成功；覆盖层写入失败会留下混合配置。保存前先序列化全部变更，多文件保存保留原内容，错误时逆序恢复并报告回滚失败；单文件保持原写入路径，成功后不回读、不触发外部诊断。此回滚仅处理可捕获错误，不承诺进程崩溃下的事务恢复。
+
 ## 2026-09-02 Tauri 事件桥在浏览器预览中必须 fail-safe

 - **现象**：Vitest/jsdom 挂载 AGC 客户端时，错误报告通知调用 `@tauri-apps/api/event.listen`，因缺少 `window.__TAURI_INTERNALS__` 产生未处理拒绝；测试断言虽通过，CI 仍以 unhandled errors 失败。
@@ -12,7 +12,7 @@

 常用设置负责运行参数的读取、编辑和保存，配置读写独立于账号权限诊断。账号权限由登录会话与实际智能服务请求链路处理，设置面板只维护配置草稿与读写反馈。

-保存配置复用写入前读取的高优先级本地覆盖内容：常用设置同步覆盖文件中已有的对应配置项，模型选择仅同步 `selectedModelId`；无冲突时不写覆盖文件。主配置和需要更新的覆盖文件均写入成功后返回规范化配置，写入失败则报告错误，不执行保存后回读或外部诊断。各文件沿用现有原子写入；跨文件失败可能已保存部分内容，用户可重新保存。
+保存配置复用写入前读取的高优先级本地覆盖内容：常用设置同步覆盖文件中已有的对应配置项，模型选择仅同步 `selectedModelId`；无冲突时不写覆盖文件。所有内容先完成序列化，多文件写入前保存原始内容，任一写入失败时逆序恢复已变更文件，回滚失败须明确报告。各文件沿用现有原子写入，不提供断电或进程崩溃下的多文件事务保证。全部成功后直接返回规范化配置，不执行保存后回读或外部诊断；单文件保存保持原路径。

 ## 2026-09-08 Web 游戏 npm 与 Phaser 4 产物合同