description: "保存当前 profile 配置，并通过 Loader 应用。" kind: "package-reference"

@liusiqi-dev/dsh-config-editor

English | 中文

概述

将插件配置保存到当前 profile 的 patch 并立即应用。写入在改动磁盘前验证完整候选值，并与 profile 更改及 HMR 串行执行。无效值和更高层覆盖不会改动文件。

目录

• 使用此包
• 理解实现
• 进一步探索
• 模型体验
• 已知限制与延后工作
• 开发备注

使用此包

在具有 Loader 和 profileContext 的 profile 应用中挂载此服务。它没有配置字段。

- id: config-editor
  name: '@liusiqi-dev/dsh-config-editor'

使用 settings 提供只编辑即时字段的表单。编辑完整配置的调用方可使用 ctx.configEditor.edit()；普通字段保留 Loader 的正常生命周期。

理解实现

编辑器 在派生候选配置前应用外部更改，与其他 profile 操作共同锁定 profile manifest，并原子替换配置覆盖项。它保留替换值以外的 YAML 注释和 !!js 表达式。应用失败时恢复之前的文档并重新加载之前的 patch。

读取配置时，没有 profile config 覆盖项的条目共用一次组合结果。有覆盖项的条目分别组合，仅移除自身的覆盖项；profile 插入的条目和其他条目的覆盖项仍然生效。返回的配置为独立副本，组合结果不跨读取缓存。

此包不发布 invariant companion：编辑器不维护独立配置投影。Loader 和持久化的 profile patch 拥有配置状态。

进一步探索

• Profile 加载——patch 组合。
• HMR——重载协调。
• 设置——schema 派生表单。

模型体验

通过面向模型的插件读取的配置值间接影响模型。

KV Cache 影响

改变请求前缀的消费者决定缓存影响。

已知限制与延后工作

• 编辑写入当前 profile patch。Home patch 和命令行 overlay 参与优先级解析，但不作为写入目标。
• 完整配置覆盖保留普通字段，但会在 profile 层固定其当前原始值。
• 仅可编辑 profile 根 Include 拥有且可唯一定位的条目。

开发备注

无。