dsh-preset-workbench

dsh-preset-workbench

在 DSH（DeepSeek Harness）设置页里，创建与编辑 Agent 预设的可视化工作台——不用写 YAML，不用求创造模式代劳。 A visual workbench on the DSH (DeepSeek Harness) Settings page for creating and editing agent presets — no YAML, no asking the "creation mode" to do it for you.

---

中文 · English

---

中文

简介

预设是 DSH 新会话的“开局配置包”：选定哪个预设，会话里的 AI 就是什么人设、什么能力。本插件把预设的编辑变成设置页里的一页可视化工具：

• 分段提示词：每段独立标题与内容，勾选框控制这段是否进入系统提示词（不勾 = 文字保留但不给 AI 看）
• 能力开关：15 项可选工具能力，勾选即写入组合文件、取消即移除，每次切换自动做挂载校验
• 会话里直接换预设：输入框上方一个胶囊，换预设后排到下一次自动压缩后生效；可设一直显示 / 悬浮才显示 / 不显示
• 内置模板：随插件自带“鲸鱼娘”“梁神模式”“空提示词”三套预设，任何机器安装即用
• 四页结构：查看 / 新建 / 预设是什么？ / 对话中切换预设
• 安全边界：系统预设只读；绝不覆盖本机已有预设；高权限能力带环境预检

功能

来源徽章怎么看

判定规则：只比对一个方向——模板里的每个文件，在你的目录里是否都存在且内容相同。多出来的文件会被忽略，因为 sections.json 是预设唯一的段落清单（没有自动发现机制）：你真正用到的内容要么改动了模板文件，要么改动了 sections.json，两种都会被判为「已改动」；而未被引用的多余文件不会进入预设渲染，据此报警只会产生误报。

安装

# 从本地目录安装
dsh plugin add --profile web <本插件目录的绝对路径>

# 或从 GitHub 仓库安装
dsh plugin add --profile web github:<你的用户名>/dsh-preset-workbench

安装后重启 dsh，打开 设置 → 预设工作台 即可使用。包内含 templates/（鲸鱼娘、梁神、空提示词三套内置模板），所以 npm install dsh-preset-workbench 或 dsh plugin add dsh-preset-workbench 安装后开箱即用。

使用

1. 打开设置 → 预设工作台
2. 下拉框选择一个用户预设（鲸鱼娘 / 梁神 / 空提示词 / 你自己建的）
3. 编辑各段提示词 → 点「💾 保存全部」→ 下次新开的会话生效
4. 新建自己的预设：填 id（英文小写）与显示名 → 从模板创建 → 改内容 → 保存
5. 给预设加能力：展开「🧰 能力开关」打勾，每次切换自动校验

能力开关

15 项可分三档：

地基能力（命令 shell、文件编辑器、长对话压缩）永远在，不设开关、不受勾选影响。

内置模板

模板随插件打包发布，安装即用；创建时复制到新 id 名下，不影响本机已有同名预设。

工作原理

• 预设 = .agent-presets/<id> 下的一个文件夹（组合文件 + 提示词分段 + 元数据）
• 本插件 = 设置页新页 + 一个 loopback HTTP 桥（/api/preset-workbench）
• 能力开关 = 在组合文件里插入/移除带标记的工具行；每次切换后自动跑挂载校验
• 模板复制 = 插件内 templates/ 只读素材 → 复制到新 id，重写显示名；id 被占用即拒绝，绝不覆盖
• 只改用户预设；官方内置预设（standard/code/minimal/cordis）一律只读

常见问题

• 会覆盖我已有的同名预设吗？ 不会。创建时检查 id，冲突则拒绝并提示“预设 id 已被占用”。
• 能改官方系统预设吗？ 不能，所有写操作仅限用户预设。
• 改动什么时候生效？ 保存后对之后新开的会话生效，当前会话不变。

许可

MIT

---

English

Intro

Presets are DSH's "starting config pack" for new sessions: choosing a preset defines who the session's AI is and what it can do. This plugin turns preset editing into one visual page inside Settings:

• Sectioned prompts: each section has its own title/content; the checkbox decides whether it enters the system prompt (unchecked = text kept but hidden from the AI)
• Capability toggles: 15 optional tool capabilities — check to write the rows into the composition, uncheck to remove, auto-validated on every toggle
• Switch preset mid-conversation: a chip above the composer; a switch queues until the next automatic compaction. Choose always visible / on hover / hidden
• Built-in templates: ships with three presets ("鲸鱼娘 / Whale Girl", "梁神模式 / Liangshen Mode", "空提示词 / Bare"), ready on any machine after install
• Four tabs: View / New / What is a preset? / Switch preset mid-conversation
• Safety boundaries: system presets are read-only; existing local presets are never overwritten; high-power capabilities carry environment pre-checks

Features

Reading the provenance badge

How "modified" is decided: only one direction is compared — for every file in the shipped template, does your directory contain it with identical content? Extra files are ignored, because sections.json is the preset's only section manifest (there is no auto-discovery): anything you actually use either changes a template file or changes sections.json, and both are detected, while unreferenced leftovers never reach the rendered preset and would only cause false alarms.

Install

# local directory
dsh plugin add --profile web /absolute/path/to/this/plugin

# or from GitHub
dsh plugin add --profile web github:<your-username>/dsh-preset-workbench

Restart dsh after installing, then open Settings → 预设工作台 (Preset Workbench). The package ships templates/ (Whale Girl, Liangshen & Bare built-in templates), so npm install dsh-preset-workbench or dsh plugin add dsh-preset-workbench works out of the box.

Usage

1. Open Settings → Preset Workbench
2. Pick a user preset from the dropdown (Whale Girl / Liangshen / Bare / yours)
3. Edit prompt sections → click「💾 Save All」→ takes effect on new sessions
4. Create your own: fill in an id (lowercase english) + display name → create from template → edit → save
5. Add capabilities: open「🧰 Capability Toggles」and check any item — each toggle auto-validates

Capabilities

15 items in three risk tiers:

Base capabilities (shell, file editor, compaction) are always on and not togglable.

Built-in Templates

Templates are packed with the plugin; creation copies them to a new id and never touches local presets with the same name.

How It Works

• A preset is a folder under .agent-presets/<id> (composition + prompt sections + metadata)
• This plugin = one new Settings page + a loopback HTTP bridge (/api/preset-workbench)
• Capability toggles insert/remove marked tool rows in the composition file; every toggle runs a mount validation
• Template creation copies read-only assets from templates/ to the new id and rewrites the display name; occupied ids are refused — never overwritten
• Only user presets are writable; official presets (standard/code/minimal/cordis) are always read-only

FAQ

• Will it overwrite an existing preset with the same id? No. Creation checks for occupied ids and refuses with "预设 id 已被占用".
• Can I edit the official system presets? No; every write is restricted to user presets.
• When do changes take effect? Saved changes apply to newly opened sessions; the current session is unchanged.

License

MIT