@morehao/dsh-skills-console 0.5.5 → 0.5.6

package/README.en.md

@@ -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

@@ -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") {

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