前言¶
在 DSH(DeepSeek Harness)里,预设决定新会话的「开局配置」:选哪个预设,会话里的 AI 就带什么人设、挂载哪些工具。若只能手改 .agent-presets 下的组合文件和 YAML,或依赖创造模式代写,迭代成本高、也容易写错挂载。下面介绍社区插件 dsh-preset-workbench(维护者 DDDMUC),它在 DSH 设置页提供一页可视化工作台,用分段提示词、能力开关和内置模板完成预设的查看、新建与编辑,无需手写 YAML。
这是什么¶
dsh-preset-workbench 是 DSH 的客户端类插件(package.json 中 dsh.client.platform 为 web)。定位是:在 设置 → 预设工作台 中创建与编辑用户 Agent 预设;同时通过插件机制把磁盘上的用户预设声明进 DSH 预设注册表。
实现上,插件在设置页增加 UI,并通过 loopback HTTP 桥(/api/preset-workbench)读写本机 .agent-presets/<id> 目录。预设由组合文件、提示词分段(sections.json 为段落清单)与元数据组成。系统预设(如 standard、code、minimal、cordis)只读;写操作仅限用户预设,且创建时若 id 冲突会拒绝,不会覆盖本机已有同名预设。
插件要求 DSH 版本 >=0.2.0-rc.1(见 package.json 的 dsh.engines)。当前 npm 包版本为 1.1.0,许可证 MIT。社区目录页:skillhub.cn/plugins/DDDMUC/dsh-preset-workbench;源码:github.com/DDDMUC/dsh-preset-workbench。
核心功能¶
分段提示词¶
每段提示词有独立标题与内容,并带启用勾选框:勾选则进入系统提示词,不勾选则文字仍保留在编辑器里,但不发给 AI。可增删段落,改完后保存。
能力开关¶
共 15 项可选工具能力:勾选即写入预设组合文件,取消即移除;每次切换会自动做挂载校验。部分能力为「预留接线(disabled)」模式;command-compact(/compact 命令)可关,人设与自动压缩相关能力仍锁定。命令 shell、文件编辑器、长对话压缩等地基能力不设开关。
README 按风险分档概括如下(具体项以设置页为准):
| 档位 | 能力类型(摘要) |
|---|---|
| 安全 | 联网搜索与抓取、标准文件工具、AGENTS.md、技能库、提问确认、任务清单、后台任务、长期目标、规划模式等 |
| 中等 | 子代理与工作流(含 Ralph 迭代代理) |
| 高危(带环境预检) | PPT/代码模式演示(需宿主 codeRuntime)、插件改制工具 cordis_* 等 |
| 预留接线 | Codex、Claude Code 产品子代理、一次性 bash/pwsh 等(写入官方同款 disabled 行) |
来源徽章¶
每个预设会标注来源,便于区分内置模板与自建内容:
| 徽章 | 含义 |
|---|---|
| 内置模板 | id 与插件 templates/ 中模板同名,且内容与模板逐字节一致 |
| 内置模板 · 已改动 | 基于模板 id,但内容已有修改 |
| 自定义 | 非内置模板,为用户自建 |
| 官方预设 | 由 DSH 或第三方插件声明、磁盘无目录,工作台仅可查看 |
新建、校验与目录¶
- 新建预设:填写英文小写 id 与显示名,从模板就地展开段落与能力开关,改完后「另存为新预设」,模板本体不被修改。
- 校验挂载:模拟会话加载,报告组合错误。
- 打开目录:在资源管理器中打开该预设文件夹。
- 删除预设:两击确认,仅限用户预设。
会话内切换预设¶
输入框上方提供预设「胶囊」:可在对话中切换预设;已开始的会话会排队到下一次自动压缩后生效,胶囊可显示「当前 › 目标」。在「对话中切换预设」页可设置胶囊为一直显示、鼠标悬浮才出现或不显示(偏好存于本机浏览器)。
内置模板¶
安装后随插件自带三套模板(templates/),任意机器安装即可用:
| 模板 id | 说明 |
|---|---|
cetacea(鲸鱼娘) |
极简角色扮演:持久 shell、文件编辑器、压缩与分段人设 |
liangshen(梁神模式) |
全功能向:文件/搜索/技能/目标/规划/压缩/子代理/workflow/Ralph/联网等 |
bare(空提示词) |
裸模:初始无系统提示词与工具表,分段为空,自行添加 |
工作台 UI 分为四块:查看、新建、预设是什么?、对话中切换预设。
安装与启用¶
从 README 原文,安装方式包括本地路径、GitHub 与 npm:
# 从本地目录安装
dsh plugin add --profile web <本插件目录的绝对路径>
# 或从 GitHub 仓库安装
dsh plugin add --profile web github:<你的用户名>/dsh-preset-workbench
针对本仓库,可将占位用户名替换为维护者路径,例如:
dsh plugin add --profile web github:DDDMUC/dsh-preset-workbench
README 还说明:包内含 templates/,因此也可使用:
npm install dsh-preset-workbench
或:
dsh plugin add dsh-preset-workbench
安装后重启 dsh,打开 设置 → 预设工作台 即可使用。
典型用法¶
- 打开 设置 → 预设工作台。
- 在下拉框选择用户预设(鲸鱼娘 / 梁神 / 空提示词或自建预设)。
- 编辑各段提示词,点击「保存全部」——对之后新开的会话生效,当前会话不变。
- 新建预设:填写 id 与显示名 → 从模板创建 → 修改内容与能力开关 → 保存。
- 展开「能力开关」勾选所需能力,每次切换会自动校验。
若要在对话中换预设,使用输入框上方胶囊;切换在下次自动压缩后生效,菜单中用 ✓ 与「下次压缩后」区分当前与待生效项。
适用场景与注意¶
适合谁:需要经常调整 Agent 人设与工具组合、又不想直接维护 YAML 的 DSH 用户;希望用模板快速 fork 出自定义预设的开发者。
生效范围:保存与切换规则以 README 为准——保存后对新会话生效;会话内切换排队到下一次自动压缩。
安全与信任:插件以当前 dsh 进程权限读写本机预设目录;高危能力带环境预检。安装前建议阅读 MIT 许可证 与仓库源码。DSH 生态强调「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。
常见问题(摘自 README):不会覆盖已有同名预设;不能修改官方系统预设;改动对新会话生效。
结尾¶
dsh-preset-workbench 把 Agent 预设编辑收敛到设置页:分段提示词、15 项能力开关、三套内置模板与会话内切换,并明确区分内置模板、自定义与官方只读预设。若你已在用 DSH >=0.2.0-rc.1,可按上文命令安装并重启后进入预设工作台试用。