dsh-skill-browser 1.8.7 → 1.9.9

package/lib/keyword-groups.js

@@ -0,0 +1,200 @@
+// ── v1.9.7: 关键词快速分组（零 token、毫秒级）────────────────────────
+// 用户反馈 AI 分组「太满」而且慢。本模块用**技能目录名的关键词正则**直接切
+// 「大类 → 子类」两级方案，不调用任何模型：
+//   · 零 token、零网络，110+ 技能 < 5ms 出方案
+//   · 结果完全确定，同样的技能库永远得到同样的分组
+//   · 规则写死可审计，随时能按用户口味加一行
+//   · 每个子类硬上限 8 项，避免"一屏塞满"
+//
+// 规则表 RULES 是**有序**的：从上往下第一条命中即生效（first-match-wins）。
+// 所以「具体」的规则必须排在「笼统」的规则之前。
+//
+// 输出结构与 groups.js 的 aiClassify() 完全一致，前端复用同一个方案弹层：
+//   { ok, plan:{ domains:[ { name, emoji, subs:[ { name, emoji, skills:[dir] } ] } ] },
+//     stats:{ skills, domains, subs, covered }, mode:"keyword", unmatched:[] }
+
+var MAX_SUB = 8;
+
+var DOMAINS = [
+  { key: "fluent", name: "Fluent/CFD 仿真", emoji: "🌀" },
+  { key: "dsh", name: "DSH 工具链", emoji: "🛠️" },
+  { key: "skill", name: "技能库治理", emoji: "🧠" },
+  { key: "agent", name: "多智能体与长任务", emoji: "🤝" },
+  { key: "gateway", name: "网关与反代", emoji: "🌐" },
+  { key: "install", name: "软件安装与下载", emoji: "💾" },
+  { key: "system", name: "系统与文件", emoji: "🖥️" },
+  { key: "dev", name: "开发与发布", emoji: "⌨️" },
+  { key: "doc", name: "文档与邮件", emoji: "📄" },
+  { key: "image", name: "图片与视觉", emoji: "🖼️" },
+  { key: "life", name: "网盘与生活", emoji: "🎨" }
+];
+
+var RULES = [
+  // ── Fluent / CFD（16 条，按用途切细，每子类 ≤8）────────────────
+  { dom: "fluent", sub: "SpaceClaim 几何操作", emoji: "📐", re: /^spaceclaim-/ },
+  { dom: "fluent", sub: "几何参数与模型", emoji: "📏",
+    re: /^(geometry-|fluent-debug-tank|fluent-domain-count|fluent-update-regions|ansys-local-workflows)/ },
+  { dom: "fluent", sub: "画网格", emoji: "🕸️", re: /^fluent-mesh/ },
+  { dom: "fluent", sub: "求解设置与初始化", emoji: "⚙️",
+    re: /^(fluent-setfile-|fluent-initialization|fluent-discretization-|fluent-precompute-|fluent-run-continuity|fluent-session-connect|fluent-gui-open)/ },
+  { dom: "fluent", sub: "物理模型与扭矩", emoji: "🌀",
+    re: /^(fluent-mrf-|fluent-aeration-|fluent-pbm-|fluent-torque-|impeller-circulation|torque-power-)/ },
+  { dom: "fluent", sub: "后处理·云图与矢量", emoji: "🌈",
+    re: /^(fluent-contour-|fluent-line-surface-|fluent-liquid-surface-|fluent-shear-|fluent-animation-)/ },
+  { dom: "fluent", sub: "后处理·xyplot 曲线", emoji: "📈", re: /^fluent-xyplot-/ },
+  { dom: "fluent", sub: "后处理·整理与对比", emoji: "📊",
+    re: /^(fluent-postprocess-|fluent-data-postprocess-|pbm-data-)/ },
+  { dom: "fluent", sub: "运行监控与进程", emoji: "📡",
+    re: /^(fluent-operation-monitor|fluent-run-health-check|fluent-midrun-save|fluent-detached-|fluent-process-|fluent-iter-monitor|fluent-monitor-report)/ },
+  { dom: "fluent", sub: "故障排查", emoji: "🔍",
+    re: /^(fluent-run-failure-|fluent-divergence-|fluent-path-check|fluent-path-index-repair|fluent-prev-run-vdisplay)/ },
+  { dom: "fluent", sub: "主线与铁律", emoji: "🧭",
+    re: /^(fluent-universal-mainline|fluent-control-laws|fluent-quick-reference|fluent-cfd$)/ },
+  { dom: "fluent", sub: "查证与经验", emoji: "📚",
+    re: /^(fluent-doc-query|fluent-experience|fluent-first-reference|fluent-growth-loop|fluent-experiment-first)/ },
+  { dom: "fluent", sub: "步骤与产物规范", emoji: "📝",
+    re: /^(fluent-artifact-path|fluent-case-save-discipline|fluent-step-plan|fluent-simulation-template|fluent-subagent-parallel)/ },
+  { dom: "fluent", sub: "多工况流程", emoji: "🔁",
+    re: /^(fluent-muti-|fluent-workflow-change|fluent-case-workflow-)/ },
+  { dom: "fluent", sub: "文件与备份", emoji: "🗂️",
+    re: /^(fluent-case-|fluent-file-|fluent-junk-cleanup)/ },
+  { dom: "fluent", sub: "主线与铁律", emoji: "🧭", re: /^fluent-/ },
+
+  // ── DSH 工具链 ──────────────────────────────────────────────────
+  { dom: "dsh", sub: "全局配置", emoji: "⚙️", re: /^dsh-config$/ },
+  { dom: "dsh", sub: "启动与恢复", emoji: "🚑", re: /^dsh-recovery$/ },
+  { dom: "dsh", sub: "插件发布与同步", emoji: "🚀", re: /^dsh-plugin-publish-/ },
+  { dom: "dsh", sub: "插件版本巡检", emoji: "📦", re: /^dsh-plugin-update-/ },
+  { dom: "dsh", sub: "插件开发", emoji: "🧩", re: /^dsh-plugin-/ },
+  { dom: "dsh", sub: "插件发现与安装", emoji: "🔌", re: /^(find-plugins|dsh-market)/ },
+  { dom: "dsh", sub: "全局配置", emoji: "⚙️", re: /^dsh-/ },
+
+  // ── 技能库治理 ──────────────────────────────────────────────────
+  { dom: "skill", sub: "技能库治理", emoji: "🧠", re: /^skill-/ },
+
+  // ── 多智能体与长任务 ────────────────────────────────────────────
+  { dom: "agent", sub: "团队与预设", emoji: "🤝", re: /^(agent-team-|agent-preset-)/ },
+  { dom: "agent", sub: "长任务与并行", emoji: "🎯", re: /^(goal-auto-continuation|task-parallel-)/ },
+
+  // ── 网关与反代 ──────────────────────────────────────────────────
+  { dom: "gateway", sub: "接入与额度", emoji: "🌐",
+    re: /^(reverse-proxy-|agent2api-|lobsterai-)/ },
+
+  // ── 软件安装与下载 ──────────────────────────────────────────────
+  { dom: "install", sub: "软件安装配置", emoji: "💾", re: /^software-install-/ },
+  { dom: "install", sub: "镜像与下载", emoji: "⬇️", re: /^download-mirror-/ },
+
+  // ── 系统与文件 ──────────────────────────────────────────────────
+  { dom: "system", sub: "删除与文件卫生", emoji: "🧹", re: /^(delete-to-recyclebin-|desktop-file-hygiene-)/ },
+  { dom: "system", sub: "Windows 排障", emoji: "🖥️", re: /^(windows-toolkit|diagnose-windows)/ },
+
+  // ── 开发与发布 ──────────────────────────────────────────────────
+  { dom: "dev", sub: "GitHub 发布", emoji: "🚀", re: /^github-publish/ },
+  { dom: "dev", sub: "浏览器自动化", emoji: "🎭", re: /^playwright/ },
+  { dom: "dev", sub: "前端与设计", emoji: "🎨", re: /^(frontend-design|design$)/ },
+
+  // ── 文档与邮件 ──────────────────────────────────────────────────
+  { dom: "doc", sub: "文档处理", emoji: "📄", re: /^(document-toolkit|office)/ },
+  { dom: "doc", sub: "批量邮件", emoji: "✉️", re: /^mail-bulk-/ },
+
+  // ── 图片与视觉 ──────────────────────────────────────────────────
+  { dom: "image", sub: "电子印章", emoji: "🔖", re: /^image-electronic-seal/ },
+  { dom: "image", sub: "壁纸与相册", emoji: "🖼️", re: /^(wallpaper-|image-gallery)/ },
+  { dom: "image", sub: "本地出图", emoji: "🎨", re: /^qwen21-/ },
+
+  // ── 网盘与生活 ──────────────────────────────────────────────────
+  { dom: "life", sub: "网盘", emoji: "☁️", re: /^(quarkclouddrive|baidu)/ },
+  { dom: "life", sub: "生活杂项", emoji: "🎈", re: /^(misc-lowfreq-|maoxt-|weather)/ }
+];
+
+// 兜底：上面全没命中的技能，按 scan.js 的 cat 归入对应大类，子类名「未归类」。
+var CAT_FALLBACK = {
+  fluent: { dom: "fluent", sub: "主线与铁律", emoji: "🧭" },
+  dsh: { dom: "dsh", sub: "全局配置", emoji: "⚙️" },
+  dev: { dom: "dev", sub: "前端与设计", emoji: "🎨" },
+  system: { dom: "system", sub: "Windows 排障", emoji: "🖥️" },
+  image: { dom: "image", sub: "壁纸与相册", emoji: "🖼️" },
+  output: { dom: "agent", sub: "长任务与并行", emoji: "🎯" }
+};
+
+function domMeta(key) {
+  for (var i = 0; i < DOMAINS.length; i++) if (DOMAINS[i].key === key) return DOMAINS[i];
+  return { key: "other", name: "其他技能", emoji: "📦" };
+}
+
+function matchRule(dir) {
+  for (var i = 0; i < RULES.length; i++) if (RULES[i].re.test(dir)) return RULES[i];
+  return null;
+}
+
+// 一个子类超过 MAX_SUB 时，拆成「名称 1」「名称 2」…，保证一屏不满。
+function splitSub(name, emoji, dirs) {
+  var out = [];
+  if (dirs.length <= MAX_SUB) { out.push({ name: name, emoji: emoji, skills: dirs }); return out; }
+  var part = 1;
+  for (var i = 0; i < dirs.length; i += MAX_SUB) {
+    out.push({
+      name: name + " " + part,
+      emoji: emoji,
+      skills: dirs.slice(i, i + MAX_SUB)
+    });
+    part++;
+  }
+  return out;
+}
+
+// 纯函数：给一组 {dir, cat, ...} 技能，返回两级分组方案。
+// 不读盘、不写盘、不联网 —— 调用方拿 plan 去走既有的 applyPlan()。
+export function keywordClassify(skills) {
+  var list = Array.isArray(skills) ? skills : [];
+  var byDom = {};
+  var unmatched = [];
+
+  for (var i = 0; i < list.length; i++) {
+    var s = list[i] || {};
+    var dir = String(s.dir || "").trim();
+    if (!dir) continue;
+    var rule = matchRule(dir);
+    if (!rule) {
+      var fb = CAT_FALLBACK[String(s.cat || "")] || { dom: "life", sub: "未归类", emoji: "📦" };
+      rule = { dom: fb.dom, sub: "未归类", emoji: "📦" };
+      unmatched.push(dir);
+    }
+    if (!byDom[rule.dom]) byDom[rule.dom] = { subs: {}, order: [] };
+    var d = byDom[rule.dom];
+    if (!d.subs[rule.sub]) { d.subs[rule.sub] = { emoji: rule.emoji || "📁", dirs: [] }; d.order.push(rule.sub); }
+    d.subs[rule.sub].dirs.push(dir);
+  }
+
+  var domains = [];
+  for (var m = 0; m < DOMAINS.length; m++) {
+    var key = DOMAINS[m].key;
+    if (!byDom[key]) continue;
+    var g = byDom[key];
+    var subs = [];
+    for (var t = 0; t < g.order.length; t++) {
+      var sb = g.subs[g.order[t]];
+      var parts = splitSub(g.order[t], sb.emoji, sb.dirs);
+      for (var p = 0; p < parts.length; p++) subs.push(parts[p]);
+    }
+    if (subs.length) domains.push({ name: DOMAINS[m].name, emoji: DOMAINS[m].emoji, subs: subs });
+  }
+
+  var subCount = 0, covered = 0;
+  for (var a = 0; a < domains.length; a++) {
+    subCount += domains[a].subs.length;
+    for (var b = 0; b < domains[a].subs.length; b++) covered += domains[a].subs[b].skills.length;
+  }
+
+  return {
+    ok: true,
+    plan: { domains: domains },
+    stats: { skills: covered, domains: domains.length, subs: subCount, covered: covered },
+    mode: "keyword",
+    unmatched: unmatched
+  };
+}
+
+export function keywordDomains() { return DOMAINS; }
+export function keywordRules() { return RULES; }
+export var KEYWORD_MAX_SUB = MAX_SUB;

package/lib/ledger-stats.js

@@ -0,0 +1,203 @@
+// dsh-skill-browser — 调用台账统计聚合（纯函数，无外部依赖）
+//
+// 数据源：技能失效-自动登记.jsonl（每行一条 skill 工具调用结果）
+//   {"ts":"2026-09-03T19:18:04.963Z","skill":"geometry-backup","ok":true,
+//    "kind":"auto-tool-result","callId":"call_x","error":""}
+//
+// 本模块只做「聚合」：按起止日期过滤 → 按 日/周/月/年 分桶 → 按技能排行。
+// 不读文件、不碰网络，方便单测。
+
+var MAX_BUCKETS = 400;
+
+function pad2(n) { return n < 10 ? "0" + n : String(n); }
+
+// 取 ISO 时间串的本地日期部分 YYYY-MM-DD（ts 是 UTC，用 Date 转本地）
+export function dayKeyOf(ts) {
+  var d = new Date(String(ts || ""));
+  if (isNaN(d.getTime())) return "";
+  return d.getFullYear() + "-" + pad2(d.getMonth() + 1) + "-" + pad2(d.getDate());
+}
+
+// 周一为一周起点
+export function weekStartOf(dayKey) {
+  var m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(String(dayKey || ""));
+  if (!m) return "";
+  var d = new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
+  var dow = d.getDay();            // 0=周日
+  var back = dow === 0 ? 6 : dow - 1;
+  d.setDate(d.getDate() - back);
+  return d.getFullYear() + "-" + pad2(d.getMonth() + 1) + "-" + pad2(d.getDate());
+}
+
+function addDays(dayKey, n) {
+  var m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(String(dayKey || ""));
+  if (!m) return "";
+  var d = new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
+  d.setDate(d.getDate() + n);
+  return d.getFullYear() + "-" + pad2(d.getMonth() + 1) + "-" + pad2(d.getDate());
+}
+
+function monthKeyOf(dayKey) { return String(dayKey || "").slice(0, 7); }
+function yearKeyOf(dayKey) { return String(dayKey || "").slice(0, 4); }
+
+// 桶 key + 展示标签
+function bucketOf(dayKey, gran) {
+  if (gran === "year") { var y = yearKeyOf(dayKey); return { key: y, label: y }; }
+  if (gran === "month") { var mo = monthKeyOf(dayKey); return { key: mo, label: mo }; }
+  if (gran === "week") {
+    var ws = weekStartOf(dayKey);
+    return { key: ws, label: ws.slice(5) + "~" + addDays(ws, 6).slice(5) };
+  }
+  return { key: dayKey, label: dayKey.slice(5) };
+}
+
+// 下一个桶（用于补空洞）
+function nextBucketKey(key, gran) {
+  if (gran === "year") return String(Number(key) + 1);
+  if (gran === "month") {
+    var m = /^(\d{4})-(\d{2})$/.exec(key); if (!m) return "";
+    var y = Number(m[1]), mo = Number(m[2]);
+    mo++; if (mo > 12) { mo = 1; y++; }
+    return y + "-" + pad2(mo);
+  }
+  return addDays(key, gran === "week" ? 7 : 1);
+}
+
+export function normalizeGran(v) {
+  var g = String(v || "").toLowerCase();
+  if (g === "year" || g === "month" || g === "week" || g === "day") return g;
+  return "day";
+}
+
+// 记录规整：只保留需要的字段，非法 ts 丢弃
+export function normalizeRecords(raw) {
+  var out = [];
+  var list = Object.prototype.toString.call(raw) === "[object Array]" ? raw : [];
+  for (var i = 0; i < list.length; i++) {
+    var r = list[i] || {};
+    var day = dayKeyOf(r.ts);
+    if (!day) continue;
+    var skill = String(r.skill == null ? "" : r.skill).trim();
+    if (!skill) continue;
+    out.push({
+      ts: String(r.ts),
+      day: day,
+      skill: skill,
+      ok: r.ok === false ? false : true,
+      kind: String(r.kind == null ? "" : r.kind)
+    });
+  }
+  out.sort(function (a, b) { return a.ts < b.ts ? -1 : a.ts > b.ts ? 1 : 0; });
+  return out;
+}
+
+// 主聚合入口
+// opts: { from, to, gran, top, sort }
+export function buildStats(rawRecords, opts) {
+  var o = opts || {};
+  var gran = normalizeGran(o.gran);
+  var records = normalizeRecords(rawRecords);
+
+  // 全量时间边界（不受筛选影响，用于前端提示「数据可用区间」）
+  var dataFirst = records.length ? records[0].day : "";
+  var dataLast = records.length ? records[records.length - 1].day : "";
+
+  var from = String(o.from || "").trim();
+  var to = String(o.to || "").trim();
+  if (from && to && from > to) { var t = from; from = to; to = t; }
+
+  var picked = [];
+  for (var i = 0; i < records.length; i++) {
+    var r = records[i];
+    if (from && r.day < from) continue;
+    if (to && r.day > to) continue;
+    picked.push(r);
+  }
+
+  // ---- 总计 ----
+  var okCount = 0, failCount = 0;
+  var skillAgg = Object.create(null);
+  var daySet = Object.create(null);
+  for (var j = 0; j < picked.length; j++) {
+    var x = picked[j];
+    if (x.ok) okCount++; else failCount++;
+    daySet[x.day] = 1;
+    var a = skillAgg[x.skill];
+    if (!a) { a = skillAgg[x.skill] = { skill: x.skill, calls: 0, ok: 0, fail: 0, last: "", first: "" }; }
+    a.calls++;
+    if (x.ok) a.ok++; else a.fail++;
+    if (!a.first) a.first = x.ts;
+    a.last = x.ts;
+  }
+  var calls = picked.length;
+  var activeDays = Object.keys(daySet).length;
+
+  var totals = {
+    calls: calls,
+    ok: okCount,
+    fail: failCount,
+    rate: calls ? Math.round((okCount / calls) * 1000) / 10 : 0,
+    skills: Object.keys(skillAgg).length,
+    days: activeDays,
+    avgPerDay: activeDays ? Math.round((calls / activeDays) * 10) / 10 : 0
+  };
+
+  // ---- 分桶（补空洞）----
+  var buckets = [];
+  if (picked.length) {
+    var map = Object.create(null);
+    var order = [];
+    for (var k = 0; k < picked.length; k++) {
+      var b = bucketOf(picked[k].day, gran);
+      if (!b.key) continue;
+      var cur = map[b.key];
+      if (!cur) { cur = map[b.key] = { key: b.key, label: b.label, calls: 0, ok: 0, fail: 0 }; order.push(b.key); }
+      cur.calls++;
+      if (picked[k].ok) cur.ok++; else cur.fail++;
+    }
+    order.sort();
+    // 补空洞：从首个桶走到末个桶
+    var firstKey = order[0], lastKey = order[order.length - 1];
+    var walk = firstKey, guard = 0;
+    while (walk && walk <= lastKey && guard < MAX_BUCKETS) {
+      if (map[walk]) buckets.push(map[walk]);
+      else buckets.push({ key: walk, label: bucketOf(gran === "day" ? walk : (gran === "year" ? walk + "-01-01" : (gran === "month" ? walk + "-01" : walk)), gran).label, calls: 0, ok: 0, fail: 0 });
+      walk = nextBucketKey(walk, gran);
+      guard++;
+    }
+  }
+
+  // ---- 排行 ----
+  var ranks = [];
+  for (var sk in skillAgg) if (Object.prototype.hasOwnProperty.call(skillAgg, sk)) ranks.push(skillAgg[sk]);
+  var sort = String(o.sort || "calls");
+  var cmp = {
+    calls: function (a, b) { return b.calls - a.calls || b.fail - a.fail || (a.skill < b.skill ? -1 : 1); },
+    fails: function (a, b) { return b.fail - a.fail || b.calls - a.calls || (a.skill < b.skill ? -1 : 1); },
+    rate: function (a, b) { return (a.ok / a.calls) - (b.ok / b.calls) || b.calls - a.calls; },
+    last: function (a, b) { return a.last < b.last ? 1 : a.last > b.last ? -1 : 0; },
+    name: function (a, b) { return a.skill < b.skill ? -1 : a.skill > b.skill ? 1 : 0; }
+  }[sort] || null;
+  ranks.sort(cmp || function (a, b) { return b.calls - a.calls; });
+  for (var q = 0; q < ranks.length; q++) {
+    ranks[q].rank = q + 1;
+    ranks[q].rate = ranks[q].calls ? Math.round((ranks[q].ok / ranks[q].calls) * 1000) / 10 : 0;
+  }
+  var top = Number(o.top);
+  if (!(top > 0)) top = 0;
+  if (top && ranks.length > top) ranks = ranks.slice(0, top);
+
+  return {
+    ok: true,
+    gran: gran,
+    from: from,
+    to: to,
+    sort: sort,
+    dataFirst: dataFirst,
+    dataLast: dataLast,
+    totals: totals,
+    buckets: buckets,
+    ranks: ranks,
+    rankTotal: Object.keys(skillAgg).length
+  };
+}

package/lib/ledger-writer.js

@@ -16,7 +16,7 @@
 // 台账 md 内插件维护区块用标记包围，幂等追加：
 //   <!-- dsh-skill-browser:auto-ledger:v1 BEGIN --> ... <!-- dsh-skill-browser:auto-ledger:v1 END -->
 
-import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, appendFileSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, appendFileSync, readdirSync, statSync, openSync, readSync, closeSync } from "node:fs";
 import { join, dirname } from "node:path";
 
 var LEDGER_REL = ["skill-master", "references", "技能生效-失效台账.md"];
@@ -223,6 +223,61 @@ export function readAutoLog(root, skillFilter) {
   return out;
 }
 
+// ── v1.9.6 性能：自动登记 jsonl 的增量读取 ────────────────────
+// 问题：原 readAutoLog 每次调用都 readFileSync 整个 jsonl（986+ 行且持续增长），
+// 台账看板每次切粒度/改排序都会重读一遍，导致卡顿与内存抖动。
+// 方案：①用 stat 探针判断文件是否变化（size+mtimeMs），未变化直接复用解析结果；
+//       ②需要"最近 N 条"时只从文件尾部读，不读全文。
+export function autoLogStat(root) {
+  var p = autoLogFilePath(root);
+  try {
+    if (!existsSync(p)) return { path: p, exists: false, size: 0, mtimeMs: 0 };
+    var st = statSync(p);
+    return { path: p, exists: true, size: st.size, mtimeMs: st.mtimeMs };
+  } catch (e) {
+    return { path: p, exists: false, size: 0, mtimeMs: 0 };
+  }
+}
+
+// 只读文件尾部若干字节（按行切齐），用于"最近 N 条"场景，避免全量读盘
+export function readAutoLogTail(root, limit, skillFilter) {
+  var n = Math.max(1, Number(limit) || 30);
+  var p = autoLogFilePath(root);
+  if (!existsSync(p)) return [];
+  var text = "";
+  try {
+    var st = statSync(p);
+    // 每行约 130 字节，按需多读 40% 余量；不足则退回全量
+    var want = Math.min(st.size, Math.max(4096, n * 190));
+    var fd = openSync(p, "r");
+    try {
+      var buf = Buffer.alloc(want);
+      readSync(fd, buf, 0, want, Math.max(0, st.size - want));
+      text = buf.toString("utf8");
+    } finally {
+      try { closeSync(fd); } catch (e2) {}
+    }
+    if (want < st.size) {
+      var nl = text.indexOf("\n");
+      if (nl >= 0) text = text.slice(nl + 1); // 丢掉可能被截断的首行
+    }
+  } catch (e) {
+    try { text = readFileSync(p, "utf8"); } catch (e3) { return []; }
+  }
+  var out = [];
+  var lines = text.split("\n");
+  for (var i = 0; i < lines.length; i++) {
+    var line = lines[i].trim();
+    if (!line) continue;
+    try {
+      var obj = JSON.parse(line);
+      if (skillFilter && obj.skill !== skillFilter) continue;
+      out.push(obj);
+    } catch (e4) { /* 跳过坏行/截断行 */ }
+  }
+  return out.length > n ? out.slice(out.length - n) : out;
+}
+
 // ── 内部：队列与写盘 ────────────────────────────────────
 function enqueue(state, entry) {
   state.queue.push(entry);

package/lib/scan.js

@@ -69,10 +69,25 @@ export function categorize(dirName) {
   return { id: cat, sub: sub };
 }
 
+// v1.9.0: resolve one skill's version string.
+// Order: SKILL.md frontmatter `version` -> sibling package.json `version` -> "".
+// "" means "not yet versioned" (the panel renders a fallback badge).
+function readSkillVersion(root, dirName, fm) {
+  var v = String((fm && fm.version) || "").trim();
+  if (v) return v;
+  try {
+    var pkgPath = join(root, dirName, "package.json");
+    if (!existsSync(pkgPath)) return "";
+    var pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    return String((pkg && pkg.version) || "").trim();
+  } catch (e) { return ""; }
+}
+
 // Scan one skill root directory. Returns an array of skill summaries,
 // sorted by directory name. Skips non-directories, `_`-prefixed and
 // `.`-prefixed entries, and directories without a SKILL.md.
 // v1.7.2: each entry also carries `disabled` (read from frontmatter).
+// v1.9.0: each entry also carries `version` ("" = not yet versioned).
 export function scanSkills(root, zhDict) {
   var out = [];
   if (!root || !existsSync(root)) return out;
@@ -93,6 +108,7 @@ export function scanSkills(root, zhDict) {
       zh: (zhDict && zhDict[e.name]) || "",
       cat: cat.id,
       sub: cat.sub,
+      version: readSkillVersion(root, e.name, fm),
       mtime: safeMtime(skillFile),
       disabled: fmSaysDisabled(fm)
     });

package/lib/zh.js

@@ -137,5 +137,121 @@ export var UI_TEXT = {
   aggMenuTitleCat: "分类批量启停 — 仅作用于当前分类",
   aggMenuStat: "{scope} · 共 {n} 项 · 已停用 {x} 项",
   aggCatStat: "停用 {x}/{y}",
-  aggCancelText: "取消"
+  aggCancelText: "取消",
+  // ── v1.9.0：版本号 / 视图分组 / AI 分组与封面 ──
+  versionLabel: "版本",
+  versionNone: "暂未编版本号",
+  versionTip: "该技能 SKILL.md frontmatter 与 package.json 都没有声明 version",
+  groupsTitle: "我的分组",
+  groupsHint: "分组只是视图归档，不会移动任何技能文件",
+  groupNew: "＋ 新建分组",
+  groupAi: "🤖 AI 自动分组",
+  groupAll: "全部",
+  groupUngrouped: "未分组",
+  groupEmpty: "还没有分组，点「＋ 新建分组」或「🤖 AI 自动分组」",
+  groupNamePrompt: "分组名称",
+  groupNamePlaceholder: "例如：Fluent 仿真、逆向工具、文档处理",
+  groupDeleteConfirm: "删除分组「{name}」？技能文件不会受影响，只是取消归档。",
+  groupCreated: "已创建分组：{name}",
+  groupRenamed: "已重命名：{name}",
+  groupDeleted: "已删除分组：{name}",
+  groupAssignTip: "放进这个分组（只改视图，不动文件）",
+  groupMove: "移动",
+  groupMoveTitle: "移动到分组",
+  groupMoveNone: "移出分组",
+  groupAssigned: "已把 {name} 移入「{group}」",
+  groupUnassigned: "已把 {name} 移出分组",
+  groupAiRunning: "AI 正在分析技能库并分组，请稍候…",
+  groupAiDone: "AI 已建 {n} 个分组",
+  groupAiFail: "AI 分组失败：{err}",
+  groupCover: "AI 生成封面",
+  groupCoverRunning: "正在生成封面…",
+  groupCoverDone: "封面已生成",
+  groupCoverFail: "封面生成失败：{err}",
+  groupRename: "重命名",
+  groupDelete: "删除分组",
+  groupManageTitle: "分组管理",
+  aiNoLlm: "AI 不可用：宿主未提供 llm 服务",
+  modelUsing: "AI 分组将使用：{model}",
+  modelSourceDefault: "DSH 默认模型",
+  modelSourceAgent: "当前对话模型",
+  modelSourceConfig: "插件配置",
+  modelSourceCatalog: "宿主可用模型",
+  modelNone: "AI 不可用：没找到任何可用模型，请到 DSH 设置 → 模型 选一个默认模型",
+  modelProbeTip: "点一下检测 AI 分组会用哪个模型（不会真的调模型）",
+  hotReload: "热重载",
+  hotReloadTip: "热重载：重新加载插件代码，不重启桌面端",
+  hotReloadRunning: "正在热重载…",
+  hotReloadDone: "热重载完成（v{v} · 第 {n} 代）",
+  hotReloadFail: "热重载失败：{e}",
+  hotReloadRefresh: "代码已换新，正在刷新界面…",
+    cardMore: "加载更多（还有 {n} 条）",
+    detailHint: "点开才动态加载全文，列表只做静态摘要",
+  lstatTitle: "调用台账",
+  lstatQuickToday: "今天",
+  lstatQuick7: "近7天",
+  lstatQuick30: "近30天",
+  lstatQuickMonth: "本月",
+  lstatQuickPrevMonth: "上月",
+  lstatQuickYear: "今年",
+  lstatQuickAll: "全部",
+  lstatFrom: "起",
+  lstatTo: "止",
+  lstatGran: "粒度",
+  lstatGranDay: "日",
+  lstatGranWeek: "周",
+  lstatGranMonth: "月",
+  lstatGranYear: "年",
+  lstatCalls: "调用",
+  lstatSkills: "活跃技能",
+  lstatDays: "活跃天数",
+  lstatRate: "成功率",
+  lstatAvg: "日均",
+  lstatTrend: "调用趋势",
+  lstatRank: "技能调用排行",
+  lstatColRank: "#",
+  lstatColSkill: "技能",
+  lstatColVer: "版本",
+  lstatColCalls: "调用",
+  lstatColOk: "成功",
+  lstatColFail: "失败",
+  lstatColRate: "成功率",
+  lstatColLast: "最后调用",
+  lstatSortTip: "点表头切换排序",
+  lstatEmptyRange: "该区间没有调用记录",
+  lstatEmptyAll: "还没有任何调用记录 —— 用一次技能后这里就会出现数据",
+  lstatLoading: "台账统计加载中…",
+  lstatFail: "台账统计加载失败：{err}",
+  lstatDataRange: "数据区间 {from} ~ {to}",
+  lstatNoData: "无数据",
+  lstatManual: "人工台账",
+  lstatAuto: "自动登记流水",
+  lstatAutoTip: "插件监听 skill 工具调用结果自动记录 · 最近 30 条",
+  lstatCollapse: "展开原始流水",
+  lstatExpand: "收起原始流水",
+  lstatTopN: "仅显示前 {n}",
+  // ── v1.9.3：两级分组（总-分）与 AI 方案确认 ──
+  groupSubsOf: "子类",
+  groupWhole: "整个大类",
+  groupNewSub: "在此大类下新建子类",
+  groupCurTag: "当前",
+  groupKidsN: "{n} 子类",
+  groupKw: "⚡ 关键词分组",
+  groupKwTip: "本地关键词规则直接分组：零 token、毫秒级、结果固定",
+  groupAiTip: "调用模型重新归纳分组：慢，但更懂语义",
+  groupPlanTitleKw: "⚡ 关键词分组方案（确认后才会写入）",
+  groupPlanTitle: "🤖 AI 分组方案（确认后才会写入）",
+  groupPlanStat: "共 {d} 个大类 · {s} 个子类 · 覆盖 {n} 个技能",
+  groupPlanReplace: "替换：清掉旧的 AI 分组，按此方案重建",
+  groupPlanMerge: "追加：保留现有分组，只补未归类的技能",
+  groupApplyRunning: "正在写入分组…",
+  groupApplyDone: "已应用：{d} 个大类 / {s} 个子类",
+  groupApplyFail: "应用分组失败：{err}",
+  groupSubCreated: "子类已创建：{name}",
+  groupSubPrompt: "在「{p}」下新建子类，输入名称：",
+  groupSubFail: "新建子类失败",
+  groupModeTree: "🌳 树状",
+  groupModeFlat: "▦ 平铺",
+  groupModeTreeTip: "树状：每个大类一行，子类常驻缩进挂在下层，层层展开一眼看全",
+  groupModeFlatTip: "平铺：大类排成卡片，点开才显示子类（v1.9.3 原样）"
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-skill-browser",
-  "version": "1.8.7",
-  "description": "DSH 技能浏览器：悬浮球面板浏览共享技能库（分类/中文简介/搜索/失效台账/全文查看），含 DSH 设置页悬浮球显隐开关与一键恢复默认位置按钮、技能库位置可配置（原生目录选择框）与技能失效台账自动登记（自动/人工分开显示）；推荐插件位仅保留面板设置展开区一处。Skill library browser panel with categories, Chinese descriptions, configurable skill root with native directory chooser, one-click ball position reset and automatic skill-failure ledger.",
+  "version": "1.9.9",
+  "description": "技能浏览器：把 ~/.dsh/skills 里的技能做成可视化面板（搜索/分类/启停/详情/调用台账）。v1.9.0 自定义分组+版本号+AI 分组+AI 封面；v1.9.1 调用台账看板；v1.9.2 全皮肤自适应配色；v1.9.3 两级分组+滚动条+悬浮球层级；v1.9.4 面板⚡热重载；v1.9.5 吸顶表头不透明；v1.9.6 详情层隔离+分片渲染+增量读取；v1.9.7 关键词快速分组；v1.9.8 树状/平铺双模式分组栏；v1.9.9 零配置模型自动发现+全皮肤文字可见性加固。",
   "type": "module",
   "main": "lib/index.js",
   "sideEffects": false,
@@ -65,7 +65,13 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh": ">=0.1.7-rc.1"
+    "@deepseek-ai/dsh": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.7-rc.1 || ^0.2.0-rc.1"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",