Yichen Jiang
f8555b5561
The section knows no namespace: it declares `settings.plugin.item` and renders whatever cards were registered into it, so a plugin that ships a browser half owns its card and its controls. The three cards here cover the host-plane sections this deployment exposes. A field shows its effective value and, when the raw user layer carries it, an override badge and a reset that clears it back to the composition layer. Controls commit on blur and Enter rather than per keystroke, which would burn namespace revisions and race its own reads. The search key is the one value that never rides a response: the card reports only whether one is configured and writes it through the credentials domain, addressed by the reference the section names. A card renders nothing while its namespace is unavailable — a deployment that does not compose the owning plugin should show no trace of it rather than a disabled card the user cannot act on.
2.8 KiB
2.8 KiB
dsh-client-ui-plugin-config
English | 中文
插件设置分区：每个配置由用户拥有的 Host 插件占一张可展开卡片。卡片展示插件名称及其管辖范围；就地展开后是绑定到该插件 settings 命名空间的手写控件，每个字段标注用户是否覆盖过它，并提供重置回部署组装值的入口。
这里会出现什么
只有当某个命名空间既被存活的 Host 插件注册、又被服务给浏览器时，它的卡片才会渲染。未组装该插件的部署——或未向任何客户端服务该命名空间的部署——不会渲染空卡片或禁用卡片，而是什么都不渲染，因此这一分区反映的是该部署实际运行的东西。
第一批覆盖 shell 执行器（bash）、agent 循环的工具调用并行度（agent-loop）以及 DeepSeek 搜索提供方（web-search-deepseek）。
扩展点
本分区声明了根级列表 slot settings.plugin.item。带浏览器半侧的插件把自己的卡片注册进该 slot 并拥有其控件；本包既不枚举命名空间，也不渲染未被交给它的表单。排序遵循 slot 的 order。
写入
每个控件都通过客户端 settings scope 写入单个字段，该 scope 用读取时的命名空间 revision 为每次写入设栅，因此已与文档脱节的表单会被拒绝，而不是覆盖并发变更。字段是否被覆盖，取决于它是否出现在原始用户层中，而非取决于它的值；重置会清除该字段，使其重新继承组装层。secret 角色的字段绝不搭乘响应，因此密钥控件只报告是否已配置，并经由 credentials 领域而非 settings 分节写入。
模型体验
无。该分区渲染浏览器配置 UI；它写入的值只通过拥有这些值的插件到达模型，而这些效应各由其拥有方的包记录。
KV Cache 影响
无；该包既不组装也不发送提供方请求。
已知限制与暂缓事项
- 只有宿主平面的插件会出现——由 agent preset 挂载的插件把配置内联在该 preset 的
agent.cordis.yml中，且根本无法注册 settings 命名空间（同一 preset 挂载第二个会话时会因重复注册而失败），因此本分区不会列出它。编辑那些值仍是 preset 编辑器的职责。 - 暴露是 Host 的白名单，而非插件的声明——不在 api-proxy 白名单中的命名空间，即便其拥有方已注册，也只会得到
settings-not-exposed，因此在本仓库之外分发的插件无法在不改动packages/host/apiproxy的前提下让自己的配置出现在这里。 - shell 卡片跟随被组装的执行器——POSIX 与 PowerShell 两个执行器家族共用
bash命名空间，因为一个宿主只组装其中之一，所以该卡片的字段随平台不同，而两者都不组装的部署不会显示这张卡片。