✨ Skill 系统：version 字段、URL 分发机制、更新检查

- Skill 支持 version 字段（SkillSummary/SkillMetadata/SkillRecord）
- 新增 URL 安装流程：以 SKILL.cat.md 为入口，按相对路径 fetch scripts/references
- 新增更新检查机制：checkForUpdates/updateSkill，基于 semver 比较
- SKILL.cat.md 优先于 SKILL.md（parseSkillZip 兼容）
- DNR 拦截 .cat.md URL，安装页自动识别并走 URL 安装流程
- SkillInstallView 展示 version 和 installUrl
- AgentSkills 页面支持 URL 安装输入和批量检查更新
- 8 个语言文件新增 i18n keys
- 新增单元测试覆盖 version/URL 安装/更新检查

Author: CodFrm

src/app/repo/skill_repo.ts

@@ -86,11 +86,14 @@ export class SkillRepo extends OPFSRepo {
     const summary: SkillSummary = {
       name: record.name,
       description: record.description,
+      ...(record.version ? { version: record.version } : {}),
       toolNames: record.toolNames,
       referenceNames: record.referenceNames,
       ...(record.config && Object.keys(record.config).length > 0 ? { hasConfig: true } : {}),
       // 保留已有的 enabled 状态
       ...(idx >= 0 && registry[idx].enabled !== undefined ? { enabled: registry[idx].enabled } : {}),
+      // 保留或更新 installUrl
+      ...(record.installUrl ? { installUrl: record.installUrl } : idx >= 0 && registry[idx].installUrl ? { installUrl: registry[idx].installUrl } : {}),
       installtime: record.installtime,
       updatetime: record.updatetime,
     };

src/app/service/agent/core/types.ts

@@ -284,18 +284,23 @@ export type SkillConfigField = {
 export type SkillSummary = {
   name: string;
   description: string;
+  version?: string; // 语义化版本号
   toolNames: string[]; // 随 Skill 打包的脚本名称（scripts/ 目录下）
   referenceNames: string[]; // 参考资料名称（references/ 目录下）
   hasConfig?: boolean; // 是否有 config 字段声明
   enabled?: boolean; // 是否启用，默认 true（undefined 视为 true）
+  installUrl?: string; // 安装来源 URL（用于检查更新）
   installtime: number;
   updatetime: number;
 };
 
-// SKILL.md frontmatter 解析结果
+// SKILL.cat.md frontmatter 解析结果
 export type SkillMetadata = {
   name: string;
   description: string;
+  version?: string; // 语义化版本号
+  scripts?: string[]; // 脚本文件名列表（URL 安装时按相对路径获取）
+  references?: string[]; // 参考资料文件名列表
   config?: Record<string, SkillConfigField>;
 };
 

src/app/service/agent/service_worker/agent.ts

@@ -165,11 +165,15 @@ export class AgentService {
     this.group.on("saveSkillConfig", (params: { name: string; values: Record<string, unknown> }) =>
       this.skillService.skillRepo.saveConfigValues(params.name, params.values)
     );
-    // Skill ZIP 安装页面相关消息
+    // Skill 安装页面相关消息
     this.group.on("prepareSkillInstall", (zipBase64: string) => this.prepareSkillInstall(zipBase64));
+    this.group.on("prepareSkillFromUrl", (url: string) => this.skillService.prepareSkillFromUrl(url));
     this.group.on("getSkillInstallData", (uuid: string) => this.getSkillInstallData(uuid));
     this.group.on("completeSkillInstall", (uuid: string) => this.completeSkillInstall(uuid));
     this.group.on("cancelSkillInstall", (uuid: string) => this.cancelSkillInstall(uuid));
+    // Skill 更新检查
+    this.group.on("checkForUpdates", () => this.skillService.checkForUpdates());
+    this.group.on("updateSkill", (name: string) => this.skillService.updateSkill(name));
     // Model CRUD 及摘要模型 API（委托给 AgentModelService）
     this.modelService.init();
     // MCP API（供 Options UI 调用，复用已有的 handleMCPApi）
@@ -268,14 +272,15 @@ export class AgentService {
     return this.skillService.prepareSkillInstall(zipBase64);
   }
 
-  // 获取缓存的 Skill ZIP 数据并解析
+  // 获取缓存的 Skill 安装数据并解析
   async getSkillInstallData(uuid: string): Promise<{
     skillMd: string;
     metadata: SkillMetadata;
     prompt: string;
     scripts: Array<{ name: string; code: string }>;
     references: Array<{ name: string; content: string }>;
     isUpdate: boolean;
+    installUrl?: string;
   }> {
     return this.skillService.getSkillInstallData(uuid);
   }

src/app/service/agent/service_worker/skill.test.ts

@@ -387,7 +387,7 @@ Updated prompt.`;
     it("无效 SKILL.md 应抛出异常", async () => {
       const { service } = createTestService();
 
-      await expect(service.installSkill("not valid skill md")).rejects.toThrow("Invalid SKILL.md");
+      await expect(service.installSkill("not valid skill md")).rejects.toThrow("Invalid SKILL.cat.md");
     });
 
     it("含无效 Skill Script 时应抛出异常", async () => {
@@ -511,4 +511,246 @@ return query;`;
       expect(record.referenceNames).toEqual([]);
     });
   });
+
+  describe("installSkill version 和 installUrl", () => {
+    it("应正确保存 version 字段", async () => {
+      const { service, mockSkillRepo } = createTestService();
+
+      const skillMd = `---
+name: versioned
+description: test
+version: 1.2.3
+---
+Prompt.`;
+
+      const record = await (service as any).skillService.installSkill(skillMd);
+      expect(record.version).toBe("1.2.3");
+      expect(mockSkillRepo.saveSkill.mock.calls[0][0].version).toBe("1.2.3");
+    });
+
+    it("应正确保存 installUrl", async () => {
+      const { service, mockSkillRepo } = createTestService();
+
+      const skillMd = `---
+name: from-url
+description: test
+version: 1.0.0
+---
+Prompt.`;
+      const url = "https://example.com/skills/test/SKILL.cat.md";
+
+      const record = await (service as any).skillService.installSkill(skillMd, undefined, undefined, url);
+      expect(record.installUrl).toBe(url);
+      expect(mockSkillRepo.saveSkill.mock.calls[0][0].installUrl).toBe(url);
+    });
+
+    it("无 version 时 record.version 应为 undefined", async () => {
+      const { service } = createTestService();
+
+      const skillMd = `---
+name: no-ver
+description: test
+---
+Prompt.`;
+
+      const record = await (service as any).skillService.installSkill(skillMd);
+      expect(record.version).toBeUndefined();
+    });
+  });
+
+  describe("installFromUrl", () => {
+    it("应从 URL 获取 SKILL.cat.md 并安装", async () => {
+      const { service, mockSkillRepo } = createTestService();
+
+      const skillMd = `---
+name: remote-skill
+description: Remote skill
+version: 2.0.0
+scripts:
+  - helper.js
+references:
+  - docs.md
+---
+Remote prompt.`;
+
+      const scriptCode = VALID_SKILLSCRIPT_CODE;
+      const refContent = "# Docs\nSome docs.";
+
+      const fetchSpy = vi.spyOn(globalThis, "fetch").mockImplementation(async (url) => {
+        const urlStr = typeof url === "string" ? url : url.toString();
+        if (urlStr.endsWith("SKILL.cat.md")) {
+          return { ok: true, text: async () => skillMd } as Response;
+        }
+        if (urlStr.includes("scripts/helper.js")) {
+          return { ok: true, text: async () => scriptCode } as Response;
+        }
+        if (urlStr.includes("references/docs.md")) {
+          return { ok: true, text: async () => refContent } as Response;
+        }
+        return { ok: false, status: 404, statusText: "Not Found" } as Response;
+      });
+
+      try {
+        const record = await (service as any).skillService.installFromUrl(
+          "https://example.com/skills/test/SKILL.cat.md"
+        );
+
+        expect(record.name).toBe("remote-skill");
+        expect(record.version).toBe("2.0.0");
+        expect(record.installUrl).toBe("https://example.com/skills/test/SKILL.cat.md");
+        expect(record.toolNames).toEqual(["test-tool"]);
+        expect(record.referenceNames).toEqual(["docs.md"]);
+
+        // 验证 fetch 调用了正确的相对路径
+        expect(fetchSpy).toHaveBeenCalledTimes(3);
+        const urls = fetchSpy.mock.calls.map((c) => (typeof c[0] === "string" ? c[0] : c[0].toString()));
+        expect(urls).toContain("https://example.com/skills/test/SKILL.cat.md");
+        expect(urls).toContain("https://example.com/skills/test/scripts/helper.js");
+        expect(urls).toContain("https://example.com/skills/test/references/docs.md");
+      } finally {
+        fetchSpy.mockRestore();
+      }
+    });
+
+    it("SKILL.cat.md 获取失败时应抛错", async () => {
+      const { service } = createTestService();
+
+      const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue({
+        ok: false,
+        status: 404,
+        statusText: "Not Found",
+      } as Response);
+
+      try {
+        await expect(
+          (service as any).skillService.installFromUrl("https://example.com/not-found.cat.md")
+        ).rejects.toThrow("Failed to fetch");
+      } finally {
+        fetchSpy.mockRestore();
+      }
+    });
+  });
+
+  describe("checkForUpdates / updateSkill", () => {
+    it("远程版本更高时应返回更新信息", async () => {
+      const { service, mockSkillRepo } = createTestService();
+
+      const skillList = [{ name: "updatable", version: "1.0.0", installUrl: "https://example.com/SKILL.cat.md" }];
+      mockSkillRepo.listSkills.mockResolvedValue(skillList);
+
+      const remoteMd = `---
+name: updatable
+description: test
+version: 2.0.0
+---
+Updated prompt.`;
+
+      const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue({
+        ok: true,
+        text: async () => remoteMd,
+      } as Response);
+
+      try {
+        const updates = await (service as any).skillService.checkForUpdates();
+        expect(updates).toHaveLength(1);
+        expect(updates[0].name).toBe("updatable");
+        expect(updates[0].currentVersion).toBe("1.0.0");
+        expect(updates[0].remoteVersion).toBe("2.0.0");
+      } finally {
+        fetchSpy.mockRestore();
+      }
+    });
+
+    it("远程版本相同或更低时不返回更新", async () => {
+      const { service, mockSkillRepo } = createTestService();
+
+      mockSkillRepo.listSkills.mockResolvedValue([
+        { name: "up-to-date", version: "2.0.0", installUrl: "https://example.com/SKILL.cat.md" },
+      ]);
+
+      const remoteMd = `---
+name: up-to-date
+description: test
+version: 2.0.0
+---
+Same prompt.`;
+
+      const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue({
+        ok: true,
+        text: async () => remoteMd,
+      } as Response);
+
+      try {
+        const updates = await (service as any).skillService.checkForUpdates();
+        expect(updates).toHaveLength(0);
+      } finally {
+        fetchSpy.mockRestore();
+      }
+    });
+
+    it("无 installUrl 的 Skill 不参与更新检查", async () => {
+      const { service, mockSkillRepo } = createTestService();
+
+      mockSkillRepo.listSkills.mockResolvedValue([
+        { name: "local-only", version: "1.0.0" },
+        { name: "no-version", installUrl: "https://example.com/SKILL.cat.md" },
+      ]);
+
+      const updates = await (service as any).skillService.checkForUpdates();
+      expect(updates).toHaveLength(0);
+    });
+
+    it("网络错误时静默忽略", async () => {
+      const { service, mockSkillRepo } = createTestService();
+
+      mockSkillRepo.listSkills.mockResolvedValue([
+        { name: "net-err", version: "1.0.0", installUrl: "https://example.com/SKILL.cat.md" },
+      ]);
+
+      const fetchSpy = vi.spyOn(globalThis, "fetch").mockRejectedValue(new Error("Network error"));
+
+      try {
+        const updates = await (service as any).skillService.checkForUpdates();
+        expect(updates).toHaveLength(0);
+      } finally {
+        fetchSpy.mockRestore();
+      }
+    });
+
+    it("updateSkill 应从 installUrl 重新安装", async () => {
+      const { service, mockSkillRepo } = createTestService();
+
+      const url = "https://example.com/skills/test/SKILL.cat.md";
+      mockSkillRepo.listSkills.mockResolvedValue([{ name: "to-update", version: "1.0.0", installUrl: url }]);
+
+      const remoteMd = `---
+name: to-update
+description: updated
+version: 2.0.0
+---
+Updated.`;
+
+      const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue({
+        ok: true,
+        text: async () => remoteMd,
+      } as Response);
+
+      try {
+        const record = await (service as any).skillService.updateSkill("to-update");
+        expect(record.name).toBe("to-update");
+        expect(record.version).toBe("2.0.0");
+        expect(record.installUrl).toBe(url);
+      } finally {
+        fetchSpy.mockRestore();
+      }
+    });
+
+    it("无 installUrl 的 Skill 调用 updateSkill 应抛错", async () => {
+      const { service, mockSkillRepo } = createTestService();
+
+      mockSkillRepo.listSkills.mockResolvedValue([{ name: "local-only", version: "1.0.0" }]);
+
+      await expect((service as any).skillService.updateSkill("local-only")).rejects.toThrow("no install URL");
+    });
+  });
 });