Yichen Jiang
6758da87ae
One settings row picking which preset new sessions are composed from. It is deliberately a new-session preference, not a live switch: a session's preset is fixed at creation and the host refuses to adopt an existing session under a different one, so the row says "applies to sessions you start from now on" rather than implying it can retune a running agent. Options and the current value come from one `agentPreset.list` call — the roster already reports which id an unspecified session gets, so the row needs no settings-schema introspection, unlike the permission row it is modelled on. The write targets only the namespace's `default` field. The menu marks `user` rows: a locally authored preset is exactly as privileged as the plugins it names, and presenting it identically to a shipped one would hide that. An empty roster reads as `unavailable` and renders nothing, because composing no presets is a valid deployment rather than a failure — distinct from a roster call that failed, which surfaces its message.
2.3 KiB
2.3 KiB
dsh-client-ui-agent-preset
English | 中文
agent preset 表层：General 设置中的一行，用于选择新建会话据以组装的 preset。
为什么它是"新建会话"的偏好设置
会话的 preset 在创建时即固定——宿主拒绝以不同 preset 接管已存在的会话，因为该会话的历史是在最初那份 preset 的工具下产生的。因此本行不可能是实时切换，它也如实说明了这一点：更改只对此后开启的会话生效，而运行中的会话保持它们开始时的组装。
它读什么、写什么
选项与当前默认值都来自同一次 agentPreset.list 调用。名单本身已经报告了"未显式选择的会话会得到哪个 id"，因此本行无需对 settings schema 做内省；写入目标是 agent-presets settings 命名空间的 default 字段，也正是宿主在创建时解析的那个字段。
本地创作的 preset 的权限恰好等于它所引用的插件，因此列表会标注 user 行，而不是把每个 preset 都呈现为随附且已审核的。
本行在自身命名空间的 settings/changed 以及 connection/reset 时重新读取：名单是一个活动目录，默认值是一项设置，外部编辑与重新连接都可能改变它。
何时不显示本行
未组装任何 preset 的部署返回空名单，本行不渲染任何内容——此时每个会话共用宿主组装，也就无从选择。
Model Experience
Indirectly, through the preset a later session is composed from; dsh-agent-presets owns what that composition puts in front of the model.
KV Cache effect
没有直接的失效影响。更改默认值绝不触及运行中会话的前缀；此后创建的会话依据它自己的组装建立自己的前缀。
Known Limitations and Deferred Work
- 创建时无法逐会话选择 —— 本行只设置默认值。wire 上
session.create已经携带agentPreset，因此会话开启表层可以提供该选择；该表层尚不存在。 - preset 按 id 列出 —— preset 不携带展示用元数据，因此菜单显示的是目录名。
- 不提供创作能力 —— 创建、编辑或删除 preset 是文件系统行为；本表层只在名单提供的范围内做选择。