dsh-preset-workbench 0.0.0-stage → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-preset-workbench contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,206 @@
-# Temporary Holding Version
+# dsh-preset-workbench
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> 在 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](#english)**
+
+---
+
+## 中文
+
+## 简介
+
+预设是 DSH 新会话的“开局配置包”：选定哪个预设，会话里的 AI 就是什么人设、什么能力。本插件把预设的编辑变成设置页里的一页可视化工具：
+
+- **分段提示词**：每段独立标题与内容，勾选框控制这段是否进入系统提示词（不勾 = 文字保留但不给 AI 看）
+- **能力开关**：15 项可选工具能力，勾选即写入组合文件、取消即移除，每次切换自动做挂载校验
+- **内置模板**：随插件自带“鲸鱼娘”“梁神模式”“空提示词”三套预设，任何机器安装即用
+- **安全边界**：系统预设只读；绝不覆盖本机已有预设；高权限能力带环境预检
+
+## 功能
+
+| 功能 | 说明 |
+| --- | --- |
+| 分段提示词编辑 | 每段：启用勾选 / 标题 / 内容，可增删段落 |
+| **来源徽章** | 每个预设标注 📦 内置模板 / 📦·✏️ 已改动 / 👤 自定义 / 官方预设，一眼分清“随插件发布的模板”和“你自己创作的” |
+| 新建预设 | 选择内置模板或本机已有预设，一键复制（自带分段装载器） |
+| 能力开关 | 15 项能力：勾选写入、取消移除、自动校验；含“预留接线（disabled）”模式 |
+| 打开目录 | 一键在资源管理器中打开该预设文件夹 |
+| 校验挂载 | 模拟会话加载，报告组合错误 |
+| 删除预设 | 两击确认防误删；仅限用户预设 |
+
+### 来源徽章怎么看
+
+| 徽章 | 含义 |
+| --- | --- |
+| 📦 **内置模板** | id 与插件 `templates/` 里的模板同名，且内容与模板**逐字节一致**——这些内容已随插件公开 |
+| 📦 **内置模板 · ✏️ 已改动** | 名字是模板，但内容有你自己的东西——**不要假定它和模板一样可以公开** |
+| 👤 **自定义** | 不在内置模板之列，是你自己创作的预设 |
+| **官方预设** | 由 DSH 官方或第三方插件声明，磁盘上没有目录，本工作台只能查看 |
+
+**判定规则**：只比对一个方向——模板里的每个文件，在你的目录里是否都存在且内容相同。多出来的文件会被忽略，因为 `sections.json` 是预设唯一的段落清单（没有自动发现机制）：你真正用到的内容要么改动了模板文件，要么改动了 `sections.json`，两种都会被判为「已改动」；而未被引用的多余文件不会进入预设渲染，据此报警只会产生误报。
+
+## 安装
+
+```bash
+# 从本地目录安装
+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 项可分三档：
+
+| 档位 | 能力 |
+| --- | --- |
+| 🟢 安全 | 联网搜索+抓取、标准文件工具、AGENTS.md 工作区指令、技能库、提问确认、任务清单、后台任务、长期目标、规划模式 |
+| 🟡 中等 | 子代理+工作流（含 Ralph 迭代代理） |
+| 🔴 高危（带预检） | PPT/代码模式演示（需宿主 codeRuntime，否则安全拒绝）、插件改制工具 cordis_* |
+| 🔌 预留接线 | Codex、Claude Code 产品子代理（写入官方同款 disabled 行，启用需另装捆绑）、一次性 bash/pwsh |
+
+地基能力（命令 shell、文件编辑器、长对话压缩）永远在，不设开关、不受勾选影响。
+
+## 内置模板
+
+| 模板 | 说明 |
+| --- | --- |
+| `cetacea`（鲸鱼娘） | 极简角色扮演模板：持久 shell + 文件编辑器 + 压缩 + 分段人设（自带分段装载器） |
+| `liangshen`（梁神模式） | 全功能预设：文件/搜索/技能/目标/规划/压缩/子代理/workflow/Ralph/联网等 |
+| `bare`（空提示词） | 裸模模板：没有系统提示词、也没有工具（装配阶段清空工具表）；人设分段初始为空，加一段就有提示词 |
+
+模板随插件打包发布，安装即用；创建时复制到新 id 名下，**不影响本机已有同名预设**。
+
+## 工作原理
+
+- 预设 = `.agent-presets/<id>` 下的一个文件夹（组合文件 + 提示词分段 + 元数据）
+- 本插件 = 设置页新页 + 一个 loopback HTTP 桥（`/api/preset-workbench`）
+- 能力开关 = 在组合文件里插入/移除带标记的工具行；每次切换后自动跑挂载校验
+- 模板复制 = 插件内 `templates/` 只读素材 → 复制到新 id，重写显示名；id 被占用即拒绝，绝不覆盖
+- 只改用户预设；官方内置预设（standard/code/minimal/cordis）一律只读
+
+## 常见问题
+
+- **会覆盖我已有的同名预设吗？** 不会。创建时检查 id，冲突则拒绝并提示“预设 id 已被占用”。
+- **能改官方系统预设吗？** 不能，所有写操作仅限用户预设。
+- **改动什么时候生效？** 保存后对**之后新开的会话**生效，当前会话不变。
+
+
+
+## 许可
+
+[MIT](./LICENSE)
+
+---
+
+## 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
+- **Built-in templates**: ships with three presets ("鲸鱼娘 / Whale Girl", "梁神模式 / Liangshen Mode", "空提示词 / Bare"), ready on any machine after install
+- **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** | Every preset is labelled 📦 built-in template / 📦·✏️ modified / 👤 custom / official, so "ships with the plugin" and "you wrote it" are never confused |
+| Create presets | From built-in template or any existing user preset, one-click copy (with section loader) |
+| 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** |
+| 👤 **Custom** | Not one of the built-in templates; a preset you authored |
+| **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
+
+```bash
+# 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:
+
+| 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 |
+| --- | --- |
+| `cetacea`（鲸鱼娘 / Whale Girl） | Minimal roleplay preset: persistent shell + file editor + compaction + sectioned persona (ships its own loader) |
+| `liangshen`（梁神模式 / Liangshen Mode） | Full-featured preset: files, search, skills, goals, planning, compaction, subagents, workflows, Ralph, web... |
+| `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.
+
+
+
+## License
+
+[MIT](./LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-preset-workbench - 设置页“预设工作台”：用户自己创建/编辑预设提示词。
+- insert:
+    - id: preset-workbench
+      name: dsh-preset-workbench