description: "在 Web 中选择 Agent preset 和新任务默认值，查看各模式的说明与声明的配置。创建与修改引导至创造模式。" kind: "package-reference"

@deepseek-ai/dsh-client-ui-agent-preset

English | 中文

概述

在 Web 中选择 Agent preset 和新任务默认值，查看各模式的说明与声明的配置。创建与修改引导至创造模式。

目录

• 使用此包
• 理解实现
• 延伸阅读
• 模型体验
• 已知限制与待办
• 开发备注

使用此包

设置页显示内置与自定义卡片分组、默认项高亮和点击卡片选择；没有 preset 的分组不显示，但自定义分组会保留其创造入口。每张卡片都提供「查看配置」，以只读 YAML 打开该 preset 声明的插件列表，使用 Loader 自己的方言（含 !!js 条件）；加载失败的 preset 同样可读，因为其诊断信息正指向这份 YAML。Escape 只关闭查看器并将焦点还给卡片；离开设置页会清空查看器，迟到的读取结果不会重新打开它。本页不编辑任何内容：创造入口启动一个创造模式任务，以 bundle 形式创建或覆盖 preset；当 cordis preset 在列表中且存在会话流程时提供。

通用设置中的代码工作工具决定能否选择模式：关闭后新会话选择器消失，而设置卡片仍可选择继续用于新任务的已保存默认值，Creator 入口也保持可用。开启时，选择健康定义作为默认值也会同步当前新任务页面的空白会话；关闭时，被复用的空白会话保留原预设。Creator 入口开启一个使用 cordis preset 的新任务。

已知的内置预设提供只读的模式说明与使用示例对话框。各页签保留各自的滚动位置；关闭后焦点回到打开它的操作。帮助不会改变新任务默认值。默认徽标取代卡片的分组徽标，预设 id 显示在标题旁。指南文案与示例归本包所有。

理解实现

agentPresets/list 提供列表并标记当前默认值，agentPresets/read 为查看器提供一条声明的 YAML；默认值的修改写入 agent-preset-registry settings 命名空间。选择器、空白会话同步和只读会话标签使用记录的 preset 标识。连接重置和设置更新会刷新列表。

延伸阅读

• Scope — 注册隔离。
• Agent — 会话运行时。
• Cordis — 插件配置与生命周期。

模型体验

通过选定的 preset 间接影响模型，其插件拥有模型可见能力。

KV Cache effect

选择变更只影响之后的任务，已有插件与提示词保持不变。

已知限制与待办

• Web 不创建也不编辑 preset：配置查看器是只读的；通过创造模式安装的 bundle 声明新 preset，或按行 id 覆盖内置 preset，覆盖会替换整个子插件列表。

开发备注

无。

运行时不变量： 不发布 companion；状态由 Host 注册表拥有，客户端展示与选择行为由组件测试验证。