@morehao/dsh-skills-console 0.5.5 → 0.5.7

package/README.en.md

@@ -94,7 +94,7 @@ Some skills only have an English description, and some titles alone don't tell y
 The **refresh button** next to the identity capsule in the page header checks whether *Skills Console itself* has a new release. This is a different axis from skill updates — it checks this plugin's own npm releases:
 
 - **How it checks**: follows the registry plan from the host's `pluginManager.registries()` (inheriting the profile's mirror / private source / token config) and asks `<registry>/<package>/latest` in turn (8s timeout, version only; falls back to the official `registry.npmjs.org` only if none answer), then compares with the installed version; the host caches for 5 minutes so repeated opens don't hit the network. About 20 seconds after startup it warms the cache once, silently.
-- **One-click update**: when the desktop host exposes `pluginManager`, clicking "Update to x.y.z" reinstalls this plugin to the latest version (installed from the registry that reported it); **restart DSH to apply** (no auto-reload).
+- **One-click update**: when the desktop host exposes `pluginManager`, clicking "Update to x.y.z" reinstalls this plugin to the latest version (installed from the registry that reported it). With HMR, the host refuses to overwrite an installed package by name with `already-installed`; the plugin follows the official update path (`removeBundle` then `installBundle`); **restart DSH to apply** (no auto-reload).
 - **Manual fallback**: if one-click update is unavailable, the dialog shows a copyable command (`dsh plugin --profile <profile> add <package>@latest`).
 - **When a new version exists**: a small dot lights up on the refresh button; open it to see current / latest version and the update button, plus the release's **GitHub Release notes** body pulled for that version (if unavailable, a "view release notes on GitHub" link instead).
 - **Boundaries**: it only queries registries and only (re)installs this plugin itself, touching no other plugin's state directory; failures degrade silently to "could not reach the registry" and never affect any skill-management feature.
@@ -157,8 +157,10 @@ AI intro settings (in the plugin `config` of the profile / `cordis.patch.yml`):
 | `intro.enabled` | `true` | `false` hides the ✨ entry and the API returns 501 |
 | `intro.provider` / `intro.model` | empty | empty uses DSH's current default model; both must be set together |
 | `intro.maxInputBytes` | `24576` | cap on the `SKILL.md` sent to the model (8–48 KB); longer input is truncated and marked in the prompt |
-| `intro.maxOutputTokens` | `300` | output cap (96–1024) |
-| `intro.timeoutMs` | `30000` | per-generation timeout (5–60 s); timeouts return 504 |
+| `intro.maxOutputTokens` | `4096` | output ceiling (96–8192). This is a runaway guard, not a length target; reasoning tokens count toward it, and the effective floor is raised per model |
+| `intro.timeoutMs` | `60000` | per-generation timeout (5–60 s); timeouts return 504 |
+
+The intro length is controlled by the 160-character prompt target. Do not treat `maxOutputTokens` as a length target; lowering it does not save cost, it only leaves a reasoning model no room for visible text.
 
 ## Development and publishing
 

package/README.md

@@ -94,7 +94,7 @@ DSH（DeepSeek Harness）的技能控制台：**安装、更新、删除、启
 页头身份胶囊旁的**刷新按钮**用来检查「技能控制台」这个插件自己有没有新版本，而管的是另一个维度——它不是检查技能的上游，而是检查本插件在 npm 上的发布：
 
 - **怎么查**：按宿主 `pluginManager.registries()` 给的 registry 计划（继承 profile 的镜像 / 私有源 / token 配置）依次问 `<registry>/<包名>/latest`（8 秒超时，只取版本号，取不到才回退官方 `registry.npmjs.org`），与本机安装的版本比较；Host 端 5 分钟缓存，连续打开不重复打网络。启动后约 20 秒会静默热身一次，不打扰你。
-- **一键更新**：桌面端有 `pluginManager` 服务时，弹窗里点「更新到 x.y.z」即可把本插件重装到最新版（装到查到最新版的那个 registry）；更新成功后**重启 DSH 生效**（不自动刷新）。
+- **一键更新**：桌面端有 `pluginManager` 服务时，弹窗里点「更新到 x.y.z」即可把本插件重装到最新版（装到查到最新版的那个 registry）。HMR 开启时宿主会以 `already-installed` 拒绝覆盖同名已安装包，插件按官方更新路径先 `removeBundle` 再 `installBundle`；更新成功后**重启 DSH 生效**（不自动刷新）。
 - **手动兜底**：环境不支持一键更新时，弹窗给出可复制的手动命令（`dsh plugin --profile <profile> add <包名>@latest`）。
 - **有新版本时**：刷新按钮上会亮一个小圆点，点开即见当前版本 / 最新版本与更新按钮；弹窗还会拉取该版本在 GitHub 上的 **Release 发布说明**正文一并展示（拉不到时给「在 GitHub 查看发布说明」链接）。
 - **边界**：只问 registry、只装本插件自身，不读写其他插件的状态目录；失败静默降级为「暂时无法获取最新版本」，不影响技能管理的任何功能。
@@ -157,8 +157,10 @@ plugin_manager install_bundle(target = <本仓库绝对路径>)
 | `intro.enabled` | `true` | `false` 时界面隐藏 ✨ 入口，接口返回 501 |
 | `intro.provider` / `intro.model` | 空 | 留空用 DSH 当前默认模型；两个必须同时给 |
 | `intro.maxInputBytes` | `24576` | 发给模型的 `SKILL.md` 上限（8–48 KB），超出截断并在提示词里标注 |
-| `intro.maxOutputTokens` | `300` | 输出上限（96–1024） |
-| `intro.timeoutMs` | `30000` | 单次生成超时（5–60 秒），超时返回 504 |
+| `intro.maxOutputTokens` | `4096` | 输出上限（96–8192）。这是防跑飞的预算，不是长度目标；推理模型的思考 token 也计入，实际会按模型自动抬高保底 |
+| `intro.timeoutMs` | `60000` | 单次生成超时（5–60 秒），超时返回 504 |
+
+简介长度由提示词里的 160 字控制，不要把 `maxOutputTokens` 当成目标长度；调小它不会省钱，只会让推理模型没有输出正文的空间。
 
 ## 开发与发布
 

package/client.js

@@ -244,6 +244,7 @@ var DICT = {
     "form.subpath": "子目录（可空）",
     "form.hint": "会立即下载并写入 ~/.agents/skills，并按「新安装时自动共享」的选择共享至对应 Agent。",
     "form.subHint": "只记录你关注这个仓库，不会安装任何技能。",
+    "form.submitFailed": "添加失败，请重试",
     "subscription.defaultRef": "默认分支",
     "confirm.deleteTitle": "删除技能",
     "confirm.deleteBody": "会从本机移除，断开本插件建立的其他 Agent 链接并清理记录；目录先备份到回收站（保留 7 天）。不会删除你的源仓库。",
@@ -356,6 +357,9 @@ var DICT = {
     "intro.error.timeout": "生成超时，请重试",
     "intro.error.auth": "模型提供方认证失败",
     "intro.error.empty": "模型没有返回内容",
+    "intro.error.truncated": "简介被输出上限截断，请重试",
+    "intro.error.reasoningOnly": "模型只输出了思考过程，没有输出正文；请提高输出上限或换非推理模型",
+    "intro.error.noText": "模型没有输出文字简介，请重试",
     "intro.error.busy": "正在生成，请稍候",
     "intro.error.source": "读不到远端的 SKILL.md（仓库私有、已删除或网络问题）",
     "intro.error.noSource": "订阅快照里没有这个技能，请先点「检查更新」",
@@ -525,6 +529,7 @@ var DICT = {
     "form.subpath": "Subdirectory (optional)",
     "form.hint": "Downloads into ~/.agents/skills and shares it with agents per the auto-share setting.",
     "form.subHint": "Only records the repository; installs nothing.",
+    "form.submitFailed": "Failed; please try again",
     "subscription.defaultRef": "default branch",
     "confirm.deleteTitle": "Delete skill",
     "confirm.deleteBody": "Removes it locally, disconnects the agent links this plugin created, and clears the record. A snapshot stays in trash for 7 days. Your source repo is untouched.",
@@ -638,6 +643,9 @@ var DICT = {
     "intro.error.timeout": "Generation timed out; try again",
     "intro.error.auth": "The model provider rejected the credentials",
     "intro.error.empty": "The model returned no content",
+    "intro.error.truncated": "The intro hit the output limit and was truncated; try again",
+    "intro.error.reasoningOnly": "The model only produced reasoning, not intro text; raise the output limit or use a non-reasoning model",
+    "intro.error.noText": "The model returned no text intro; try again",
     "intro.error.busy": "Already generating; please wait",
     "intro.error.source": "Could not read the remote SKILL.md (private repo, deleted, or network)",
     "intro.error.noSource": "This skill is not in the subscription snapshot; run “Check for updates” first",
@@ -1152,6 +1160,7 @@ var CSS = `
   /* 标题不参与收窄：窄面板里让身份胶囊先省略，标题本身不折行 */
   .dshsc-title { font-size: 17px; font-weight: 600; letter-spacing: -.01em; margin: 0; flex: none; white-space: nowrap; }
   .dshsc-sub { font-size: 12px; line-height: 1.55; color: var(--dsw-alias-label-secondary); margin: 0; max-width: 64ch; }
+  .dshsc-form-error { font-size: 12px; line-height: 1.55; margin: 8px 0 0; max-width: 64ch; color: var(--dsw-alias-state-error-primary); }
   .dshsc-spacer { flex: 1; }
   .dshsc-head-actions { display: flex; align-items: center; justify-content: flex-end; gap: 6px; flex-wrap: wrap; margin-left: auto; }
   /* 标题行恒为一行：身份胶囊只在面板极窄（连标题行都放不下）时才省略，工具组不被挤走。
@@ -1984,26 +1993,38 @@ function useSkillActions({ t, rows, reload, run, setBusy, setToast, setModal })
     return apiCall("POST", "/probe", { source: String(source || "").trim() });
   }
   async function installSkills({ source, skills }) {
-    setModal(null);
-    await run("install", async () => {
-      const result = await apiCall("POST", "/install", { source: String(source || "").trim(), skills });
-      const warnings = result.warnings?.length || 0;
-      setToast({
-        kind: warnings ? "err" : "ok",
-        text: `${result.installed?.length || 0} ${t("skillCount")}${warnings ? ` · ${warnings} 条提示` : ""}`
-      });
-    });
+    try {
+      await run("install", async () => {
+        const result = await apiCall("POST", "/install", { source: String(source || "").trim(), skills });
+        const warnings = result.warnings?.length || 0;
+        setToast({
+          kind: warnings ? "err" : "ok",
+          text: `${result.installed?.length || 0} ${t("skillCount")}${warnings ? ` · ${warnings} 条提示` : ""}`
+        });
+        return result;
+      }, { toastError: false });
+      setModal(null);
+      return { ok: true };
+    } catch (err) {
+      return { ok: false, error: err?.message || String(err) };
+    }
   }
   async function addSubscription(form) {
-    setModal(null);
-    await run("subscribe", async () => {
-      const result = await apiCall("POST", "/subscriptions", {
-        source: form.source.trim(),
-        ref: form.ref.trim() || void 0,
-        subpath: form.subpath.trim() || void 0
-      });
-      setToast({ kind: "ok", text: result.subscription?.source || form.source });
-    });
+    try {
+      const result = await run("subscribe", async () => {
+        const res = await apiCall("POST", "/subscriptions", {
+          source: form.source.trim(),
+          ref: form.ref.trim() || void 0,
+          subpath: form.subpath.trim() || void 0
+        });
+        setToast({ kind: "ok", text: res.subscription?.source || form.source });
+        return res;
+      }, { toastError: false });
+      setModal(null);
+      return { ok: true, result };
+    } catch (err) {
+      return { ok: false, error: err?.message || String(err) };
+    }
   }
   async function refreshSubscription(row) {
     await run(`refresh:${row.id}`, async () => {
@@ -2070,14 +2091,14 @@ function useSkillsData() {
     return () => clearTimeout(timer);
   }, [toast]);
   const run = import_react2.default.useCallback(
-    async (label, task) => {
+    async (label, task, { toastError = true } = {}) => {
       setBusy(label);
       try {
         const result = await task();
         await reload();
         return result;
       } catch (err) {
-        setToast({ kind: "err", text: err.message });
+        if (toastError) setToast({ kind: "err", text: err.message });
         throw err;
       } finally {
         setBusy(null);
@@ -2590,12 +2611,13 @@ function Toolbar({
 var import_react4 = __toESM(require("react"), 1);
 
 // client/views/overlay.js
-function Overlay({ t, title, children, footer, onCancel }) {
-  useOverlayLayer(true, onCancel);
+function Overlay({ t, title, children, footer, onCancel, dismissible = true }) {
+  useOverlayLayer(true, dismissible ? onCancel : () => {
+  });
   return portalize(h(
     "div",
     { className: "dshsc-overlay", onClick: (event) => {
-      if (event.target === event.currentTarget) onCancel?.();
+      if (dismissible && event.target === event.currentTarget) onCancel?.();
     } },
     h(
       "div",
@@ -2603,9 +2625,10 @@ function Overlay({ t, title, children, footer, onCancel }) {
       h("button", {
         className: "dshsc-modal-close",
         "aria-label": t("action.cancel"),
+        disabled: !dismissible,
         onClick: (event) => {
           event.stopPropagation();
-          onCancel?.();
+          if (dismissible) onCancel?.();
         }
       }, "×"),
       h("h3", null, title),
@@ -2624,6 +2647,9 @@ var ERROR_KEY = {
   "error.skills.intro-timeout": "intro.error.timeout",
   "error.skills.intro-auth": "intro.error.auth",
   "error.skills.intro-empty": "intro.error.empty",
+  "error.skills.intro-truncated": "intro.error.truncated",
+  "error.skills.intro-reasoning-only": "intro.error.reasoningOnly",
+  "error.skills.intro-no-text": "intro.error.noText",
   "error.skills.intro-busy": "intro.error.busy",
   "error.skills.intro-source": "intro.error.source",
   "error.skills.subscription-not-found": "intro.error.subscription",
@@ -3614,6 +3640,8 @@ function AddSkillModal({ t, onCancel, onProbe, onInstall }) {
   const [manual, setManual] = import_react6.default.useState("");
   const [skipped, setSkipped] = import_react6.default.useState(0);
   const [error, setError] = import_react6.default.useState(null);
+  const [pending, setPending] = import_react6.default.useState(false);
+  const [submitError, setSubmitError] = import_react6.default.useState(null);
   const reset = (value) => {
     setSource(value);
     setPhase("idle");
@@ -3621,12 +3649,14 @@ function AddSkillModal({ t, onCancel, onProbe, onInstall }) {
     setSelected(/* @__PURE__ */ new Set());
     setSkipped(0);
     setError(null);
+    setSubmitError(null);
   };
   const probe = async () => {
     const value = source.trim();
-    if (!value || phase === "probing") return;
+    if (!value || phase === "probing" || pending) return;
     setPhase("probing");
     setError(null);
+    setSubmitError(null);
     try {
       const result = await onProbe(value);
       const found = Array.isArray(result?.skills) ? result.skills : [];
@@ -3639,20 +3669,33 @@ function AddSkillModal({ t, onCancel, onProbe, onInstall }) {
       setPhase("failed");
     }
   };
-  const toggle = (name) => setSelected((prev) => {
-    const next = new Set(prev);
-    if (next.has(name)) next.delete(name);
-    else next.add(name);
-    return next;
-  });
+  const toggle = (name) => {
+    setSubmitError(null);
+    setSelected((prev) => {
+      const next = new Set(prev);
+      if (next.has(name)) next.delete(name);
+      else next.add(name);
+      return next;
+    });
+  };
   const names = manual.split(/[,，\s]+/).map((item) => item.trim()).filter(Boolean);
   const skippedText = skipped > 0 ? t("form.skipped").replace("{n}", String(skipped)) : null;
   const manualMode = phase === "empty" || phase === "failed";
   const skills = phase === "picked" ? [...selected] : names;
   const canSubmit = phase === "picked" ? selected.size > 0 : manualMode ? names.length > 0 : false;
-  const submit = () => {
-    if (!canSubmit) return;
-    onInstall({ source: source.trim(), skills });
+  const submit = async () => {
+    if (!canSubmit || pending) return;
+    setPending(true);
+    setSubmitError(null);
+    let res;
+    try {
+      res = await onInstall({ source: source.trim(), skills });
+    } catch (err) {
+      res = { ok: false, error: err?.message || String(err) };
+    }
+    if (res?.ok) return;
+    setPending(false);
+    setSubmitError(res?.error || t("form.submitFailed"));
   };
   return h(
     Overlay,
@@ -3660,14 +3703,16 @@ function AddSkillModal({ t, onCancel, onProbe, onInstall }) {
       t,
       title: t("action.addSkill"),
       onCancel,
+      // 提交安装进行中禁止关闭：请求不可取消，允许关闭只是假装取消
+      dismissible: !pending,
       footer: [
-        h("button", { key: "c", className: "dshsc-btn ghost", onClick: onCancel }, t("action.cancel")),
+        h("button", { key: "c", className: "dshsc-btn ghost", disabled: pending, onClick: onCancel }, t("action.cancel")),
         h("button", {
           key: "s",
           className: "dshsc-btn primary",
-          disabled: !canSubmit,
-          onClick: submit
-        }, t("action.save"))
+          disabled: !canSubmit || pending,
+          onClick: () => void submit()
+        }, pending ? t("busy.working") : t("action.save"))
       ]
     },
     h("p", { className: "dshsc-sub" }, t("form.pickHint")),
@@ -3681,18 +3726,20 @@ function AddSkillModal({ t, onCancel, onProbe, onInstall }) {
         h("input", {
           value: source,
           placeholder: t("form.sourceHint"),
+          disabled: pending,
           onChange: (event) => reset(event.target.value),
           onKeyDown: (event) => {
-            if (event.key === "Enter") void probe();
+            if (event.key === "Enter" && !pending) void probe();
           }
         }),
         h("button", {
           className: "dshsc-btn",
-          disabled: !source.trim() || phase === "probing",
+          disabled: !source.trim() || phase === "probing" || pending,
           onClick: () => void probe()
         }, phase === "probing" ? t("form.probing") : t("form.probe"))
       )
     ),
+    submitError ? h("p", { className: "dshsc-form-error", role: "alert" }, submitError) : null,
     phase === "picked" ? h(
       "div",
       { key: "picked" },
@@ -3702,11 +3749,19 @@ function AddSkillModal({ t, onCancel, onProbe, onInstall }) {
         { style: { display: "flex", gap: 6, marginBottom: 6 } },
         h("button", {
           className: "dshsc-btn ghost",
-          onClick: () => setSelected(new Set(options.map((item) => item.name)))
+          disabled: pending,
+          onClick: () => {
+            setSubmitError(null);
+            setSelected(new Set(options.map((item) => item.name)));
+          }
         }, t("form.selectAll")),
         h("button", {
           className: "dshsc-btn ghost",
-          onClick: () => setSelected(/* @__PURE__ */ new Set())
+          disabled: pending,
+          onClick: () => {
+            setSubmitError(null);
+            setSelected(/* @__PURE__ */ new Set());
+          }
         }, t("form.selectNone"))
       ),
       h("div", { className: "dshsc-panel" }, options.map((option) => h(
@@ -3715,6 +3770,7 @@ function AddSkillModal({ t, onCancel, onProbe, onInstall }) {
         h("input", {
           type: "checkbox",
           checked: selected.has(option.name),
+          disabled: pending,
           onChange: () => toggle(option.name)
         }),
         h(
@@ -3739,7 +3795,11 @@ function AddSkillModal({ t, onCancel, onProbe, onInstall }) {
         h("input", {
           value: manual,
           placeholder: "git-kit, handoff",
-          onChange: (event) => setManual(event.target.value)
+          disabled: pending,
+          onChange: (event) => {
+            setManual(event.target.value);
+            if (submitError) setSubmitError(null);
+          }
         })
       )
     ) : null,
@@ -3750,23 +3810,41 @@ function AddSkillModal({ t, onCancel, onProbe, onInstall }) {
 // client/views/modals.js
 function FormModal({ t, title, hint, fields, onCancel, onSubmit }) {
   const [form, setForm] = import_react7.default.useState(() => Object.fromEntries(fields.map((field) => [field.key, ""])));
+  const [pending, setPending] = import_react7.default.useState(false);
+  const [error, setError] = import_react7.default.useState(null);
   const incomplete = fields.some(
     (field) => field.required !== false && !String(form[field.key] || "").trim()
   );
+  const submit = async () => {
+    if (incomplete || pending) return;
+    setPending(true);
+    setError(null);
+    let res;
+    try {
+      res = await onSubmit(form);
+    } catch (err) {
+      res = { ok: false, error: err?.message || String(err) };
+    }
+    if (res?.ok) return;
+    setPending(false);
+    setError(res?.error || t("form.submitFailed"));
+  };
   return h(
     Overlay,
     {
       t,
       title,
       onCancel,
+      // 提交进行中禁止关闭：请求不可取消，允许关闭只是假装取消
+      dismissible: !pending,
       footer: [
-        h("button", { key: "c", className: "dshsc-btn ghost", onClick: onCancel }, t("action.cancel")),
+        h("button", { key: "c", className: "dshsc-btn ghost", disabled: pending, onClick: onCancel }, t("action.cancel")),
         h("button", {
           key: "s",
           className: "dshsc-btn primary",
-          disabled: incomplete,
-          onClick: () => onSubmit(form)
-        }, t("action.save"))
+          disabled: incomplete || pending,
+          onClick: () => void submit()
+        }, pending ? t("busy.working") : t("action.save"))
       ]
     },
     hint ? h("p", { className: "dshsc-sub" }, hint) : null,
@@ -3777,9 +3855,14 @@ function FormModal({ t, title, hint, fields, onCancel, onSubmit }) {
       h("input", {
         value: form[field.key],
         placeholder: field.placeholder,
-        onChange: (event) => setForm((prev) => ({ ...prev, [field.key]: event.target.value }))
+        disabled: pending,
+        onChange: (event) => {
+          setForm((prev) => ({ ...prev, [field.key]: event.target.value }));
+          if (error) setError(null);
+        }
       })
-    ))
+    )),
+    error ? h("p", { className: "dshsc-form-error", role: "alert" }, error) : null
   );
 }
 function ConfirmModal({ t, title, body, onCancel, onConfirm, danger, confirmLabel, hideCancel = false }) {
@@ -3894,7 +3977,7 @@ function Modals({ t, modal, data, autoLinkAgents, actions, onClose, onSaveAutoLi
         { key: "subpath", label: t("form.subpath"), placeholder: "skills", required: false }
       ],
       onCancel: onClose,
-      onSubmit: (form) => void actions.addSubscription(form)
+      onSubmit: (form) => actions.addSubscription(form)
     });
   }
   if (modal.type === "exports") {
@@ -5000,6 +5083,11 @@ function SkillReader({
 
 // client/views/plugin-update-modal.js
 var import_react9 = __toESM(require("react"), 1);
+function flattenDetails(text) {
+  return String(text ?? "").replace(/<details[^>]*>\s*<summary>([\s\S]*?)<\/summary>/gi, (_, summary) => `**${String(summary).trim()}**
+
+`).replace(/<\/details>/gi, "");
+}
 function PluginUpdateModal({ t, update, onClose, repoUrl }) {
   const { status, checking, applying, checkError, applyError, check, apply: apply2, release, loadRelease } = update;
   const [copied, setCopied] = import_react9.default.useState(false);
@@ -5018,7 +5106,7 @@ function PluginUpdateModal({ t, update, onClose, repoUrl }) {
   }, [available, latest, loadRelease]);
   const releaseData = release?.version === latest ? release.data : null;
   const releaseLoading = release?.version === latest && release.loading;
-  const releaseBody = typeof releaseData?.body === "string" ? releaseData.body.trim() : "";
+  const releaseBody = typeof releaseData?.body === "string" ? flattenDetails(releaseData.body.trim()).trim() : "";
   const releaseUrl = releaseData?.htmlUrl || (repoUrl ? `${repoUrl}/releases` : null);
   const copy = () => {
     if (!manual || typeof navigator === "undefined" || !navigator.clipboard?.writeText) return;
@@ -5031,7 +5119,7 @@ function PluginUpdateModal({ t, update, onClose, repoUrl }) {
   let stateLine;
   if (checking && !status) stateLine = t("pluginUpdate.checking");
   else if (checkError || status?.checkFailed) stateLine = t("pluginUpdate.checkFailed");
-  else if (restartRequired) stateLine = t("pluginUpdate.updated", { version: updatedVersion || latest });
+  else if (restartRequired) stateLine = t("pluginUpdate.updated").replace("{version}", String(updatedVersion || latest || ""));
   else if (available) stateLine = t("pluginUpdate.available");
   else if (status) stateLine = t("pluginUpdate.upToDate");
   else stateLine = t("pluginUpdate.checking");
@@ -5050,7 +5138,7 @@ function PluginUpdateModal({ t, update, onClose, repoUrl }) {
       className: "dshsc-btn primary",
       disabled: applying,
       onClick: () => void apply2()
-    }, applying ? t("pluginUpdate.applying") : t("pluginUpdate.update", { version: latest })));
+    }, applying ? t("pluginUpdate.applying") : t("pluginUpdate.update").replace("{version}", String(latest || ""))));
   }
   footer.push(h("button", { key: "close", className: "dshsc-btn ghost", onClick: onClose }, t("pluginUpdate.close")));
   return h(
@@ -5069,7 +5157,7 @@ function PluginUpdateModal({ t, update, onClose, repoUrl }) {
     available ? h(
       "div",
       { className: "dshsc-release" },
-      h("div", { className: "dshsc-release-head" }, t("pluginUpdate.whatsNew", { version: latest })),
+      h("div", { className: "dshsc-release-head" }, t("pluginUpdate.whatsNew").replace("{version}", String(latest || ""))),
       releaseLoading ? h("p", { className: "dshsc-sub" }, t("pluginUpdate.releaseLoading")) : releaseBody ? h("div", { className: "dshsc-release-body" }, h(Markdown, { text: releaseBody })) : h(
         "p",
         { className: "dshsc-sub" },

package/lib/core/intro-store.js

@@ -33,6 +33,8 @@ function sanitizeEntry(entry) {
     inputBytes: Number.isFinite(entry.inputBytes) ? entry.inputBytes : null,
     truncated: Boolean(entry.truncated),
     sourceBytes: Number.isFinite(entry.sourceBytes) ? entry.sourceBytes : null,
+    maxTokens: Number.isFinite(entry.maxTokens) ? entry.maxTokens : null,
+    finish: typeof entry.finish === 'string' ? entry.finish : 'stop',
   };
 }
 
@@ -125,10 +127,11 @@ export function createIntroStore({ paths, logger = () => {} }) {
       return problem;
     },
     load,
-    /** 读一条缓存；没有就是 null。返回浅拷贝，调用方改不坏内存表。 */
+    /** 读一条缓存；没有就是 null。只有 `finish: stop` 的完整简介才会被返回。 */
     get(name, lang) {
       const entry = load().items[name]?.[lang];
-      return entry ? { ...entry } : null;
+      if (!entry || entry.finish !== 'stop') return null;
+      return { ...entry };
     },
     /** 写一条缓存；写盘失败不影响返回值（介绍已经拿到了）。 */
     put(name, lang, entry) {

package/lib/core/intro.js

@@ -19,9 +19,10 @@ import { sha256 } from './hash.js';
 
 /**
  * 简介缓存的格式版本（与 state 的版本无关，坏了直接当空表）。
- * v3 = 简介必须写清触发方式 / 触发关键词；v2 的旧条目只讲能力，直接丢弃重建。
+ * v4 = 只缓存 `finish: stop` 的完整简介；v3 及更早的条目（含 300 token 上限下
+ * 产生的截断文本）全部丢弃重建。
  */
-export const INTRO_STORE_VERSION = 3;
+export const INTRO_STORE_VERSION = 4;
 
 /** 介绍语言：跟随界面语言，只支持这两档。 */
 export const INTRO_LANGS = Object.freeze(['zh', 'en']);
@@ -31,20 +32,30 @@ export const INTRO_LIMITS = Object.freeze({
   minInputBytes: 8 * 1024,
   maxInputBytes: 48 * 1024,
   minOutputTokens: 96,
-  maxOutputTokens: 1024,
+  maxOutputTokens: 8_192,
   minTimeoutMs: 5_000,
   maxTimeoutMs: 60_000,
   /** 单条简介的字符上限（提示词要 160 字并含触发句，留出余量后兜底） */
   maxIntroChars: 400,
 });
 
+/**
+ * 输出预算的保底值：`maxOutputTokens` 是「防跑飞上限」，不是长度目标。
+ * 推理模型的思考 token 与正文共用同一份输出预算，300 这种小上限会被思考吃光；
+ * 因此推理模型至少 4096，普通模型至少 1024（400 字符中文也可能超过 300 token）。
+ */
+export const INTRO_OUTPUT_FLOOR = Object.freeze({
+  plain: 1_024,
+  reasoning: 4_096,
+});
+
 export const DEFAULT_INTRO_CONFIG = Object.freeze({
   enabled: true,
   provider: null,
   model: null,
   maxInputBytes: 24 * 1024,
-  maxOutputTokens: 300,
-  timeoutMs: 30_000,
+  maxOutputTokens: 4_096,
+  timeoutMs: 60_000,
 });
 
 /** 调用/准备阶段的失败，由 Service 转成带 HTTP 状态的错误。 */
@@ -326,7 +337,7 @@ function failureFrom(error) {
  * @param {{system: string, input: string}} options.prompt
  * @param {number} options.maxOutputTokens
  * @param {AbortSignal} [options.signal]
- * @returns {Promise<{ text: string, usage: object|null, provider: string, model: string }>}
+ * @returns {Promise<{ text: string, usage: object|null, provider: string, model: string, maxTokens: number, reasoningEffort: string|null, finish: string }>}
  */
 export async function runIntroCall({ llm, route, prompt, maxOutputTokens, signal }) {
   if (!llm || (typeof llm.prepareCall !== 'function' && typeof llm.stream !== 'function')) {
@@ -345,16 +356,29 @@ export async function runIntroCall({ llm, route, prompt, maxOutputTokens, signal
     },
   ];
 
+  // 输出上限是「防跑飞预算」，不是长度目标：推理 token 也计入这里。
+  // 推理模型至少 4096，普通模型至少 1024，避免思考吃光预算后正文为空。
+  const requestedMaxTokens = Math.max(
+    Number.isFinite(maxOutputTokens) ? maxOutputTokens : DEFAULT_INTRO_CONFIG.maxOutputTokens,
+    INTRO_OUTPUT_FLOOR.plain,
+  );
+
   let call = null;
   try {
     if (typeof llm.prepareCall === 'function') {
       call = await llm.prepareCall(
-        { provider: route.provider, model: route.model, maxTokens: maxOutputTokens },
+        { provider: route.provider, model: route.model, maxTokens: requestedMaxTokens },
         signal,
         (controls, model) => {
+          const floor = model?.reasoning ? INTRO_OUTPUT_FLOOR.reasoning : INTRO_OUTPUT_FLOOR.plain;
+          const modelCap = Number.isFinite(model?.defaultMaxTokens) ? model.defaultMaxTokens : Infinity;
           // 介绍不需要长思考：取适配器公布的最低推理强度，压低首字延迟与成本。
           const lowest = model?.reasoning?.efforts?.[0]?.id;
-          return lowest ? { ...controls, reasoningEffort: lowest } : controls;
+          return {
+            ...controls,
+            maxTokens: Math.max(controls.maxTokens ?? 0, Math.min(floor, modelCap)),
+            ...(lowest ? { reasoningEffort: lowest } : {}),
+          };
         },
       );
     }
@@ -362,42 +386,96 @@ export async function runIntroCall({ llm, route, prompt, maxOutputTokens, signal
     throw failureFrom(error);
   }
 
+  const fallbackMaxTokens = Math.max(requestedMaxTokens, INTRO_OUTPUT_FLOOR.reasoning);
   const options = call
     ? { ...call.config, messages, system: prompt.system, signal }
     : {
         provider: route.provider,
         model: route.model,
-        maxTokens: maxOutputTokens,
+        maxTokens: fallbackMaxTokens,
         messages,
         system: prompt.system,
         signal,
       };
 
-  let text = '';
+  let deltaText = '';
+  let sawTextDelta = false;
+  const textBlocks = new Map();
+  let reasoningChars = 0;
   let usage = null;
   let finish = null;
   try {
     const stream = call ? call.stream(options) : llm.stream(options);
     for await (const chunk of stream) {
       if (!chunk || typeof chunk !== 'object') continue;
-      if (chunk.type === 'text-delta') text += typeof chunk.text === 'string' ? chunk.text : '';
-      else if (chunk.type === 'usage') usage = chunk.usage || null;
-      else if (chunk.type === 'finish') finish = chunk.reason || null;
+      if (chunk.type === 'text-delta') {
+        sawTextDelta = true;
+        if (typeof chunk.text === 'string') deltaText += chunk.text;
+      } else if (chunk.type === 'reasoning-delta') {
+        if (typeof chunk.text === 'string') reasoningChars += chunk.text.length;
+      } else if (chunk.type === 'block-end') {
+        const block = chunk.block;
+        if (block?.type === 'text' && typeof block.text === 'string') {
+          textBlocks.set(chunk.index, block.text);
+        } else if (block?.type === 'reasoning' && typeof block.text === 'string') {
+          reasoningChars = Math.max(reasoningChars, block.text.length);
+        }
+      } else if (chunk.type === 'usage') {
+        usage = chunk.usage || null;
+      } else if (chunk.type === 'finish') {
+        finish = chunk.reason || null;
+      }
     }
   } catch (error) {
     throw failureFrom(error);
   }
 
-  if (finish && finish.kind !== 'stop' && finish.kind !== 'max-tokens') {
-    throw failureFrom({ failure: finish.failure || null, code: finish.kind === 'aborted' ? 'ABORTED' : null });
+  const effectiveMaxTokens = Number.isFinite(options.maxTokens) ? options.maxTokens : requestedMaxTokens;
+  const kind = finish?.kind || 'stop';
+
+  if (kind === 'aborted') {
+    throw failureFrom({ failure: finish?.failure || null, code: 'ABORTED' });
+  }
+  if (kind === 'error') {
+    throw failureFrom({ failure: finish?.failure || null, code: null });
+  }
+  if (kind === 'max-tokens') {
+    throw new IntroError(
+      'error.skills.intro-truncated',
+      '简介达到输出上限被截断，请重试或调大 intro.maxOutputTokens',
+      { finish: kind, maxTokens: effectiveMaxTokens, usage },
+      502,
+    );
+  }
+  if (kind === 'tool-calls') {
+    throw new IntroError(
+      'error.skills.intro-no-text',
+      '模型没有输出文字简介（尝试调用工具），请重试',
+      { finish: kind, maxTokens: effectiveMaxTokens, usage },
+      502,
+    );
+  }
+  if (kind !== 'stop') {
+    throw failureFrom({ failure: finish?.failure || null, code: null });
   }
 
+  // 块式适配器可能不给 text-delta，回退用 block-end 里的 text block。
+  const text = sawTextDelta ? deltaText : [...textBlocks.values()].join('');
   const cleaned = cleanIntroText(text);
   if (!cleaned) {
+    const produced = reasoningChars > 0 || Number(usage?.outputTokens) > 0;
+    if (produced) {
+      throw new IntroError(
+        'error.skills.intro-reasoning-only',
+        '模型只输出了思考过程、没有输出简介正文，请提高输出上限或换一个非推理模型',
+        { finish: kind, maxTokens: effectiveMaxTokens, usage, reasoningChars },
+        502,
+      );
+    }
     throw new IntroError(
       'error.skills.intro-empty',
-      '模型没有返回内容，请重试或换一个模型',
-      { finish: finish?.kind || null },
+      '模型没有返回内容，请重试',
+      { finish: kind, maxTokens: effectiveMaxTokens, usage },
       502,
     );
   }
@@ -407,6 +485,9 @@ export async function runIntroCall({ llm, route, prompt, maxOutputTokens, signal
     usage,
     provider: route.provider,
     model: route.model,
+    maxTokens: effectiveMaxTokens,
+    reasoningEffort: options.reasoningEffort || null,
+    finish: kind,
   };
 }
 
@@ -416,7 +497,18 @@ export function introKey(name, lang) {
 }
 
 /** 汇总一次生成的元信息（缓存条目与响应共用）。 */
-export function introEntry({ text, hash, provider, model, usage, inputBytes, truncated, sourceBytes }) {
+export function introEntry({
+  text,
+  hash,
+  provider,
+  model,
+  usage,
+  inputBytes,
+  truncated,
+  sourceBytes,
+  maxTokens = null,
+  finish = 'stop',
+}) {
   return {
     hash,
     text,
@@ -427,6 +519,8 @@ export function introEntry({ text, hash, provider, model, usage, inputBytes, tru
     inputBytes,
     truncated: Boolean(truncated),
     sourceBytes: sourceBytes ?? inputBytes,
+    maxTokens: Number.isFinite(maxTokens) ? maxTokens : null,
+    finish,
   };
 }
 

package/lib/core/plugin-update.js

@@ -13,9 +13,10 @@
  * 设计取舍（对齐本机同类插件 archive-manager / ds-bot 的轻量做法，但更保守）：
  * - 依次问 registry 计划里的 `<base><pkg>/latest`，8s 超时，只取 `version` 字段；失败不抛，返回 null。
  * - 版本比较手写（本仓 runtime 依赖只有 tar，不引入 semver）；结构非法一律判「不更新」。
- * - 安装只走宿主 `pluginManager.installBundle`（桌面端官方能力）；拿不到就抛
- *   `error.plugin-update.manual`，把手动命令放进 detail 让前端展示/复制。
- * - 不落盘、不加锁：一次点击只触发一次，`applying` 由路由层单飞守住；重启由用户决定。
+ * - 安装只走宿主 `pluginManager.installBundle`（桌面端官方能力）；HMR 下已安装的包会被以
+ *   `already-installed` 拒绝，此时按官方更新路径先 `removeBundle` 再 `installBundle`；拿不到
+ *   这些能力就抛 `error.plugin-update.manual`，把手动命令放进 detail 让前端展示/复制。
+ * - 不落盘、不加锁：本模块用 `applying` 单飞（进入 `apply()` 立即置位，覆盖查询 + 安装全程）；重启由用户决定。
  */
 import { readFileSync } from 'node:fs';
 
@@ -101,6 +102,26 @@ function manualCommand(meta, profileName) {
     : `dsh plugin add ${spec}`;
 }
 
+/**
+ * 宿主 `installBundle` / `removeBundle` 的结果两种形态都要接：
+ * 本地服务直接返回 `{ application, error? }`；远程代理可能再包一层 `{ ok, value | error }`。
+ */
+function unwrapResult(result) {
+  if (
+    result && typeof result === 'object'
+    && typeof result.ok === 'boolean'
+    && !('application' in result)
+    && ('value' in result || 'error' in result)
+  ) {
+    return result.ok ? result.value : { application: 'failed', error: result.error ?? { code: 'operation-error' } };
+  }
+  return result;
+}
+
+function failureMessage(result) {
+  return result?.error?.diagnostic || result?.error?.message || result?.error?.code || '更新失败';
+}
+
 /** registry 归一成 `https://host/` 形式；非法返回 null。 */
 function normalizeRegistry(value) {
   if (typeof value !== 'string' || value.trim() === '') return null;
@@ -241,33 +262,45 @@ export function createPluginUpdate({ getPluginManager, getProfileName, fetchImpl
     if (applying) {
       throw new ServiceError('error.plugin-update.busy', '插件正在更新，请稍候', null, 409);
     }
-    const latest = await latestVersion();
-    if (latest === null) {
-      throw new ServiceError('error.plugin-update.check-failed', '暂时无法获取最新版本，请稍后再试', manualCommand(meta, profileName()), 503);
-    }
-    if (!isNewerVersion(meta.version, latest)) {
-      return { ...view({ latest }), updatedVersion: null };
-    }
-    const pm = manager();
-    if (pm === null) {
-      throw new ServiceError(
-        'error.plugin-update.manual',
-        '当前环境不支持自动更新，请手动执行命令',
-        manualCommand(meta, profileName()),
-        409,
-      );
-    }
+    // 进入即置位：先查最新版也有 await，若等查到再置位，两次并发点击会都通过守卫、装两遍
     applying = true;
     try {
+      const latest = await latestVersion();
+      if (latest === null) {
+        throw new ServiceError('error.plugin-update.check-failed', '暂时无法获取最新版本，请稍后再试', manualCommand(meta, profileName()), 503);
+      }
+      if (!isNewerVersion(meta.version, latest)) {
+        return { ...view({ latest }), updatedVersion: null, applying: false };
+      }
+      const pm = manager();
+      if (pm === null) {
+        throw new ServiceError(
+          'error.plugin-update.manual',
+          '当前环境不支持自动更新，请手动执行命令',
+          manualCommand(meta, profileName()),
+          409,
+        );
+      }
       // 用查到最新版的那个 registry 去装，和「问」保持一致；没有就用宿主默认（不传 options）
       const registry = cache?.version === latest ? cache.registry : undefined;
-      const result = await pm.installBundle(
-        `${meta.name}@${latest}`,
-        registry ? { registry } : undefined,
-      );
+      const spec = `${meta.name}@${latest}`;
+      const installOptions = registry ? { registry } : undefined;
+      let result = unwrapResult(await pm.installBundle(spec, installOptions));
+      // HMR 开启时，installBundle 对已安装的包名会在跑 pnpm 前直接拒绝 already-installed；
+      // 官方页面的「更新」就是先 removeBundle 再 installBundle，这里照同一路径做显式更新。
+      if (result?.error?.code === 'already-installed' && typeof pm.removeBundle === 'function') {
+        const removed = unwrapResult(await pm.removeBundle(meta.name));
+        if (removed?.error || removed?.application === 'failed') {
+          const code = removed?.error?.code;
+          const message = code === 'stop-profile'
+            ? '插件正在运行且当前 profile 未启用 HMR，请完全退出 DSH 后手动更新'
+            : failureMessage(removed);
+          throw new ServiceError('error.plugin-update.install-failed', String(message).slice(0, 600), manualCommand(meta, profileName()), 500);
+        }
+        result = unwrapResult(await pm.installBundle(spec, installOptions));
+      }
       if (result?.error || !['applied', 'restart-required', 'overridden'].includes(result?.application)) {
-        const message = result?.error?.diagnostic || result?.error?.message || result?.error?.code || '更新失败';
-        throw new ServiceError('error.plugin-update.install-failed', String(message).slice(0, 600), manualCommand(meta, profileName()), 500);
+        throw new ServiceError('error.plugin-update.install-failed', String(failureMessage(result)).slice(0, 600), manualCommand(meta, profileName()), 500);
       }
       cache = { version: latest, expiresAt: now() + CACHE_TTL_MS, registry };
       return {
@@ -275,6 +308,7 @@ export function createPluginUpdate({ getPluginManager, getProfileName, fetchImpl
         updateAvailable: false,
         updatedVersion: latest,
         restartRequired: true,
+        applying: false,
       };
     } finally {
       applying = false;

package/lib/core/service.js

@@ -1514,6 +1514,8 @@ export function createService({
             inputBytes: prompt.inputBytes,
             truncated: prompt.truncated,
             sourceBytes: prompt.sourceBytes,
+            maxTokens: result.maxTokens,
+            finish: result.finish,
           });
           introStore.put(name, language, entry);
           logger('intro.generate', {
@@ -1521,6 +1523,9 @@ export function createService({
             lang: language,
             provider: result.provider,
             model: result.model,
+            effort: result.reasoningEffort || null,
+            maxTokens: result.maxTokens ?? null,
+            finish: result.finish || null,
             inputBytes: prompt.inputBytes,
             truncated: prompt.truncated,
             durationMs: Date.now() - startedAt,
@@ -1536,7 +1541,12 @@ export function createService({
           };
         } catch (error) {
           if (!(error instanceof ServiceError)) {
-            logger('intro.generate.failed', { name, message: error?.message, code: error?.code });
+            logger('intro.generate.failed', {
+              name,
+              message: error?.message,
+              code: error?.code,
+              detail: error?.detail || null,
+            });
           }
           throw error;
         }
@@ -1648,6 +1658,8 @@ export function createService({
               inputBytes: prompt.inputBytes,
               truncated: prompt.truncated,
               sourceBytes: prompt.sourceBytes,
+              maxTokens: result.maxTokens,
+              finish: result.finish,
             });
             introStore.put(target.cacheKey, language, entry);
             logger('intro.generate.remote', {
@@ -1657,6 +1669,9 @@ export function createService({
               commit: target.commit,
               provider: result.provider,
               model: result.model,
+              effort: result.reasoningEffort || null,
+              maxTokens: result.maxTokens ?? null,
+              finish: result.finish || null,
               inputBytes: prompt.inputBytes,
               truncated: prompt.truncated,
               durationMs: Date.now() - startedAt,
@@ -1681,6 +1696,7 @@ export function createService({
                 name,
                 message: error?.message,
                 code: error?.code,
+                detail: error?.detail || null,
               });
             }
             throw error;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morehao/dsh-skills-console",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "description": "统一管理本地技能的安装、更新、删除与接入，让同一份技能在多个 Agent 间复用。A skill manager for DeepSeek Harness: install, update, remove, link and toggle agent skills.",
   "license": "MIT",
   "author": "morehao <morehao@qq.com>",