@spzhongwin/skill-logger-plugin 1.0.8 → 1.0.10

package/openclaw.plugin.json

@@ -1,50 +1,50 @@
-{
-  "id": "skill-logger-plugin",
-  "name": "Skill Logger",
-  "description": "追踪 openclaw skill 内功能点（脚本/命令/工具/HTTP）使用与报错，落本地并批量上报",
-  "activation": {
-    "onStartup": true
-  },
-  "configSchema": {
-    "type": "object",
-    "additionalProperties": true,
-    "properties": {
-      "pluginId": {
-        "type": "string",
-        "description": "自定义插件 ID"
-      },
-      "pluginName": {
-        "type": "string",
-        "description": "自定义插件名称"
-      },
-      "platformBaseUrl": {
-        "type": "string",
-        "description": "拉取 skill 标准配置的服务地址；缺省时使用内置静态桩"
-      },
-      "reportBaseUrl": {
-        "type": "string",
-        "description": "批量上报的服务地址；缺省时只落本地、不上报"
-      },
-      "authToken": {
-        "type": "string",
-        "description": "拉取/上报接口的 Authorization 头值（如 'Bearer xxx'）"
-      },
-      "recordUnattributed": {
-        "type": "boolean",
-        "description": "是否记录无法归属到具体功能点的 exec 调用（默认 true）"
-      },
-      "enableFileLog": {
-        "type": "boolean",
-        "description": "是否开启插件专属文件日志（落盘为 skill-logger.err），用于排查 WS 连接和指令运行情况"
-      },
-      "autoUpdateSkills": {
-        "type": "boolean",
-        "description": "是否开启 skill 版本自动更新（检测到本地落后于平台最新版本时下载并覆盖各 workspace 下的副本）；默认开启，仅显式设为 false 才关闭"
-      },
-      "versionCheckIntervalMinutes": {
-        "type": "number",
-        "description": "版本检查+自动更新的周期（分钟）。每隔该周期按本地所有已装 skill 向服务端拉最新版本并按需更新；默认 30。本地扫描发现固定 3 分钟，与此独立"
-      }
-    }
-  }
-}
+{
+  "id": "skill-logger-plugin",
+  "name": "Skill Logger",
+  "description": "追踪 openclaw skill 内功能点（脚本/命令/工具/HTTP）使用与报错，落本地并批量上报",
+  "activation": {
+    "onStartup": true
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": true,
+    "properties": {
+      "pluginId": {
+        "type": "string",
+        "description": "自定义插件 ID"
+      },
+      "pluginName": {
+        "type": "string",
+        "description": "自定义插件名称"
+      },
+      "platformBaseUrl": {
+        "type": "string",
+        "description": "拉取 skill 标准配置的服务地址；缺省时使用内置静态桩"
+      },
+      "reportBaseUrl": {
+        "type": "string",
+        "description": "批量上报的服务地址；缺省时只落本地、不上报"
+      },
+      "authToken": {
+        "type": "string",
+        "description": "拉取/上报接口的 Authorization 头值（如 'Bearer xxx'）"
+      },
+      "recordUnattributed": {
+        "type": "boolean",
+        "description": "是否记录无法归属到具体功能点的 exec 调用（默认 true）"
+      },
+      "enableFileLog": {
+        "type": "boolean",
+        "description": "是否开启插件专属文件日志（落盘为 skill-logger.err），用于排查 WS 连接和指令运行情况"
+      },
+      "autoUpdateSkills": {
+        "type": "boolean",
+        "description": "是否开启 skill 版本自动更新（检测到本地落后于平台最新版本时下载并覆盖各 workspace 下的副本）；默认开启，仅显式设为 false 才关闭"
+      },
+      "versionCheckIntervalMinutes": {
+        "type": "number",
+        "description": "版本检查+自动更新的周期（分钟）。每隔该周期按本地所有已装 skill 向服务端拉最新版本并按需更新；默认 30。本地扫描发现固定 3 分钟，与此独立"
+      }
+    }
+  }
+}

package/package.json

@@ -1,37 +1,37 @@
-{
-  "name": "@spzhongwin/skill-logger-plugin",
-  "version": "1.0.8",
-  "type": "module",
-  "exports": "./dist/index.js",
-  "scripts": {
-    "test": "node --experimental-strip-types --test src/*.test.ts",
-    "typecheck": "tsc --noEmit",
-    "build": "npx esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --external:ws"
-  },
-  "openclaw": {
-    "extensions": [
-      "./dist/index.js"
-    ],
-    "contracts": {
-      "tools": [
-        "report_skill_error"
-      ]
-    },
-    "compat": {
-      "pluginApi": ">=2026.3.28",
-      "minGatewayVersion": "2026.3.28"
-    },
-    "build": {
-      "openclawVersion": "2026.3.28",
-      "pluginSdkVersion": "2026.3.28"
-    }
-  },
-  "devDependencies": {
-    "@types/node": "^22.19.20",
-    "@types/ws": "^8.18.1",
-    "typescript": "^5.9.3"
-  },
-  "dependencies": {
-    "ws": "^8.21.0"
-  }
-}
+{
+  "name": "@spzhongwin/skill-logger-plugin",
+  "version": "1.0.10",
+  "type": "module",
+  "exports": "./dist/index.js",
+  "scripts": {
+    "test": "node --experimental-strip-types --test src/*.test.ts",
+    "typecheck": "tsc --noEmit",
+    "build": "npx esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --external:ws"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "contracts": {
+      "tools": [
+        "report_skill_error"
+      ]
+    },
+    "compat": {
+      "pluginApi": ">=2026.3.28",
+      "minGatewayVersion": "2026.3.28"
+    },
+    "build": {
+      "openclawVersion": "2026.3.28",
+      "pluginSdkVersion": "2026.3.28"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.20",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "ws": "^8.21.0"
+  }
+}

package/src/active-skills.test.ts

@@ -1,32 +1,32 @@
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import { ActiveSkills } from "./active-skills.ts";
-
-describe("ActiveSkills", () => {
-  it("标记并取回激活 skill", () => {
-    const a = new ActiveSkills();
-    a.markActive("s1", "skA");
-    a.markActive("s1", "skB");
-    assert.deepEqual([...a.getActive("s1")].sort(), ["skA", "skB"]);
-    assert.deepEqual([...a.getActive("s2")], []);
-  });
-
-  it("TTL 过期后不再返回", () => {
-    let t = 1000;
-    const a = new ActiveSkills({ ttlMs: 100, now: () => t });
-    a.markActive("s", "skA");
-    t = 1050;
-    assert.deepEqual([...a.getActive("s")], ["skA"]);
-    t = 2000;
-    assert.deepEqual([...a.getActive("s")], []);
-  });
-
-  it("超出 session 上限按 LRU 淘汰最旧", () => {
-    const a = new ActiveSkills({ maxSessions: 2 });
-    a.markActive("s1", "x");
-    a.markActive("s2", "x");
-    a.markActive("s3", "x"); // 淘汰 s1
-    assert.deepEqual([...a.getActive("s1")], []);
-    assert.deepEqual([...a.getActive("s3")], ["x"]);
-  });
-});
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { ActiveSkills } from "./active-skills.ts";
+
+describe("ActiveSkills", () => {
+  it("标记并取回激活 skill", () => {
+    const a = new ActiveSkills();
+    a.markActive("s1", "skA");
+    a.markActive("s1", "skB");
+    assert.deepEqual([...a.getActive("s1")].sort(), ["skA", "skB"]);
+    assert.deepEqual([...a.getActive("s2")], []);
+  });
+
+  it("TTL 过期后不再返回", () => {
+    let t = 1000;
+    const a = new ActiveSkills({ ttlMs: 100, now: () => t });
+    a.markActive("s", "skA");
+    t = 1050;
+    assert.deepEqual([...a.getActive("s")], ["skA"]);
+    t = 2000;
+    assert.deepEqual([...a.getActive("s")], []);
+  });
+
+  it("超出 session 上限按 LRU 淘汰最旧", () => {
+    const a = new ActiveSkills({ maxSessions: 2 });
+    a.markActive("s1", "x");
+    a.markActive("s2", "x");
+    a.markActive("s3", "x"); // 淘汰 s1
+    assert.deepEqual([...a.getActive("s1")], []);
+    assert.deepEqual([...a.getActive("s3")], ["x"]);
+  });
+});

package/src/active-skills.ts

@@ -1,77 +1,77 @@
-/**
- * 按 session 记录「已触发（激活）的 skill」，供 matcher 在通用命令（curl、共享 CLI）
- * 出现多候选时消歧——优先归属到本 session 已激活的 skill。
- *
- * 内存态，带 TTL + 容量上限，防止长跑 gateway 进程里无限增长。
- */
-
-type SkillEntry = { name: string; ts: number };
-
-const DEFAULT_TTL_MS = 30 * 60 * 1000; // 30 分钟
-const DEFAULT_MAX_SESSIONS = 500;
-
-export type ActiveSkillsOptions = {
-  ttlMs?: number;
-  maxSessions?: number;
-  /** 注入时钟，便于测试。 */
-  now?: () => number;
-};
-
-export class ActiveSkills {
-  private readonly ttlMs: number;
-  private readonly maxSessions: number;
-  private readonly now: () => number;
-  /** sessionKey -> (skillName -> entry)。用 Map 保留插入顺序以便 LRU 淘汰。 */
-  private readonly bySession = new Map<string, Map<string, SkillEntry>>();
-
-  constructor(opts: ActiveSkillsOptions = {}) {
-    this.ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
-    this.maxSessions = opts.maxSessions ?? DEFAULT_MAX_SESSIONS;
-    this.now = opts.now ?? Date.now;
-  }
-
-  /** 标记某 session 触发了某 skill。 */
-  markActive(sessionKey: string | undefined, skillName: string): void {
-    const key = sessionKey || "__nosession__";
-    let skills = this.bySession.get(key);
-    if (!skills) {
-      skills = new Map();
-      this.bySession.set(key, skills);
-    } else {
-      // 触碰即刷新 LRU 顺序
-      this.bySession.delete(key);
-      this.bySession.set(key, skills);
-    }
-    skills.set(skillName, { name: skillName, ts: this.now() });
-    this.evictIfNeeded();
-  }
-
-  /** 取某 session 当前仍在 TTL 内的已激活 skill 集合。 */
-  getActive(sessionKey: string | undefined): Set<string> {
-    const key = sessionKey || "__nosession__";
-    const skills = this.bySession.get(key);
-    const out = new Set<string>();
-    if (!skills) return out;
-    const cutoff = this.now() - this.ttlMs;
-    for (const [name, entry] of skills) {
-      if (entry.ts >= cutoff) out.add(name);
-      else skills.delete(name);
-    }
-    if (skills.size === 0) this.bySession.delete(key);
-    return out;
-  }
-
-  /** session 结束时清掉其激活记录（释放内存 + 避免跨会话误判）。 */
-  clearSession(sessionKey: string | undefined): void {
-    this.bySession.delete(sessionKey || "__nosession__");
-  }
-
-  /** 超出 session 上限时，按 LRU 淘汰最旧的 session。 */
-  private evictIfNeeded(): void {
-    while (this.bySession.size > this.maxSessions) {
-      const oldest = this.bySession.keys().next().value;
-      if (oldest === undefined) break;
-      this.bySession.delete(oldest);
-    }
-  }
-}
+/**
+ * 按 session 记录「已触发（激活）的 skill」，供 matcher 在通用命令（curl、共享 CLI）
+ * 出现多候选时消歧——优先归属到本 session 已激活的 skill。
+ *
+ * 内存态，带 TTL + 容量上限，防止长跑 gateway 进程里无限增长。
+ */
+
+type SkillEntry = { name: string; ts: number };
+
+const DEFAULT_TTL_MS = 30 * 60 * 1000; // 30 分钟
+const DEFAULT_MAX_SESSIONS = 500;
+
+export type ActiveSkillsOptions = {
+  ttlMs?: number;
+  maxSessions?: number;
+  /** 注入时钟，便于测试。 */
+  now?: () => number;
+};
+
+export class ActiveSkills {
+  private readonly ttlMs: number;
+  private readonly maxSessions: number;
+  private readonly now: () => number;
+  /** sessionKey -> (skillName -> entry)。用 Map 保留插入顺序以便 LRU 淘汰。 */
+  private readonly bySession = new Map<string, Map<string, SkillEntry>>();
+
+  constructor(opts: ActiveSkillsOptions = {}) {
+    this.ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
+    this.maxSessions = opts.maxSessions ?? DEFAULT_MAX_SESSIONS;
+    this.now = opts.now ?? Date.now;
+  }
+
+  /** 标记某 session 触发了某 skill。 */
+  markActive(sessionKey: string | undefined, skillName: string): void {
+    const key = sessionKey || "__nosession__";
+    let skills = this.bySession.get(key);
+    if (!skills) {
+      skills = new Map();
+      this.bySession.set(key, skills);
+    } else {
+      // 触碰即刷新 LRU 顺序
+      this.bySession.delete(key);
+      this.bySession.set(key, skills);
+    }
+    skills.set(skillName, { name: skillName, ts: this.now() });
+    this.evictIfNeeded();
+  }
+
+  /** 取某 session 当前仍在 TTL 内的已激活 skill 集合。 */
+  getActive(sessionKey: string | undefined): Set<string> {
+    const key = sessionKey || "__nosession__";
+    const skills = this.bySession.get(key);
+    const out = new Set<string>();
+    if (!skills) return out;
+    const cutoff = this.now() - this.ttlMs;
+    for (const [name, entry] of skills) {
+      if (entry.ts >= cutoff) out.add(name);
+      else skills.delete(name);
+    }
+    if (skills.size === 0) this.bySession.delete(key);
+    return out;
+  }
+
+  /** session 结束时清掉其激活记录（释放内存 + 避免跨会话误判）。 */
+  clearSession(sessionKey: string | undefined): void {
+    this.bySession.delete(sessionKey || "__nosession__");
+  }
+
+  /** 超出 session 上限时，按 LRU 淘汰最旧的 session。 */
+  private evictIfNeeded(): void {
+    while (this.bySession.size > this.maxSessions) {
+      const oldest = this.bySession.keys().next().value;
+      if (oldest === undefined) break;
+      this.bySession.delete(oldest);
+    }
+  }
+}