@winspan/claude-forge 0.1.1

package/dist/resume/index.js

@@ -0,0 +1,142 @@
+import fs from 'fs';
+import path from 'path';
+import { SessionStateMachine } from './state-machine.js';
+import { ResumeContextGenerator } from './context-gen.js';
+import { MutexLock } from '../utils/mutex-lock.js';
+import { logger } from '../utils/logger.js';
+const RESUME_START = '<!-- forge:resume -->';
+const RESUME_END = '<!-- forge:end-resume -->';
+export class ResumeEngine {
+    storage;
+    stateMachine;
+    contextGen;
+    maxAgeDays;
+    lastSaveTime = new Map(); // projectPath → timestamp
+    saveCooldownMs = 3 * 60 * 1000; // 3 分钟冷却
+    writeLock = new MutexLock('Resume');
+    constructor(storage, api, timeoutMinutes = 10, maxAgeDays = 7) {
+        this.storage = storage;
+        this.stateMachine = new SessionStateMachine(storage, timeoutMinutes);
+        this.contextGen = new ResumeContextGenerator(storage, api);
+        this.maxAgeDays = maxAgeDays;
+    }
+    /**
+     * 会话结束时调用：立即生成续接摘要并保存，下次进来直接可用
+     */
+    async saveOnStop(sessionId, projectPath) {
+        const session = this.storage.getSession(sessionId, projectPath);
+        if (!session || session.event_count < 3) {
+            return;
+        }
+        logger.info(`正在为会话 ${sessionId} 生成续接快照`);
+        await this.writeLock.runExclusive(projectPath, async () => {
+            const context = await this.contextGen.generate(session);
+            this.injectToClaudeMd(projectPath, context);
+            this.lastSaveTime.set(projectPath, Date.now());
+            logger.info(`续接快照已保存：${projectPath}`);
+        });
+    }
+    /**
+     * 中途实时更新：蒸馏完成后自动刷新 resume 块
+     * 带冷却控制，避免频繁调用 API
+     */
+    async saveIncremental(sessionId, projectPath) {
+        // 冷却检查
+        const lastSave = this.lastSaveTime.get(projectPath) || 0;
+        if (Date.now() - lastSave < this.saveCooldownMs) {
+            logger.info(`[续接] ${projectPath} 处于冷却中，跳过`);
+            return;
+        }
+        const session = this.storage.getSession(sessionId, projectPath);
+        if (!session || session.event_count < 5) {
+            return;
+        }
+        logger.info(`[续接] 增量更新：${projectPath}`);
+        await this.writeLock.runExclusive(projectPath, async () => {
+            const context = await this.contextGen.generate(session);
+            this.injectToClaudeMd(projectPath, context);
+            this.lastSaveTime.set(projectPath, Date.now());
+        });
+    }
+    /**
+     * 新会话开始时调用：检查是否有上次的续接上下文
+     * 如果已经由 saveOnStop 预生成了，直接展示（不需要再调 API）
+     */
+    async checkAndInject(projectPath) {
+        // 如果 .claude/CLAUDE.md 已有 resume 区块（由 saveOnStop 生成），直接返回 true
+        const claudeMdPath = path.join(projectPath, '.claude', 'CLAUDE.md');
+        if (fs.existsSync(claudeMdPath)) {
+            const content = fs.readFileSync(claudeMdPath, 'utf-8');
+            if (content.includes(RESUME_START)) {
+                logger.info('续接上下文已存在（来自 saveOnStop）');
+                return true;
+            }
+        }
+        // 否则检查是否有中断会话，实时生成
+        const interrupted = this.stateMachine.checkInterrupted(projectPath);
+        if (!interrupted) {
+            return false;
+        }
+        if (this.stateMachine.isExpired(interrupted, this.maxAgeDays)) {
+            logger.info(`中断会话 ${interrupted.session_id} 已过期（> ${this.maxAgeDays} 天），跳过`);
+            this.stateMachine.markAbandoned(interrupted.session_id);
+            return false;
+        }
+        logger.info(`正在为中断会话 ${interrupted.session_id} 生成续接上下文`);
+        const context = await this.contextGen.generate(interrupted);
+        this.injectToClaudeMd(projectPath, context);
+        this.stateMachine.markResumed(interrupted.session_id);
+        logger.info('续接上下文已注入 CLAUDE.md');
+        return true;
+    }
+    /**
+     * 清除 CLAUDE.md 中的 resume 区块
+     */
+    clearResumeBlock(projectPath) {
+        const claudeMdPath = path.join(projectPath, '.claude', 'CLAUDE.md');
+        if (!fs.existsSync(claudeMdPath))
+            return;
+        let content = fs.readFileSync(claudeMdPath, 'utf-8');
+        const startIdx = content.indexOf(RESUME_START);
+        const endIdx = content.indexOf(RESUME_END);
+        if (startIdx !== -1 && endIdx !== -1) {
+            content =
+                content.substring(0, startIdx) +
+                    content.substring(endIdx + RESUME_END.length);
+            content = content.replace(/\n{3,}/g, '\n\n');
+            fs.writeFileSync(claudeMdPath, content, 'utf-8');
+            logger.info('CLAUDE.md 中的续接区块已清除');
+        }
+    }
+    injectToClaudeMd(projectPath, context) {
+        const claudeDir = path.join(projectPath, '.claude');
+        const claudeMdPath = path.join(claudeDir, 'CLAUDE.md');
+        if (!fs.existsSync(claudeDir)) {
+            fs.mkdirSync(claudeDir, { recursive: true });
+        }
+        let content = '';
+        if (fs.existsSync(claudeMdPath)) {
+            content = fs.readFileSync(claudeMdPath, 'utf-8');
+        }
+        const resumeBlock = `
+${RESUME_START}
+## 上次工作续接
+
+${context}
+${RESUME_END}
+`;
+        const startIdx = content.indexOf(RESUME_START);
+        const endIdx = content.indexOf(RESUME_END);
+        if (startIdx !== -1 && endIdx !== -1) {
+            content =
+                content.substring(0, startIdx) +
+                    resumeBlock.trim() +
+                    content.substring(endIdx + RESUME_END.length);
+        }
+        else {
+            content = content.trimEnd() + '\n\n' + resumeBlock.trim() + '\n';
+        }
+        fs.writeFileSync(claudeMdPath, content, 'utf-8');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/resume/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resume/index.ts"],"names":[],"mappings":"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"}

package/dist/resume/state-machine.d.ts

@@ -0,0 +1,21 @@
+import type { StorageEngine } from '../storage/index.js';
+import type { Session } from '../types/session.js';
+export declare class SessionStateMachine {
+    private storage;
+    private timeoutMinutes;
+    constructor(storage: StorageEngine, timeoutMinutes?: number);
+    /**
+     * 检查项目下是否有被中断的会话
+     */
+    checkInterrupted(projectPath: string): Session | null;
+    /**
+     * 标记会话状态转换
+     */
+    markResumed(sessionId: string): void;
+    markAbandoned(sessionId: string): void;
+    /**
+     * 检查中断会话是否已过期（超过 maxAgeDays 天）
+     */
+    isExpired(session: Session, maxAgeDays?: number): boolean;
+}
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/resume/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/resume/state-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,qBAAqB,CAAC;AAGlE,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,cAAc;gBADd,OAAO,EAAE,aAAa,EACtB,cAAc,GAAE,MAAW;IAGrC;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAkCrD;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,GAAE,MAAU,GAAG,OAAO;CAM7D"}

package/dist/resume/state-machine.js

@@ -0,0 +1,58 @@
+import { logger } from '../utils/logger.js';
+export class SessionStateMachine {
+    storage;
+    timeoutMinutes;
+    constructor(storage, timeoutMinutes = 10) {
+        this.storage = storage;
+        this.timeoutMinutes = timeoutMinutes;
+    }
+    /**
+     * 检查项目下是否有被中断的会话
+     */
+    checkInterrupted(projectPath) {
+        // 1. 检查 active 会话是否已超时
+        const activeSessions = this.storage.querySessions({
+            project_path: projectPath,
+            status: 'active',
+        });
+        const now = Date.now();
+        for (const session of activeSessions) {
+            if (session.last_event_time) {
+                const lastTime = new Date(session.last_event_time).getTime();
+                const minutesSince = (now - lastTime) / 1000 / 60;
+                if (minutesSince > this.timeoutMinutes) {
+                    // 超时 → 标记为 interrupted
+                    this.storage.updateSessionStatus(session.session_id, 'interrupted');
+                    logger.info(`会话 ${session.session_id} 已标记为中断（${minutesSince.toFixed(0)} 分钟无活动）`);
+                    return { ...session, status: 'interrupted' };
+                }
+            }
+        }
+        // 2. 查找已标记为 interrupted 的会话（取最近一个）
+        const interrupted = this.storage.querySessions({
+            project_path: projectPath,
+            status: 'interrupted',
+        });
+        return interrupted.length > 0 ? interrupted[0] : null;
+    }
+    /**
+     * 标记会话状态转换
+     */
+    markResumed(sessionId) {
+        this.storage.updateSessionStatus(sessionId, 'resumed');
+        logger.info(`会话 ${sessionId} 已标记为已续接`);
+    }
+    markAbandoned(sessionId) {
+        this.storage.updateSessionStatus(sessionId, 'abandoned');
+        logger.info(`会话 ${sessionId} 已标记为已放弃`);
+    }
+    /**
+     * 检查中断会话是否已过期（超过 maxAgeDays 天）
+     */
+    isExpired(session, maxAgeDays = 7) {
+        const lastTime = session.last_event_time || session.start_time;
+        const daysSince = (Date.now() - new Date(lastTime).getTime()) / 1000 / 60 / 60 / 24;
+        return daysSince > maxAgeDays;
+    }
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/resume/state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../../src/resume/state-machine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,OAAO,mBAAmB;IAEpB;IACA;IAFV,YACU,OAAsB,EACtB,iBAAyB,EAAE;QAD3B,YAAO,GAAP,OAAO,CAAe;QACtB,mBAAc,GAAd,cAAc,CAAa;IAClC,CAAC;IAEJ;;OAEG;IACH,gBAAgB,CAAC,WAAmB;QAClC,uBAAuB;QACvB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;YAChD,YAAY,EAAE,WAAW;YACzB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC7D,MAAM,YAAY,GAAG,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;gBAElD,IAAI,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;oBACvC,uBAAuB;oBACvB,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;oBACpE,MAAM,CAAC,IAAI,CACT,MAAM,OAAO,CAAC,UAAU,WAAW,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CACpE,CAAC;oBACF,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;YAC7C,YAAY,EAAE,WAAW;YACzB,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAAiB;QAC3B,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,MAAM,SAAS,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,MAAM,SAAS,UAAU,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAgB,EAAE,aAAqB,CAAC;QAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC;QAC/D,MAAM,SAAS,GACb,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACpE,OAAO,SAAS,GAAG,UAAU,CAAC;IAChC,CAAC;CACF"}

package/dist/skill-registry/collector.d.ts

@@ -0,0 +1,75 @@
+import type { SkillMeta } from './scanner.js';
+import { ClaudeAPI } from '../utils/claude-api.js';
+export interface SkillSource {
+    type: 'github' | 'npm' | 'registry' | 'url';
+    url: string;
+    name?: string;
+}
+export interface CollectResult {
+    skill: SkillMeta;
+    rawContent: string;
+    dependencies: string[];
+    installCommand?: string;
+    sourceUrl: string;
+}
+export interface CuratedSource {
+    repo: string;
+    branch: string;
+    dir: string;
+    /** 文件格式：skill-md 有 frontmatter，command-md 是纯 markdown 命令 */
+    format: 'skill-md' | 'command-md';
+    description: string;
+}
+export interface CuratedFetchResult {
+    source: CuratedSource;
+    filePath: string;
+    rawUrl: string;
+    content: string;
+    name: string;
+}
+export declare class SkillCollector {
+    private api;
+    constructor(api?: ClaudeAPI);
+    /**
+     * 从 GitHub 搜索包含 SKILL.md 的仓库
+     */
+    searchGitHub(query: string): Promise<CollectResult[]>;
+    /**
+     * 从 npm 搜索 claude-code-skill 包
+     */
+    searchNpm(query: string): Promise<CollectResult[]>;
+    /**
+     * 从 URL 直接下载 SKILL.md
+     */
+    fetchFromUrl(url: string): Promise<CollectResult | null>;
+    /**
+     * 安装采集到的 Skill 到本地 ~/.claude/skills/
+     */
+    install(result: CollectResult): Promise<boolean>;
+    /**
+     * 从已知高质量社区仓库定向采集内容
+     * 返回原始文件内容，供 SkillEvolver 蒸馏使用
+     */
+    fetchCurated(sources?: CuratedSource[]): Promise<CuratedFetchResult[]>;
+    /**
+     * 卸载 Skill
+     */
+    uninstall(skillName: string): Promise<boolean>;
+    /**
+     * 评估 Skill 质量（调用 Claude API）
+     */
+    evaluate(skill: SkillMeta, rawContent?: string): Promise<{
+        score: number;
+        reason: string;
+    }>;
+    /**
+     * 下载并解析 SKILL.md
+     */
+    private fetchAndParse;
+    /**
+     * 通过 GitHub Trees API 列出仓库指定目录下的所有 .md 文件
+     */
+    private listGitHubDir;
+    private parseFrontmatter;
+}
+//# sourceMappingURL=collector.d.ts.map

package/dist/skill-registry/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/skill-registry/collector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAMnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,KAAK,CAAC;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,MAAM,EAAE,UAAU,GAAG,YAAY,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAkDD,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAmB;gBAElB,GAAG,CAAC,EAAE,SAAS;IAI3B;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAwC3D;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAuCxD;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK9D;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAsCtD;;;OAGG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAsC5E;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBpD;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA+CjG;;OAEG;YACW,aAAa;IAwB3B;;OAEG;YACW,aAAa;IAiB3B,OAAO,CAAC,gBAAgB;CAuBzB"}

package/dist/skill-registry/collector.js

@@ -0,0 +1,334 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { logger } from '../utils/logger.js';
+import { SkillsConfigManager } from './skills-config.js';
+const SKILLS_DIR = path.join(os.homedir(), '.claude', 'skills');
+/**
+ * 已知高质量社区资源，定向采集而非盲目搜索
+ */
+const CURATED_SOURCES = [
+    {
+        repo: 'obra/superpowers',
+        branch: 'main',
+        dir: 'skills',
+        format: 'skill-md',
+        description: 'Superpowers for Claude Code — 工程化工作流技能库',
+    },
+    {
+        repo: 'anthropics/claude-code',
+        branch: 'main',
+        dir: '.claude/commands',
+        format: 'command-md',
+        description: 'Anthropic 官方 Claude Code 内置命令',
+    },
+    {
+        repo: 'NomenAK/SuperClaude',
+        branch: 'main',
+        dir: '.claude/commands',
+        format: 'command-md',
+        description: 'SuperClaude Framework — 增强型命令集',
+    },
+    {
+        repo: 'hesreallyhim/awesome-claude-code',
+        branch: 'main',
+        dir: '.claude/commands',
+        format: 'command-md',
+        description: 'Awesome Claude Code — 社区精选命令',
+    },
+];
+export class SkillCollector {
+    api;
+    constructor(api) {
+        this.api = api || null;
+    }
+    /**
+     * 从 GitHub 搜索包含 SKILL.md 的仓库
+     */
+    async searchGitHub(query) {
+        logger.info(`[采集器] GitHub 搜索：${query}`);
+        const searchQuery = encodeURIComponent(`${query} filename:SKILL.md`);
+        const url = `https://api.github.com/search/code?q=${searchQuery}&per_page=10`;
+        try {
+            const resp = await fetch(url, {
+                headers: {
+                    'Accept': 'application/vnd.github.v3+json',
+                    'User-Agent': 'claude-forge-collector',
+                },
+            });
+            if (!resp.ok) {
+                logger.warn(`[采集器] GitHub API 错误：${resp.status}`);
+                return [];
+            }
+            const data = await resp.json();
+            const results = [];
+            for (const item of data.items || []) {
+                // 获取 SKILL.md 原始内容
+                const rawUrl = `https://raw.githubusercontent.com/${item.repository.full_name}/main/${item.path}`;
+                const skill = await this.fetchAndParse(rawUrl, item.repository.full_name);
+                if (skill) {
+                    skill.sourceUrl = item.html_url;
+                    results.push(skill);
+                }
+            }
+            logger.info(`[采集器] GitHub：找到 ${results.length} 个技能`);
+            return results;
+        }
+        catch (err) {
+            logger.error(`[采集器] GitHub 搜索失败：${err}`);
+            return [];
+        }
+    }
+    /**
+     * 从 npm 搜索 claude-code-skill 包
+     */
+    async searchNpm(query) {
+        logger.info(`[采集器] npm 搜索：${query}`);
+        const searchQuery = encodeURIComponent(`claude-code-skill ${query}`);
+        const url = `https://registry.npmjs.org/-/v1/search?text=${searchQuery}&size=10`;
+        try {
+            const resp = await fetch(url);
+            if (!resp.ok)
+                return [];
+            const data = await resp.json();
+            const results = [];
+            for (const obj of data.objects || []) {
+                const pkg = obj.package;
+                results.push({
+                    skill: {
+                        name: pkg.name,
+                        version: pkg.version,
+                        description: pkg.description || '',
+                        source: 'remote',
+                        path: '',
+                        stats: { callCount: 0, lastUsed: null, successRate: 1, userFeedback: { positive: 0, negative: 0 } },
+                    },
+                    rawContent: '',
+                    dependencies: [pkg.name],
+                    installCommand: `npm install -g ${pkg.name}`,
+                    sourceUrl: pkg.links.npm,
+                });
+            }
+            logger.info(`[采集器] npm：找到 ${results.length} 个包`);
+            return results;
+        }
+        catch (err) {
+            logger.error(`[采集器] npm 搜索失败：${err}`);
+            return [];
+        }
+    }
+    /**
+     * 从 URL 直接下载 SKILL.md
+     */
+    async fetchFromUrl(url) {
+        logger.info(`[采集器] 从 URL 获取：${url}`);
+        return this.fetchAndParse(url, url);
+    }
+    /**
+     * 安装采集到的 Skill 到本地 ~/.claude/skills/
+     */
+    async install(result) {
+        const skillName = result.skill.name;
+        const skillDir = path.join(SKILLS_DIR, skillName);
+        logger.info(`[采集器] 安装中：${skillName}`);
+        try {
+            // 1. 创建目录
+            if (!fs.existsSync(skillDir)) {
+                fs.mkdirSync(skillDir, { recursive: true });
+            }
+            // 2. 写入 SKILL.md
+            if (result.rawContent) {
+                fs.writeFileSync(path.join(skillDir, 'SKILL.md'), result.rawContent, 'utf-8');
+            }
+            // 3. 写入元信息
+            const meta = {
+                name: skillName,
+                source: result.sourceUrl,
+                installedAt: new Date().toISOString(),
+                version: result.skill.version,
+            };
+            fs.writeFileSync(path.join(skillDir, '.forge-meta.json'), JSON.stringify(meta, null, 2), 'utf-8');
+            logger.info(`[采集器] 已安装：${skillName} 至 ${skillDir}`);
+            return true;
+        }
+        catch (err) {
+            logger.error(`[采集器] 安装失败：${err}`);
+            return false;
+        }
+    }
+    /**
+     * 从已知高质量社区仓库定向采集内容
+     * 返回原始文件内容，供 SkillEvolver 蒸馏使用
+     */
+    async fetchCurated(sources) {
+        // 合并内置渠道 + 用户自定义渠道
+        const userSources = new SkillsConfigManager().listSources();
+        const allSources = sources ?? [...CURATED_SOURCES, ...userSources];
+        const results = [];
+        for (const source of allSources) {
+            logger.info(`[采集器] 定向采集：${source.repo}/${source.dir}`);
+            try {
+                const files = await this.listGitHubDir(source.repo, source.branch, source.dir);
+                for (const filePath of files) {
+                    const rawUrl = `https://raw.githubusercontent.com/${source.repo}/${source.branch}/${filePath}`;
+                    try {
+                        const resp = await fetch(rawUrl, {
+                            headers: { 'User-Agent': 'claude-forge-collector' },
+                        });
+                        if (!resp.ok)
+                            continue;
+                        const content = await resp.text();
+                        if (content.trim().length < 50)
+                            continue; // 跳过空文件
+                        results.push({
+                            source,
+                            filePath,
+                            rawUrl,
+                            content,
+                            name: path.basename(filePath, '.md'),
+                        });
+                    }
+                    catch { /* skip single file errors */ }
+                }
+                logger.info(`[采集器] ${source.repo} 定向采集：${files.length} 个文件`);
+            }
+            catch (err) {
+                logger.warn(`[采集器] ${source.repo} 定向采集失败：${err}`);
+            }
+        }
+        logger.info(`[采集器] 定向采集总计：${results.length} 条`);
+        return results;
+    }
+    /**
+     * 卸载 Skill
+     */
+    async uninstall(skillName) {
+        const skillDir = path.join(SKILLS_DIR, skillName);
+        // 只删除由 forge 安装的（有 .forge-meta.json 标记）
+        const metaPath = path.join(skillDir, '.forge-meta.json');
+        if (!fs.existsSync(metaPath)) {
+            logger.warn(`[采集器] 无法卸载 ${skillName}：非 forge 安装`);
+            return false;
+        }
+        try {
+            fs.rmSync(skillDir, { recursive: true });
+            logger.info(`[采集器] 已卸载：${skillName}`);
+            return true;
+        }
+        catch (err) {
+            logger.error(`[采集器] 卸载失败：${err}`);
+            return false;
+        }
+    }
+    /**
+     * 评估 Skill 质量（调用 Claude API）
+     */
+    async evaluate(skill, rawContent) {
+        if (!this.api) {
+            return { score: 0.5, reason: 'No API configured for evaluation' };
+        }
+        const content = rawContent || skill.description;
+        const prompt = `你是一个 Skill 质量评估专家。评估以下 Claude Code Skill 的质量。
+
+## Skill 信息
+- 名称: ${skill.name}
+- 版本: ${skill.version}
+- 来源: ${skill.source}
+- 描述: ${skill.description}
+
+## Skill 内容
+${content.substring(0, 3000)}
+
+## 评估维度
+1. 描述清晰度（description 是否准确描述了功能和使用场景）
+2. 安全性（是否有潜在安全风险，如任意代码执行、数据泄露）
+3. 实用性（功能是否有实际价值）
+4. 完整性（是否包含足够的使用指引）
+
+## 输出格式
+### SCORE
+0.0 到 1.0 之间的分数
+
+### REASON
+简要说明评估理由（一句话）`;
+        try {
+            const response = await this.api.complete(prompt, 'skill-collector');
+            const scoreMatch = response.match(/###\s*SCORE\s*\n\s*([\d.]+)/i);
+            const reasonMatch = response.match(/###\s*REASON\s*\n\s*(.+)/i);
+            const score = scoreMatch ? parseFloat(scoreMatch[1]) : 0.5;
+            const reason = reasonMatch?.[1]?.trim() || '评估完成';
+            logger.info(`[采集器] 已评估 ${skill.name}：score=${score}`);
+            return { score: Math.max(0, Math.min(1, score)), reason };
+        }
+        catch (err) {
+            logger.error(`[采集器] 评估失败：${err}`);
+            return { score: 0.5, reason: `Evaluation error: ${err}` };
+        }
+    }
+    /**
+     * 下载并解析 SKILL.md
+     */
+    async fetchAndParse(url, sourceName) {
+        try {
+            const resp = await fetch(url);
+            if (!resp.ok)
+                return null;
+            const content = await resp.text();
+            const meta = this.parseFrontmatter(content, sourceName);
+            return {
+                skill: {
+                    ...meta,
+                    source: 'remote',
+                    path: '',
+                    stats: { callCount: 0, lastUsed: null, successRate: 1, userFeedback: { positive: 0, negative: 0 } },
+                },
+                rawContent: content,
+                dependencies: meta.requires?.bins || [],
+                sourceUrl: url,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 通过 GitHub Trees API 列出仓库指定目录下的所有 .md 文件
+     */
+    async listGitHubDir(repo, branch, dir) {
+        const url = `https://api.github.com/repos/${repo}/git/trees/${branch}?recursive=1`;
+        const resp = await fetch(url, {
+            headers: {
+                'Accept': 'application/vnd.github.v3+json',
+                'User-Agent': 'claude-forge-collector',
+            },
+        });
+        if (!resp.ok)
+            return [];
+        const data = await resp.json();
+        const prefix = dir.endsWith('/') ? dir : dir + '/';
+        return (data.tree || [])
+            .filter(item => item.type === 'blob' && item.path.startsWith(prefix) && item.path.endsWith('.md'))
+            .map(item => item.path);
+    }
+    parseFrontmatter(content, fallbackName) {
+        const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        const fm = fmMatch?.[1] || '';
+        const nameMatch = fm.match(/name:\s*(.+)/);
+        const versionMatch = fm.match(/version:\s*(.+)/);
+        const descMatch = fm.match(/description:\s*"([^"]+)"/);
+        const binsMatch = fm.match(/bins:\s*\[([^\]]+)\]/);
+        const bins = binsMatch
+            ? binsMatch[1].split(',').map(b => b.trim().replace(/"/g, ''))
+            : undefined;
+        return {
+            name: nameMatch?.[1]?.trim() || fallbackName.split('/').pop() || fallbackName,
+            version: versionMatch?.[1]?.trim() || '0.0.0',
+            description: descMatch?.[1] || '',
+            source: 'remote',
+            path: '',
+            requires: bins ? { bins } : undefined,
+            stats: { callCount: 0, lastUsed: null, successRate: 1, userFeedback: { positive: 0, negative: 0 } },
+        };
+    }
+}
+//# sourceMappingURL=collector.js.map