异步保存解决了请求等待问题,也让前端需要同时处理编辑草稿、已保存设置和任务结果。页面刚刷新时读到的数据,可能比正在执行的任务旧;读取失败时,也不能直接用空配置替代。
本篇只讨论浏览器与配置接口之间的状态恢复。相关实现来自 singbox-merlin 0.5.42,重点是保留后续编辑,区分正常空值与异常读取,并让旧配置迁移真正反映用户操作。
一、刷新页面,也可能把新配置覆盖回旧配置
一个比较隐蔽的问题发生在任务进行中刷新页面。
页面先读到旧设置,随后任务执行完,服务端已经保存新设置。如果前端只更新“已保存”状态,却继续保留初始化时的旧草稿,下一次点保存,就可能把刚生效的新设置覆盖回去。
处理时不能简单规定“任务完成后覆盖所有表单”。因为用户可能在等待期间继续编辑,这些后续修改也应该保留。
本次修复按照草稿是否存在后续编辑决定同步方式:干净草稿跟随最新设置,有新编辑的草稿继续保留。进行中的配置刷新会合并,并在需要时补充一次读取;页面生命周期之间的迟到响应也要区分处理。
前端因此需要知道每份数据的来源:它是旧的初始化结果、任务完成后的读取,还是用户刚输入的内容。
frontend/src/context/AppContext.tsx 的 applyRouterConfig 把实际配置更新与草稿同步放在同一处。省略界面错误状态后,关键代码是:
const previous = submitted || confirmedConfig.current;
confirmedConfig.current = actual;
setRouterConfig(actual);
setConfigDraft(draft =>
!draft || !routerDraftChanged(draft, previous) ? actual : draft
);
actual 是刚确认的服务端配置,previous 使用本次提交或上次确认的配置作比较基准。没有草稿,或者草稿相对这个基准没有后续变化,就同步 actual;有后续编辑则继续保留草稿。
这里使用函数式状态更新,判断基于更新时拿到的草稿,而不是请求发出时闭包里保存的旧值。它解决草稿同步;迟到读取和刷新合并还由其他生命周期与请求状态逻辑负责,不能只复制这个片段就认为所有竞态已消失。
二、配置读取失败,不能伪装成空配置
另一类问题来自梅林 DBus 中额外转义的 JSON。
接口请求可能成功,但返回内容经过字符串包装或多层转义,前端解析失败。此前统一显示“暂未读取配置”,既看不出真实原因,也无法区分未配置与读取异常。
现在网关返回标准 JSON,前端兼容已有的转义和包装格式,异常时显示具体错误并保留草稿。读取过程不顺手改写 DBus,避免查询动作改变保存状态。
订阅迁移也有类似要求。读取旧版订阅字符串需要兼容,但结构化保存后必须清理旧记录。删除最后一份订阅且没有本地来源时,也不能回退到旧运行节点,让界面显示“已经删除”,实际却继续沿用旧内容。
兼容处理需要让用户的新增、修改和删除都真实生效。
三、用一条时间线检查覆盖风险
假设页面发出配置读取 A,后台保存任务随后完成,再发出读取 B。即使 A 比 B 晚返回,它也不应覆盖任务完成后得到的新状态。这是检查慢响应问题的一条示例时间线,不代表每个请求都一定按此顺序执行。
草稿还要增加另一项判断:用户是否在任务开始后继续编辑。没有后续修改时可以同步最新设置,有后续修改时则保留当前草稿,避免服务器刷新吞掉输入。
仓库审查记录覆盖慢响应、刷新恢复、后续编辑保留和转义配置读取。继续读 docs/review-save-start-2026-10-03.md 时,可以先按时间列出读取与保存动作,再对照前端回归。本文没有重新执行浏览器测试。
本系列对应仓库目前为私有,代码片段取自已核对的实现;删去的字段或流程已在相关段落注明。