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.
中文
简介
预设是 DSH 新会话的“开局配置包”：选定哪个预设，会话里的 AI 就是什么人设、什么能力。本插件把预设的编辑变成设置页里的一页可视化工具：
- 分段提示词：每段独立标题与内容，勾选框控制这段是否进入系统提示词（不勾 = 文字保留但不给 AI 看）
- 能力开关：15 项可选工具能力，勾选即写入组合文件、取消即移除，每次切换自动做挂载校验
- 会话里直接换预设：输入框上方一个胶囊，换预设后排到下一次自动压缩后生效；可设一直显示 / 悬浮才显示 / 不显示
- 内置模板：随插件自带「空提示词」一套裸模模板，任何机器安装即用
- 四页结构：查看 / 新建 / 预设是什么？ / 对话中切换预设
- 产出的预设是一等公民：每次保存都会在该预设目录里生成 bundle（
package.json+cordis.patch.yml）并登记进 profile，DSH 自己就能加载——卸载本插件也不影响这些预设 - 安全边界：系统预设只读；绝不覆盖本机已有预设；高权限能力带环境预检
功能
| 功能 | 说明 |
|---|---|
| 分段提示词编辑 | 每段：启用勾选 / 标题 / 内容，可增删段落 |
| 来源徽章 | 与随包模板同名或已改动的预设标 📦 / 📦·✏️，官方声明式预设标「官方预设」；自己创作的预设不显示徽章 |
| 新建预设 | 选模板后就地展开它的段落与能力开关，改完直接“另存为新预设”——模板本体不动，不必先复制再回头编辑 |
| 会话内切换 | 输入框上方的预设胶囊；已开始的会话排队到下一次自动压缩后生效，胶囊显示「当前 › 目标」，菜单里 ✓ 表示生效中、行尾「下次压缩后」表示待生效 |
| 胶囊显示方式 | 「对话中切换预设」页可选：一直显示 / 鼠标悬浮才出现 / 不显示（偏好存在本机浏览器） |
| 能力开关 | 15 项能力：勾选写入、取消移除、自动校验；含“预留接线（disabled）”模式。command-compact（/compact 命令）可关；人设与自动压缩仍锁定 |
| 打开目录 | 一键在资源管理器中打开该预设文件夹 |
| 校验挂载 | 模拟会话加载，报告组合错误 |
| 删除预设 | 两击确认防误删；仅限用户预设 |
来源徽章怎么看
| 徽章 | 含义 |
|---|---|
| 📦 内置模板 | id 与插件 templates/ 里的模板同名，且内容与模板逐字节一致——这些内容已随插件公开 |
| 📦 内置模板 · ✏️ 已改动 | 名字是模板，但内容有你自己的东西——不要假定它和模板一样可以公开 |
| 官方预设 | 由 DSH 官方或第三方插件声明，磁盘上没有目录，本工作台只能查看 |
判定规则：只比对一个方向——模板里的每个文件，在你的目录里是否都存在且内容相同。多出来的文件会被忽略，因为 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 安装后开箱即用。
使用
- 打开设置 → 预设工作台
- 下拉框选择一个用户预设（本机已有的，或你自己建的）
- 编辑各段提示词 → 点「💾 保存全部」→ 下次新开的会话生效
- 新建自己的预设：填 id（英文小写）与显示名 → 从模板创建 → 改内容 → 保存
- 给预设加能力：展开「🧰 能力开关」打勾，每次切换自动校验
能力开关
15 项可分三档：
| 档位 | 能力 |
|---|---|
| 🟢 安全 | 联网搜索+抓取、标准文件工具、AGENTS.md 工作区指令、技能库、提问确认、任务清单、后台任务、长期目标、规划模式 |
| 🟡 中等 | 子代理+工作流（含 Ralph 迭代代理） |
| 🔴 高危（带预检） | PPT/代码模式演示（需宿主 codeRuntime，否则安全拒绝）、插件改制工具 cordis_* |
| 🔌 预留接线 | Codex、Claude Code 产品子代理（写入官方同款 disabled 行，启用需另装捆绑）、一次性 bash/pwsh |
地基能力（命令 shell、文件编辑器、长对话压缩）永远在，不设开关、不受勾选影响。
内置模板
| 模板 | 说明 |
|---|---|
bare（空提示词） |
裸模模板：没有系统提示词、也没有工具（装配阶段清空工具表）；人设分段初始为空，加一段就有提示词 |
模板随插件打包发布，安装即用；创建时复制到新 id 名下，不影响本机已有同名预设。
工作原理
- 预设 =
.agent-presets/<id>下的一个文件夹（组合文件 + 提示词分段 + 元数据） - 本插件 = 设置页新页 + 一个 loopback HTTP 桥（
/api/preset-workbench） - 能力开关 = 在组合文件里插入/移除带标记的工具行；每次切换后自动跑挂载校验
- 模板复制 = 插件内
templates/只读素材 → 复制到新 id，重写显示名；id 被占用即拒绝，绝不覆盖 - 只改用户预设；官方内置预设（standard/code/minimal/cordis）一律只读
常见问题
- 会覆盖我已有的同名预设吗？ 不会。创建时检查 id，冲突则拒绝并提示“预设 id 已被占用”。
- 能改官方系统预设吗？ 不能，所有写操作仅限用户预设。
- 改动什么时候生效？ 保存后对之后新开的会话生效，当前会话不变。
许可
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 one bare template ("空提示词 / Bare"), ready on any machine after install
- Four tabs: View / New / What is a preset? / Switch preset mid-conversation
- Presets it writes are first-class: every save also generates a bundle (
package.json+cordis.patch.yml) and registers it in the profile, so DSH loads the preset itself — these presets keep working after this plugin is removed - Safety boundaries: system presets are read-only; existing local presets are never overwritten; high-power capabilities carry environment pre-checks
Features
| Feature | Description |
|---|---|
| Sectioned prompt editor | Per-section: enabled checkbox / title / content; add & remove sections |
| Provenance badge | Presets matching a shipped template are labelled 📦 / 📦·✏️ and declared presets are labelled "official"; your own presets carry no badge |
| Create presets | Pick a template and edit its sections and capabilities in place, then "Save as new preset" — the template itself is never modified, and there is no copy-then-edit round trip |
| Switch mid-conversation | Preset chip above the composer; a running session queues the switch until its next automatic compaction, the chip shows "current › target", and the menu marks ✓ for the active preset and "next compaction" for the pending one |
| Chip visibility | On the "Switch preset mid-conversation" page: always visible / on hover / hidden (preference stored in this browser) |
| Capability toggles | 15 capabilities, write-on-check / remove-on-uncheck, auto mount validation, plus "wired but disabled" mode |
| Open directory | One click to reveal the preset folder in the file explorer |
| Validate mount | Simulates session loading and reports composition errors |
| Delete preset | Double-click confirm (anti-mistake); user presets only |
Reading the provenance badge
| Badge | Meaning |
|---|---|
| 📦 Built-in template | The id matches a template in the plugin's templates/, and the content matches it byte for byte — that content is already public with the plugin |
| 📦 Built-in template · ✏️ modified | The name is a template's, but the content contains your own additions — do not assume it is as public as the template |
| Official preset | Declared by DSH or a third-party plugin with no directory on disk; view-only here |
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
- Open Settings → Preset Workbench
- Pick a user preset from the dropdown (Whale Girl / Liangshen / Bare / yours)
- Edit prompt sections → click「💾 Save All」→ takes effect on new sessions
- Create your own: fill in an id (lowercase english) + display name → create from template → edit → save
- Add capabilities: open「🧰 Capability Toggles」and check any item — each toggle auto-validates
Capabilities
15 items in three risk tiers:
| Tier | Items |
|---|---|
| 🟢 Safe | Web search + fetch, standard file tools, AGENTS.md, skills, ask-user confirmations, todo, background jobs, long-term goals, plan mode |
| 🟡 Medium | Subagents + workflows (incl. Ralph iterative agent) |
| 🔴 High (pre-checked) | PPT/code-mode presentation (requires host codeRuntime, otherwise safely refused), cordis_* plugin tooling |
| 🔌 Wired-but-disabled | Codex & Claude Code product subagents (official-style disabled rows; enable needs bundles), one-shot bash/pwsh |
Base capabilities (shell, file editor, compaction) are always on and not togglable.
Built-in Templates
| Template | Description |
|---|---|
bare（空提示词 / Bare） |
Raw-model template: no system prompt and no tools (the tool surface is emptied at assembly); the section list starts empty, so adding one section is what gives it a prompt |
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.
No comments yet. Be the first to write one.