@spzhongwin/skill-logger-plugin 1.0.11 → 1.0.13

package/src/sample-config.json

@@ -1,72 +1,72 @@
-{
-  "configs": [
-    {
-      "skillName": "model-usage",
-      "version": "0.0.0-stub",
-      "description": "查看各 provider 模型用量（本地静态桩）",
-      "functions": [
-        {
-          "id": "usage_current",
-          "name": "当前用量",
-          "description": "查看当前模型用量",
-          "match": {
-            "type": "script",
-            "script": "scripts/model_usage.py",
-            "argRules": [{ "flag": "--mode", "value": "current" }]
-          }
-        },
-        {
-          "id": "usage_all",
-          "name": "全部用量",
-          "description": "查看全部模型用量",
-          "match": {
-            "type": "script",
-            "script": "scripts/model_usage.py",
-            "argRules": [{ "flag": "--mode", "value": "all" }]
-          }
-        }
-      ]
-    },
-    {
-      "skillName": "openai-whisper-api",
-      "version": "0.0.0-stub",
-      "description": "Whisper 音频转写（本地静态桩）",
-      "functions": [
-        {
-          "id": "transcribe",
-          "name": "音频转写",
-          "match": { "type": "script", "script": "scripts/transcribe.sh" }
-        }
-      ]
-    },
-    {
-      "skillName": "mcporter",
-      "version": "0.0.0-stub",
-      "description": "MCP CLI 包装示例（本地静态桩）",
-      "functions": [
-        {
-          "id": "linear_list_issues",
-          "name": "列 Linear issue",
-          "match": { "type": "command", "command": "mcporter", "targetPattern": "call linear.list_issues" }
-        }
-      ]
-    },
-    {
-      "skillName": "linear-mcp",
-      "version": "0.0.0-stub",
-      "description": "MCP/SSE 工具直调 + HTTP 端点示例（本地静态桩）",
-      "functions": [
-        {
-          "id": "create_issue",
-          "name": "创建 issue（MCP工具直调）",
-          "match": { "type": "tool", "toolName": "linear_create_issue" }
-        },
-        {
-          "id": "transcribe_http",
-          "name": "转写 HTTP 端点",
-          "match": { "type": "http", "urlContains": "/v1/audio/transcriptions" }
-        }
-      ]
-    }
-  ]
-}
+{
+  "configs": [
+    {
+      "skillName": "model-usage",
+      "version": "0.0.0-stub",
+      "description": "查看各 provider 模型用量（本地静态桩）",
+      "functions": [
+        {
+          "id": "usage_current",
+          "name": "当前用量",
+          "description": "查看当前模型用量",
+          "match": {
+            "type": "script",
+            "script": "scripts/model_usage.py",
+            "argRules": [{ "flag": "--mode", "value": "current" }]
+          }
+        },
+        {
+          "id": "usage_all",
+          "name": "全部用量",
+          "description": "查看全部模型用量",
+          "match": {
+            "type": "script",
+            "script": "scripts/model_usage.py",
+            "argRules": [{ "flag": "--mode", "value": "all" }]
+          }
+        }
+      ]
+    },
+    {
+      "skillName": "openai-whisper-api",
+      "version": "0.0.0-stub",
+      "description": "Whisper 音频转写（本地静态桩）",
+      "functions": [
+        {
+          "id": "transcribe",
+          "name": "音频转写",
+          "match": { "type": "script", "script": "scripts/transcribe.sh" }
+        }
+      ]
+    },
+    {
+      "skillName": "mcporter",
+      "version": "0.0.0-stub",
+      "description": "MCP CLI 包装示例（本地静态桩）",
+      "functions": [
+        {
+          "id": "linear_list_issues",
+          "name": "列 Linear issue",
+          "match": { "type": "command", "command": "mcporter", "targetPattern": "call linear.list_issues" }
+        }
+      ]
+    },
+    {
+      "skillName": "linear-mcp",
+      "version": "0.0.0-stub",
+      "description": "MCP/SSE 工具直调 + HTTP 端点示例（本地静态桩）",
+      "functions": [
+        {
+          "id": "create_issue",
+          "name": "创建 issue（MCP工具直调）",
+          "match": { "type": "tool", "toolName": "linear_create_issue" }
+        },
+        {
+          "id": "transcribe_http",
+          "name": "转写 HTTP 端点",
+          "match": { "type": "http", "urlContains": "/v1/audio/transcriptions" }
+        }
+      ]
+    }
+  ]
+}

package/src/semver.test.ts

@@ -1,23 +1,23 @@
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import { compareVersions, isOutdated } from "./semver.ts";
-
-describe("compareVersions", () => {
-  it("数值逐段比较：1.10 > 1.9", () => assert.equal(compareVersions("1.10.0", "1.9.0"), 1));
-  it("缺省段按 0 补齐：1.2 == 1.2.0", () => assert.equal(compareVersions("1.2", "1.2.0"), 0));
-  it("容忍 v 前缀", () => assert.equal(compareVersions("v2.0.0", "2.0.0"), 0));
-  it("a < b", () => assert.equal(compareVersions("1.0.0", "1.0.1"), -1));
-  it("忽略预发布后缀（核心相等）", () => assert.equal(compareVersions("1.0.0-beta", "1.0.0"), 0));
-  it("非数字版本退化为字符串比较", () => assert.equal(compareVersions("abc", "abc"), 0));
-});
-
-describe("isOutdated", () => {
-  it("本地落后 → true", () => assert.equal(isOutdated("1.0.0", "1.1.0"), true));
-  it("本地更新 → false", () => assert.equal(isOutdated("2.0.0", "1.9.0"), false));
-  it("相等 → false", () => assert.equal(isOutdated("1.2.3", "1.2.3"), false));
-  it("1.9 vs 1.10：应判过期（数值语义）", () => assert.equal(isOutdated("1.9.0", "1.10.0"), true));
-  it("缺本地版本 → 不判过期", () => assert.equal(isOutdated(undefined, "1.0.0"), false));
-  it("缺最新版本 → 不判过期", () => assert.equal(isOutdated("1.0.0", undefined), false));
-  it("非 semver 且不同 → 过期（保守）", () => assert.equal(isOutdated("alpha", "beta"), true));
-  it("带预发布后缀核心相同 → 不过期", () => assert.equal(isOutdated("2026-01", "2026-02"), false));
-});
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { compareVersions, isOutdated } from "./semver.ts";
+
+describe("compareVersions", () => {
+  it("数值逐段比较：1.10 > 1.9", () => assert.equal(compareVersions("1.10.0", "1.9.0"), 1));
+  it("缺省段按 0 补齐：1.2 == 1.2.0", () => assert.equal(compareVersions("1.2", "1.2.0"), 0));
+  it("容忍 v 前缀", () => assert.equal(compareVersions("v2.0.0", "2.0.0"), 0));
+  it("a < b", () => assert.equal(compareVersions("1.0.0", "1.0.1"), -1));
+  it("忽略预发布后缀（核心相等）", () => assert.equal(compareVersions("1.0.0-beta", "1.0.0"), 0));
+  it("非数字版本退化为字符串比较", () => assert.equal(compareVersions("abc", "abc"), 0));
+});
+
+describe("isOutdated", () => {
+  it("本地落后 → true", () => assert.equal(isOutdated("1.0.0", "1.1.0"), true));
+  it("本地更新 → false", () => assert.equal(isOutdated("2.0.0", "1.9.0"), false));
+  it("相等 → false", () => assert.equal(isOutdated("1.2.3", "1.2.3"), false));
+  it("1.9 vs 1.10：应判过期（数值语义）", () => assert.equal(isOutdated("1.9.0", "1.10.0"), true));
+  it("缺本地版本 → 不判过期", () => assert.equal(isOutdated(undefined, "1.0.0"), false));
+  it("缺最新版本 → 不判过期", () => assert.equal(isOutdated("1.0.0", undefined), false));
+  it("非 semver 且不同 → 过期（保守）", () => assert.equal(isOutdated("alpha", "beta"), true));
+  it("带预发布后缀核心相同 → 不过期", () => assert.equal(isOutdated("2026-01", "2026-02"), false));
+});

package/src/semver.ts

@@ -1,60 +1,60 @@
-/**
- * 轻量语义化版本比较（纯函数，无依赖）。
- *
- * 仅用于「本地 skill 版本 vs 平台最新版本」的过期判断，不追求完整 semver 规范：
- *  - 容忍前缀 `v`/`V`（如 `v1.2.3`）；
- *  - 比较 `主.次.修订…` 的数值段，缺省段按 0 补齐（`1.2` == `1.2.0`）；
- *  - 预发布/构建元数据（`-beta`、`+build`）只取核心版本比较，忽略其后缀；
- *  - 任一侧无法解析为「点分数字」时，退化为字符串相等判断。
- */
-
-/** 解析核心数字段；非「点分数字」返回 null（触发字符串回退）。 */
-function parseCore(v: string): number[] | null {
-  const core = v.trim().replace(/^[vV]/, "").split(/[-+]/, 1)[0];
-  if (!core) return null;
-  const parts = core.split(".");
-  const nums: number[] = [];
-  for (const p of parts) {
-    if (!/^\d+$/.test(p)) return null;
-    nums.push(Number(p));
-  }
-  return nums.length > 0 ? nums : null;
-}
-
-/**
- * 比较 a 与 b：a<b 返回 -1，a>b 返回 1，相等返回 0。
- * 两侧都能解析为点分数字时按数值逐段比较；否则退化为字符串比较。
- */
-export function compareVersions(a: string, b: string): -1 | 0 | 1 {
-  const na = parseCore(a);
-  const nb = parseCore(b);
-  if (na && nb) {
-    const len = Math.max(na.length, nb.length);
-    for (let i = 0; i < len; i++) {
-      const x = na[i] ?? 0;
-      const y = nb[i] ?? 0;
-      if (x < y) return -1;
-      if (x > y) return 1;
-    }
-    return 0;
-  }
-  // 字符串回退：仅区分相等/不等（不臆测大小关系）。
-  const sa = a.trim();
-  const sb = b.trim();
-  if (sa === sb) return 0;
-  return sa < sb ? -1 : 1;
-}
-
-/**
- * 本地版本是否「落后于」最新版本（即需要更新）。
- *  - 两侧都是合法 semver：latest 数值更大才算过期；
- *  - 无法数值比较时：字符串不相等即视为过期（保守，宁可多更新一次）。
- * 任一侧为空 → 不判过期（缺版本号则不参与更新）。
- */
-export function isOutdated(local: string | undefined, latest: string | undefined): boolean {
-  if (!local || !latest) return false;
-  const na = parseCore(local);
-  const nb = parseCore(latest);
-  if (na && nb) return compareVersions(local, latest) < 0;
-  return local.trim() !== latest.trim();
-}
+/**
+ * 轻量语义化版本比较（纯函数，无依赖）。
+ *
+ * 仅用于「本地 skill 版本 vs 平台最新版本」的过期判断，不追求完整 semver 规范：
+ *  - 容忍前缀 `v`/`V`（如 `v1.2.3`）；
+ *  - 比较 `主.次.修订…` 的数值段，缺省段按 0 补齐（`1.2` == `1.2.0`）；
+ *  - 预发布/构建元数据（`-beta`、`+build`）只取核心版本比较，忽略其后缀；
+ *  - 任一侧无法解析为「点分数字」时，退化为字符串相等判断。
+ */
+
+/** 解析核心数字段；非「点分数字」返回 null（触发字符串回退）。 */
+function parseCore(v: string): number[] | null {
+  const core = v.trim().replace(/^[vV]/, "").split(/[-+]/, 1)[0];
+  if (!core) return null;
+  const parts = core.split(".");
+  const nums: number[] = [];
+  for (const p of parts) {
+    if (!/^\d+$/.test(p)) return null;
+    nums.push(Number(p));
+  }
+  return nums.length > 0 ? nums : null;
+}
+
+/**
+ * 比较 a 与 b：a<b 返回 -1，a>b 返回 1，相等返回 0。
+ * 两侧都能解析为点分数字时按数值逐段比较；否则退化为字符串比较。
+ */
+export function compareVersions(a: string, b: string): -1 | 0 | 1 {
+  const na = parseCore(a);
+  const nb = parseCore(b);
+  if (na && nb) {
+    const len = Math.max(na.length, nb.length);
+    for (let i = 0; i < len; i++) {
+      const x = na[i] ?? 0;
+      const y = nb[i] ?? 0;
+      if (x < y) return -1;
+      if (x > y) return 1;
+    }
+    return 0;
+  }
+  // 字符串回退：仅区分相等/不等（不臆测大小关系）。
+  const sa = a.trim();
+  const sb = b.trim();
+  if (sa === sb) return 0;
+  return sa < sb ? -1 : 1;
+}
+
+/**
+ * 本地版本是否「落后于」最新版本（即需要更新）。
+ *  - 两侧都是合法 semver：latest 数值更大才算过期；
+ *  - 无法数值比较时：字符串不相等即视为过期（保守，宁可多更新一次）。
+ * 任一侧为空 → 不判过期（缺版本号则不参与更新）。
+ */
+export function isOutdated(local: string | undefined, latest: string | undefined): boolean {
+  if (!local || !latest) return false;
+  const na = parseCore(local);
+  const nb = parseCore(latest);
+  if (na && nb) return compareVersions(local, latest) < 0;
+  return local.trim() !== latest.trim();
+}

package/src/skill-version.ts

@@ -1,53 +1,53 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-/**
- * 优先从 .meta.json 获取版本，如果没有，再回退到 SKILL.md 提取。
- */
-export async function readSkillVersion(rootDir: string, skillMdContent?: string): Promise<string | undefined> {
-  // 1. 优先尝试从 .meta.json 中读取
-  try {
-    const metaPath = path.join(rootDir, ".meta.json");
-    const metaContent = await fs.readFile(metaPath, "utf-8");
-    const meta = JSON.parse(metaContent);
-    if (meta && typeof meta.version === "string" && meta.version.trim() && meta.version !== "unknown") {
-      return meta.version.trim();
-    }
-  } catch {
-    // 忽略异常，继续 fallback
-  }
-
-  // 2. 降级到 SKILL.md 提取
-  if (!skillMdContent) {
-    try {
-      skillMdContent = await fs.readFile(path.join(rootDir, "SKILL.md"), "utf-8");
-    } catch {
-      return undefined;
-    }
-  }
-
-  return parseSkillVersion(skillMdContent);
-}
-
-/**
- * 从 SKILL.md 文本中提取版本号（纯正则、不借助任何模型）。
- *
- * 兼容点：
- *  - 键名：英文 `version` / `Version`（大小写不敏感）、中文 `当前版本号` / `当前版本` / `版本号` / `版本`；
- *  - 冒号：半角 `:` 或全角 `：`；
- *  - 取值：去除包裹引号、行尾 ` # 注释`、首尾空白。
- *
- * 范围：在整篇 SKILL.md 内按「单独一行」匹配（frontmatter 在最前，故天然优先命中）。
- * 因要求行首即键名（前面只允许空白），Markdown 标题 `## Version: x`（带 `#` 前缀）不会被误命中。
- * 取不到返回 undefined（该 skill 不参与版本更新）。
- */
-export function parseSkillVersion(content: string): string | undefined {
-  const m = /(?:^|\r?\n)[ \t]*(?:version|当前版本号|当前版本|版本号|版本)[ \t]*[:：][ \t]*(.+)/i.exec(content);
-  if (!m) return undefined;
-  const v = m[1]
-    .replace(/\s+#.*$/, "") // 行尾注释
-    .trim()
-    .replace(/^["']|["']$/g, "") // 包裹引号
-    .trim();
-  return v || undefined;
-}
+import fs from "node:fs/promises";
+import path from "node:path";
+
+/**
+ * 优先从 .meta.json 获取版本，如果没有，再回退到 SKILL.md 提取。
+ */
+export async function readSkillVersion(rootDir: string, skillMdContent?: string): Promise<string | undefined> {
+  // 1. 优先尝试从 .meta.json 中读取
+  try {
+    const metaPath = path.join(rootDir, ".meta.json");
+    const metaContent = await fs.readFile(metaPath, "utf-8");
+    const meta = JSON.parse(metaContent);
+    if (meta && typeof meta.version === "string" && meta.version.trim() && meta.version !== "unknown") {
+      return meta.version.trim();
+    }
+  } catch {
+    // 忽略异常，继续 fallback
+  }
+
+  // 2. 降级到 SKILL.md 提取
+  if (!skillMdContent) {
+    try {
+      skillMdContent = await fs.readFile(path.join(rootDir, "SKILL.md"), "utf-8");
+    } catch {
+      return undefined;
+    }
+  }
+
+  return parseSkillVersion(skillMdContent);
+}
+
+/**
+ * 从 SKILL.md 文本中提取版本号（纯正则、不借助任何模型）。
+ *
+ * 兼容点：
+ *  - 键名：英文 `version` / `Version`（大小写不敏感）、中文 `当前版本号` / `当前版本` / `版本号` / `版本`；
+ *  - 冒号：半角 `:` 或全角 `：`；
+ *  - 取值：去除包裹引号、行尾 ` # 注释`、首尾空白。
+ *
+ * 范围：在整篇 SKILL.md 内按「单独一行」匹配（frontmatter 在最前，故天然优先命中）。
+ * 因要求行首即键名（前面只允许空白），Markdown 标题 `## Version: x`（带 `#` 前缀）不会被误命中。
+ * 取不到返回 undefined（该 skill 不参与版本更新）。
+ */
+export function parseSkillVersion(content: string): string | undefined {
+  const m = /(?:^|\r?\n)[ \t]*(?:version|当前版本号|当前版本|版本号|版本)[ \t]*[:：][ \t]*(.+)/i.exec(content);
+  if (!m) return undefined;
+  const v = m[1]
+    .replace(/\s+#.*$/, "") // 行尾注释
+    .trim()
+    .replace(/^["']|["']$/g, "") // 包裹引号
+    .trim();
+  return v || undefined;
+}