@roarpeng/graphflow 1.1.0 → 1.3.0

package/dist/integrations/skill-installer.js

@@ -0,0 +1,612 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSkillSourcePath = resolveSkillSourcePath;
+exports.resolveCursorRulesSourcePath = resolveCursorRulesSourcePath;
+exports.resolveClaudeMdSourcePath = resolveClaudeMdSourcePath;
+exports.installAgentInstructions = installAgentInstructions;
+exports.getAgentInstructionStatus = getAgentInstructionStatus;
+exports.installAgentSkills = installAgentSkills;
+exports.getAgentSkillStatus = getAgentSkillStatus;
+exports.installTraeSkills = installTraeSkills;
+exports.installCursorRules = installCursorRules;
+exports.installClaudeCodeMd = installClaudeCodeMd;
+exports.installAllSkills = installAllSkills;
+/**
+ * skill-installer.ts — 共享的 Skill / Rules 安装模块
+ *
+ * 封装 Trae Skill、Cursor Rules、Claude Code CLAUDE.md 的安装逻辑，
+ * 可被 CLI init 和 VS Code 扩展共用。所有安装失败静默处理（log warn）。
+ */
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+// ── 平台检测 ──────────────────────────────────────────────────────────
+const isWindows = process.platform === "win32";
+function resolveHomePaths() {
+    const home = (0, node_os_1.homedir)();
+    const appData = process.env.APPDATA ?? (isWindows ? (0, node_path_1.join)(home, "AppData", "Roaming") : "");
+    const localAppData = process.env.LOCALAPPDATA ?? (isWindows ? (0, node_path_1.join)(home, "AppData", "Local") : "");
+    return { home, appData, localAppData };
+}
+// ── Trae Skill 安装 ──────────────────────────────────────────────────
+function getTraeUserDirs() {
+    const { home, appData } = resolveHomePaths();
+    const dirs = [];
+    if (isWindows) {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(appData, "Trae"))) {
+            dirs.push({
+                name: "Trae",
+                skillsDir: (0, node_path_1.join)(appData, "Trae", "User", "skills"),
+            });
+        }
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(appData, "Trae CN"))) {
+            dirs.push({
+                name: "Trae CN",
+                skillsDir: (0, node_path_1.join)(appData, "Trae CN", "User", "skills"),
+            });
+        }
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(appData, "TRAE SOLO CN"))) {
+            dirs.push({
+                name: "TRAE SOLO CN",
+                skillsDir: (0, node_path_1.join)(appData, "TRAE SOLO CN", "User", "skills"),
+            });
+        }
+    }
+    else {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(home, ".config", "Trae"))) {
+            dirs.push({
+                name: "Trae",
+                skillsDir: (0, node_path_1.join)(home, ".config", "Trae", "User", "skills"),
+            });
+        }
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(home, ".config", "Trae CN"))) {
+            dirs.push({
+                name: "Trae CN",
+                skillsDir: (0, node_path_1.join)(home, ".config", "Trae CN", "User", "skills"),
+            });
+        }
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(home, ".config", "TRAE SOLO CN"))) {
+            dirs.push({
+                name: "TRAE SOLO CN",
+                skillsDir: (0, node_path_1.join)(home, ".config", "TRAE SOLO CN", "User", "skills"),
+            });
+        }
+    }
+    return dirs;
+}
+// ── Cursor Rules 安装 ─────────────────────────────────────────────────
+function getCursorRulesDirs() {
+    const { home, appData } = resolveHomePaths();
+    const dirs = [];
+    // 用户级 Cursor rules 目录
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(home, ".cursor"))) {
+        dirs.push({
+            name: "Cursor (user)",
+            rulesDir: (0, node_path_1.join)(home, ".cursor", "rules"),
+        });
+    }
+    // AppData 位置（某些 Cursor 版本）
+    if (isWindows && (0, node_fs_1.existsSync)((0, node_path_1.join)(appData, "Cursor"))) {
+        dirs.push({
+            name: "Cursor (AppData)",
+            rulesDir: (0, node_path_1.join)(appData, "Cursor", "User", "rules"),
+        });
+    }
+    return dirs;
+}
+// ── Claude Code CLAUDE.md 安装 ────────────────────────────────────────
+function getClaudeCodeDirs() {
+    const { home, appData } = resolveHomePaths();
+    const dirs = [];
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(home, ".claude"))) {
+        dirs.push({
+            name: "Claude Code",
+            claudeDir: (0, node_path_1.join)(home, ".claude"),
+        });
+    }
+    if (isWindows && (0, node_fs_1.existsSync)((0, node_path_1.join)(appData, "Claude Code"))) {
+        dirs.push({
+            name: "Claude Code (AppData)",
+            claudeDir: (0, node_path_1.join)(appData, "Claude Code"),
+        });
+    }
+    return dirs;
+}
+// ── 路径解析（支持多种候选路径） ────────────────────────────────────────
+/**
+ * 解析 Trae Skill 源文件路径。
+ * 支持以下候选路径（按优先级排序）：
+ * 1. vendorRuntimeRoot（VS Code 扩展打包后 vendor/graphflow 路径）
+ * 2. 标准的 dist/surfaces/ 路径
+ * 3. src/surfaces/ 源码路径
+ */
+function resolveSkillSourcePath(vendorRuntimeRoot) {
+    const candidates = [
+        // VS Code 扩展 vendor 路径（打包后）
+        ...(vendorRuntimeRoot
+            ? [
+                (0, node_path_1.join)(vendorRuntimeRoot, "src", "surfaces", "trae-skill", "graphflow"),
+                (0, node_path_1.join)(vendorRuntimeRoot, "dist", "surfaces", "trae-skill", "graphflow"),
+            ]
+            : []),
+        // 标准构建产物路径
+        (0, node_path_1.join)(__dirname, "..", "..", "surfaces", "trae-skill", "graphflow"),
+        (0, node_path_1.join)(__dirname, "..", "..", "..", "src", "surfaces", "trae-skill", "graphflow"),
+        (0, node_path_1.join)(process.cwd(), "src", "surfaces", "trae-skill", "graphflow"),
+        (0, node_path_1.join)(process.cwd(), "dist", "surfaces", "trae-skill", "graphflow"),
+    ];
+    for (const dir of candidates) {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(dir, "SKILL.md"))) {
+            return dir;
+        }
+    }
+    return undefined;
+}
+/**
+ * 解析 Cursor Rules 源文件路径。
+ */
+function resolveCursorRulesSourcePath(vendorRuntimeRoot) {
+    const candidates = [
+        // VS Code 扩展 vendor 路径（打包后）
+        ...(vendorRuntimeRoot
+            ? [
+                (0, node_path_1.join)(vendorRuntimeRoot, "src", "surfaces", "cursor-rules"),
+                (0, node_path_1.join)(vendorRuntimeRoot, "dist", "surfaces", "cursor-rules"),
+            ]
+            : []),
+        // 标准构建产物路径
+        (0, node_path_1.join)(__dirname, "..", "..", "surfaces", "cursor-rules"),
+        (0, node_path_1.join)(__dirname, "..", "..", "..", "src", "surfaces", "cursor-rules"),
+        (0, node_path_1.join)(process.cwd(), "src", "surfaces", "cursor-rules"),
+        (0, node_path_1.join)(process.cwd(), "dist", "surfaces", "cursor-rules"),
+    ];
+    for (const dir of candidates) {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(dir, "graphflow.mdc"))) {
+            return dir;
+        }
+    }
+    return undefined;
+}
+/**
+ * 解析 Claude Code CLAUDE.md 源文件路径。
+ */
+function resolveClaudeMdSourcePath(vendorRuntimeRoot) {
+    const candidates = [
+        // VS Code 扩展 vendor 路径（打包后）
+        ...(vendorRuntimeRoot
+            ? [
+                (0, node_path_1.join)(vendorRuntimeRoot, "CLAUDE.md"),
+            ]
+            : []),
+        // 标准路径
+        (0, node_path_1.join)(__dirname, "..", "..", "CLAUDE.md"),
+        (0, node_path_1.join)(__dirname, "..", "..", "..", "CLAUDE.md"),
+        (0, node_path_1.join)(process.cwd(), "CLAUDE.md"),
+    ];
+    for (const filePath of candidates) {
+        if ((0, node_fs_1.existsSync)(filePath)) {
+            return filePath;
+        }
+    }
+    return undefined;
+}
+// ── 文件安装辅助 ────────────────────────────────────────────────────
+/**
+ * 通用文件安装：将源文件复制到目标位置，若已存在且内容相同则跳过。
+ */
+function installFile(sourcePath, destDir, destFileName) {
+    const destFile = (0, node_path_1.join)(destDir, destFileName);
+    const existed = (0, node_fs_1.existsSync)(destFile);
+    if (existed) {
+        const existingContent = (0, node_fs_1.readFileSync)(destFile, "utf8");
+        const newContent = (0, node_fs_1.readFileSync)(sourcePath, "utf8");
+        if (existingContent === newContent) {
+            return { status: "skipped", message: "already up to date" };
+        }
+    }
+    (0, node_fs_1.mkdirSync)(destDir, { recursive: true });
+    (0, node_fs_1.copyFileSync)(sourcePath, destFile);
+    return { status: existed ? "updated" : "created" };
+}
+// ── Agent 指令文件（append-with-markers 安全写入） ──────────────────────
+const INSTRUCTION_BEGIN = "<!-- GRAPHFLOW:BEGIN managed block — edit outside these markers only -->";
+const INSTRUCTION_END = "<!-- GRAPHFLOW:END -->";
+/**
+ * GraphFlow 的精简 token-first 指令块（受 Windsurf 6000 字符全局规则上限约束，保持简短）。
+ * 写入各 agent 的全局规则/记忆文件，告诉模型优先调用 GraphFlow 压缩上下文。
+ */
+function buildInstructionBlock() {
+    return [
+        INSTRUCTION_BEGIN,
+        "## GraphFlow Context-First Rule",
+        "",
+        "GraphFlow is a local code knowledge-graph + context compression MCP server.",
+        "Before broad code exploration, implementation, debugging, review, or architecture",
+        "questions in this project:",
+        "",
+        "1. Call `graphflow_preview_context` with the task/query first.",
+        "2. Use the returned `summary`, `anchors`, and `tokenBudget` as the primary context.",
+        "3. Read full files only when anchors point there or compressed context is insufficient.",
+        "4. For multi-step or ambiguous work, call `graphflow_plan` before implementing.",
+        "5. After project changes, call `graphflow_index` to keep the graph fresh.",
+        "",
+        "Do not scan the whole repository or read many large files before trying GraphFlow",
+        "context. Treat GraphFlow output as structured, token-saving context.",
+        INSTRUCTION_END,
+        "",
+    ].join("\n");
+}
+/**
+ * 将受管指令块以 append-with-markers 方式写入文件：
+ * - 文件不存在 → 创建并写入块
+ * - 已存在且含旧块 → 仅替换标记之间的内容（保留用户其它内容）
+ * - 已存在且无块 → 追加到文件末尾（保留用户其它内容）
+ * - 块内容已是最新 → skipped
+ */
+function upsertManagedBlock(filePath, destDirToCreate) {
+    try {
+        const block = buildInstructionBlock();
+        const existed = (0, node_fs_1.existsSync)(filePath);
+        if (!existed) {
+            (0, node_fs_1.mkdirSync)(destDirToCreate, { recursive: true });
+            (0, node_fs_1.writeFileSync)(filePath, `${block}\n`, "utf8");
+            return { status: "created" };
+        }
+        const current = (0, node_fs_1.readFileSync)(filePath, "utf8");
+        const beginIdx = current.indexOf(INSTRUCTION_BEGIN);
+        const endIdx = current.indexOf(INSTRUCTION_END);
+        if (beginIdx !== -1 && endIdx !== -1 && endIdx > beginIdx) {
+            const before = current.slice(0, beginIdx);
+            const after = current.slice(endIdx + INSTRUCTION_END.length);
+            const next = `${before}${block.trimEnd()}${after}`;
+            if (next === current) {
+                return { status: "skipped", message: "already up to date" };
+            }
+            (0, node_fs_1.writeFileSync)(filePath, next, "utf8");
+            return { status: "updated" };
+        }
+        // 无现有块：追加（保留用户已有内容）
+        const separator = current.endsWith("\n") ? "\n" : "\n\n";
+        (0, node_fs_1.writeFileSync)(filePath, `${current}${separator}${block}\n`, "utf8");
+        return { status: "updated" };
+    }
+    catch (error) {
+        return { status: "error", message: error instanceof Error ? error.message : String(error) };
+    }
+}
+/** 各 agent 的全局指令/记忆文件目标（仅在检测到对应 marker 时写入）。 */
+function getAgentInstructionTargets() {
+    const { home } = resolveHomePaths();
+    const targets = [];
+    // 注：Claude Code 的 ~/.claude/CLAUDE.md 由 installClaudeCodeMd 单独处理，
+    // 此处不重复写入，避免对同一文件的双重写入冲突。
+    // Windsurf 全局规则：~/.codeium/windsurf/memories/global_rules.md（6000 字符上限）
+    targets.push({
+        agent: "Windsurf",
+        markerDir: (0, node_path_1.join)(home, ".codeium", "windsurf"),
+        destDir: (0, node_path_1.join)(home, ".codeium", "windsurf", "memories"),
+        filePath: (0, node_path_1.join)(home, ".codeium", "windsurf", "memories", "global_rules.md"),
+    });
+    // Codex 全局指令：~/.codex/AGENTS.md
+    targets.push({
+        agent: "Codex",
+        markerDir: (0, node_path_1.join)(home, ".codex"),
+        destDir: (0, node_path_1.join)(home, ".codex"),
+        filePath: (0, node_path_1.join)(home, ".codex", "AGENTS.md"),
+    });
+    // Gemini CLI 全局指令：~/.gemini/GEMINI.md
+    targets.push({
+        agent: "Gemini",
+        markerDir: (0, node_path_1.join)(home, ".gemini"),
+        destDir: (0, node_path_1.join)(home, ".gemini"),
+        filePath: (0, node_path_1.join)(home, ".gemini", "GEMINI.md"),
+    });
+    return targets;
+}
+/**
+ * 将 GraphFlow 指令块安全写入所有检测到的 agent 的全局规则/记忆文件。
+ * 使用 append-with-markers，绝不覆盖用户已有内容。
+ */
+function installAgentInstructions() {
+    const results = [];
+    for (const target of getAgentInstructionTargets()) {
+        if (!(0, node_fs_1.existsSync)(target.markerDir)) {
+            continue; // 未检测到该 agent，跳过
+        }
+        const result = upsertManagedBlock(target.filePath, target.destDir);
+        results.push({ target: target.agent, status: result.status, message: result.message });
+    }
+    if (results.length === 0) {
+        results.push({ target: "Agent instructions", status: "skipped", message: "No supported agent detected" });
+    }
+    return results;
+}
+/** 检查每个 agent 的全局指令文件是否含 GraphFlow 受管块（用于 doctor 自检）。 */
+function getAgentInstructionStatus() {
+    return getAgentInstructionTargets().map((target) => {
+        const detected = (0, node_fs_1.existsSync)(target.markerDir);
+        let installed = false;
+        if ((0, node_fs_1.existsSync)(target.filePath)) {
+            const content = (0, node_fs_1.readFileSync)(target.filePath, "utf8");
+            installed = content.includes(INSTRUCTION_BEGIN) && content.includes(INSTRUCTION_END);
+        }
+        return { agent: target.agent, configPath: target.filePath, detected, installed };
+    });
+}
+// ── Agent Skill 文件夹安装（真正的 Cursor / Claude / Codex Skill） ────────
+/**
+ * 各 agent 的"真正的 Skill"目录目标（仅在检测到对应 marker 时写入）。
+ *
+ * 重要：Cursor 自定义 Skill 的正确目录是 `~/.cursor/skills/<name>/SKILL.md`，
+ * 绝不能写入 `~/.cursor/skills-cursor/`（那是 Cursor 内置 Skill 的保留目录）。
+ * Claude Code / Codex 同样支持 `~/.claude/skills/`、`~/.codex/skills/` 约定。
+ */
+function getAgentSkillTargets() {
+    const { home } = resolveHomePaths();
+    return [
+        // Cursor 用户级 Skill（~/.cursor/skills/graphflow/SKILL.md）
+        {
+            agent: "Cursor",
+            markerDir: (0, node_path_1.join)(home, ".cursor"),
+            skillsRoot: (0, node_path_1.join)(home, ".cursor", "skills"),
+        },
+        // Claude Code 用户级 Skill（~/.claude/skills/graphflow/SKILL.md）
+        {
+            agent: "Claude Code",
+            markerDir: (0, node_path_1.join)(home, ".claude"),
+            skillsRoot: (0, node_path_1.join)(home, ".claude", "skills"),
+        },
+        // Codex 用户级 Skill（~/.codex/skills/graphflow/SKILL.md）
+        {
+            agent: "Codex",
+            markerDir: (0, node_path_1.join)(home, ".codex"),
+            skillsRoot: (0, node_path_1.join)(home, ".codex", "skills"),
+        },
+    ];
+}
+/**
+ * 将 GraphFlow 的 SKILL.md 安装为各检测到的 agent 的"真正的 Skill"
+ * （Cursor / Claude Code / Codex 的 `skills/graphflow/SKILL.md`）。
+ * SKILL.md 已带合法的 `name: graphflow` frontmatter，可被 Cursor 直接识别。
+ */
+function installAgentSkills(vendorRuntimeRoot) {
+    const results = [];
+    const skillSourceDir = resolveSkillSourcePath(vendorRuntimeRoot);
+    if (!skillSourceDir) {
+        results.push({
+            target: "Agent skills",
+            status: "skipped",
+            message: "Skill source (SKILL.md) not found",
+        });
+        return results;
+    }
+    const sourceSkillFile = (0, node_path_1.join)(skillSourceDir, "SKILL.md");
+    for (const target of getAgentSkillTargets()) {
+        if (!(0, node_fs_1.existsSync)(target.markerDir)) {
+            continue; // 未检测到该 agent，跳过
+        }
+        try {
+            const destDir = (0, node_path_1.join)(target.skillsRoot, "graphflow");
+            const result = installFile(sourceSkillFile, destDir, "SKILL.md");
+            results.push({ target: target.agent, status: result.status, message: result.message });
+        }
+        catch (error) {
+            results.push({
+                target: target.agent,
+                status: "error",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    if (results.length === 0) {
+        results.push({
+            target: "Agent skills",
+            status: "skipped",
+            message: "No supported agent detected",
+        });
+    }
+    return results;
+}
+/** 检查每个 agent 的 Skill 文件是否已安装（用于 doctor 自检）。 */
+function getAgentSkillStatus() {
+    return getAgentSkillTargets().map((target) => {
+        const detected = (0, node_fs_1.existsSync)(target.markerDir);
+        const filePath = (0, node_path_1.join)(target.skillsRoot, "graphflow", "SKILL.md");
+        return { agent: `${target.agent} skill`, configPath: filePath, detected, installed: (0, node_fs_1.existsSync)(filePath) };
+    });
+}
+// ── 单项安装函数 ──────────────────────────────────────────────────────
+/**
+ * 安装 Trae Skill（SKILL.md）到所有检测到的 Trae 用户目录。
+ */
+function installTraeSkills(vendorRuntimeRoot) {
+    const results = [];
+    const skillSourceDir = resolveSkillSourcePath(vendorRuntimeRoot);
+    if (!skillSourceDir) {
+        results.push({
+            target: "Trae",
+            status: "skipped",
+            message: "Skill source (SKILL.md) not found",
+        });
+        return results;
+    }
+    const traeDirs = getTraeUserDirs();
+    if (traeDirs.length === 0) {
+        results.push({
+            target: "Trae",
+            status: "skipped",
+            message: "No Trae installation detected",
+        });
+        return results;
+    }
+    const sourceSkillFile = (0, node_path_1.join)(skillSourceDir, "SKILL.md");
+    for (const trae of traeDirs) {
+        try {
+            const destDir = (0, node_path_1.join)(trae.skillsDir, "graphflow");
+            const result = installFile(sourceSkillFile, destDir, "SKILL.md");
+            results.push({ target: trae.name, status: result.status, message: result.message });
+        }
+        catch (error) {
+            results.push({
+                target: trae.name,
+                status: "error",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return results;
+}
+/**
+ * 安装 Cursor Rules（graphflow.mdc）到所有检测到的 Cursor 用户目录。
+ */
+function installCursorRules(vendorRuntimeRoot) {
+    const results = [];
+    const rulesSourceDir = resolveCursorRulesSourcePath(vendorRuntimeRoot);
+    if (!rulesSourceDir) {
+        results.push({
+            target: "Cursor",
+            status: "skipped",
+            message: "Cursor rules source (graphflow.mdc) not found",
+        });
+        return results;
+    }
+    const cursorDirs = getCursorRulesDirs();
+    if (cursorDirs.length === 0) {
+        results.push({
+            target: "Cursor",
+            status: "skipped",
+            message: "No Cursor installation detected",
+        });
+        return results;
+    }
+    const sourceRulesFile = (0, node_path_1.join)(rulesSourceDir, "graphflow.mdc");
+    for (const cursor of cursorDirs) {
+        try {
+            const result = installFile(sourceRulesFile, cursor.rulesDir, "graphflow.mdc");
+            results.push({ target: cursor.name, status: result.status, message: result.message });
+        }
+        catch (error) {
+            results.push({
+                target: cursor.name,
+                status: "error",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return results;
+}
+/**
+ * 安装 Claude Code CLAUDE.md 到检测到的 Claude Code 用户目录。
+ */
+function installClaudeCodeMd(vendorRuntimeRoot) {
+    const results = [];
+    const sourcePath = resolveClaudeMdSourcePath(vendorRuntimeRoot);
+    if (!sourcePath) {
+        results.push({
+            target: "Claude Code",
+            status: "skipped",
+            message: "CLAUDE.md source not found",
+        });
+        return results;
+    }
+    const claudeDirs = getClaudeCodeDirs();
+    if (claudeDirs.length === 0) {
+        results.push({
+            target: "Claude Code",
+            status: "skipped",
+            message: "No Claude Code installation detected",
+        });
+        return results;
+    }
+    for (const claude of claudeDirs) {
+        try {
+            const result = installFile(sourcePath, claude.claudeDir, "CLAUDE.md");
+            results.push({ target: claude.name, status: result.status, message: result.message });
+        }
+        catch (error) {
+            results.push({
+                target: claude.name,
+                status: "error",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return results;
+}
+// ── 一站式安装函数 ────────────────────────────────────────────────────
+/**
+ * 一键安装所有 Skill / Rules / CLAUDE.md。
+ * 所有失败静默处理（catch + 返回 error 状态），不会抛出异常。
+ *
+ * @param vendorRuntimeRoot 可选的 vendor 运行时根目录（VS Code 扩展中使用）
+ * @param log 可选的日志回调，用于输出安装信息
+ */
+function installAllSkills(vendorRuntimeRoot, log) {
+    const logFn = log ?? ((msg) => console.log(msg));
+    const traeSkills = installTraeSkills(vendorRuntimeRoot);
+    for (const result of traeSkills) {
+        if (result.status === "error") {
+            logFn(`[WARN] Trae Skill ${result.target}: ${result.message}`);
+            continue;
+        }
+        if (result.status === "skipped") {
+            logFn(`[SKIP] Trae Skill ${result.target}: ${result.message ?? "skipped"}`);
+            continue;
+        }
+        logFn(`[OK] ${result.status === "created" ? "Created" : "Updated"} Trae Skill for ${result.target}`);
+    }
+    const cursorRules = installCursorRules(vendorRuntimeRoot);
+    for (const result of cursorRules) {
+        if (result.status === "error") {
+            logFn(`[WARN] Cursor Rules ${result.target}: ${result.message}`);
+            continue;
+        }
+        if (result.status === "skipped") {
+            logFn(`[SKIP] Cursor Rules ${result.target}: ${result.message ?? "skipped"}`);
+            continue;
+        }
+        logFn(`[OK] ${result.status === "created" ? "Created" : "Updated"} Cursor Rules for ${result.target}`);
+    }
+    const claudeMd = installClaudeCodeMd(vendorRuntimeRoot);
+    for (const result of claudeMd) {
+        if (result.status === "error") {
+            logFn(`[WARN] Claude Code CLAUDE.md ${result.target}: ${result.message}`);
+            continue;
+        }
+        if (result.status === "skipped") {
+            logFn(`[SKIP] Claude Code CLAUDE.md ${result.target}: ${result.message ?? "skipped"}`);
+            continue;
+        }
+        logFn(`[OK] ${result.status === "created" ? "Created" : "Updated"} Claude Code CLAUDE.md for ${result.target}`);
+    }
+    // 向所有检测到的 agent 的全局规则/记忆文件安全写入 GraphFlow 指令块
+    // （Windsurf / Codex / Gemini 等，append-with-markers，不覆盖用户内容）。
+    const agentInstructions = installAgentInstructions();
+    for (const result of agentInstructions) {
+        if (result.status === "error") {
+            logFn(`[WARN] Agent instructions ${result.target}: ${result.message}`);
+            continue;
+        }
+        if (result.status === "skipped") {
+            logFn(`[SKIP] Agent instructions ${result.target}: ${result.message ?? "skipped"}`);
+            continue;
+        }
+        logFn(`[OK] ${result.status === "created" ? "Created" : "Updated"} GraphFlow instructions for ${result.target}`);
+    }
+    // 安装"真正的 Agent Skill"（Cursor / Claude Code / Codex 的 skills/graphflow/SKILL.md），
+    // 这样在 Cursor 的 Skills 列表中也能看到 graphflow，而不仅仅是 Rule。
+    const agentSkills = installAgentSkills(vendorRuntimeRoot);
+    for (const result of agentSkills) {
+        if (result.status === "error") {
+            logFn(`[WARN] Agent Skill ${result.target}: ${result.message}`);
+            continue;
+        }
+        if (result.status === "skipped") {
+            logFn(`[SKIP] Agent Skill ${result.target}: ${result.message ?? "skipped"}`);
+            continue;
+        }
+        logFn(`[OK] ${result.status === "created" ? "Created" : "Updated"} GraphFlow Skill for ${result.target}`);
+    }
+    return { traeSkills, cursorRules, claudeMd, agentInstructions, agentSkills };
+}
+//# sourceMappingURL=skill-installer.js.map

package/dist/integrations/skill-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-installer.js","sourceRoot":"","sources":["../../src/integrations/skill-installer.ts"],"names":[],"mappings":";;AAiKA,wDAqBC;AAKD,oEAqBC;AAKD,8DAmBC;AAoJD,4DAgBC;AAGD,8DAUC;AA4CD,gDAyCC;AAGD,kDAMC;AAOD,8CAwCC;AAKD,gDAuCC;AAKD,kDAqCC;AAWD,4CA4EC;AAntBD;;;;;GAKG;AACH,qCAA2F;AAC3F,qCAAkC;AAClC,yCAAiC;AAmCjC,qEAAqE;AAErE,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AAE/C,SAAS,gBAAgB;IACvB,MAAM,IAAI,GAAG,IAAA,iBAAO,GAAE,CAAC;IACvB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3F,MAAM,YAAY,GAChB,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AACzC,CAAC;AAED,sEAAsE;AAEtE,SAAS,eAAe;IACtB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC7C,MAAM,IAAI,GAA+C,EAAE,CAAC;IAE5D,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,IAAA,gBAAI,EAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;aACnD,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,IAAA,gBAAI,EAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC;aACtD,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,cAAc;gBACpB,SAAS,EAAE,IAAA,gBAAI,EAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC;aAC3D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;aAC3D,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,cAAc;gBACpB,SAAS,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC;aACnE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uEAAuE;AAEvE,SAAS,kBAAkB;IACzB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC7C,MAAM,IAAI,GAA8C,EAAE,CAAC;IAE3D,sBAAsB;IACtB,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IAED,2BAA2B;IAC3B,IAAI,SAAS,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,kBAAkB;YACxB,QAAQ,EAAE,IAAA,gBAAI,EAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uEAAuE;AAEvE,SAAS,iBAAiB;IACxB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC7C,MAAM,IAAI,GAA+C,EAAE,CAAC;IAE5D,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,CAAC;SACjC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,uBAAuB;YAC7B,SAAS,EAAE,IAAA,gBAAI,EAAC,OAAO,EAAE,aAAa,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6DAA6D;AAE7D;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAAC,iBAA0B;IAC/D,MAAM,UAAU,GAAa;QAC3B,4BAA4B;QAC5B,GAAG,CAAC,iBAAiB;YACnB,CAAC,CAAC;gBACE,IAAA,gBAAI,EAAC,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,CAAC;gBACrE,IAAA,gBAAI,EAAC,iBAAiB,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,CAAC;aACvE;YACH,CAAC,CAAC,EAAE,CAAC;QACP,WAAW;QACX,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,CAAC;QAClE,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,CAAC;QAC/E,IAAA,gBAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,CAAC;QACjE,IAAA,gBAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,CAAC;KACnE,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,4BAA4B,CAAC,iBAA0B;IACrE,MAAM,UAAU,GAAa;QAC3B,4BAA4B;QAC5B,GAAG,CAAC,iBAAiB;YACnB,CAAC,CAAC;gBACE,IAAA,gBAAI,EAAC,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,CAAC;gBAC1D,IAAA,gBAAI,EAAC,iBAAiB,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,CAAC;aAC5D;YACH,CAAC,CAAC,EAAE,CAAC;QACP,WAAW;QACX,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,CAAC;QACvD,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,CAAC;QACpE,IAAA,gBAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,CAAC;QACtD,IAAA,gBAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,CAAC;KACxD,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;YAC3C,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,iBAA0B;IAClE,MAAM,UAAU,GAAa;QAC3B,4BAA4B;QAC5B,GAAG,CAAC,iBAAiB;YACnB,CAAC,CAAC;gBACE,IAAA,gBAAI,EAAC,iBAAiB,EAAE,WAAW,CAAC;aACrC;YACH,CAAC,CAAC,EAAE,CAAC;QACP,OAAO;QACP,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC;QACxC,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC;QAC9C,IAAA,gBAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC;KACjC,CAAC;IACF,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,IAAI,IAAA,oBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,iEAAiE;AAEjE;;GAEG;AACH,SAAS,WAAW,CAClB,UAAkB,EAClB,OAAe,EACf,YAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAA,oBAAU,EAAC,QAAQ,CAAC,CAAC;IAErC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,eAAe,GAAG,IAAA,sBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,IAAA,sBAAY,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,eAAe,KAAK,UAAU,EAAE,CAAC;YACnC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,IAAA,mBAAS,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,IAAA,sBAAY,EAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AACrD,CAAC;AAED,iEAAiE;AAEjE,MAAM,iBAAiB,GAAG,0EAA0E,CAAC;AACrG,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAEjD;;;GAGG;AACH,SAAS,qBAAqB;IAC5B,OAAO;QACL,iBAAiB;QACjB,iCAAiC;QACjC,EAAE;QACF,6EAA6E;QAC7E,mFAAmF;QACnF,4BAA4B;QAC5B,EAAE;QACF,gEAAgE;QAChE,qFAAqF;QACrF,yFAAyF;QACzF,iFAAiF;QACjF,2EAA2E;QAC3E,EAAE;QACF,mFAAmF;QACnF,sEAAsE;QACtE,eAAe;QACf,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CACzB,QAAgB,EAChB,eAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,qBAAqB,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAA,oBAAU,EAAC,QAAQ,CAAC,CAAC;QAErC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAA,mBAAS,EAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,IAAA,uBAAa,EAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,EAAE,MAAM,CAAC,CAAC;YAC9C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC;QAED,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAEhD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAC7D,MAAM,IAAI,GAAG,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;YACnD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;YAC9D,CAAC;YACD,IAAA,uBAAa,EAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACtC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC;QAED,oBAAoB;QACpB,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QACzD,IAAA,uBAAa,EAAC,QAAQ,EAAE,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,IAAI,EAAE,MAAM,CAAC,CAAC;QACpE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9F,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,SAAS,0BAA0B;IAMjC,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,OAAO,GAAmF,EAAE,CAAC;IAEnG,kEAAkE;IAClE,0BAA0B;IAE1B,wEAAwE;IACxE,OAAO,CAAC,IAAI,CAAC;QACX,KAAK,EAAE,UAAU;QACjB,SAAS,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC;QAC7C,OAAO,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;QACvD,QAAQ,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC;KAC5E,CAAC,CAAC;IAEH,gCAAgC;IAChC,OAAO,CAAC,IAAI,CAAC;QACX,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,QAAQ,CAAC;QAC/B,OAAO,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,QAAQ,CAAC;QAC7B,QAAQ,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC;KAC5C,CAAC,CAAC;IAEH,sCAAsC;IACtC,OAAO,CAAC,IAAI,CAAC;QACX,KAAK,EAAE,QAAQ;QACf,SAAS,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,CAAC;QAChC,OAAO,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,CAAC;QAC9B,QAAQ,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC;KAC7C,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAgB,wBAAwB;IACtC,MAAM,OAAO,GAAyB,EAAE,CAAC;IAEzC,KAAK,MAAM,MAAM,IAAI,0BAA0B,EAAE,EAAE,CAAC;QAClD,IAAI,CAAC,IAAA,oBAAU,EAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,SAAS,CAAC,iBAAiB;QAC7B,CAAC;QACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yDAAyD;AACzD,SAAgB,yBAAyB;IACvC,OAAO,0BAA0B,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACjD,MAAM,QAAQ,GAAG,IAAA,oBAAU,EAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,IAAA,oBAAU,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACtD,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACnF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AAEnE;;;;;;GAMG;AACH,SAAS,oBAAoB;IAK3B,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACpC,OAAO;QACL,wDAAwD;QACxD;YACE,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,CAAC;YAChC,UAAU,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC;SAC5C;QACD,6DAA6D;QAC7D;YACE,KAAK,EAAE,aAAa;YACpB,SAAS,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,CAAC;YAChC,UAAU,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC;SAC5C;QACD,sDAAsD;QACtD;YACE,KAAK,EAAE,OAAO;YACd,SAAS,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,QAAQ,CAAC;YAC/B,UAAU,EAAE,IAAA,gBAAI,EAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC;SAC3C;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,iBAA0B;IAC3D,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,MAAM,cAAc,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;IAEjE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,mCAAmC;SAC7C,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,eAAe,GAAG,IAAA,gBAAI,EAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAEzD,KAAK,MAAM,MAAM,IAAI,oBAAoB,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAA,oBAAU,EAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,SAAS,CAAC,iBAAiB;QAC7B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,WAAW,CAAC,eAAe,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACzF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,MAAM,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,6BAA6B;SACvC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gDAAgD;AAChD,SAAgB,mBAAmB;IACjC,OAAO,oBAAoB,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC3C,MAAM,QAAQ,GAAG,IAAA,oBAAU,EAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAClE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAA,oBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;IAC7G,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AAEnE;;GAEG;AACH,SAAgB,iBAAiB,CAAC,iBAA0B;IAC1D,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,MAAM,cAAc,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;IAEjE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,mCAAmC;SAC7C,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,+BAA+B;SACzC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,eAAe,GAAG,IAAA,gBAAI,EAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAEzD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,WAAW,CAAC,eAAe,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACtF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,IAAI,CAAC,IAAI;gBACjB,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,iBAA0B;IAC3D,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,MAAM,cAAc,GAAG,4BAA4B,CAAC,iBAAiB,CAAC,CAAC;IAEvE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,+CAA+C;SACzD,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;IACxC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,iCAAiC;SAC3C,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,eAAe,GAAG,IAAA,gBAAI,EAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAE9D,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;YAC9E,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,MAAM,CAAC,IAAI;gBACnB,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,iBAA0B;IAC5D,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;IAEhE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,4BAA4B;SACtC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,sCAAsC;SAChD,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YACtE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,MAAM,CAAC,IAAI;gBACnB,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,kEAAkE;AAElE;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,iBAA0B,EAC1B,GAA+B;IAE/B,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAEzD,MAAM,UAAU,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IACxD,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,KAAK,CAAC,qBAAqB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,KAAK,CAAC,qBAAqB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;YAC5E,SAAS;QACX,CAAC;QACD,KAAK,CAAC,QAAQ,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,mBAAmB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACvG,CAAC;IAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;IAC1D,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,KAAK,CAAC,uBAAuB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACjE,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,KAAK,CAAC,uBAAuB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;YAC9E,SAAS;QACX,CAAC;QACD,KAAK,CAAC,QAAQ,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,qBAAqB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IACxD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,KAAK,CAAC,gCAAgC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1E,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,KAAK,CAAC,gCAAgC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;YACvF,SAAS;QACX,CAAC;QACD,KAAK,CAAC,QAAQ,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,8BAA8B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAClH,CAAC;IAED,6CAA6C;IAC7C,6DAA6D;IAC7D,MAAM,iBAAiB,GAAG,wBAAwB,EAAE,CAAC;IACrD,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,KAAK,CAAC,6BAA6B,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,KAAK,CAAC,6BAA6B,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;YACpF,SAAS;QACX,CAAC;QACD,KAAK,CAAC,QAAQ,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,+BAA+B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnH,CAAC;IAED,iFAAiF;IACjF,oDAAoD;IACpD,MAAM,WAAW,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;IAC1D,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,KAAK,CAAC,sBAAsB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAChE,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,KAAK,CAAC,sBAAsB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;YAC7E,SAAS;QACX,CAAC;QACD,KAAK,CAAC,QAAQ,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,wBAAwB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC;AAC/E,CAAC"}

package/dist/learning/embeddings.d.ts

@@ -2,7 +2,18 @@ import type { GraphNode } from "../core/types";
 export declare const EMBEDDING_DIM = 256;
 export interface EmbeddingProvider {
     embed(text: string): Promise<number[]>;
+    /**
+     * 预热：用一段简短的 dummy 文本（如 "warmup"）做一次推理，
+     * 避免首个真实请求的冷启动延迟（尤其是本地模型懒加载场景）。
+     * 异步执行，不应阻塞主流程。可选实现。
+     */
+    warmup?(): Promise<void>;
 }
+/**
+ * 安全地预热 embedding provider。不会抛出异常，适合用 `void warmupEmbeddingProvider(p)` 非阻塞调用。
+ * 预热失败不影响主流程，首个真实请求会再次尝试加载/推理。
+ */
+export declare function warmupEmbeddingProvider(provider: EmbeddingProvider): Promise<void>;
 export declare function cosineSimilarity(a: number[], b: number[]): number;
 export declare function hashEmbedding(text: string, dim?: number): number[];
 export declare function createHashEmbeddingProvider(dim?: number): EmbeddingProvider;