[Bug] 内测声明弹窗在设置写入失败时永久锁死界面（无任何逃生口）

[1207627875]

问题概述

内测声明欢迎弹窗（welcome notice modal）在用户确认状态写入持久化失败时，会把整个应用永久锁死：没有任何关闭路径，只能无限点击"继续"并反复看到红色报错"暂时无法保存确认状态，请重试。"。

复现现象

1. 首次启动 / 未确认内测声明时，弹出阻塞式弹窗：

2. 点击"继续"一次后，出现红色错误提示：

3. 再次点击"继续"只会重复同样的错误。弹窗右上角没有关闭按钮，点击遮罩、按 ESC 都无效，背后的侧边栏/设置也全部无法点击（整个 #root 被设为 inert）。
4. 刷新页面后，弹窗会再次出现，无法绕过。

根因分析（四重设计缺陷叠加）

1. "关闭弹窗"被硬绑定到"持久化写入成功"

WelcomeNotice 的点击逻辑：

const acknowledge = async () => {
  if (await controller.acknowledge()) finish(); // 只有返回 true 才关闭弹窗
};

finish() 负责卸载弹窗。一旦 acknowledge() 返回 false（写入未持久化），弹窗就一直挂着。durable（持久化）分支没有像 memory 分支那样的"本次会话内本地记住"兜底：

if (this.scope.getSnapshot().mode === "memory") {
  this.localAcknowledged = true;
  this.derive();
  return true;
}

2. 弹窗同时关掉了所有其他出口

OnboardingModal：

const ignoreImplicitDismiss = () => {};
return <Modal open title onClose={ignoreImplicitDismiss} headless ... />

• onClose 是空函数，关闭按钮 / 遮罩点击 / ESC 全部被吞掉；
• useEffect 把 document.getElementById("root").inert = true，整个应用根节点不可交互。

结果：点击"继续"成了唯一出路，而这条路恰恰是正在失败的那条。

3. 要持久化的字段本身被标记为"易失、不持久化"

host 端插件配置：

// packages/client/ui-settings-general/src/index.ts
const Config = z.object({ welcomeNoticeVersion: z.string().volatile() });

Cordis/schemastery 体系里 volatile() 的语义就是"运行时易失、不持久化"。settings 写入侧的 write() / strip() 逻辑会把 volatile 字段从持久化层剥离；scope.set(...) 之后 store 重新读取 scope.value.welcomeNoticeVersion 仍然是 undefined，于是 acknowledged 恒为 false，状态进入 error，显示"暂时无法保存确认状态"。一个"跨启动记住用户选择"的字段，却被标记成了 volatile，这是设计自相矛盾。

4. 错误状态下仍然只提供那个正在失败的按钮

按钮的禁用条件只看 status === "saving"，error 状态下"继续"依然可点，用户只能无限重复同一个失败动作，没有"跳过本次 / 稍后再说"的次级按钮。

为什么常规自救无效

• 编辑 settings.yaml / settings.yaml.imported：旧文件在首次启动迁移时被 rename 为 .imported，之后不再被读取；运行时配置已经迁到 cordis.patch.yml。
• 我曾在 .imported 文件里手动加过 welcomeNoticeVersion，但因为命名空间写错（写成了 ui-onboarding，正确应为 ui-settings-general），且该文件已废弃，弹窗依旧：

• 即使改对了文件，重启后弹窗仍在，因为真正生效的是 cordis.patch.yml，且该字段是 volatile：

• 刷新页面：store 重新读取仍为空的已确认值，弹窗再次弹出。

建议修复方向

1. 把"知情确认"和"持久化落盘"解耦：增加一个"跳过本次 / 稍后"次级按钮，走 process-local（本次会话内存内）确认后直接关闭。持久化失败只应意味着"下次再问"，绝不能意味着"这次用不了产品"。
2. 不要用一个非阻塞的声明弹窗锁死整个 App：至少在 error 状态下允许 ESC / 遮罩关闭（或显示关闭按钮），只在真正可操作时才设置 #root.inert = true。
3. 不要把跨启动确认字段标记为 volatile()：去掉 .volatile() 让它正常持久化，或为 durable 写入单独提供非 volatile 存储。
4. 错误状态的交互优化：error 时主按钮改为"重试"，增加"本次跳过"次级按钮，并加简单重试退避，避免连续打被拒的写入。

涉及文件

• packages/client/ui-settings-models/src/client/WelcomeNotice.js
• packages/client/ui-settings-models/src/client/OnboardingModal.js（onClose: ignoreImplicitDismiss、#root.inert = true）
• packages/client/ui-settings-models/src/client/welcome-store.js（acknowledge() 返回 false；仅 memory 分支有兜底）
• packages/client/ui-settings-general/src/index.ts（welcomeNoticeVersion: z.string().volatile()）
• host settings 侧 write() / strip() 逻辑（packages/settings/...）

[idleRain]

背景难绷

[bar851233656]

我误打误撞方法是在cordis.patch.yml

• id: ui-settings-general
  name: "@deepseek-ai/dsh-client-ui-settings-general"
  config:
  welcomeNoticeVersion: 2026-08-13.1 然后解决了

[wuchubuzai2018]

我也遇到这个了，虽然能解决，但是第三方插件的配置也无法保存