dsh-preset-workbench:在 DSH 设置页可视化编辑 Agent 预设

前言

在 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,打开 设置 → 预设工作台 即可使用。

典型用法

  1. 打开 设置 → 预设工作台。
  2. 在下拉框选择用户预设(鲸鱼娘 / 梁神 / 空提示词或自建预设)。
  3. 编辑各段提示词,点击「保存全部」——对之后新开的会话生效,当前会话不变。
  4. 新建预设:填写 id 与显示名 → 从模板创建 → 修改内容与能力开关 → 保存。
  5. 展开「能力开关」勾选所需能力,每次切换会自动校验。

若要在对话中换预设,使用输入框上方胶囊;切换在下次自动压缩后生效,菜单中用 ✓ 与「下次压缩后」区分当前与待生效项。

适用场景与注意

适合谁:需要经常调整 Agent 人设与工具组合、又不想直接维护 YAML 的 DSH 用户;希望用模板快速 fork 出自定义预设的开发者。

生效范围:保存与切换规则以 README 为准——保存后对新会话生效;会话内切换排队到下一次自动压缩。

安全与信任:插件以当前 dsh 进程权限读写本机预设目录;高危能力带环境预检。安装前建议阅读 MIT 许可证 与仓库源码。DSH 生态强调「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。

常见问题(摘自 README):不会覆盖已有同名预设;不能修改官方系统预设;改动对新会话生效。

结尾

dsh-preset-workbench 把 Agent 预设编辑收敛到设置页:分段提示词、15 项能力开关、三套内置模板与会话内切换,并明确区分内置模板、自定义与官方只读预设。若你已在用 DSH >=0.2.0-rc.1,可按上文命令安装并重启后进入预设工作台试用。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye