@spzhongwin/skill-logger-plugin 1.0.11 → 1.0.13

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);
+    }
+  }
+}

package/src/config-sync.test.ts

@@ -1,165 +1,165 @@
-import { describe, it, beforeEach, afterEach } from "node:test";
-import assert from "node:assert/strict";
-import fs from "node:fs/promises";
-import path from "node:path";
-import os from "node:os";
-import { ConfigSync, parseSkillVersion } from "./config-sync.ts";
-import type { SkillStandardConfig } from "./types.ts";
-
-let dir: string;
-let extensionsDir: string;
-let syncStatePath: string;
-
-const sampleConfigs: SkillStandardConfig[] = [
-  { skillName: "foo", version: "1", functions: [{ id: "run", name: "运行", match: { type: "script", script: "scripts/run.py" } }] },
-  { skillName: "bar", version: "1", functions: [{ id: "x", name: "x", match: { type: "tool", toolName: "bar_x" } }] },
-];
-
-async function writeSkill(name: string, withScripts = true): Promise<void> {
-  const skillDir = path.join(extensionsDir, "myext", "skills", name);
-  await fs.mkdir(skillDir, { recursive: true });
-  await fs.writeFile(path.join(skillDir, "SKILL.md"), `---\nname: ${name}\n---\n# ${name}\n`);
-  if (withScripts) {
-    await fs.mkdir(path.join(skillDir, "scripts"), { recursive: true });
-    await fs.writeFile(path.join(skillDir, "scripts", "run.py"), "print(1)\n");
-  }
-}
-
-function makeSync() {
-  return new ConfigSync({
-    paths: { extensionsDir, syncStatePath, openclawConfigPath: path.join(dir, "openclaw.json") },
-    getConfig: () => ({}), // 无 platformBaseUrl → 用静态桩
-    sampleConfigs,
-    // 测试注入固定扫描目录，跳过 openclaw.json 解析；skill 实际写在 extensionsDir 下。
-    resolveSkillDirs: () => [path.join(os.tmpdir(), "openclaw-test-skills")],
-  });
-}
-
-beforeEach(async () => {
-  dir = path.join(os.tmpdir(), `slp-sync-${Date.now()}-${Math.random().toString(36).slice(2)}`);
-  extensionsDir = path.join(dir, "extensions");
-  syncStatePath = path.join(dir, "sync.json");
-  await fs.mkdir(extensionsDir, { recursive: true });
-});
-
-afterEach(async () => {
-  await fs.rm(dir, { recursive: true, force: true });
-});
-
-describe("parseSkillVersion（中英文兼容、纯正则）", () => {
-  const fm = (body: string) => `---\n${body}\n---\n# skill\n`;
-  it("英文 version", () => assert.equal(parseSkillVersion(fm("name: x\nversion: 1.2.3")), "1.2.3"));
-  it("大写 Version", () => assert.equal(parseSkillVersion(fm("Version: 2.0.0")), "2.0.0"));
-  it("中文 版本号 + 全角冒号", () => assert.equal(parseSkillVersion(fm("版本号：3.1")), "3.1"));
-  it("中文 版本 + 半角冒号", () => assert.equal(parseSkillVersion(fm("版本: v4")), "v4"));
-  it("去除包裹引号", () => assert.equal(parseSkillVersion(fm('version: "1.0.0"')), "1.0.0"));
-  it("去除行尾注释", () => assert.equal(parseSkillVersion(fm("version: 1.0.0  # latest")), "1.0.0"));
-  it("无版本字段返回 undefined", () => assert.equal(parseSkillVersion(fm("name: x")), undefined));
-  it("无 frontmatter 时全文宽松查找", () => assert.equal(parseSkillVersion("版本号: 9.9\n正文"), "9.9"));
-  it("版本写在正文单独一行 → 能取到", () =>
-    assert.equal(parseSkillVersion(fm("name: x") + "\n版本号：7.7\n"), "7.7"));
-  it("Markdown 标题 ## Version 不误取（# 前缀）", () =>
-    assert.equal(parseSkillVersion(fm("name: x") + "\n## Version: 5.5\n"), undefined));
-  it("frontmatter 与正文都有版本 → frontmatter 优先", () =>
-    assert.equal(parseSkillVersion(fm("version: 1.0.0") + "\nversion: 2.0.0\n"), "1.0.0"));
-});
-
-describe("ConfigSync.scanInstalledSkills", () => {
-  it("扫描出 SKILL.md 并解析 name", async () => {
-    await writeSkill("foo");
-    const skills = await makeSync().scanInstalledSkills();
-    const foo = skills.find((s) => s.name === "foo");
-    assert.ok(foo);
-    assert.ok(foo!.signature.length > 0);
-  });
-
-  it("跳过 node_modules", async () => {
-    const nm = path.join(extensionsDir, "myext", "node_modules", "pkg", "skills", "ghost");
-    await fs.mkdir(nm, { recursive: true });
-    await fs.writeFile(path.join(nm, "SKILL.md"), `---\nname: ghost\n---\n`);
-    const skills = await makeSync().scanInstalledSkills();
-    assert.equal(skills.find((s) => s.name === "ghost"), undefined);
-  });
-});
-
-describe("ConfigSync.diffAgainstState", () => {
-  it("初次全部需拉取", async () => {
-    await writeSkill("foo");
-    const cs = makeSync();
-    const installed = await cs.scanInstalledSkills();
-    const { toFetch } = cs.diffAgainstState(installed);
-    assert.equal(toFetch.length, 1);
-    assert.equal(toFetch[0].name, "foo");
-  });
-});
-
-describe("ConfigSync.pullConfigs（静态桩）", () => {
-  it("仅返回请求到的 skill（ok=true）", async () => {
-    const got = await makeSync().pullConfigs([{ name: "foo" }]);
-    assert.equal(got.ok, true);
-    assert.equal(got.configs.length, 1);
-    assert.equal(got.configs[0].skillName, "foo");
-  });
-});
-
-describe("ConfigSync 多 workspace 映射与过期检测", () => {
-  async function writeSkillIn(wsDir: string, name: string, version: string): Promise<string> {
-    const skillDir = path.join(wsDir, "skills", name);
-    await fs.mkdir(skillDir, { recursive: true });
-    await fs.writeFile(path.join(skillDir, "SKILL.md"), `---\nname: ${name}\nversion: ${version}\n---\n`);
-    return skillDir;
-  }
-
-  it("同名 skill 在多个 workspace → 映射记录全部副本，去重后只返回一份", async () => {
-    const wsA = path.join(dir, "workspace-a");
-    const wsB = path.join(dir, "workspace-b");
-    await writeSkillIn(wsA, "demo", "1.0.0");
-    await writeSkillIn(wsB, "demo", "1.0.0");
-    const cs = new ConfigSync({
-      paths: { extensionsDir, syncStatePath, openclawConfigPath: path.join(dir, "openclaw.json") },
-      getConfig: () => ({}),
-      sampleConfigs,
-      resolveSkillDirs: () => [path.join(wsA, "skills"), path.join(wsB, "skills")],
-    });
-    const list = await cs.scanInstalledSkills();
-    assert.equal(list.filter((s) => s.name === "demo").length, 1); // 去重
-    assert.equal(cs.getInstallations().get("demo")?.length, 2); // 映射保留两份
-  });
-
-  it("detectOutdated：本地版本落后于平台最新版本时被标记", async () => {
-    const wsA = path.join(dir, "workspace-a");
-    await writeSkillIn(wsA, "demo", "1.0.0");
-    const cs = new ConfigSync({
-      paths: { extensionsDir, syncStatePath, openclawConfigPath: path.join(dir, "openclaw.json") },
-      getConfig: () => ({}),
-      // 平台最新版本 2.0.0（桩无 latestVersion 字段 → 回退用 version 当最新）
-      sampleConfigs: [{ skillName: "demo", version: "2.0.0", functions: [] }],
-      resolveSkillDirs: () => [path.join(wsA, "skills")],
-    });
-    await cs.checkVersionsAndUpdate(); // 刷新 latestVersions + 检测（无 updater 注入则不覆盖文件）
-    const outdated = cs.detectOutdated();
-    assert.equal(outdated.length, 1);
-    assert.equal(outdated[0].skillName, "demo");
-    assert.equal(outdated[0].localVersion, "1.0.0");
-    assert.equal(outdated[0].latestVersion, "2.0.0");
-
-    // agent↔skill 映射应本地持久化到 sync.json
-    const state = JSON.parse(await fs.readFile(syncStatePath, "utf-8"));
-    assert.ok(state.installations.demo, "sync.json 应含 installations 映射");
-    assert.equal(state.installations.demo[0].version, "1.0.0");
-  });
-});
-
-describe("ConfigSync.reconcile 端到端", () => {
-  it("对账后索引含该 skill 功能点，并持久化", async () => {
-    await writeSkill("foo");
-    const cs = makeSync();
-    await cs.reconcile();
-    // foo 的 run.py 应进入 script 索引
-    assert.ok(cs.getIndex().scriptByBasename.has("run.py"));
-    // 持久化文件存在且含 foo
-    const state = JSON.parse(await fs.readFile(syncStatePath, "utf-8"));
-    assert.ok(state.active.foo);
-    assert.ok(state.configPool["foo@unknown"]);
-  });
-});
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+import { ConfigSync, parseSkillVersion } from "./config-sync.ts";
+import type { SkillStandardConfig } from "./types.ts";
+
+let dir: string;
+let extensionsDir: string;
+let syncStatePath: string;
+
+const sampleConfigs: SkillStandardConfig[] = [
+  { skillName: "foo", version: "1", functions: [{ id: "run", name: "运行", match: { type: "script", script: "scripts/run.py" } }] },
+  { skillName: "bar", version: "1", functions: [{ id: "x", name: "x", match: { type: "tool", toolName: "bar_x" } }] },
+];
+
+async function writeSkill(name: string, withScripts = true): Promise<void> {
+  const skillDir = path.join(extensionsDir, "myext", "skills", name);
+  await fs.mkdir(skillDir, { recursive: true });
+  await fs.writeFile(path.join(skillDir, "SKILL.md"), `---\nname: ${name}\n---\n# ${name}\n`);
+  if (withScripts) {
+    await fs.mkdir(path.join(skillDir, "scripts"), { recursive: true });
+    await fs.writeFile(path.join(skillDir, "scripts", "run.py"), "print(1)\n");
+  }
+}
+
+function makeSync() {
+  return new ConfigSync({
+    paths: { extensionsDir, syncStatePath, openclawConfigPath: path.join(dir, "openclaw.json") },
+    getConfig: () => ({}), // 无 platformBaseUrl → 用静态桩
+    sampleConfigs,
+    // 测试注入固定扫描目录，跳过 openclaw.json 解析；skill 实际写在 extensionsDir 下。
+    resolveSkillDirs: () => [path.join(os.tmpdir(), "openclaw-test-skills")],
+  });
+}
+
+beforeEach(async () => {
+  dir = path.join(os.tmpdir(), `slp-sync-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+  extensionsDir = path.join(dir, "extensions");
+  syncStatePath = path.join(dir, "sync.json");
+  await fs.mkdir(extensionsDir, { recursive: true });
+});
+
+afterEach(async () => {
+  await fs.rm(dir, { recursive: true, force: true });
+});
+
+describe("parseSkillVersion（中英文兼容、纯正则）", () => {
+  const fm = (body: string) => `---\n${body}\n---\n# skill\n`;
+  it("英文 version", () => assert.equal(parseSkillVersion(fm("name: x\nversion: 1.2.3")), "1.2.3"));
+  it("大写 Version", () => assert.equal(parseSkillVersion(fm("Version: 2.0.0")), "2.0.0"));
+  it("中文 版本号 + 全角冒号", () => assert.equal(parseSkillVersion(fm("版本号：3.1")), "3.1"));
+  it("中文 版本 + 半角冒号", () => assert.equal(parseSkillVersion(fm("版本: v4")), "v4"));
+  it("去除包裹引号", () => assert.equal(parseSkillVersion(fm('version: "1.0.0"')), "1.0.0"));
+  it("去除行尾注释", () => assert.equal(parseSkillVersion(fm("version: 1.0.0  # latest")), "1.0.0"));
+  it("无版本字段返回 undefined", () => assert.equal(parseSkillVersion(fm("name: x")), undefined));
+  it("无 frontmatter 时全文宽松查找", () => assert.equal(parseSkillVersion("版本号: 9.9\n正文"), "9.9"));
+  it("版本写在正文单独一行 → 能取到", () =>
+    assert.equal(parseSkillVersion(fm("name: x") + "\n版本号：7.7\n"), "7.7"));
+  it("Markdown 标题 ## Version 不误取（# 前缀）", () =>
+    assert.equal(parseSkillVersion(fm("name: x") + "\n## Version: 5.5\n"), undefined));
+  it("frontmatter 与正文都有版本 → frontmatter 优先", () =>
+    assert.equal(parseSkillVersion(fm("version: 1.0.0") + "\nversion: 2.0.0\n"), "1.0.0"));
+});
+
+describe("ConfigSync.scanInstalledSkills", () => {
+  it("扫描出 SKILL.md 并解析 name", async () => {
+    await writeSkill("foo");
+    const skills = await makeSync().scanInstalledSkills();
+    const foo = skills.find((s) => s.name === "foo");
+    assert.ok(foo);
+    assert.ok(foo!.signature.length > 0);
+  });
+
+  it("跳过 node_modules", async () => {
+    const nm = path.join(extensionsDir, "myext", "node_modules", "pkg", "skills", "ghost");
+    await fs.mkdir(nm, { recursive: true });
+    await fs.writeFile(path.join(nm, "SKILL.md"), `---\nname: ghost\n---\n`);
+    const skills = await makeSync().scanInstalledSkills();
+    assert.equal(skills.find((s) => s.name === "ghost"), undefined);
+  });
+});
+
+describe("ConfigSync.diffAgainstState", () => {
+  it("初次全部需拉取", async () => {
+    await writeSkill("foo");
+    const cs = makeSync();
+    const installed = await cs.scanInstalledSkills();
+    const { toFetch } = cs.diffAgainstState(installed);
+    assert.equal(toFetch.length, 1);
+    assert.equal(toFetch[0].name, "foo");
+  });
+});
+
+describe("ConfigSync.pullConfigs（静态桩）", () => {
+  it("仅返回请求到的 skill（ok=true）", async () => {
+    const got = await makeSync().pullConfigs([{ name: "foo" }]);
+    assert.equal(got.ok, true);
+    assert.equal(got.configs.length, 1);
+    assert.equal(got.configs[0].skillName, "foo");
+  });
+});
+
+describe("ConfigSync 多 workspace 映射与过期检测", () => {
+  async function writeSkillIn(wsDir: string, name: string, version: string): Promise<string> {
+    const skillDir = path.join(wsDir, "skills", name);
+    await fs.mkdir(skillDir, { recursive: true });
+    await fs.writeFile(path.join(skillDir, "SKILL.md"), `---\nname: ${name}\nversion: ${version}\n---\n`);
+    return skillDir;
+  }
+
+  it("同名 skill 在多个 workspace → 映射记录全部副本，去重后只返回一份", async () => {
+    const wsA = path.join(dir, "workspace-a");
+    const wsB = path.join(dir, "workspace-b");
+    await writeSkillIn(wsA, "demo", "1.0.0");
+    await writeSkillIn(wsB, "demo", "1.0.0");
+    const cs = new ConfigSync({
+      paths: { extensionsDir, syncStatePath, openclawConfigPath: path.join(dir, "openclaw.json") },
+      getConfig: () => ({}),
+      sampleConfigs,
+      resolveSkillDirs: () => [path.join(wsA, "skills"), path.join(wsB, "skills")],
+    });
+    const list = await cs.scanInstalledSkills();
+    assert.equal(list.filter((s) => s.name === "demo").length, 1); // 去重
+    assert.equal(cs.getInstallations().get("demo")?.length, 2); // 映射保留两份
+  });
+
+  it("detectOutdated：本地版本落后于平台最新版本时被标记", async () => {
+    const wsA = path.join(dir, "workspace-a");
+    await writeSkillIn(wsA, "demo", "1.0.0");
+    const cs = new ConfigSync({
+      paths: { extensionsDir, syncStatePath, openclawConfigPath: path.join(dir, "openclaw.json") },
+      getConfig: () => ({}),
+      // 平台最新版本 2.0.0（桩无 latestVersion 字段 → 回退用 version 当最新）
+      sampleConfigs: [{ skillName: "demo", version: "2.0.0", functions: [] }],
+      resolveSkillDirs: () => [path.join(wsA, "skills")],
+    });
+    await cs.checkVersionsAndUpdate(); // 刷新 latestVersions + 检测（无 updater 注入则不覆盖文件）
+    const outdated = cs.detectOutdated();
+    assert.equal(outdated.length, 1);
+    assert.equal(outdated[0].skillName, "demo");
+    assert.equal(outdated[0].localVersion, "1.0.0");
+    assert.equal(outdated[0].latestVersion, "2.0.0");
+
+    // agent↔skill 映射应本地持久化到 sync.json
+    const state = JSON.parse(await fs.readFile(syncStatePath, "utf-8"));
+    assert.ok(state.installations.demo, "sync.json 应含 installations 映射");
+    assert.equal(state.installations.demo[0].version, "1.0.0");
+  });
+});
+
+describe("ConfigSync.reconcile 端到端", () => {
+  it("对账后索引含该 skill 功能点，并持久化", async () => {
+    await writeSkill("foo");
+    const cs = makeSync();
+    await cs.reconcile();
+    // foo 的 run.py 应进入 script 索引
+    assert.ok(cs.getIndex().scriptByBasename.has("run.py"));
+    // 持久化文件存在且含 foo
+    const state = JSON.parse(await fs.readFile(syncStatePath, "utf-8"));
+    assert.ok(state.active.foo);
+    assert.ok(state.configPool["foo@unknown"]);
+  });
+});