dsh-prompt-customizer 0.1.0 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DreamsTOF
+
+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.en.md

@@ -0,0 +1,114 @@
+# dsh-prompt-customizer
+
+> **English** | [简体中文](README.md)
+
+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, including dynamically generated sections).
+  - **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/`.
+
+## Known limitations
+
+- **Replacing a dynamically generated section freezes its content**: sections like `app:web-surface` are generated live at assembly time (e.g. they embed the current Web server URL). After replacing, the text becomes fixed at the value you edited and no longer tracks runtime state such as the port. To keep following runtime changes, block the section instead of replacing it.
+- **Dynamic text resolution is best-effort**: the panel tries to call a dynamic section's generator function (with a minimal context) to echo its real content. A few dynamic sections that depend on richer context and throw when called fall back to showing `<动态生成>`; the rest of the features are unaffected.
+
+## License
+
+[MIT](LICENSE) © 2026 DreamsTOF

package/README.i18n.yaml

@@ -0,0 +1,2 @@
+en: README.en.md
+zh-CN: README.md

package/README.md

@@ -1,107 +1,114 @@
 # 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.
+> [English](README.en.md) | **简体中文**
 
-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.
+一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 插件，让你通过设置面板 UI 控制**系统提示词**和**工具目录**。
 
-## 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
+- **提示词段**
+  - **屏蔽**指定名称的段（从组装后的系统提示词中移除）。
+  - **替换**某段的文本（编辑时会回显原始文本，包括动态生成的段）。
+  - **注入**全新的段。
+  - 通过 **↑/↓ 箭头**或**拖拽**（HTML5）排序。顺序以虚拟的 0 起始下标存储，因此不会出现重复或小数 order。
+- **工具**
+  - **黑名单**（`exclude`）：隐藏列出的工具。
+  - **白名单**（`include`）：仅保留列出的工具（优先于 exclude）。
+  - 只影响面向模型的目录，工具与路由仍正常工作。
+- **预设**
+  - **保存**当前定制为预设（完整快照）。
+  - **应用**预设：同名段被覆盖、预设独有段被添加、预设名单之外的当前段默认被屏蔽。
+  - **导出 / 导入**预设为 JSON（完整快照）。
+  - 预设存储**相对顺序**（每段记录它跟在哪个段之后），因此可跨不同段集合的提示词移植。
+  - 本地可保存多个预设，同一时间只能激活一个。
 
-Install from npm:
+## 安装
+
+从 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.
+安装后，打开 dsh Web UI → **设置** → 侧边栏中的 **提示词定制**。
 
-## Usage
+## 使用说明
 
-### Prompt sections tab
+### 提示词 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).
+- **复选框**：屏蔽 / 取消屏蔽。
+- **替换**按钮：编辑该段文本（默认回显原始文本）。
+- **↑/↓ 箭头**和**拖拽手柄**：调整顺序。
+- `#N` 徽标显示该段的虚拟顺序（0 起始的位置）。
 
-The **注入新段** (Inject section) box at the bottom adds a brand-new section by name, order, and text.
+底部的 **注入新段** 区域可按名称、顺序和文本添加全新段。
 
-### Tools tab
+### 工具 Tab
 
-Toggle tools to hide them (blacklist), or switch to whitelist mode to keep only the checked tools.
+勾选工具以隐藏（黑名单），或切换到白名单模式仅保留勾选的工具。
 
-### Presets tab
+### 预设 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).
+- **保存当前为预设**：捕获当前的提示词 / 工具定制。
+- **应用**：激活某个预设（覆盖同名段、添加预设独有段、屏蔽预设名单之外的当前段）。
+- **导出**：将预设下载为 JSON。
+- **导入**：加载预设 JSON 文件（同名预设会被跳过）。
 
-## Configuration
+## 配置
 
-The plugin stores its config in the dsh settings document under the `prompt-customizer` namespace (`~/.dsh/settings.yaml`). You can edit it directly:
+插件配置存储在 dsh 设置文档的 `prompt-customizer` 命名空间下（`~/.dsh/settings.yaml`）。你也可以直接编辑：
 
 ```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`). |
+| `sections` | `string[]` | 要屏蔽的提示词段名称。 |
+| `replace` | `Record<string, string>` | 每个段名称对应的替换文本。 |
+| `inject` | `{name, order, text}[]` | 要注入或覆盖的段（order 控制拼接位置）。 |
+| `tools.exclude` | `string[]` | 要隐藏的工具名称。 |
+| `tools.include` | `string[]` | 非空时仅保留这些工具（优先于 `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/`.
+浏览器端使用 [tsdown](https://github.com/rolldown/tsdown) 打包为 `client/client.js`（`__ModuleLoader__` factory bundle）。宿主端代码位于 `lib/`。
+
+## 已知限制
+
+- **替换动态生成的段会固定其生成内容**：像 `app:web-surface` 这类段在装配时实时生成（如嵌入当前 Web 服务器 URL）。替换后，文本会固定为您编辑时的值，不再随端口等运行时状态自动更新；如需跟随运行时变化，请勿替换该段，改用屏蔽。
+- **动态文本解析是尽力而为**：面板读取动态段时会尝试调用其生成函数并传入最小上下文，以便回显真实内容。个别依赖更复杂上下文、调用时会抛错的动态段会回退显示 `<动态生成>`，不影响其余功能。
 
 ## License
 
-MIT
+[MIT](LICENSE) © 2026 DreamsTOF

package/client/client.js

@@ -281,6 +281,121 @@ window.__ModuleLoader__.load({
 			};
 		})();
 		//#endregion
+		//#region src/client/presets.ts
+		/** Merge the inventory sections with the user's inject list, sorted by order. */
+		function mergeSections(inv, cfg, blockedNames) {
+			const map = /* @__PURE__ */ new Map();
+			for (const sec of inv?.sections ?? []) map.set(sec.name, sec);
+			for (const item of cfg.inject ?? []) {
+				const existing = map.get(item.name);
+				if (existing) map.set(item.name, {
+					...existing,
+					order: item.order
+				});
+				else map.set(item.name, {
+					name: item.name,
+					order: item.order,
+					text: item.text || "<动态生成>",
+					active: !blockedNames.has(item.name),
+					replaced: false
+				});
+			}
+			return [...map.values()].sort((a, b) => a.order - b.order);
+		}
+		/**
+		* Resolve a preset's relative order into an absolute ordered list (0..n-1).
+		* Sections with no anchor (or whose anchor is absent) come first in preset
+		* order; each anchored section is inserted right after its anchor; any
+		* remaining sections (cycles) are appended.
+		*/
+		function resolveOrder(presetOrder) {
+			const list = presetOrder ?? [];
+			const afterMap = /* @__PURE__ */ new Map();
+			const textMap = /* @__PURE__ */ new Map();
+			for (const sec of list) {
+				afterMap.set(sec.name, sec.after);
+				textMap.set(sec.name, sec.text);
+			}
+			const result = [];
+			const placed = /* @__PURE__ */ new Set();
+			for (const sec of list) {
+				const anchor = afterMap.get(sec.name);
+				if (!anchor || !afterMap.has(anchor)) {
+					result.push(sec.name);
+					placed.add(sec.name);
+				}
+			}
+			let changed = true;
+			while (changed) {
+				changed = false;
+				for (const sec of list) {
+					if (placed.has(sec.name)) continue;
+					const anchor = afterMap.get(sec.name);
+					if (anchor && placed.has(anchor)) {
+						result.splice(result.indexOf(anchor) + 1, 0, sec.name);
+						placed.add(sec.name);
+						changed = true;
+					}
+				}
+			}
+			for (const sec of list) if (!placed.has(sec.name)) {
+				result.push(sec.name);
+				placed.add(sec.name);
+			}
+			return result.map((name, i) => ({
+				name,
+				order: i,
+				text: textMap.get(name) ?? ""
+			}));
+		}
+		/**
+		* Build a preset snapshot from the current config. The order list is derived
+		* from the MERGED section list (not just `cfg.inject`) so that a preset saved
+		* after only blocking sections (without reordering) still carries the full
+		* ordered set, and thus a meaningful "active list" when applied.
+		*/
+		function buildPresetData(cfg, merged) {
+			const order = merged.map((sec, i) => ({
+				name: sec.name,
+				after: i > 0 ? merged[i - 1].name : void 0,
+				text: sec.text ?? ""
+			}));
+			return {
+				sections: cfg.sections,
+				replace: cfg.replace,
+				order,
+				tools: cfg.tools
+			};
+		}
+		/**
+		* Compute the config patch when applying a preset:
+		*  - same-name sections are overridden (the order list drives this at runtime)
+		*  - preset sections missing from the current prompt are added
+		*  - current sections NOT in the preset's ordered list are disabled by default
+		*  - only the preset's ACTIVE sections (in the order list but not in its block
+		*    list) are unblocked; the preset's own blocked sections stay blocked.
+		*/
+		function applyPresetData(data, cfg, currentNames) {
+			const presetOrder = data.order ?? [];
+			const presetNames = new Set(presetOrder.map((x) => x.name));
+			const blocked = new Set(data.sections ?? []);
+			const activeNames = new Set([...presetNames].filter((n) => !blocked.has(n)));
+			for (const name of currentNames) if (!presetNames.has(name)) blocked.add(name);
+			for (const name of activeNames) blocked.delete(name);
+			return {
+				sections: [...blocked],
+				replace: {
+					...cfg.replace ?? {},
+					...data.replace ?? {}
+				},
+				inject: resolveOrder(presetOrder),
+				tools: {
+					exclude: data.tools?.exclude ?? [],
+					include: data.tools?.include ?? []
+				}
+			};
+		}
+		//#endregion
 		//#region src/client/SectionsTab.tsx
 		/** Prompt-sections tab: block / replace / inject / reorder prompt sections. */
 		function SectionsTab({ cfg, inv, scope, t }) {
@@ -290,25 +405,7 @@ window.__ModuleLoader__.load({
 			const [draft, setDraft] = (0, react.useState)("");
 			const [dragName, setDragName] = (0, react.useState)(null);
 			const [dropTarget, setDropTarget] = (0, react.useState)(null);
-			const merged = (() => {
-				const map = /* @__PURE__ */ new Map();
-				for (const sec of inv?.sections ?? []) map.set(sec.name, sec);
-				for (const item of cfg.inject ?? []) {
-					const existing = map.get(item.name);
-					if (existing) map.set(item.name, {
-						...existing,
-						order: item.order
-					});
-					else map.set(item.name, {
-						name: item.name,
-						order: item.order,
-						text: item.text || "<动态生成>",
-						active: !blockedNames.has(item.name),
-						replaced: false
-					});
-				}
-				return [...map.values()].sort((a, b) => a.order - b.order);
-			})();
+			const merged = mergeSections(inv, cfg, blockedNames);
 			const toggleBlock = (name, currentlyBlocked) => {
 				const list = (cfg.sections ?? []).slice();
 				if (currentlyBlocked) {
@@ -603,26 +700,11 @@ window.__ModuleLoader__.load({
 			const presets = cfg.presets ?? [];
 			const [name, setName] = (0, react.useState)("");
 			const fileRef = (0, react.useRef)(null);
-			const currentNames = (() => {
-				const set = /* @__PURE__ */ new Set();
-				for (const sec of inv?.sections ?? []) set.add(sec.name);
-				for (const item of cfg.inject ?? []) set.add(item.name);
-				return set;
-			})();
+			const merged = mergeSections(inv, cfg, new Set(cfg.sections ?? []));
+			const currentNames = new Set(merged.map((sec) => sec.name));
 			const saveCurrent = () => {
 				const presetName = name.trim() || `${t("preset")} ${presets.length + 1}`;
-				const inject = cfg.inject ?? [];
-				const order = inject.map((sec, i) => ({
-					name: sec.name,
-					after: i > 0 ? inject[i - 1].name : void 0,
-					text: sec.text
-				}));
-				const data = {
-					sections: cfg.sections,
-					replace: cfg.replace,
-					order,
-					tools: cfg.tools
-				};
+				const data = buildPresetData(cfg, merged);
 				scope.set("presets", [...presets, {
 					id: genId(),
 					name: presetName,
@@ -631,21 +713,11 @@ window.__ModuleLoader__.load({
 				setName("");
 			};
 			const applyPreset = (preset) => {
-				const presetOrder = preset.data.order ?? [];
-				const presetNames = new Set(presetOrder.map((x) => x.name));
-				const blocked = new Set(preset.data.sections ?? []);
-				for (const name of currentNames) if (!presetNames.has(name)) blocked.add(name);
-				for (const name of presetNames) blocked.delete(name);
-				scope.set("inject", resolveOrder(presetOrder));
-				scope.set("replace", {
-					...cfg.replace ?? {},
-					...preset.data.replace ?? {}
-				});
-				scope.set("sections", [...blocked]);
-				scope.set("tools", preset.data.tools ?? {
-					exclude: [],
-					include: []
-				});
+				const patch = applyPresetData(preset.data, cfg, currentNames);
+				scope.set("inject", patch.inject);
+				scope.set("replace", patch.replace);
+				scope.set("sections", patch.sections);
+				scope.set("tools", patch.tools);
 				scope.set("activePreset", preset.id);
 			};
 			const deletePreset = (id) => {
@@ -734,51 +806,6 @@ window.__ModuleLoader__.load({
 		function genId() {
 			return "p_" + Date.now().toString(36) + Math.random().toString(36).slice(2, 7);
 		}
-		/**
-		* Resolve a preset's relative order into an absolute ordered list (0..n-1).
-		* Sections with no anchor (or whose anchor is absent) come first in preset
-		* order; each anchored section is inserted right after its anchor; any
-		* remaining sections (cycles) are appended.
-		*/
-		function resolveOrder(presetOrder) {
-			const afterMap = /* @__PURE__ */ new Map();
-			const textMap = /* @__PURE__ */ new Map();
-			for (const sec of presetOrder) {
-				afterMap.set(sec.name, sec.after);
-				textMap.set(sec.name, sec.text);
-			}
-			const result = [];
-			const placed = /* @__PURE__ */ new Set();
-			for (const sec of presetOrder) {
-				const anchor = afterMap.get(sec.name);
-				if (!anchor || !afterMap.has(anchor)) {
-					result.push(sec.name);
-					placed.add(sec.name);
-				}
-			}
-			let changed = true;
-			while (changed) {
-				changed = false;
-				for (const sec of presetOrder) {
-					if (placed.has(sec.name)) continue;
-					const anchor = afterMap.get(sec.name);
-					if (anchor && placed.has(anchor)) {
-						result.splice(result.indexOf(anchor) + 1, 0, sec.name);
-						placed.add(sec.name);
-						changed = true;
-					}
-				}
-			}
-			for (const sec of presetOrder) if (!placed.has(sec.name)) {
-				result.push(sec.name);
-				placed.add(sec.name);
-			}
-			return result.map((name, i) => ({
-				name,
-				order: i,
-				text: textMap.get(name) ?? ""
-			}));
-		}
 		//#endregion
 		//#region src/client/index.ts
 		/**
@@ -813,15 +840,6 @@ window.__ModuleLoader__.load({
 					scope,
 					t
 				})));
-				scoped.slots.inject("settings.plugin.item", () => scoped.slots.register({
-					name: "settings.plugin.item",
-					key: NS,
-					locale: NS,
-					inject: () => ({ t })
-				}, () => (0, react.createElement)(Panel, {
-					scope,
-					t
-				})));
 			});
 		}
 		function Panel({ scope, t }) {