dsh-prompt-snippets 1.3.0 → 1.3.1

package/README.md

@@ -108,7 +108,9 @@ and reload the page.
   面板里点 🕘 展开该片段的历史，可回看历次正文；`/snippet show` 也会显示 revision 号。
 - **命令面板（全局快捷唤起）**：任意时刻按 `Ctrl+Shift+K`（或 `Ctrl+Shift+P`）弹出片段搜索
   浮层，输入关键字即时过滤（名称/分类/标签/正文），`↑` `↓` 选择、`Enter` 插入、`Esc` 关闭；
-  收藏片段自动置顶，无需先点开 dock 面板。
+  收藏片段自动置顶，无需先点开 dock 面板。选中后按 `Ctrl+Enter`（Mac `Cmd+Enter`）则是
+  **插入并立即发送**；带必填占位符的片段仍需先填表单，无法直接发送。`↑` `↓` 切换选中项时
+  列表自动滚动跟随，始终把选中项保持在可视区内。
 
 ## 使用
 

package/client.js

@@ -334,6 +334,12 @@ window.__ModuleLoader__.load({
         maxHeight: "120px",
         overflow: "auto",
       },
+      historyLink: {
+        color: "var(--dsw-alias-brand-primary)",
+        cursor: "pointer",
+        textDecoration: "underline",
+        textUnderlineOffset: "2px",
+      },
       // ── v1.3 命令面板（全局快捷唤起 overlay） ──
       paletteOverlay: {
         position: "fixed",
@@ -366,7 +372,7 @@ window.__ModuleLoader__.load({
         outline: "none",
         fontFamily: "inherit",
       },
-      paletteList: { overflowY: "auto", padding: "6px", flex: 1 },
+      paletteList: { overflowY: "auto", padding: "6px", flex: 1, minHeight: 0 },
       paletteRow: {
         display: "flex",
         alignItems: "center",
@@ -750,12 +756,12 @@ window.__ModuleLoader__.load({
       return [...groups.entries()];
     }
 
-    /** 大小写不敏感、命中名称/分类/内容任一处。 */
+    /** 大小写不敏感、命中名称/分类/标签/内容任一处。 */
     function filterSnippets(snippets, query) {
       const q = query.trim().toLowerCase();
       if (!q) return snippets;
       return snippets.filter((s) => {
-        const hay = `${s.name}\n${s.category || ""}\n${s.content}`.toLowerCase();
+        const hay = `${s.name}\n${s.category || ""}\n${(s.tags || []).join(" ")}\n${s.content}`.toLowerCase();
         return hay.includes(q);
       });
     }
@@ -984,6 +990,7 @@ window.__ModuleLoader__.load({
       const [paletteQuery, setPaletteQuery] = useState("");
       const [paletteSelected, setPaletteSelected] = useState(-1);
       const paletteInputRef = useRef(null);
+      const paletteListRef = useRef(null);
       const searchRef = useRef(null);
       const nameRef = useRef(null);
       // 面板 DOM 引用：拖拽/缩放期间直接改 style.left/top/width/height，
@@ -1034,11 +1041,13 @@ window.__ModuleLoader__.load({
 
       useEffect(() => {
         const onKey = (e) => {
-          if (e.key === "k" && e.ctrlKey && e.shiftKey) {
+          // 用 e.code（物理键位）而非 e.key：Shift+K 会让 e.key 变成大写 "K"，
+          // 导致 Ctrl+Shift+K 永远匹配不到小写 "k"。
+          if (e.code === "KeyK" && (e.ctrlKey || e.metaKey) && e.shiftKey) {
             e.preventDefault();
             setPaletteOpen(true);
             setOpen(false);
-          } else if (e.key === "p" && e.ctrlKey && e.shiftKey) {
+          } else if (e.code === "KeyP" && (e.ctrlKey || e.metaKey) && e.shiftKey) {
             e.preventDefault();
             setPaletteOpen(true);
             setOpen(false);
@@ -1061,6 +1070,22 @@ window.__ModuleLoader__.load({
         return sorted.slice(0, 30);
       }, [snippets, paletteQuery]);
 
+      // 选中项变化时，把对应的列表行滚进可视区（否则上下键切换超过可视高度后不跟随）。
+      useEffect(() => {
+        if (!paletteOpen || paletteSelected < 0 || !paletteListRef.current) return;
+        const el = paletteListRef.current;
+        const row = el.querySelector(`[data-ps-index="${paletteSelected}"]`);
+        if (!row) return;
+        const elTop = el.getBoundingClientRect().top;
+        const rowTop = row.getBoundingClientRect().top;
+        const rowBottom = row.getBoundingClientRect().bottom;
+        if (rowTop < elTop) {
+          el.scrollTop += rowTop - elTop;
+        } else if (rowBottom > el.getBoundingClientRect().bottom) {
+          el.scrollTop += rowBottom - el.getBoundingClientRect().bottom;
+        }
+      }, [paletteOpen, paletteSelected]);
+
       const openPalette = () => {
         setPaletteQuery("");
         setPaletteSelected(-1);
@@ -1074,9 +1099,9 @@ window.__ModuleLoader__.load({
         setPaletteSelected(-1);
       };
 
-      const paletteChoose = (snippet) => {
+      const paletteChoose = (snippet, sendAfter = false) => {
         closePalette();
-        insert(snippet);
+        insert(snippet, sendAfter);
       };
 
       // §3.1：启动时问一次模型可用性。拿不到就不降级为「假装可用」——
@@ -1295,12 +1320,32 @@ window.__ModuleLoader__.load({
         Promise.resolve(rpc.call(CHANNEL, "touch", { ids: [snippetId] })).catch(() => {});
       };
 
+      // 发送当前草稿（Ctrl+Enter 插入并发送时调用；失败不打断，交给用户手动补救）。
+      const submitDraft = () => {
+        try {
+          inputActions.submit();
+        } catch (_) {
+          setError("发送失败：请确认输入框里有内容再试。");
+        }
+      };
+
       // ────────── 插入：直插 / 按默认值插 / 弹表单 ──────────
-      const insert = (snippet) => {
+      // sendAfter：插入成功后立即发送草稿。带必填占位符的片段仍需先填表单，
+      // 无法自动发送，此时降级为「弹表单、填完手动发送」。
+      const insert = (snippet, sendAfter = false) => {
         const plan = fillPlan(snippet);
         if (plan.kind === "form") {
           setFilling({ snippet, values: {} });
           setError(null);
+          // 从命令面板（palette）触发时主面板是关闭的，表单渲染在 open 面板内部，
+          // 必须同时打开主面板并定位，否则「按回车后表单被吞」。
+          if (!open) {
+            if (!panelPos) {
+              const saved = loadSavedPos();
+              setPanelPos(saved ? clampPos(saved.left, saved.top, panelSize) : clampPos(GAP, GAP, panelSize));
+            }
+            setOpen(true);
+          }
           return;
         }
         const { tokens } = scanPlaceholders(snippet.content);
@@ -1312,7 +1357,11 @@ window.__ModuleLoader__.load({
         touch(snippet.id);
         setError(null);
         setOpen(false);
-        if (plan.kind === "defaults") setNotice("已用默认值填充，可在 ✏️ 里改");
+        if (sendAfter) {
+          submitDraft();
+        } else if (plan.kind === "defaults") {
+          setNotice("已用默认值填充，可在 ✏️ 里改");
+        }
       };
 
       const setFillValue = (name, value) => {
@@ -1988,6 +2037,10 @@ window.__ModuleLoader__.load({
             const opts = Array.isArray(d.options) ? d.options : [];
             const label = (typeof d.label === "string" && d.label ? d.label : nm) + (required ? " · 必填" : "");
             const val = typeof cur.values[nm] === "string" ? cur.values[nm] : "";
+            // 长文本变量（变量名带「代码/原文/记录/要点/说明/内容/text/body」或已含换行）用 textarea，
+            // 单行 input 会吃掉换行，粘贴多行代码/会议记录没法看。
+            const multiline =
+              /代码|code|原文|记录|要点|说明|内容|text|body/i.test(nm) || (typeof val === "string" && val.includes("\n"));
             return h(
               "label",
               { key: nm, style: style.field },
@@ -2005,6 +2058,14 @@ window.__ModuleLoader__.load({
                     !required ? h("option", { value: "" }, "（不填）") : null,
                     opts.map((o) => h("option", { key: o, value: o }, o))
                   )
+                : multiline
+                ? h("textarea", {
+                    className: "ps-textarea",
+                    style: { ...style.textarea, minHeight: "54px" },
+                    value: val,
+                    placeholder: typeof d.default === "string" ? d.default : "",
+                    onChange: (ev) => setFillValue(nm, ev.target.value),
+                  })
                 : h("input", {
                     type: "text",
                     className: "ps-input",
@@ -2251,7 +2312,7 @@ window.__ModuleLoader__.load({
               {
                 type: "button",
                 className: "ps-icon",
-                style: { ...style.icon, ...style.iconBusy },
+                style: history && history.id === s.id ? { ...style.icon, ...style.itemEditing } : style.icon,
                 onClick: () => showHistory(s),
                 title: "查看历史版本",
                 "aria-label": `历史「${s.name}」`,
@@ -2357,7 +2418,8 @@ window.__ModuleLoader__.load({
                 } else if (e.key === "Enter") {
                   e.preventDefault();
                   const pick = paletteSelected >= 0 ? paletteResults[paletteSelected] : paletteResults[0];
-                  if (pick) paletteChoose(pick);
+                  // Enter 插入；Ctrl+Enter / Meta+Enter 插入并立即发送。
+                  if (pick) paletteChoose(pick, e.ctrlKey || e.metaKey);
                 } else if (e.key === "Escape") {
                   e.preventDefault();
                   closePalette();
@@ -2366,7 +2428,7 @@ window.__ModuleLoader__.load({
             }),
             h(
               "div",
-              { style: style.paletteList },
+              { style: style.paletteList, ref: paletteListRef },
               paletteResults.length === 0
                 ? h("div", { style: style.empty }, snippets.length === 0 ? "还没有片段，点 dock 的「＋ 新建」保存一个。" : `没有匹配「${paletteQuery}」的片段。`)
                 : paletteResults.map((s, i) =>
@@ -2376,6 +2438,7 @@ window.__ModuleLoader__.load({
                         key: s.id,
                         type: "button",
                         className: "ps-item",
+                        "data-ps-index": i,
                         style: i === paletteSelected ? style.paletteRowActive : style.paletteRow,
                         onMouseEnter: () => setPaletteSelected(i),
                         onClick: () => paletteChoose(s),
@@ -2393,7 +2456,7 @@ window.__ModuleLoader__.load({
             h(
               "div",
               { style: style.paletteHint },
-              "↑↓ 选择 · Enter 插入 · Esc 关闭 · Ctrl+Shift+K 唤起"
+              "↑↓ 选择 · Enter 插入 · Ctrl+Enter 插入并发送 · Esc 关闭 · Ctrl+Shift+K 唤起"
             )
           )
         );
@@ -2421,7 +2484,40 @@ window.__ModuleLoader__.load({
                     h(
                       "div",
                       { style: style.historyContent },
-                      h("div", { style: { color: C.textDim, fontSize: "10px" } }, `保存于 ${fmtTime(v.at)} · 插入旧版`),
+                      h(
+                        "div",
+                        { style: { color: C.textDim, fontSize: "10px" } },
+                        `保存于 ${fmtTime(v.at)} · `,
+                        h(
+                          "span",
+                          {
+                            style: style.historyLink,
+                            role: "button",
+                            tabIndex: 0,
+                            onClick: () => {
+                              if (!insertText(v.content)) {
+                                setError("插入失败：请先把光标放进输入框再试。");
+                                return;
+                              }
+                              setError(null);
+                              setNotice("已插入旧版内容");
+                            },
+                            onKeyDown: (e) => {
+                              if (e.key === "Enter" || e.key === " ") {
+                                e.preventDefault();
+                                if (!insertText(v.content)) {
+                                  setError("插入失败：请先把光标放进输入框再试。");
+                                  return;
+                                }
+                                setError(null);
+                                setNotice("已插入旧版内容");
+                              }
+                            },
+                            title: "把这一版的内容插入输入框",
+                          },
+                          "插入旧版"
+                        )
+                      ),
                       v.content
                     )
                   )

package/index.js

@@ -34,48 +34,78 @@ const TEMPLATE_PACK = [
     category: "开发",
     tags: ["代码", "审查"],
     content: "请审查下面这段代码，重点关注 {{关注点}}，指出潜在 bug、性能问题与可读性改进，并给出修改建议。\n\n```\n{{代码}}\n```",
+    variables: {
+      关注点: {
+        label: "关注点",
+        options: ["正确性、边界与命名", "性能与内存", "安全漏洞", "可读性与重构"],
+        default: "正确性、边界与命名",
+      },
+      代码: { label: "待审查代码", required: true },
+    },
   },
   {
     name: "Git 提交信息",
     category: "开发",
     tags: ["git", "提交"],
     content: "请根据以下变更，生成一条规范的 git commit message（约定式提交风格，一行标题 + 空行 + 要点式正文）：\n\n{{变更说明}}",
+    variables: { 变更说明: { label: "变更说明", required: true } },
   },
   {
     name: "Bug 排查",
     category: "开发",
     tags: ["bug", "排查"],
     content: "我遇到一个问题：{{现象}}。相关环境：{{环境}}。已尝试：{{已尝试}}。请按「现象 → 根因假设 → 验证方法 → 修复方案」逐步分析。",
+    variables: {
+      现象: { label: "问题现象", required: true },
+      环境: { label: "相关环境", default: "操作系统 / 版本 / 依赖" },
+      已尝试: { label: "已尝试的方法" },
+    },
   },
   {
     name: "周报",
     category: "写作",
     tags: ["周报", "工作"],
     content: "请根据以下要点，帮我整理成一份结构清晰的周报（本周完成 / 进行中 / 下周计划 / 风险与求助）：\n\n{{要点}}",
+    variables: { 要点: { label: "工作要点", required: true } },
   },
   {
     name: "翻译润色",
     category: "写作",
     tags: ["翻译", "润色"],
     content: "请把下面的内容翻译成 {{目标语言}}，并润色为自然流畅的表达，保留原意与格式：\n\n{{原文}}",
+    variables: {
+      目标语言: {
+        label: "目标语言",
+        options: ["英文", "简体中文", "繁体中文", "日文", "韩文", "法文", "德文"],
+        default: "英文",
+      },
+      原文: { label: "待翻译内容", required: true },
+    },
   },
   {
     name: "日报",
     category: "写作",
     tags: ["日报", "工作"],
     content: "今天是 {{date}}，请根据以下要点帮我生成一份工作日报（今日完成 / 明日计划 / 需要协调）：\n\n{{要点}}",
+    variables: { 要点: { label: "工作要点", required: true } },
   },
   {
     name: "会议纪要",
     category: "写作",
     tags: ["会议", "纪要"],
     content: "请把下面的会议记录整理成纪要（结论 / 待办与负责人 / 时间点）：\n\n{{记录}}",
+    variables: { 记录: { label: "会议记录", required: true } },
   },
   {
     name: "学习计划",
     category: "学习",
     tags: ["学习", "计划"],
     content: "我想在 {{时间}} 内掌握 {{主题}}，目前基础是 {{当前水平}}。请制定一个可执行的学习计划，分阶段列出目标、内容与检验方式。",
+    variables: {
+      时间: { label: "学习周期", default: "3 个月" },
+      主题: { label: "学习主题", required: true },
+      当前水平: { label: "当前基础", default: "零基础" },
+    },
   },
 ];
 
@@ -292,7 +322,7 @@ function seedTemplates() {
   const now = Date.now();
   const snippets = TEMPLATE_PACK.map((t, i) => {
     const { names } = scanPlaceholders(t.content);
-    const { variables } = normalizeVariables(names, {});
+    const { variables } = normalizeVariables(names, t.variables || {});
     return {
       id: randomUUID(),
       name: t.name,
@@ -957,17 +987,23 @@ async function saveSnippet(payload) {
       if (other) {
         return conflictError("name", `已有另一个片段叫「${name}」。`, other);
       }
-      // 记历史：被覆盖的这一版（name/content/variables 快照）
-      historyId = existing.id;
-      historySnapshot = {
-        name: existing.name,
-        content: existing.content,
-        variables: existing.variables,
-        category: existing.category,
-        tags: existing.tags,
-        at: existing.updatedAt,
-        revision: existing.revision,
-      };
+      // 记历史：被覆盖的这一版（name/content/variables 快照）。
+      // 只改分类/标签/置顶这类元数据时内容与变量都没动，不该产生一条历史版本，
+      // 否则「换了个标签」就多出一次可回退的旧版，历史列表会迅速被噪声塞满。
+      const contentChanged = existing.content !== content;
+      const variablesChanged = JSON.stringify(existing.variables) !== JSON.stringify(variables);
+      if (contentChanged || variablesChanged) {
+        historyId = existing.id;
+        historySnapshot = {
+          name: existing.name,
+          content: existing.content,
+          variables: existing.variables,
+          category: existing.category,
+          tags: existing.tags,
+          at: existing.updatedAt,
+          revision: existing.revision,
+        };
+      }
       existing.name = name;
       existing.content = content;
       existing.variables = variables;
@@ -1570,22 +1606,7 @@ async function dispatch(ctx, endpoint, payload, signal) {
       // 不重新落盘、不重新生成内容——否则会覆盖掉用户手工改过的导出文件。
       if (typeof payload?.revealPath === "string" && payload.revealPath.trim() !== "") {
         const p = payload.revealPath.trim();
-        let revealed = false;
-        let revealError = null;
-        if (process.platform === "win32") {
-          try {
-            const { spawn } = await import("node:child_process");
-            await new Promise((resolve) => {
-              const child = spawn("explorer.exe", [`/select,${p}`], { stdio: "ignore", detached: true });
-              child.on("error", () => resolve(false));
-              child.on("spawn", () => resolve(true));
-              setTimeout(() => resolve(true), 500);
-            });
-            revealed = true;
-          } catch (error) {
-            revealError = error instanceof Error ? error.message : String(error);
-          }
-        }
+        const { revealed, revealError } = await revealInFileManager(p);
         return { ok: true, value: { path: p, revealed, revealError: revealError || undefined } };
       }
       // payload.write = 文件名（字符串）时，落盘到数据目录的 exports/ 并回传路径。
@@ -1600,24 +1621,12 @@ async function dispatch(ctx, endpoint, payload, signal) {
         } catch (error) {
           return fail("internal", `写入导出文件失败：${error instanceof Error ? error.message : String(error)}`);
         }
-        // 请求方要求打开导出文件所在目录时，用系统默认方式 reveal（Windows: explorer /select）。
-        // 打开失败只降级不报错——用户仍可凭回传的绝对路径手动定位。
+        // 请求方要求打开导出文件所在目录时，用系统默认方式 reveal（Windows: explorer /select；
+        // macOS: open -R；Linux: xdg-open 目录）。打开失败只降级不报错——用户仍可凭回传的绝对路径手动定位。
         let revealed = false;
         let revealError = null;
-        if (payload.reveal === true && process.platform === "win32") {
-          try {
-            const { spawn } = await import("node:child_process");
-            await new Promise((resolve) => {
-              const p = spawn("explorer.exe", [`/select,${target}`], { stdio: "ignore", detached: true });
-              p.on("error", () => resolve(false));
-              p.on("spawn", () => resolve(true));
-              // explorer 可能已经存在则立即退出，也可能挂起；500ms 兜底，不阻塞导出结果
-              setTimeout(() => resolve(true), 500);
-            });
-            revealed = true;
-          } catch (error) {
-            revealError = error instanceof Error ? error.message : String(error);
-          }
+        if (payload.reveal === true) {
+          ({ revealed, revealError } = await revealInFileManager(target));
         }
         return {
           ok: true,
@@ -1686,6 +1695,42 @@ const ADD_USAGE = "/snippet add <名称> <内容> [--cat=<分类>] [--tag=<标
 const USAGE = `${ADD_USAGE} | list | show <名称> | rm <名称|#id> | undo <名称|#id> | mv <名称> <新名称> | pin <名称|#id> | unpin <名称|#id> | tag <名称|#id> <标签…> | optimize <名称> | export [文件名] | import <文件路径> [--replace] [--dry]`;
 
 /** 导出文件名不能带路径分隔符，也不能是 `.`/`..`，避免写出数据目录。 */
+/**
+ * 用系统默认方式在文件管理器里定位一个已存在的文件。
+ * win32 → explorer /select,；darwin → open -R；linux 等 → xdg-open 所在目录。
+ * 打开失败只降级（revealed=false + revealError），不抛异常。
+ */
+async function revealInFileManager(filePath) {
+  let revealed = false;
+  let revealError = null;
+  try {
+    const { spawn } = await import("node:child_process");
+    let cmd;
+    let args;
+    if (process.platform === "win32") {
+      cmd = "explorer.exe";
+      args = [`/select,${filePath}`];
+    } else if (process.platform === "darwin") {
+      cmd = "open";
+      args = ["-R", filePath];
+    } else {
+      cmd = "xdg-open";
+      args = [dirname(filePath)];
+    }
+    await new Promise((resolve) => {
+      const child = spawn(cmd, args, { stdio: "ignore", detached: true });
+      child.on("error", () => resolve(false));
+      child.on("spawn", () => resolve(true));
+      // 文件管理器可能立即退出也可能挂起；500ms 兜底，不阻塞导出结果
+      setTimeout(() => resolve(true), 500);
+    });
+    revealed = true;
+  } catch (error) {
+    revealError = error instanceof Error ? error.message : String(error);
+  }
+  return { revealed, revealError };
+}
+
 function safeExportName(raw) {
   const text = typeof raw === "string" ? raw.trim() : "";
   const base = text === "" ? "snippets" : text;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prompt-snippets",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "type": "module",
   "description": "Save reusable prompt snippets with categories, {{placeholder}} fill forms & dropdown enums, version history, pinned/tag search, and crash-safe atomic JSON storage — insert them into the composer from a draggable dock.",
   "keywords": [