dsh-prompt-customizer 0.2.7 → 0.3.0

package/LICENSE

@@ -1,21 +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.
+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

@@ -4,7 +4,9 @@
 
 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.
+Plugin-injected prompt sections 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.
+
+![Overview](4.png)
 
 ## Features
 
@@ -13,10 +15,18 @@ Plugin-injected prompt sections (from other plugins) can pollute your system pro
   - **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.
+
+![Prompt sections](2.png)
+
 - **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.
+
+![Tools](2-1.png)
+![Tools](2-2.png)
+![Tools](2-3.png)
+
 - **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.
@@ -24,6 +34,8 @@ Plugin-injected prompt sections (from other plugins) can pollute your system pro
   - 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.
 
+![Presets](3.png)
+
 ## Installation
 
 Install from npm (replace `web` with your profile name):
@@ -64,37 +76,6 @@ Toggle tools to hide them (blacklist), or switch to whitelist mode to keep only
 - **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

package/README.i18n.yaml

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

package/README.md

@@ -6,37 +6,44 @@
 
 其他插件注入的提示词段可能会污染你的系统提示词。本插件让你可以按名称**屏蔽**、**替换**、**注入**和**排序**提示词段，并从模型目录中**隐藏工具**——全部实时生效，无需改动其他插件。
 
+![提示词段编辑界面](4.png)
+
 ## 功能特性
 
-- **提示词段**
-  - **屏蔽**指定名称的段（从组装后的系统提示词中移除）。
-  - **替换**某段的文本（编辑时会回显原始文本，包括动态生成的段）。
-  - **注入**全新的段。
-  - 通过 **↑/↓ 箭头**或**拖拽**（HTML5）排序。顺序以虚拟的 0 起始下标存储，因此不会出现重复或小数 order。
-- **工具**
-  - **黑名单**（`exclude`）：隐藏列出的工具。
-  - **白名单**（`include`）：仅保留列出的工具（优先于 exclude）。
-  - 只影响面向模型的目录，工具与路由仍正常工作。
-- **预设**
-  - **保存**当前定制为预设（完整快照）。
-  - **应用**预设：同名段被覆盖、预设独有段被添加、预设名单之外的当前段默认被屏蔽。
-  - **导出 / 导入**预设为 JSON（完整快照）。
-  - 预设存储**相对顺序**（每段记录它跟在哪个段之后），因此可跨不同段集合的提示词移植。
-  - 本地可保存多个预设，同一时间只能激活一个。
+- **提示词段管理**
+  - **屏蔽**指定名称的段（从组装后的系统提示词中移除）
+  - **替换**某段的文本（编辑时会回显原始文本，包括动态生成的段）
+  - **注入**全新的段
+  - 通过 **↑/↓ 箭头**或**拖拽**（HTML5）排序。顺序以虚拟的 0 起始下标存储，因此不会出现重复或小数 order
+
+![提示词段管理界面](2.png)
+
+- **工具过滤**
+  - 隐藏列出的工具
+  - 只影响面向模型的目录，工具与路由仍正常工作
+
+![工具过滤界面](2-1.png)
+![工具过滤界面](2-2.png)
+![工具过滤界面](2-3.png)
+
+- **预设系统**
+  - **保存**当前定制为预设（完整快照）
+  - **应用**预设：同名段被覆盖、预设独有段被添加、预设名单之外的当前段默认被屏蔽
+  - **导出 / 导入**预设为 JSON（完整快照）
+  - 预设存储**相对顺序**（每段记录它跟在哪个段之后），因此可跨不同段集合的提示词移植
+  - 本地可保存多个预设，同一时间只能激活一个
+
+![预设系统界面](3.png)
 
 ## 安装
 
-从 npm 安装（将 `web` 换成你的 profile 名）：
+从 npm 安装：
 
 ```bash
 dsh plugin --profile web add dsh-prompt-customizer
 ```
 
-或从本地目录安装：
-
-```bash
-dsh plugin --profile web add /path/to/dsh-prompt-customizer
-```
+<br />
 
 安装后，打开 dsh Web UI → **设置** → 侧边栏中的 **提示词定制**。
 
@@ -46,10 +53,10 @@ dsh plugin --profile web add /path/to/dsh-prompt-customizer
 
 每一行代表一个提示词段，包含：
 
-- **复选框**：屏蔽 / 取消屏蔽。
-- **替换**按钮：编辑该段文本（默认回显原始文本）。
-- **↑/↓ 箭头**和**拖拽手柄**：调整顺序。
-- `#N` 徽标显示该段的虚拟顺序（0 起始的位置）。
+- **复选框**：屏蔽 / 取消屏蔽
+- **替换**按钮：编辑该段文本（默认回显原始文本）
+- **↑/↓ 箭头**和**拖拽手柄**：调整顺序
+- `#N` 徽标显示该段的虚拟顺序（0 起始的位置）
 
 底部的 **注入新段** 区域可按名称、顺序和文本添加全新段。
 
@@ -59,10 +66,10 @@ dsh plugin --profile web add /path/to/dsh-prompt-customizer
 
 ### 预设 Tab
 
-- **保存当前为预设**：捕获当前的提示词 / 工具定制。
-- **应用**：激活某个预设（覆盖同名段、添加预设独有段、屏蔽预设名单之外的当前段）。
-- **导出**：将预设下载为 JSON。
-- **导入**：加载预设 JSON 文件（同名预设会被跳过）。
+- **保存当前为预设**：捕获当前的提示词 / 工具定制
+- **应用**：激活某个预设（覆盖同名段、添加预设独有段、屏蔽预设名单之外的当前段）
+- **导出**：将预设下载为 JSON
+- **导入**：加载预设 JSON 文件（同名预设会被跳过）
 
 ## 配置
 
@@ -75,25 +82,25 @@ prompt-customizer:
     - plugin:some-plugin
   # 按名称替换某段文本（保留原始顺序）。
   replace:
-    system: 'You are a helpful coding assistant.'
+    system: "You are a helpful coding assistant."
   # 注入 / 覆盖段（名称 + 顺序 + 文本）。
   inject:
     - name: tool:read
       order: 0
-      text: ''
+      text: ""
   # 工具目录过滤。
   tools:
     exclude: []
     include: []
 ```
 
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `sections` | `string[]` | 要屏蔽的提示词段名称。 |
-| `replace` | `Record<string, string>` | 每个段名称对应的替换文本。 |
-| `inject` | `{name, order, text}[]` | 要注入或覆盖的段（order 控制拼接位置）。 |
-| `tools.exclude` | `string[]` | 要隐藏的工具名称。 |
-| `tools.include` | `string[]` | 非空时仅保留这些工具（优先于 `exclude`）。 |
+| 字段            | 类型                     | 说明                                       |
+| --------------- | ------------------------ | ------------------------------------------ |
+| `sections`      | `string[]`               | 要屏蔽的提示词段名称。                     |
+| `replace`       | `Record<string, string>` | 每个段名称对应的替换文本。                 |
+| `inject`        | `{name, order, text}[]`  | 要注入或覆盖的段（order 控制拼接位置）。   |
+| `tools.exclude` | `string[]`               | 要隐藏的工具名称。                         |
+| `tools.include` | `string[]`               | 非空时仅保留这些工具（优先于 `exclude`）。 |
 
 ## 开发
 

package/client/client.js

@@ -24,6 +24,7 @@ window.__ModuleLoader__.load({
 				system: "系统",
 				replace: "编辑",
 				clearReplace: "清除",
+				clearInput: "清空",
 				injectNew: "注入新段",
 				name: "名称",
 				order: "顺序",
@@ -51,6 +52,7 @@ window.__ModuleLoader__.load({
 				apply: "应用",
 				export: "导出",
 				delete: "删除",
+				restore: "还原",
 				active: "使用中",
 				preset: "预设"
 			},
@@ -70,6 +72,7 @@ window.__ModuleLoader__.load({
 				system: "System",
 				replace: "Replace",
 				clearReplace: "Clear",
+				clearInput: "Clear",
 				injectNew: "Inject section",
 				name: "Name",
 				order: "Order",
@@ -97,6 +100,7 @@ window.__ModuleLoader__.load({
 				apply: "Apply",
 				export: "Export",
 				delete: "Delete",
+				restore: "Restore",
 				active: "Active",
 				preset: "Preset"
 			}
@@ -377,7 +381,10 @@ window.__ModuleLoader__.load({
 					source: isCustom ? "custom" : "system"
 				});
 			}
-			return [...map.values()].sort((a, b) => a.order - b.order);
+			return [...map.values()].sort((a, b) => a.order - b.order).map((sec, i) => ({
+				...sec,
+				order: i
+			}));
 		}
 		/**
 		* Resolve a preset's relative order into an absolute ordered list (0..n-1).
@@ -576,7 +583,7 @@ window.__ModuleLoader__.load({
 				scope.set("replace", next);
 				setEditing(null);
 			};
-			const clearReplace = (name) => {
+			const restoreReplace = (name) => {
 				const next = { ...replace };
 				delete next[name];
 				scope.set("replace", next);
@@ -705,19 +712,26 @@ window.__ModuleLoader__.load({
 							(0, react.createElement)("span", { style: s.code }, sec.name),
 							(0, react.createElement)("span", { style: s.orderTag }, "#" + index),
 							(0, react.createElement)("span", { style: sec.source === "custom" ? s.badgeCustom : s.badgeSystem }, sec.source === "custom" ? t("manual") : t("system")),
-							sec.replaced ? (0, react.createElement)("span", { style: s.badgeReplaced }, t("replaced")) : null
+							replace[sec.name] ? (0, react.createElement)("span", { style: s.badgeReplaced }, t("replaced")) : null
 						]), isEditing ? (0, react.createElement)("div", { style: s.editBox }, [(0, react.createElement)("textarea", {
 							style: s.editInput,
 							value: draft,
 							onChange: (e) => setDraft(e.target.value),
 							rows: 3
-						}), (0, react.createElement)("div", { style: s.injectRow }, [(0, react.createElement)("button", {
-							style: s.mini,
-							onClick: () => commitReplace(sec.name)
-						}, t("add")), (0, react.createElement)("button", {
-							style: s.mini,
-							onClick: () => setEditing(null)
-						}, t("clearReplace"))])]) : (0, react.createElement)("div", { style: s.preview }, String(sec.text ?? "").slice(0, 140) || (sec.source === "custom" ? t("empty") : t("dynamic")))]),
+						}), (0, react.createElement)("div", { style: s.injectRow }, [
+							(0, react.createElement)("button", {
+								style: s.mini,
+								onClick: () => commitReplace(sec.name)
+							}, t("save")),
+							(0, react.createElement)("button", {
+								style: s.mini,
+								onClick: () => setEditing(null)
+							}, t("clearInput")),
+							sec.source !== "custom" && replace[sec.name] ? (0, react.createElement)("button", {
+								style: s.mini,
+								onClick: () => restoreReplace(sec.name)
+							}, t("restore")) : null
+						])]) : (0, react.createElement)("div", { style: s.preview }, String(replace[sec.name] ?? sec.text ?? "").slice(0, 140) || (sec.source === "custom" ? t("empty") : t("dynamic")))]),
 						(0, react.createElement)("div", { style: s.arrowCol }, [(0, react.createElement)("button", {
 							style: s.arrow,
 							disabled: index === 0,
@@ -729,10 +743,14 @@ window.__ModuleLoader__.load({
 							onClick: () => moveOrder(index, 1),
 							title: t("moveDown")
 						}, "↓")]),
-						(0, react.createElement)("button", {
+						isEditing ? null : (0, react.createElement)("button", {
 							style: s.mini,
-							onClick: () => replace[sec.name] ? clearReplace(sec.name) : startReplace(sec.name, String(sec.text ?? ""))
-						}, replace[sec.name] ? t("clearReplace") : t("replace")),
+							onClick: () => startReplace(sec.name, String(sec.text ?? ""))
+						}, t("replace")),
+						!isEditing && sec.source !== "custom" && replace[sec.name] ? (0, react.createElement)("button", {
+							style: s.mini,
+							onClick: () => restoreReplace(sec.name)
+						}, t("restore")) : null,
 						sec.source === "custom" ? (0, react.createElement)("button", {
 							style: s.mini,
 							onClick: () => removeCustom(sec.name),
@@ -966,33 +984,28 @@ window.__ModuleLoader__.load({
 		*  after every plugin's filter, and the tools the current preset will inject
 		*  (whitelist-style, after include/exclude). Neither view edits config. */
 		const PREVIEW_URL = "/api/prompt-customizer/preview";
-		function PreviewTab({ scope, t }) {
+		function PreviewTab({ scope, t, active, refreshId }) {
 			const [sub, setSub] = (0, react.useState)("prompt");
 			const [data, setData] = (0, react.useState)(null);
 			const [error, setError] = (0, react.useState)(null);
 			const inFlight = (0, react.useRef)(false);
-			const pending = (0, react.useRef)(false);
 			const load = () => {
-				if (inFlight.current) {
-					pending.current = true;
-					return;
-				}
+				if (inFlight.current) return;
 				inFlight.current = true;
 				setData(null);
-				fetch(PREVIEW_URL, { cache: "no-store" }).then((r) => r.json()).then((body) => {
+				fetch(`${PREVIEW_URL}?t=${Date.now()}`).then((r) => r.json()).then((body) => {
 					if (body && body.ok === false) throw new Error(body.error ?? "preview failed");
 					setData(body);
 					setError(null);
 				}).catch((e) => setError(String(e instanceof Error ? e.message : e))).finally(() => {
 					inFlight.current = false;
-					if (pending.current) {
-						pending.current = false;
-						load();
-					}
 				});
 			};
 			(0, react.useEffect)(load, []);
 			(0, react.useEffect)(() => scope.subscribe(load), [scope]);
+			(0, react.useEffect)(() => {
+				if (active) load();
+			}, [active, refreshId]);
 			return (0, react.createElement)("div", { style: s.list }, [
 				(0, react.createElement)("div", { style: s.bar }, [(0, react.createElement)("button", {
 					style: sub === "prompt" ? s.tabActive : s.tab,
@@ -1050,11 +1063,13 @@ window.__ModuleLoader__.load({
 			const [inv, setInv] = (0, react.useState)(null);
 			const [tab, setTab] = (0, react.useState)("sections");
 			const [error, setError] = (0, react.useState)(null);
+			const [refreshId, setRefreshId] = (0, react.useState)(0);
 			(0, react.useEffect)(() => scope.subscribe(() => setSnap(scope.getSnapshot())), [scope]);
 			const refresh = () => {
 				fetch(INVENTORY_URL).then((r) => r.json()).then((data) => {
 					setInv(data);
 					setError(null);
+					setRefreshId((n) => n + 1);
 				}).catch((e) => setError(String(e instanceof Error ? e.message : e)));
 			};
 			(0, react.useEffect)(refresh, []);
@@ -1109,7 +1124,9 @@ window.__ModuleLoader__.load({
 					t
 				}) : (0, react.createElement)(PreviewTab, {
 					scope,
-					t
+					t,
+					active: tab === "preview",
+					refreshId
 				})
 			]);
 		}