@morehao/dsh-skills-console 0.3.7 → 0.3.8

package/client.js

@@ -848,7 +848,26 @@ function FolderIcon({ size = 12 }) {
 }
 
 // client/section.js
-var import_react5 = __toESM(require("react"), 1);
+var import_react6 = __toESM(require("react"), 1);
+
+// client/scroll.js
+function isScroller(node, tolerance = 4) {
+  if (!node || typeof getComputedStyle !== "function") return false;
+  const style = getComputedStyle(node);
+  return Boolean(style && /(auto|scroll)/.test(style.overflowY || "") && node.scrollHeight > node.clientHeight + tolerance);
+}
+function nearestScroller(node, tolerance = 4) {
+  let current = node?.parentElement || null;
+  while (current) {
+    if (isScroller(current, tolerance)) return current;
+    current = current.parentElement || null;
+  }
+  return typeof document !== "undefined" ? document.scrollingElement || null : null;
+}
+function scrollHost(node, tolerance = 4) {
+  if (isScroller(node, tolerance)) return node;
+  return node && nearestScroller(node, tolerance) || node;
+}
 
 // client/styles.js
 var CSS = `
@@ -1267,8 +1286,9 @@ var CSS = `
     color: var(--dsw-alias-label-secondary); line-height: 1.6; }
   .dshsc-reader-placeholder b { color: var(--dsw-alias-label-primary); font-size: 13px; }
 
-  /* 文件 tab：左树右预览；抽屉里上下排 */
-  .dshsc-reader-files { display: grid; grid-template-columns: minmax(0, 1fr); gap: 12px; }
+  /* 文件 tab：抽屉里上下排；整页（宽容器）左树右预览 */
+  .dshsc-reader-files { display: grid; grid-template-columns: minmax(0, 1fr); gap: 12px; align-items: start; }
+  .dshsc-reader-page .dshsc-reader-files { grid-template-columns: minmax(200px, 240px) minmax(0, 1fr); }
   .dshsc-reader-tree { border: 1px solid var(--dsw-alias-border-l1); border-radius: 10px; overflow: auto;
     max-height: 300px; background: var(--dsw-alias-bg-layer-1); }
   .dshsc-reader-preview { border: 1px solid var(--dsw-alias-border-l1); border-radius: 10px; overflow: hidden;
@@ -1386,8 +1406,11 @@ var CSS = `
     background: var(--dsw-alias-bg-layer-1); }
   .dshsc-reader-hero .dshsc-reader-head { border-bottom: 0; }
   .dshsc-reader-hero .dshsc-reader-desc { -webkit-line-clamp: 3; max-width: 78ch; }
-  .dshsc-reader-layout { flex: 1; min-height: 0; display: grid; grid-template-columns: 180px minmax(0, 1fr);
+  .dshsc-reader-layout { flex: 1; min-height: 0; display: grid; grid-template-columns: minmax(0, 1fr);
     gap: 18px; align-items: stretch; }
+  /* 只有目录真的在的时候才开第二轨：否则唯一的正文列会被自动摆进 180px 的目录轨，
+     文件 / 信息 tab 会窄成一条（树里的文件名被截断、预览挤到下面）。 */
+  .dshsc-reader-layout.has-toc { grid-template-columns: 180px minmax(0, 1fr); }
   .dshsc-reader-toc { position: sticky; top: 0; display: flex; flex-direction: column; gap: 1px;
     max-height: 70vh; overflow: auto; padding-right: 4px; }
   .dshsc-reader-toc-title { font-size: 10.5px; letter-spacing: .05em; text-transform: uppercase;
@@ -1413,11 +1436,20 @@ var CSS = `
   @container dshsc (max-width: 860px) {
     /* 行内「查看」先让位：技能名本身仍是入口 */
     .dshsc-row .dshsc-view { display: none; }
-    .dshsc-reader-layout { grid-template-columns: minmax(0, 1fr); }
+    .dshsc-reader-layout.has-toc { grid-template-columns: minmax(0, 1fr); }
+    .dshsc-reader-page .dshsc-reader-files { grid-template-columns: minmax(0, 1fr); }
     .dshsc-reader-toc { display: none; }
     .dshsc-reader-page .dshsc-reader-desc { -webkit-line-clamp: 2; }
   }
 
+  /* 描述默认按行数截断；真被截断时下面给「展开 / 收起」，所以要压在上面所有 clamp 规则之后 */
+  .dshsc-reader-descblock { display: flex; flex-direction: column; align-items: flex-start; }
+  .dshsc-reader-desc.expanded { display: block; overflow: visible; -webkit-line-clamp: unset; }
+  .dshsc-reader-more { margin-top: 3px; padding: 0; border: 0; border-radius: 4px; background: transparent;
+    color: var(--dsw-alias-brand-primary); font: inherit; font-size: 11.5px; line-height: 1.6; cursor: pointer; }
+  .dshsc-reader-more:hover { text-decoration: underline; }
+  .dshsc-reader-more:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: 2px; }
+
   .dshsc-toast { position: fixed; right: 18px; bottom: 18px; z-index: 70; font-size: 12px; padding: 10px 13px; border-radius: 9px;
     background: var(--dsw-alias-bg-layer-3); color: var(--dsw-alias-label-primary); border: 1px solid var(--dsw-alias-border-l2);
     box-shadow: 0 8px 24px rgba(0,0,0,.22); max-width: 420px; }
@@ -2447,7 +2479,12 @@ function SubscriptionsTab({
 }
 
 // client/views/modals.js
+var import_react4 = __toESM(require("react"), 1);
+
+// client/views/add-skill.js
 var import_react3 = __toESM(require("react"), 1);
+
+// client/views/overlay.js
 function Overlay({ t, title, children, footer, onCancel }) {
   useOverlayLayer(true, onCancel);
   return portalize(h(
@@ -2472,8 +2509,152 @@ function Overlay({ t, title, children, footer, onCancel }) {
     )
   ), overlayHost());
 }
+
+// client/views/add-skill.js
+function AddSkillModal({ t, onCancel, onProbe, onInstall }) {
+  const [source, setSource] = import_react3.default.useState("");
+  const [phase, setPhase] = import_react3.default.useState("idle");
+  const [options, setOptions] = import_react3.default.useState([]);
+  const [selected, setSelected] = import_react3.default.useState(() => /* @__PURE__ */ new Set());
+  const [manual, setManual] = import_react3.default.useState("");
+  const [skipped, setSkipped] = import_react3.default.useState(0);
+  const [error, setError] = import_react3.default.useState(null);
+  const reset = (value) => {
+    setSource(value);
+    setPhase("idle");
+    setOptions([]);
+    setSelected(/* @__PURE__ */ new Set());
+    setSkipped(0);
+    setError(null);
+  };
+  const probe = async () => {
+    const value = source.trim();
+    if (!value || phase === "probing") return;
+    setPhase("probing");
+    setError(null);
+    try {
+      const result = await onProbe(value);
+      const found = Array.isArray(result?.skills) ? result.skills : [];
+      setOptions(found);
+      setSelected(new Set(found.map((item) => item.name)));
+      setSkipped(Math.max(0, Number(result?.skipped) || 0));
+      setPhase(found.length > 0 ? "picked" : "empty");
+    } catch (err) {
+      setError(err?.message || String(err));
+      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 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 });
+  };
+  return h(
+    Overlay,
+    {
+      t,
+      title: t("action.addSkill"),
+      onCancel,
+      footer: [
+        h("button", { key: "c", className: "dshsc-btn ghost", onClick: onCancel }, t("action.cancel")),
+        h("button", {
+          key: "s",
+          className: "dshsc-btn primary",
+          disabled: !canSubmit,
+          onClick: submit
+        }, t("action.save"))
+      ]
+    },
+    h("p", { className: "dshsc-sub" }, t("form.pickHint")),
+    h(
+      "div",
+      { className: "dshsc-field" },
+      h("span", null, t("form.source")),
+      h(
+        "div",
+        { className: "dshsc-inline" },
+        h("input", {
+          value: source,
+          placeholder: t("form.sourceHint"),
+          onChange: (event) => reset(event.target.value),
+          onKeyDown: (event) => {
+            if (event.key === "Enter") void probe();
+          }
+        }),
+        h("button", {
+          className: "dshsc-btn",
+          disabled: !source.trim() || phase === "probing",
+          onClick: () => void probe()
+        }, phase === "probing" ? t("form.probing") : t("form.probe"))
+      )
+    ),
+    phase === "picked" ? h(
+      "div",
+      { key: "picked" },
+      h("div", { className: "dshsc-group" }, t("form.detected").replace("{n}", String(options.length))),
+      h(
+        "div",
+        { style: { display: "flex", gap: 6, marginBottom: 6 } },
+        h("button", {
+          className: "dshsc-btn ghost",
+          onClick: () => setSelected(new Set(options.map((item) => item.name)))
+        }, t("form.selectAll")),
+        h("button", {
+          className: "dshsc-btn ghost",
+          onClick: () => setSelected(/* @__PURE__ */ new Set())
+        }, t("form.selectNone"))
+      ),
+      h("div", { className: "dshsc-panel" }, options.map((option) => h(
+        "label",
+        { className: "dshsc-check dshsc-skill", key: option.name },
+        h("input", {
+          type: "checkbox",
+          checked: selected.has(option.name),
+          onChange: () => toggle(option.name)
+        }),
+        h(
+          "span",
+          { className: "dshsc-skill-main" },
+          h("span", { className: "dshsc-skill-name" }, option.name),
+          option.description ? h("small", { className: "dshsc-skill-desc" }, option.description) : null,
+          h("small", { className: "dshsc-skill-path" }, option.skillPath)
+        )
+      ))),
+      skippedText ? h("p", { className: "dshsc-sub" }, skippedText) : null
+    ) : null,
+    phase === "probing" ? h("p", { className: "dshsc-sub" }, t("form.probingHint")) : null,
+    manualMode ? h(
+      "div",
+      { key: "manual" },
+      h("p", { className: "dshsc-sub" }, phase === "empty" ? skippedText || t("form.noSkills") : `${t("form.probeFailed")}${error ? ` · ${error}` : ""}`),
+      h(
+        "label",
+        { className: "dshsc-field" },
+        h("span", null, t("form.skills")),
+        h("input", {
+          value: manual,
+          placeholder: "git-kit, handoff",
+          onChange: (event) => setManual(event.target.value)
+        })
+      )
+    ) : null,
+    h("p", { className: "dshsc-sub" }, t("form.hint"))
+  );
+}
+
+// client/views/modals.js
 function FormModal({ t, title, hint, fields, onCancel, onSubmit }) {
-  const [form, setForm] = import_react3.default.useState(() => Object.fromEntries(fields.map((field) => [field.key, ""])));
+  const [form, setForm] = import_react4.default.useState(() => Object.fromEntries(fields.map((field) => [field.key, ""])));
   const incomplete = fields.some(
     (field) => field.required !== false && !String(form[field.key] || "").trim()
   );
@@ -2521,14 +2702,14 @@ function LinksModal({ t, row, agents, workspaces, pickDirectory, onCancel, onSav
   const candidates = agents.filter(
     (agent) => agent.kind === "dsh" || agent.kind !== "project" && agent.exists
   );
-  const [targets, setTargets] = import_react3.default.useState(() => {
+  const [targets, setTargets] = import_react4.default.useState(() => {
     const visible = new Set(candidates.map((agent) => agent.target));
     const initial = new Set(row.links.map((link) => link.target).filter((target) => visible.has(target)));
     initial.add("dsh-global");
     return initial;
   });
-  const [scopeProjects, setScopeProjects] = import_react3.default.useState(row.scopeProjects || []);
-  const [scopeMode, setScopeMode] = import_react3.default.useState((row.scopeProjects || []).length > 0 ? "projects" : "global");
+  const [scopeProjects, setScopeProjects] = import_react4.default.useState(row.scopeProjects || []);
+  const [scopeMode, setScopeMode] = import_react4.default.useState((row.scopeProjects || []).length > 0 ? "projects" : "global");
   const workspacePaths = new Set(workspaces.map((workspace) => workspace.path));
   const otherProjects = scopeProjects.filter((project) => !workspacePaths.has(project));
   const toggle = (target) => setTargets((prev) => {
@@ -2622,7 +2803,7 @@ function LinksModal({ t, row, agents, workspaces, pickDirectory, onCancel, onSav
   );
 }
 function AutoLinkModal({ t, settings, agents, dsh, onCancel, onSave }) {
-  const [targets, setTargets] = import_react3.default.useState(() => new Set(
+  const [targets, setTargets] = import_react4.default.useState(() => new Set(
     Array.isArray(settings.autoLinkTargets) ? settings.autoLinkTargets : agents.map((agent) => agent.target)
   ));
   const toggle = (target) => setTargets((prev) => {
@@ -2678,146 +2859,6 @@ function AutoLinkModal({ t, settings, agents, dsh, onCancel, onSave }) {
     h("p", { className: "dshsc-sub" }, t("autoLink.hint"))
   );
 }
-function AddSkillModal({ t, onCancel, onProbe, onInstall }) {
-  const [source, setSource] = import_react3.default.useState("");
-  const [phase, setPhase] = import_react3.default.useState("idle");
-  const [options, setOptions] = import_react3.default.useState([]);
-  const [selected, setSelected] = import_react3.default.useState(() => /* @__PURE__ */ new Set());
-  const [manual, setManual] = import_react3.default.useState("");
-  const [skipped, setSkipped] = import_react3.default.useState(0);
-  const [error, setError] = import_react3.default.useState(null);
-  const reset = (value) => {
-    setSource(value);
-    setPhase("idle");
-    setOptions([]);
-    setSelected(/* @__PURE__ */ new Set());
-    setSkipped(0);
-    setError(null);
-  };
-  const probe = async () => {
-    const value = source.trim();
-    if (!value || phase === "probing") return;
-    setPhase("probing");
-    setError(null);
-    try {
-      const result = await onProbe(value);
-      const found = Array.isArray(result?.skills) ? result.skills : [];
-      setOptions(found);
-      setSelected(new Set(found.map((item) => item.name)));
-      setSkipped(Math.max(0, Number(result?.skipped) || 0));
-      setPhase(found.length > 0 ? "picked" : "empty");
-    } catch (err) {
-      setError(err?.message || String(err));
-      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 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 });
-  };
-  return h(
-    Overlay,
-    {
-      t,
-      title: t("action.addSkill"),
-      onCancel,
-      footer: [
-        h("button", { key: "c", className: "dshsc-btn ghost", onClick: onCancel }, t("action.cancel")),
-        h("button", {
-          key: "s",
-          className: "dshsc-btn primary",
-          disabled: !canSubmit,
-          onClick: submit
-        }, t("action.save"))
-      ]
-    },
-    h("p", { className: "dshsc-sub" }, t("form.pickHint")),
-    h(
-      "div",
-      { className: "dshsc-field" },
-      h("span", null, t("form.source")),
-      h(
-        "div",
-        { className: "dshsc-inline" },
-        h("input", {
-          value: source,
-          placeholder: t("form.sourceHint"),
-          onChange: (event) => reset(event.target.value),
-          onKeyDown: (event) => {
-            if (event.key === "Enter") void probe();
-          }
-        }),
-        h("button", {
-          className: "dshsc-btn",
-          disabled: !source.trim() || phase === "probing",
-          onClick: () => void probe()
-        }, phase === "probing" ? t("form.probing") : t("form.probe"))
-      )
-    ),
-    phase === "picked" ? h(
-      "div",
-      { key: "picked" },
-      h("div", { className: "dshsc-group" }, t("form.detected").replace("{n}", String(options.length))),
-      h(
-        "div",
-        { style: { display: "flex", gap: 6, marginBottom: 6 } },
-        h("button", {
-          className: "dshsc-btn ghost",
-          onClick: () => setSelected(new Set(options.map((item) => item.name)))
-        }, t("form.selectAll")),
-        h("button", {
-          className: "dshsc-btn ghost",
-          onClick: () => setSelected(/* @__PURE__ */ new Set())
-        }, t("form.selectNone"))
-      ),
-      h("div", { className: "dshsc-panel" }, options.map((option) => h(
-        "label",
-        { className: "dshsc-check dshsc-skill", key: option.name },
-        h("input", {
-          type: "checkbox",
-          checked: selected.has(option.name),
-          onChange: () => toggle(option.name)
-        }),
-        h(
-          "span",
-          { className: "dshsc-skill-main" },
-          h("span", { className: "dshsc-skill-name" }, option.name),
-          option.description ? h("small", { className: "dshsc-skill-desc" }, option.description) : null,
-          h("small", { className: "dshsc-skill-path" }, option.skillPath)
-        )
-      ))),
-      skippedText ? h("p", { className: "dshsc-sub" }, skippedText) : null
-    ) : null,
-    phase === "probing" ? h("p", { className: "dshsc-sub" }, t("form.probingHint")) : null,
-    manualMode ? h(
-      "div",
-      { key: "manual" },
-      h("p", { className: "dshsc-sub" }, phase === "empty" ? skippedText || t("form.noSkills") : `${t("form.probeFailed")}${error ? ` · ${error}` : ""}`),
-      h(
-        "label",
-        { className: "dshsc-field" },
-        h("span", null, t("form.skills")),
-        h("input", {
-          value: manual,
-          placeholder: "git-kit, handoff",
-          onChange: (event) => setManual(event.target.value)
-        })
-      )
-    ) : null,
-    h("p", { className: "dshsc-sub" }, t("form.hint"))
-  );
-}
 function Modals({ t, modal, data, autoLinkAgents, autoLinkDsh, pickDirectory, actions, onClose, onSaveAutoLink }) {
   if (modal.type === "add-skill") {
     return h(AddSkillModal, {
@@ -2900,7 +2941,7 @@ ${conflicts.map((item) => `${item.label}: ${item.linkPath}`).join("\n")}`,
 }
 
 // client/views/skill-reader.js
-var import_react4 = __toESM(require("react"), 1);
+var import_react5 = __toESM(require("react"), 1);
 
 // client/markdown.js
 function classifyHref(href) {
@@ -3183,7 +3224,7 @@ function resolveRelativeHref(currentDir, href) {
   return { relPath: out.join("/"), anchor: target.kind === "anchor" ? target.href : "" };
 }
 
-// client/views/skill-reader.js
+// client/views/markdown-view.js
 var PARSE_CACHE = /* @__PURE__ */ new Map();
 function parseCached(text) {
   const key = String(text ?? "");
@@ -3196,49 +3237,6 @@ function parseCached(text) {
   }
   return parsed;
 }
-function formatBytes(bytes) {
-  const value = Number(bytes) || 0;
-  if (value < 1024) return `${value} B`;
-  if (value < 1024 * 1024) return `${(value / 1024).toFixed(value < 10 * 1024 ? 1 : 0)} KB`;
-  return `${(value / (1024 * 1024)).toFixed(1)} MB`;
-}
-function formatWhen(iso) {
-  if (!iso) return null;
-  const date = new Date(iso);
-  if (Number.isNaN(date.getTime())) return null;
-  const pad = (value) => String(value).padStart(2, "0");
-  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
-}
-var MARKDOWN = /\.(md|markdown)$/i;
-function isMarkdownPath(relPath) {
-  return MARKDOWN.test(String(relPath || ""));
-}
-function isScroller(node) {
-  if (!node || typeof getComputedStyle !== "function") return false;
-  const style = getComputedStyle(node);
-  return Boolean(style && /(auto|scroll)/.test(style.overflowY || "") && node.scrollHeight > node.clientHeight + 4);
-}
-function nearestScroller(node) {
-  let current = node?.parentElement || null;
-  while (current) {
-    if (isScroller(current)) return current;
-    current = current.parentElement || null;
-  }
-  return typeof document !== "undefined" ? document.scrollingElement || null : null;
-}
-function scrollHost(node) {
-  if (isScroller(node)) return node;
-  return node && nearestScroller(node) || node;
-}
-var STATUS_KEY = {
-  current: "status.current",
-  "update-available": "status.update",
-  "locally-modified": "status.local",
-  conflict: "status.conflict",
-  "upstream-deleted": "status.deleted",
-  "broken-link": "status.broken",
-  unmanaged: "status.unmanaged"
-};
 function inlineNodes(nodes, { onOpenFile, onOpenAnchor, keyPrefix = "i" }) {
   if (!Array.isArray(nodes)) return null;
   return nodes.map((node, index) => {
@@ -3371,6 +3369,34 @@ function Markdown({ text, onOpenFile, onOpenAnchor }) {
   const { blocks } = parseCached(text);
   return h("div", { className: "dshsc-md" }, blockNodes(blocks, { onOpenFile, onOpenAnchor }));
 }
+
+// client/views/skill-reader.js
+function formatBytes(bytes) {
+  const value = Number(bytes) || 0;
+  if (value < 1024) return `${value} B`;
+  if (value < 1024 * 1024) return `${(value / 1024).toFixed(value < 10 * 1024 ? 1 : 0)} KB`;
+  return `${(value / (1024 * 1024)).toFixed(1)} MB`;
+}
+function formatWhen(iso) {
+  if (!iso) return null;
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return null;
+  const pad = (value) => String(value).padStart(2, "0");
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+var MARKDOWN = /\.(md|markdown)$/i;
+function isMarkdownPath(relPath) {
+  return MARKDOWN.test(String(relPath || ""));
+}
+var STATUS_KEY = {
+  current: "status.current",
+  "update-available": "status.update",
+  "locally-modified": "status.local",
+  conflict: "status.conflict",
+  "upstream-deleted": "status.deleted",
+  "broken-link": "status.broken",
+  unmanaged: "status.unmanaged"
+};
 function TabButton({ id, label, count, active, onSelect }) {
   return h("button", {
     type: "button",
@@ -3411,14 +3437,17 @@ function SkillReader({
   onToast
 }) {
   const { state, file, loadFile, retry } = useSkillReader(row);
-  const [tab, setTab] = import_react4.default.useState(initialTab);
-  const [format, setFormat] = import_react4.default.useState("rendered");
-  const [docOverride, setDocOverride] = import_react4.default.useState(null);
-  const [fileFormat, setFileFormat] = import_react4.default.useState("rendered");
-  const [tocActive, setTocActive] = import_react4.default.useState(null);
-  const bodyRef = import_react4.default.useRef(null);
-  const dialogRef = import_react4.default.useRef(null);
-  const scrollRef = import_react4.default.useRef(0);
+  const [tab, setTab] = import_react5.default.useState(initialTab);
+  const [format, setFormat] = import_react5.default.useState("rendered");
+  const [docOverride, setDocOverride] = import_react5.default.useState(null);
+  const [fileFormat, setFileFormat] = import_react5.default.useState("rendered");
+  const [tocActive, setTocActive] = import_react5.default.useState(null);
+  const [descOpen, setDescOpen] = import_react5.default.useState(false);
+  const [descClamped, setDescClamped] = import_react5.default.useState(false);
+  const bodyRef = import_react5.default.useRef(null);
+  const dialogRef = import_react5.default.useRef(null);
+  const descRef = import_react5.default.useRef(null);
+  const scrollRef = import_react5.default.useRef(0);
   useOverlayLayer(variant === "drawer" || variant === "page", onClose);
   const name = row?.name || "";
   const tree = state.tree;
@@ -3427,20 +3456,49 @@ function SkillReader({
   const bodyText = docOverride ? docOverride.content : state.body?.content || "";
   const description = row?.description || state.body?.meta?.description || "";
   const headings = tab === "doc" && bodyText ? parseCached(bodyText).headings : [];
-  import_react4.default.useEffect(() => {
+  import_react5.default.useEffect(() => {
     setDocOverride(null);
     scrollRef.current = 0;
   }, [name]);
-  import_react4.default.useEffect(() => {
+  const descOwnerRef = import_react5.default.useRef(name);
+  import_react5.default.useEffect(() => {
+    if (descOwnerRef.current === name) return;
+    descOwnerRef.current = name;
+    setDescOpen(false);
+    setDescClamped(false);
+  }, [name]);
+  import_react5.default.useLayoutEffect(() => {
+    const node = descRef.current;
+    if (!node) return void 0;
+    const measure = () => {
+      if (descOpen) return;
+      const scroll = Number(node.scrollHeight) || 0;
+      const client = Number(node.clientHeight) || 0;
+      setDescClamped(scroll > client + 1);
+    };
+    measure();
+    if (typeof window === "undefined" || !window.addEventListener) return void 0;
+    window.addEventListener("resize", measure);
+    let observer = null;
+    if (typeof ResizeObserver === "function") {
+      observer = new ResizeObserver(measure);
+      observer.observe(node);
+    }
+    return () => {
+      observer?.disconnect?.();
+      window.removeEventListener("resize", measure);
+    };
+  }, [description, descOpen]);
+  import_react5.default.useEffect(() => {
     if (!initialFile) return;
     setTab("files");
     void loadFile(initialFile);
   }, [initialFile, loadFile]);
-  import_react4.default.useEffect(() => {
+  import_react5.default.useEffect(() => {
     const node = bodyRef.current;
     if (node && scrollRef.current) node.scrollTop = scrollRef.current;
   });
-  import_react4.default.useEffect(() => {
+  import_react5.default.useEffect(() => {
     if (variant !== "drawer" || typeof document === "undefined") return void 0;
     const previous = document.activeElement;
     const node = dialogRef.current;
@@ -3467,12 +3525,12 @@ function SkillReader({
       previous?.focus?.();
     };
   }, [variant, onClose]);
-  import_react4.default.useEffect(() => {
+  import_react5.default.useEffect(() => {
     if (variant !== "page" || typeof document === "undefined") return;
     const node = document.getElementById("dshsc-reader-name");
     node?.focus?.();
   }, [variant, name]);
-  import_react4.default.useEffect(() => {
+  import_react5.default.useEffect(() => {
     if (variant !== "page" || typeof window === "undefined") return void 0;
     const node = bodyRef.current;
     if (!node?.querySelectorAll) return void 0;
@@ -3542,7 +3600,22 @@ function SkillReader({
         onClick: () => onClose?.()
       }, "×") : null
     ),
-    description ? h("p", { className: "dshsc-reader-desc" }, description) : null,
+    description ? h(
+      "div",
+      { className: "dshsc-reader-descblock" },
+      h("p", {
+        className: `dshsc-reader-desc${descOpen ? " expanded" : ""}`,
+        id: "dshsc-reader-desc",
+        ref: descRef
+      }, description),
+      descClamped ? h("button", {
+        type: "button",
+        className: "dshsc-reader-more",
+        "aria-expanded": String(descOpen),
+        "aria-controls": "dshsc-reader-desc",
+        onClick: () => setDescOpen((prev) => !prev)
+      }, t(descOpen ? "action.collapse" : "action.expand")) : null
+    ) : null,
     h(
       "div",
       { className: "dshsc-reader-meta" },
@@ -3835,6 +3908,7 @@ function SkillReader({
     }, t("action.update")) : null
   );
   if (variant === "page") {
+    const tocShown = headings.length > 1;
     return h(
       "div",
       { className: "dshsc-reader-page" },
@@ -3860,8 +3934,8 @@ function SkillReader({
       h("div", { className: "dshsc-reader-hero" }, header),
       h(
         "div",
-        { className: "dshsc-reader-layout" },
-        headings.length > 1 ? h(
+        { className: `dshsc-reader-layout${tocShown ? " has-toc" : ""}` },
+        tocShown ? h(
           "nav",
           { className: "dshsc-reader-toc", "aria-label": t("viewer.toc") },
           h("div", { className: "dshsc-reader-toc-title" }, t("viewer.toc")),
@@ -3895,19 +3969,19 @@ function SkillReader({
 var UPDATABLE2 = /* @__PURE__ */ new Set(["update-available", "locally-modified", "conflict"]);
 function Section({ t, page = false, pickDirectory, onPlacementChange }) {
   const { data, error, busy, toast, setToast, setBusy, reload, run } = useSkillsData();
-  const [tab, setTab] = import_react5.default.useState("installed");
-  const [view, setView] = import_react5.default.useState("flat");
-  const [modal, setModal] = import_react5.default.useState(null);
-  const [expanded, setExpanded] = import_react5.default.useState({});
-  const [placementBusy, setPlacementBusy] = import_react5.default.useState(null);
-  const [placementOverride, setPlacementOverride] = import_react5.default.useState(null);
-  const [query, setQuery] = import_react5.default.useState("");
-  const [viewer, setViewer] = import_react5.default.useState(null);
-  const rootRef = import_react5.default.useRef(null);
-  const scrollPos = import_react5.default.useRef(null);
-  const restoreScroll = import_react5.default.useRef(null);
-  const [filter, setFilter] = import_react5.default.useState("all");
-  const [builtinOpen, setBuiltinOpen] = import_react5.default.useState(false);
+  const [tab, setTab] = import_react6.default.useState("installed");
+  const [view, setView] = import_react6.default.useState("flat");
+  const [modal, setModal] = import_react6.default.useState(null);
+  const [expanded, setExpanded] = import_react6.default.useState({});
+  const [placementBusy, setPlacementBusy] = import_react6.default.useState(null);
+  const [placementOverride, setPlacementOverride] = import_react6.default.useState(null);
+  const [query, setQuery] = import_react6.default.useState("");
+  const [viewer, setViewer] = import_react6.default.useState(null);
+  const rootRef = import_react6.default.useRef(null);
+  const scrollPos = import_react6.default.useRef(null);
+  const restoreScroll = import_react6.default.useRef(null);
+  const [filter, setFilter] = import_react6.default.useState("all");
+  const [builtinOpen, setBuiltinOpen] = import_react6.default.useState(false);
   const { settingsOpen, settingsRef, settingsPlacement, closeSettings, toggleSettings } = useSettingsPopover();
   const { agentTip, agentTipPos, agentTipRef, openAgentTip, closeAgentTip } = useAgentTip();
   const rows = data?.installs || [];
@@ -3928,7 +4002,7 @@ function Section({ t, page = false, pickDirectory, onPlacementChange }) {
     const agentLabels = row.links.map((link) => link.target === "dsh-global" ? "DSH" : link.label);
     return [row.name, row.source || "", ...agentLabels].join(" ").toLowerCase().includes(queryText);
   });
-  import_react5.default.useEffect(() => {
+  import_react6.default.useEffect(() => {
     if (!viewer || !data) return;
     if (rows.some((row) => row.name === viewer.name)) return;
     setViewer(null);
@@ -3940,23 +4014,10 @@ function Section({ t, page = false, pickDirectory, onPlacementChange }) {
   const autoLinkDsh = (data?.agents?.all || []).find((agent) => agent.target === "dsh-global") || null;
   const autoLinkLabel = [t("links.dshGlobal"), ...autoLinkAgents.map((agent) => agent.label)].join("、");
   const placement = (placementOverride ?? data?.settings?.placement) === "sidebar" ? "sidebar" : "settings";
-  function getScrollParent(node) {
-    let current = node?.parentElement || null;
-    while (current) {
-      if (typeof getComputedStyle === "function") {
-        const style = getComputedStyle(current);
-        if (style && /(auto|scroll)/.test(style.overflowY || "") && current.scrollHeight > current.clientHeight) {
-          return current;
-        }
-      }
-      current = current.parentElement || null;
-    }
-    return typeof document !== "undefined" ? document.scrollingElement || null : null;
-  }
   function listScroller() {
     const node = rootRef.current?.querySelector?.(".dshsc-listscroll");
-    if (node && node.scrollHeight > node.clientHeight) return node;
-    return getScrollParent(rootRef.current);
+    if (isScroller(node)) return node;
+    return nearestScroller(rootRef.current);
   }
   function openViewer(row, mode = "drawer") {
     if (!row) return;
@@ -3976,7 +4037,7 @@ function Section({ t, page = false, pickDirectory, onPlacementChange }) {
     if (viewer?.mode === "page") restoreScroll.current = scrollPos.current;
     setViewer(null);
   }
-  import_react5.default.useLayoutEffect(() => {
+  import_react6.default.useLayoutEffect(() => {
     if (restoreScroll.current === null) return;
     const target = restoreScroll.current;
     restoreScroll.current = null;
@@ -4043,7 +4104,7 @@ function Section({ t, page = false, pickDirectory, onPlacementChange }) {
     onToast: (next) => setToast(next)
   }) : null;
   const listNode = h(
-    import_react5.default.Fragment,
+    import_react6.default.Fragment,
     null,
     h(Header, {
       t,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morehao/dsh-skills-console",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "统一管理本地技能的安装、更新、删除与接入，让同一份技能在多个 Agent 间复用。A skill manager for DeepSeek Harness: install, update, remove, link and toggle agent skills.",
   "license": "MIT",
   "author": "morehao <morehao@qq.com>",
@@ -52,7 +52,8 @@
     "build:client": "node scripts/build-client.mjs",
     "dev:client": "node scripts/build-client.mjs --watch",
     "check:client": "node scripts/build-client.mjs --check",
-    "check": "node scripts/check-syntax.mjs && node scripts/build-client.mjs --check && node scripts/check-naming.mjs && node scripts/check-pack.mjs && node scripts/smoke-release-notes.mjs",
+    "check:cycles": "node scripts/check-cycles.mjs",
+    "check": "node scripts/check-syntax.mjs && node scripts/check-cycles.mjs && node scripts/build-client.mjs --check && node scripts/check-naming.mjs && node scripts/check-pack.mjs && node scripts/smoke-release-notes.mjs",
     "check:syntax": "node scripts/check-syntax.mjs",
     "check:naming": "node scripts/check-naming.mjs",
     "check:pack": "node scripts/check-pack.mjs",