dsh-prompt-customizer 0.1.0

package/README.md

@@ -0,0 +1,107 @@
+# dsh-prompt-customizer
+
+A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) plugin that lets you control the **system prompt** and the **tool catalog** from a settings-panel UI.
+
+Plugin-injected prompt sections (from other plugins) can pollute your system prompt. This plugin lets you **block**, **replace**, **inject**, and **reorder** prompt sections by name, and **hide tools** from the model catalog — all live, without touching the other plugins.
+
+## Features
+
+- **Prompt sections**
+  - **Block** a section by name (removed from the assembled system prompt).
+  - **Replace** a section's text (the original text is echoed for editing).
+  - **Inject** brand-new sections.
+  - **Reorder** sections with ↑/↓ arrows or **drag & drop** (HTML5). Order is stored as a virtual 0-based index, so there are never duplicate or fractional orders.
+- **Tools**
+  - **Blacklist** (`exclude`): hide the listed tools.
+  - **Whitelist** (`include`): keep only the listed tools (wins over exclude).
+  - Only the model-facing catalog is affected — tools and routes keep working.
+- **Presets**
+  - **Save** the current customization as a preset (full snapshot).
+  - **Apply** a preset: same-name sections are overridden, preset-only sections are added, and current sections outside the preset list are disabled by default.
+  - **Export / Import** presets as JSON (full snapshot).
+  - Presets store **relative order** (each section records the section it follows), so they stay portable across prompts with different section sets.
+  - Multiple presets can be stored locally; only one is active at a time.
+
+## Installation
+
+Install from npm:
+
+```bash
+dsh plugin add dsh-prompt-customizer
+```
+
+Or install from a local checkout:
+
+```bash
+dsh plugin add /path/to/dsh-prompt-customizer
+```
+
+After installation, open the dsh web UI → **Settings** → **提示词定制** (Prompt Customizer) in the sidebar.
+
+## Usage
+
+### Prompt sections tab
+
+Each row shows a prompt section with:
+
+- A **checkbox** to block/unblock it.
+- A **replace** button to edit its text (the original text is pre-filled).
+- **↑/↓ arrows** and a **drag handle** to reorder it.
+- The `#N` badge shows the section's virtual order (0-based position).
+
+The **注入新段** (Inject section) box at the bottom adds a brand-new section by name, order, and text.
+
+### Tools tab
+
+Toggle tools to hide them (blacklist), or switch to whitelist mode to keep only the checked tools.
+
+### Presets tab
+
+- **Save current as preset** — capture the current sections/tools customization.
+- **Apply** — activate a preset (overrides same-name sections, adds preset-only sections, disables current sections outside the preset).
+- **Export** — download the preset as JSON.
+- **Import** — load a preset JSON file (same-name presets are skipped).
+
+## Configuration
+
+The plugin stores its config in the dsh settings document under the `prompt-customizer` namespace (`~/.dsh/settings.yaml`). You can edit it directly:
+
+```yaml
+prompt-customizer:
+  # Block these prompt sections by name.
+  sections:
+    - plugin:some-plugin
+  # Replace a section's text by name (original order kept).
+  replace:
+    system: 'You are a helpful coding assistant.'
+  # Inject / override sections (name + order + text).
+  inject:
+    - name: tool:read
+      order: 0
+      text: ''
+  # Tool catalog filtering.
+  tools:
+    exclude: []
+    include: []
+```
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `sections` | `string[]` | Prompt section names to block. |
+| `replace` | `Record<string, string>` | Replacement text per section name. |
+| `inject` | `{name, order, text}[]` | Sections to inject or override (order controls splice position). |
+| `tools.exclude` | `string[]` | Tool names to hide. |
+| `tools.include` | `string[]` | When non-empty, keep only these tools (wins over `exclude`). |
+
+## Development
+
+```bash
+npm install
+npm run check   # typecheck + build
+```
+
+The browser half is built with [tsdown](https://github.com/rolldown/tsdown) into `client/client.js` (a `__ModuleLoader__` factory bundle). The host half lives in `lib/`.
+
+## License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,107 @@
+# dsh-prompt-customizer
+
+一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 插件，让你通过设置面板 UI 控制**系统提示词**和**工具目录**。
+
+其他插件注入的提示词段可能会污染你的系统提示词。本插件让你可以按名称**屏蔽**、**替换**、**注入**和**排序**提示词段，并从模型目录中**隐藏工具**——全部实时生效，无需改动其他插件。
+
+## 功能特性
+
+- **提示词段**
+  - **屏蔽**指定名称的段（从组装后的系统提示词中移除）。
+  - **替换**某段的文本（编辑时会回显原始文本）。
+  - **注入**全新的段。
+  - 通过 **↑/↓ 箭头**或**拖拽**（HTML5）排序。顺序以虚拟的 0 起始下标存储，因此不会出现重复或小数 order。
+- **工具**
+  - **黑名单**（`exclude`）：隐藏列出的工具。
+  - **白名单**（`include`）：仅保留列出的工具（优先于 exclude）。
+  - 只影响面向模型的目录，工具与路由仍正常工作。
+- **预设**
+  - **保存**当前定制为预设（完整快照）。
+  - **应用**预设：同名段被覆盖、预设独有段被添加、预设名单之外的当前段默认被屏蔽。
+  - **导出 / 导入**预设为 JSON（完整快照）。
+  - 预设存储**相对顺序**（每段记录它跟在哪个段之后），因此可跨不同段集合的提示词移植。
+  - 本地可保存多个预设，同一时间只能激活一个。
+
+## 安装
+
+从 npm 安装：
+
+```bash
+dsh plugin add dsh-prompt-customizer
+```
+
+或从本地目录安装：
+
+```bash
+dsh plugin add /path/to/dsh-prompt-customizer
+```
+
+安装后，打开 dsh Web UI → **设置** → 侧边栏中的 **提示词定制**。
+
+## 使用说明
+
+### 提示词 Tab
+
+每一行代表一个提示词段，包含：
+
+- **复选框**：屏蔽 / 取消屏蔽。
+- **替换**按钮：编辑该段文本（默认回显原始文本）。
+- **↑/↓ 箭头**和**拖拽手柄**：调整顺序。
+- `#N` 徽标显示该段的虚拟顺序（0 起始的位置）。
+
+底部的 **注入新段** 区域可按名称、顺序和文本添加全新段。
+
+### 工具 Tab
+
+勾选工具以隐藏（黑名单），或切换到白名单模式仅保留勾选的工具。
+
+### 预设 Tab
+
+- **保存当前为预设**：捕获当前的提示词 / 工具定制。
+- **应用**：激活某个预设（覆盖同名段、添加预设独有段、屏蔽预设名单之外的当前段）。
+- **导出**：将预设下载为 JSON。
+- **导入**：加载预设 JSON 文件（同名预设会被跳过）。
+
+## 配置
+
+插件配置存储在 dsh 设置文档的 `prompt-customizer` 命名空间下（`~/.dsh/settings.yaml`）。你也可以直接编辑：
+
+```yaml
+prompt-customizer:
+  # 按名称屏蔽这些提示词段。
+  sections:
+    - plugin:some-plugin
+  # 按名称替换某段文本（保留原始顺序）。
+  replace:
+    system: 'You are a helpful coding assistant.'
+  # 注入 / 覆盖段（名称 + 顺序 + 文本）。
+  inject:
+    - name: tool:read
+      order: 0
+      text: ''
+  # 工具目录过滤。
+  tools:
+    exclude: []
+    include: []
+```
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `sections` | `string[]` | 要屏蔽的提示词段名称。 |
+| `replace` | `Record<string, string>` | 每个段名称对应的替换文本。 |
+| `inject` | `{name, order, text}[]` | 要注入或覆盖的段（order 控制拼接位置）。 |
+| `tools.exclude` | `string[]` | 要隐藏的工具名称。 |
+| `tools.include` | `string[]` | 非空时仅保留这些工具（优先于 `exclude`）。 |
+
+## 开发
+
+```bash
+npm install
+npm run check   # typecheck + build
+```
+
+浏览器端使用 [tsdown](https://github.com/rolldown/tsdown) 打包为 `client/client.js`（`__ModuleLoader__` factory bundle）。宿主端代码位于 `lib/`。
+
+## 许可证
+
+MIT