description: "通过 Config 派生表单查看和编辑插件的即时配置。" kind: "package-reference"

@x1a0f3n9/dsh-settings

English | 中文

概述

编辑插件通过 .volatile() 声明的字段，并查看其实际值。表单以 profile 条目 id 标识插件、保留秘密值，并拒绝过期写入。更改通过当前 profile 的 Cordis patch 持久化。

目录

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

使用此包

将此插件与 Loader 和 config-editor 一起挂载。基础组合包提供此组合。

- id: settings
  name: '@x1a0f3n9/dsh-settings'

此插件没有配置字段。表单只展示活动且可唯一定位的 profile 条目中的 volatile 字段。普通配置仍通过 Cordis 配置文件编辑。

Settings 启动后、Loader 完成所有条目的加载时，早期版本留在 harness home 中的 settings.yaml 会被导入一次：每个 section 写入同名条目（ui-developer-tools → ui-settings、ui-onboarding → ui-settings-general、shell → 当前平台的 shell 执行器条目），文件在第一次写入前改名为 settings.yaml.imported，被当前组合拒绝的 section 会记录日志并只保留在改名后的文件中。

重置恢复 profile 覆盖层以下的值，包括 schema 默认值。Home patch 和命令行 overlay 优先级更高；表单写入若会被它们覆盖，则被拒绝。

每个表单报告 autoGenerate（默认开启），供按 schema 生成页面的客户端使用；目前没有已发布的客户端这样做。自带页面的插件在 apply 中于可选的 ctx.inject(['settings'], ...) 子级内以 effect 注册 configure({ auto: false }, ctx.fiber)：子级指明策略所属的插件 fiber，迟加载或被替换的 Settings 服务也会采用该策略，业务插件无需 Settings 即可运行。策略不移除配置读写。

理解实现

表单投影 去除运行时引用和普通字段。服务 提供带修订号的描述符，在委托持久化前按完整插件 Config 验证编辑。业务插件直接读取自己的 Config 引用。

秘密角色从实际值、继承值、profile 覆盖值和 schema 默认值中隐藏；客户端接收存在性标记。路径编辑保留客户端未收到的字段。此服务投影 Loader 配置，不维护独立的权威值，因此不发布 invariant companion。

进一步探索

• 设置参考——表单值与修改。
• Volatile 配置——引用生命周期与通知。
• 配置编辑器——持久化与重载顺序。

模型体验

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

KV Cache 影响

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

已知限制与延后工作

• 嵌套 Include 独立拥有配置，不能通过当前 profile 的表单编辑。
• 字段重置恢复继承值，不能删除下层配置提供的值。取消设置数组索引会移除该元素。

开发备注

无。