dsh-prompt-refine 0.1.0

package/LICENSE

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

@@ -0,0 +1,93 @@
+# dsh-prompt-refine
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+DSH 提示词优化插件 —— 在发送前点一下,让模型结合上下文告诉你这条 prompt 缺什么。
+
+![插件预览:点 ✨ 后弹窗列出 3 条建议,勾选后实时预览合并结果](docs/overview.png)
+
+## 它做什么
+
+在输入框发送按钮**左侧**加一个 ✨ 按钮。点击后:
+
+1. 读当前草稿 + 最近几条对话历史
+2. 调你已配置好的模型(自动读 `~/.dsh/settings.yaml` 的 `agent-default-model`)
+3. 弹窗列出 **3 条「问题 + 补丁」** 形式的建议
+4. 勾选想要的 → 实时预览合并后的 prompt
+5. 点「采纳 N 条并填入」→ 新 prompt 写回输入框
+
+**不抢你的发送权**:填好后你自己按发送。Esc / 点遮罩 / 「跳过」都能随时退出。
+
+## 为什么是「补丁」而不是「重写」
+
+建议保留你原话,只补缺口:
+
+```
+原文    写个排序
+
+scope     未说明排序对象 → 对一组整数数组进行升序排序。
+format    未指定语言签名 → 请用 Python 实现,函数签名 sort_list(nums)。
+constraint 缺边界约束     → 要求 O(n log n),处理空数组与重复元素。
+```
+
+三条可以同时采纳,不用三选一。
+
+## 安装
+
+### 方式一：npm 安装（推荐）
+
+```bash
+cd ~/.dsh/profiles/web    # 换成你要装进去的 profile
+pnpm add dsh-prompt-refine
+```
+
+包内自带 `dsh.bundle.patch` 声明，安装后把 `dsh-prompt-refine` 加进该 profile `package.json` 的 `dsh.profile.bundles` 数组即可激活，然后重启 DSH。
+
+### 方式二：源码安装（开发用）
+
+```bash
+pnpm install
+pnpm build
+
+# 装进 web profile
+node scripts/install.mjs --profile web
+rm -rf ~/.dsh/profiles/web/node_modules/dsh-prompt-refine
+(cd ~/.dsh/profiles/web && pnpm install --force)
+```
+
+## 运行(开发模式)
+
+```bash
+# 在 deepseek-harness 仓库根目录
+pnpm dsh web --patch ./dsh-prompt-refine/cordis.yml --no-open --port 0
+```
+
+或者用附带的脚本(自动杀旧实例 + 重启 + 打印新 URL):
+
+```bash
+bash scripts/dev-restart.sh
+```
+
+## 模型配置
+
+**v0.1 无需配置** —— 自动读用户 settings.yaml 里的 `agent-default-model`,
+跟随你平时用的模型。改模型只改那里。
+
+v0.2 计划:插件自己的设置页,可单独指定"优化用的模型"(比如用便宜的快模型)。
+
+## 文件结构
+
+```
+src/
+  dsh-prompt-refine.ts   host 入口
+  host.ts                HTTP 端点 + ctx.llm 调用 + 降级
+  shared/types.ts        请求/响应形状
+  shared/prompt.ts       system prompt + JSON 解析
+  client.ts              ✨ 按钮 + Portal 弹窗
+scripts/
+  install.mjs            装进 profile
+```
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# dsh-prompt-refine 的 bundle patch —— 安装到 profile 后自动进配置层
+# name 用包名(不是 file:// 源码路径):loader 从 profile 的 node_modules
+# 解析到编译好的 lib/index.mjs。指向 TS 源码只在仓库内 dev 模式(pnpm dsh,
+# 带 tsx)下能跑;全局 npm 安装的 dsh 是纯 node ESM,会报
+# ERR_MODULE_NOT_FOUND: Cannot find module '...\src\host'。
+- insert:
+    - id: dsh-prompt-refine
+      name: 'dsh-prompt-refine'

package/lib/client.iife.js

@@ -0,0 +1,518 @@
+(function() {
+	//#region src/client.ts
+	function makeFactory() {
+		return (require) => {
+			const React = require("react");
+			const h = React.createElement;
+			const { createPortal } = require("react-dom");
+			const name = "dsh-prompt-refine";
+			const inject = ["slots"];
+			let portalHost = null;
+			function getPortalHost() {
+				if (portalHost === null || !portalHost.isConnected) {
+					portalHost = document.createElement("div");
+					portalHost.id = "dsh-prompt-refine-portal";
+					document.body.appendChild(portalHost);
+				}
+				return portalHost;
+			}
+			const S = {
+				btn: {
+					padding: 0,
+					width: "32px",
+					height: "32px",
+					borderRadius: "8px",
+					border: "1px solid var(--dsw-alias-border-l2)",
+					background: "transparent",
+					color: "var(--dsw-alias-label-secondary)",
+					cursor: "pointer",
+					display: "inline-flex",
+					alignItems: "center",
+					justifyContent: "center",
+					fontSize: "15px",
+					lineHeight: 1
+				},
+				overlay: {
+					position: "fixed",
+					inset: 0,
+					background: "rgba(0,0,0,0.55)",
+					display: "flex",
+					alignItems: "center",
+					justifyContent: "center",
+					zIndex: 9999,
+					padding: "20px"
+				},
+				modal: {
+					background: "var(--dsw-alias-bg-layer-1)",
+					borderRadius: "14px",
+					width: "100%",
+					maxWidth: "560px",
+					maxHeight: "86vh",
+					overflowY: "auto",
+					boxShadow: "0 20px 60px rgba(0,0,0,0.28)",
+					border: "1px solid var(--dsw-alias-border-l2)",
+					color: "var(--dsw-alias-label-primary)"
+				},
+				header: {
+					padding: "18px 22px 14px",
+					borderBottom: "1px solid var(--dsw-alias-border-l2)"
+				},
+				title: {
+					fontSize: "16px",
+					fontWeight: 600,
+					margin: "0 0 4px"
+				},
+				subtitle: {
+					fontSize: "13px",
+					color: "var(--dsw-alias-label-secondary)",
+					margin: 0
+				},
+				original: {
+					margin: "14px 22px 0",
+					padding: "10px 12px",
+					background: "var(--dsw-alias-bg-layer-1, rgba(0,0,0,0.04))",
+					borderRadius: "8px",
+					fontSize: "13px",
+					color: "var(--dsw-alias-label-secondary)",
+					borderLeft: "3px solid var(--dsw-alias-label-tertiary)"
+				},
+				originalLabel: {
+					fontSize: "10px",
+					color: "var(--dsw-alias-label-tertiary)",
+					textTransform: "uppercase",
+					letterSpacing: "0.5px",
+					marginBottom: "4px"
+				},
+				list: { padding: "14px 22px" },
+				row: {
+					display: "flex",
+					gap: "12px",
+					padding: "12px",
+					border: "1px solid var(--dsw-alias-border-l2)",
+					borderRadius: "10px",
+					marginBottom: "8px",
+					cursor: "pointer"
+				},
+				rowOn: {
+					borderColor: "var(--dsw-alias-state-business-primary)",
+					background: "var(--dsw-alias-interactive-bg-active, rgba(37,99,235,0.08))"
+				},
+				rowBody: {
+					flex: 1,
+					minWidth: 0
+				},
+				tag: {
+					display: "inline-block",
+					fontSize: "11px",
+					padding: "2px 7px",
+					borderRadius: "4px",
+					fontWeight: 500,
+					marginBottom: "6px"
+				},
+				tagScope: {
+					background: "var(--dsw-alias-state-error-secondary)",
+					color: "var(--dsw-alias-state-error-primary)"
+				},
+				tagFormat: {
+					background: "rgba(217,119,6,0.14)",
+					color: "#d97706"
+				},
+				tagConstraint: {
+					background: "rgba(37,99,235,0.14)",
+					color: "var(--dsw-alias-state-business-primary)"
+				},
+				tagClarity: {
+					background: "rgba(5,150,105,0.16)",
+					color: "var(--dsw-alias-state-success-primary)"
+				},
+				tagOther: {
+					background: "rgba(128,128,128,0.16)",
+					color: "var(--dsw-alias-label-secondary)"
+				},
+				issue: {
+					fontSize: "13.5px",
+					margin: "0 0 8px",
+					lineHeight: 1.45
+				},
+				patch: {
+					fontSize: "12.5px",
+					color: "var(--dsw-alias-label-secondary)",
+					background: "rgba(128,128,128,0.08)",
+					padding: "7px 10px",
+					borderRadius: "6px",
+					margin: 0,
+					fontFamily: "ui-monospace, \"SF Mono\", Consolas, monospace",
+					border: "1px dashed var(--dsw-alias-border-l2)"
+				},
+				preview: {
+					margin: "0 22px 14px",
+					padding: "10px 12px",
+					background: "rgba(128,128,128,0.08)",
+					borderRadius: "8px",
+					fontSize: "13px"
+				},
+				previewLabel: {
+					fontSize: "10px",
+					color: "var(--dsw-alias-label-tertiary)",
+					textTransform: "uppercase",
+					letterSpacing: "0.5px",
+					marginBottom: "6px",
+					display: "flex",
+					justifyContent: "space-between"
+				},
+				previewCount: {
+					color: "var(--dsw-alias-state-business-primary)",
+					fontWeight: 600
+				},
+				previewText: { lineHeight: 1.6 },
+				added: {
+					background: "rgba(5,150,105,0.16)",
+					color: "var(--dsw-alias-state-success-primary)",
+					padding: "1px 5px",
+					borderRadius: "3px",
+					margin: "0 2px",
+					fontWeight: 500
+				},
+				footer: {
+					padding: "14px 22px",
+					borderTop: "1px solid var(--dsw-alias-border-l2)",
+					display: "flex",
+					justifyContent: "space-between",
+					alignItems: "center",
+					gap: "12px"
+				},
+				hint: {
+					fontSize: "12px",
+					color: "var(--dsw-alias-label-tertiary)"
+				},
+				btnSec: {
+					padding: "8px 14px",
+					borderRadius: "8px",
+					border: "1px solid var(--dsw-alias-border-l2)",
+					background: "transparent",
+					color: "var(--dsw-alias-label-primary)",
+					cursor: "pointer",
+					fontSize: "14px"
+				},
+				btnPri: {
+					padding: "8px 14px",
+					borderRadius: "8px",
+					border: "none",
+					background: "var(--dsw-alias-state-business-primary)",
+					color: "var(--dsw-alias-button-info-fill, #fff)",
+					cursor: "pointer",
+					fontSize: "14px",
+					fontWeight: 600
+				},
+				skel: {
+					height: "58px",
+					background: "rgba(128,128,128,0.14)",
+					borderRadius: "10px",
+					marginBottom: "8px"
+				},
+				tip: {
+					textAlign: "center",
+					fontSize: "13px",
+					color: "var(--dsw-alias-label-secondary)",
+					padding: "8px 0"
+				},
+				err: {
+					padding: "16px 22px",
+					fontSize: "13px",
+					color: "var(--dsw-alias-state-error-primary)"
+				},
+				warn: {
+					padding: "0 22px 10px",
+					fontSize: "12px",
+					color: "var(--dsw-alias-state-warn-primary, #d97706)"
+				}
+			};
+			function tagStyle(tag) {
+				switch (tag) {
+					case "scope": return S.tagScope;
+					case "format": return S.tagFormat;
+					case "constraint": return S.tagConstraint;
+					case "clarity": return S.tagClarity;
+					default: return S.tagOther;
+				}
+			}
+			function PromptRefineControl(props) {
+				const useInput = props.useInput;
+				const useChat = props.useChat;
+				const inputActions = props.inputActions;
+				const draftNow = (useInput ? useInput((s) => s.draft) : "") ?? "";
+				const nodes = (useChat ? useChat((s) => s.legacy.nodes) : []) ?? [];
+				const [host] = React.useState(() => getPortalHost());
+				const [open, setOpen] = React.useState(false);
+				const [phase, setPhase] = React.useState("loading");
+				const [reqDraft, setReqDraft] = React.useState("");
+				const [items, setItems] = React.useState([]);
+				const [checked, setChecked] = React.useState([]);
+				const [errMsg, setErrMsg] = React.useState("");
+				const [usedModel, setUsedModel] = React.useState("");
+				const collectHistory = () => {
+					const out = [];
+					for (let i = nodes.length - 1; i >= 0 && out.length < 6; i--) {
+						const n = nodes[i];
+						if (!n) continue;
+						if (n.kind === "user") {
+							const text = (n.content ?? []).filter((b) => b && b.type === "text").map((b) => b.text ?? "").join("").trim();
+							if (text) out.unshift({
+								role: "user",
+								content: text.slice(0, 500)
+							});
+						} else if (n.kind === "assistant") {
+							const text = (n.blocks ?? []).filter((b) => b && b.kind === "text").map((b) => b.text ?? "").join("").trim();
+							if (text) out.unshift({
+								role: "assistant",
+								content: text.slice(0, 500)
+							});
+						}
+					}
+					return out;
+				};
+				const request = () => {
+					const d = draftNow.trim();
+					if (!d) {
+						setReqDraft("");
+						setPhase("empty");
+						setOpen(true);
+						return;
+					}
+					setReqDraft(d);
+					setItems([]);
+					setChecked([]);
+					setErrMsg("");
+					setUsedModel("");
+					setPhase("loading");
+					setOpen(true);
+					const history = collectHistory();
+					fetch("/dsh-prompt-refine/suggest", {
+						method: "POST",
+						headers: { "Content-Type": "application/json" },
+						body: JSON.stringify({
+							draft: d,
+							history
+						})
+					}).then((r) => r.json()).then((data) => {
+						const list = Array.isArray(data?.suggestions) ? data.suggestions.slice(0, 3) : [];
+						if (data?.ok && list.length > 0) {
+							setItems(list);
+							setChecked(list.map((_, i) => i < 2));
+							setUsedModel(data.usedModel ?? "");
+							setErrMsg(data.error ?? "");
+							setPhase("result");
+						} else {
+							setErrMsg(data?.error ?? "未知错误");
+							setPhase("error");
+						}
+					}).catch((e) => {
+						setErrMsg("网络错误: " + (e instanceof Error ? e.message : String(e)));
+						setPhase("error");
+					});
+				};
+				React.useEffect(() => {
+					if (!open) return;
+					const onKey = (e) => {
+						if (e.key === "Escape") setOpen(false);
+					};
+					window.addEventListener("keydown", onKey);
+					return () => {
+						window.removeEventListener("keydown", onKey);
+					};
+				}, [open]);
+				const close = () => setOpen(false);
+				const apply = () => {
+					const patches = [];
+					for (let i = 0; i < items.length; i++) if (checked[i] && items[i]?.patch) patches.push(items[i].patch);
+					const next = reqDraft + patches.join("");
+					if (inputActions?.setDraft) inputActions.setDraft(next);
+					setOpen(false);
+				};
+				const button = h("button", {
+					type: "button",
+					title: "优化提示词",
+					"aria-label": "优化提示词",
+					style: S.btn,
+					onClick: (e) => {
+						e.stopPropagation();
+						e.preventDefault();
+						request();
+					},
+					onMouseDown: (e) => e.preventDefault()
+				}, "✨");
+				if (!open || !host) return button;
+				const selected = [];
+				for (let i = 0; i < items.length; i++) if (checked[i] && items[i]?.patch) selected.push(items[i].patch);
+				const selectedCount = checked.filter(Boolean).length;
+				let body;
+				if (phase === "empty") body = h("div", {
+					style: S.err,
+					children: "请先在输入框写点内容,再点 ✨ 优化。"
+				});
+				else if (phase === "loading") body = h("div", {
+					style: { padding: "18px 22px" },
+					children: [
+						h("div", { style: S.skel }),
+						h("div", { style: S.skel }),
+						h("div", { style: S.skel }),
+						h("div", {
+							style: S.tip,
+							children: "正在结合上下文分析…"
+						})
+					]
+				});
+				else if (phase === "error") body = h("div", {
+					style: S.err,
+					children: "⚠ " + (errMsg || "出错了")
+				});
+				else {
+					const rows = items.map((s, i) => h("label", {
+						key: i,
+						style: {
+							...S.row,
+							...checked[i] ? S.rowOn : {}
+						},
+						children: [h("input", {
+							type: "checkbox",
+							checked: !!checked[i],
+							onChange: (e) => {
+								setChecked((prev) => {
+									const n = [...prev];
+									n[i] = e.target.checked;
+									return n;
+								});
+							},
+							style: {
+								marginTop: "2px",
+								width: "16px",
+								height: "16px",
+								accentColor: "var(--dsw-alias-state-business-primary)",
+								cursor: "pointer"
+							}
+						}), h("div", {
+							style: S.rowBody,
+							children: [
+								h("span", {
+									style: tagStyle(s.tag),
+									children: s.tag
+								}),
+								h("p", {
+									style: S.issue,
+									children: s.issue
+								}),
+								s.patch ? h("p", {
+									style: S.patch,
+									children: s.patch
+								}) : null
+							]
+						})]
+					}));
+					const previewChildren = [h("span", {
+						key: "draft",
+						children: reqDraft
+					})];
+					selected.forEach((p, i) => {
+						previewChildren.push(h("span", {
+							key: "p" + i,
+							style: S.added,
+							children: p
+						}));
+					});
+					body = h(React.Fragment, null, [
+						h("div", {
+							style: S.original,
+							children: [h("div", {
+								style: S.originalLabel,
+								children: "原文"
+							}), h("div", { children: reqDraft })]
+						}),
+						h("div", {
+							style: S.list,
+							children: rows
+						}),
+						h("div", {
+							style: S.preview,
+							children: [h("div", {
+								style: S.previewLabel,
+								children: [h("span", { children: "采纳后预览" }), h("span", {
+									style: S.previewCount,
+									children: `已选 ${selectedCount} / ${items.length}`
+								})]
+							}), h("div", {
+								style: S.previewText,
+								children: previewChildren
+							})]
+						}),
+						errMsg ? h("div", {
+							style: S.warn,
+							children: "提示:" + errMsg
+						}) : null,
+						h("div", {
+							style: S.footer,
+							children: [h("span", {
+								style: S.hint,
+								children: (usedModel ? usedModel + " · " : "") + "Esc 关闭"
+							}), h("div", {
+								style: {
+									display: "flex",
+									gap: "8px"
+								},
+								children: [h("button", {
+									type: "button",
+									style: S.btnSec,
+									onClick: close,
+									children: "跳过"
+								}), h("button", {
+									type: "button",
+									style: S.btnPri,
+									onClick: apply,
+									children: selectedCount > 0 ? `采纳 ${selectedCount} 条并填入` : "填入原文"
+								})]
+							})]
+						})
+					]);
+				}
+				const overlay = h("div", {
+					style: S.overlay,
+					onClick: (e) => {
+						if (e.target === e.currentTarget) close();
+					},
+					children: h("div", {
+						style: S.modal,
+						onClick: (e) => e.stopPropagation(),
+						children: [h("div", {
+							style: S.header,
+							children: [h("div", {
+								style: S.title,
+								children: "✨ 提示词优化建议"
+							}), h("p", {
+								style: S.subtitle,
+								children: phase === "result" ? `发现 ${items.length} 处可以更精确` : "正在结合上下文生成建议"
+							})]
+						}), body]
+					})
+				});
+				return h(React.Fragment, null, [button, createPortal(overlay, host)]);
+			}
+			function apply(ctx) {
+				const c = ctx;
+				c.slots.inject("conversation.input.right", () => c.slots.register({
+					name: "conversation.input.right",
+					id: "dsh-prompt-refine-button",
+					order: 10
+				}, PromptRefineControl));
+			}
+			return {
+				name,
+				inject,
+				apply
+			};
+		};
+	}
+	window.__ModuleLoader__.load({
+		id: "dsh-prompt-refine",
+		factory: makeFactory()
+	});
+	//#endregion
+})();