Skip to content

重启之后插件还在:
持久化的边界到底在哪 ​

一句话结论:「存下来了」和「生效了」是两件事。持久化的难点不在写入,在划清哪类状态跨重启保留、哪类必须每次重建、哪类变更要等一次重启才生效。

持久化的三层:写入、加载、生效,以及重启时的覆盖顺序

一、一个很常见的错觉 ​

插件化的工作环境里,有个体验大家都很熟悉:装好的扩展,同一配置下各个会话都能用,关掉重开也还在;可替换一个已经装好的插件,往往要重启一次才真正换过来。

前一半让人觉得「状态很稳」,后一半让人觉得「明明改了怎么没变」。其实这两件事是同一套规则的两面:持久化解决的是"下次还在",生效时机解决的是"这次算不算"。把它们混成一个「保存」按钮,就会出现各种说不清的怪现象。

设计记录里把这种边界写得很细:哪些变更即时生效、哪些需要重启、插件管理能列能装能停能卸、变更跨会话持久。这类口径属于设计描述,不是独立验证过的效果结论,只用来引出问题,不当事实背书。

二、三类状态,三种处理 ​

第一类:用户意图,必须持久。 装了哪些、怎么配、哪个开关被关掉、哪次审批给了什么结论。这类数据的特征是「丢了就回不去」,而且往往没有第二个来源可以重建。它们该有明确的归属、明确的写入口,最好还能导出成看得懂的东西。

第二类:运行时推导,必须每次重建。 当前会话里哪些工具可用、缓存的解析结果、本次启动翻转过的开关、临时目录里的中间文件。它们是从第一类推出来的,留着只会在下次启动时变成「旧世界的残留」。这类状态最典型的坑是:有人为了省事把它也写进配置,于是重启后旧值把新值覆盖了。

第三类:需要一次明确切换才生效。 替换已装的插件、换模型路由、改影响全局的注册表。它既不是纯意图也不是纯推导,改动会牵动已经在跑的对象。硬要在运行中热切,容易出现一半旧一半新;要求重启,反而是用一次干净的重建换确定性。

划错边界的后果很具体:把第二类写成持久,会得到「我明明改了,重启后又变回去了」;把第一类当成推导,会得到「重装一次,几个月调的配置全没了」。

三、我们踩过的那一下 ​

项目里有过一个很能说明问题的例子:某个模型注册开关,在页面里改完立刻看着生效了,可进程一重启就被启动时的初始化覆盖回默认。查下来不是写入失败,是这个开关被同时放在了两个地方——一份持久配置,一份启动时的默认值,后者每次都会重新写一遍。

修法不是加一次写入,是把真源收成一份:谁负责这个值、启动时谁读它、运行时谁改它,只留一条链。之后才谈要不要重启。

同类的还有「配置改了不等于功能生效」:改完必须有一次可观察的验证动作,确认读到的确实是新值,而不是页面回显了输入框里的内容。回显不等于生效,这条在调试时特别容易骗到人。

四、怎么判断该不该重启 ​

一个实用的判据:问「这个改动会不会影响已经创建好的对象」。

  • 只影响下一次读取的(新增一个条目、改一处展示文案),通常即时生效;
  • 会影响已创建对象的(替换实现、改全局表、换底层连接),要求重启更稳;
  • 说不清属于哪种的,先按需要重启处理,并给一次明确的验证动作,别猜。

还有一条经验值得记:持久化的数据要能被看见和导出。配置留在本地不是目的,出问题时能翻出来看、能搬走、能重建,才是。相关的工作流与状态约定见工作流配置;工具与配置的真实边界写在工具能力清单。

延伸阅读:《上下文预算》 讲常驻说明的成本;《插件装好≠插件能用》 讲配置丢失的具体代价;《AI 自己给自己造插件》 讲验收权。


文中外部产品的设计记录与预印本仅作背景引子,未独立复现、不宣称采用其方法;文中「我们」的做法为机制描述,不构成效果承诺。