bmall-mcp 1.0.0

package/dist/tools/sync.js

@@ -0,0 +1,287 @@
+import * as fs from "fs";
+import * as path from "path";
+import { execSync } from "child_process";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const HOME = process.env.HOME || process.env.USERPROFILE || "";
+const CWD = process.cwd();
+// Git 仓库配置
+const GIT_REPO = "git@coding.jd.com:IBKFXHJDBM/RulesManager.git";
+const GIT_BRANCH = "develop";
+const RULES_CACHE_DIR = path.join(HOME, ".bmall-mcp/rules-cache");
+// IDE 的 Rules 目录映射（项目级别）
+const IDE_PATHS = {
+    kiro: {
+        ios: path.join(CWD, ".kiro/steering/bmall-rules"),
+        android: path.join(CWD, ".kiro/steering/bmall-rules"),
+        web: path.join(CWD, ".kiro/steering/bmall-rules"),
+        flutter: path.join(CWD, ".kiro/steering/bmall-rules"),
+        unknown: path.join(CWD, ".kiro/steering/bmall-rules"),
+    },
+    cursor: {
+        ios: path.join(CWD, ".cursor/rules/bmall"),
+        android: path.join(CWD, ".cursor/rules/bmall"),
+        web: path.join(CWD, ".cursor/rules/bmall"),
+        flutter: path.join(CWD, ".cursor/rules/bmall"),
+        unknown: path.join(CWD, ".cursor/rules/bmall"),
+    },
+    windsurf: {
+        ios: path.join(CWD, ".windsurfrules"),
+        android: path.join(CWD, ".windsurfrules"),
+        web: path.join(CWD, ".windsurfrules"),
+        flutter: path.join(CWD, ".windsurfrules"),
+        unknown: path.join(CWD, ".windsurfrules"),
+    },
+};
+function log(message) {
+    console.error(`[bmall-mcp] ${message}`);
+}
+/**
+ * 检测项目类型
+ */
+function detectProjectType() {
+    // 检查特征文件/目录
+    const checks = [
+        // iOS 特征
+        ["ios/Podfile", "ios"],
+        ["*.xcodeproj", "ios"],
+        ["Podfile", "ios"],
+        // Android 特征
+        ["android/build.gradle", "android"],
+        ["build.gradle", "android"],
+        ["AndroidManifest.xml", "android"],
+        // Web 特征
+        ["package.json", "web"],
+        ["webpack.config.js", "web"],
+        ["tsconfig.json", "web"],
+        ["vite.config.ts", "web"],
+        // Flutter 特征
+        ["pubspec.yaml", "flutter"],
+        ["flutter.yaml", "flutter"],
+    ];
+    for (const [pattern, type] of checks) {
+        try {
+            if (pattern.includes("*")) {
+                // 通配符匹配
+                const files = fs.readdirSync(CWD);
+                if (files.some(f => f.match(pattern.replace("*", ".*")))) {
+                    log(`检测到 ${type} 项目特征: ${pattern}`);
+                    return type;
+                }
+            }
+            else {
+                // 直接路径检查
+                const fullPath = path.join(CWD, pattern);
+                if (fs.existsSync(fullPath)) {
+                    log(`检测到 ${type} 项目特征: ${pattern}`);
+                    return type;
+                }
+            }
+        }
+        catch (e) {
+            // 继续检查下一个
+        }
+    }
+    log(`未检测到项目类型，使用默认值: iOS`);
+    return "ios";
+}
+/**
+ * 规范化用户输入的 Rules 类型
+ */
+function normalizeRulesType(input) {
+    const normalized = input.toLowerCase().trim();
+    // iOS 的多种表达
+    if (["ios", "i", "iphone", "objective-c", "objc", "oc"].includes(normalized)) {
+        return "ios";
+    }
+    // Android 的多种表达
+    if (["android", "a", "kotlin", "java"].includes(normalized)) {
+        return "android";
+    }
+    // Web 的多种表达
+    if (["web", "w", "javascript", "js", "typescript", "ts", "react", "vue", "angular"].includes(normalized)) {
+        return "web";
+    }
+    // Flutter 的多种表达
+    if (["flutter", "f", "dart"].includes(normalized)) {
+        return "flutter";
+    }
+    // 默认返回 unknown，让调用者处理
+    return "unknown";
+}
+/**
+ * 获取 Git 仓库中对应项目类型的目录
+ */
+function getGitRulesDir(projectType) {
+    const dirMap = {
+        ios: "iOS",
+        android: "Android",
+        web: "Web",
+        flutter: "Flutter",
+        unknown: "iOS",
+    };
+    return dirMap[projectType];
+}
+/**
+ * 检测当前 IDE
+ */
+function detectCurrentIDE() {
+    // 检查环境变量
+    if (process.env.KIRO_HOME)
+        return "kiro";
+    if (process.env.CURSOR_HOME)
+        return "cursor";
+    if (process.env.WINDSURF_HOME)
+        return "windsurf";
+    // 检查目录是否存在
+    if (fs.existsSync(path.join(HOME, ".kiro")))
+        return "kiro";
+    if (fs.existsSync(path.join(HOME, ".cursor")))
+        return "cursor";
+    if (fs.existsSync(path.join(HOME, ".codeium/windsurf")))
+        return "windsurf";
+    // 默认返回 kiro
+    return "kiro";
+}
+/**
+ * 从 Git 克隆或更新 Rules（使用 sparse-checkout）
+ */
+async function fetchRulesFromGit(projectType) {
+    try {
+        const rulesDir = getGitRulesDir(projectType);
+        log(`Git 仓库: ${GIT_REPO}`);
+        log(`分支: ${GIT_BRANCH}`);
+        log(`项目类型: ${projectType}`);
+        log(`Rules 目录: ${rulesDir}`);
+        log(`缓存目录: ${RULES_CACHE_DIR}`);
+        log(`当前工作目录: ${CWD}`);
+        // 创建缓存目录
+        if (!fs.existsSync(RULES_CACHE_DIR)) {
+            log(`创建缓存目录: ${RULES_CACHE_DIR}`);
+            fs.mkdirSync(RULES_CACHE_DIR, { recursive: true });
+            log(`初始化 Git 仓库...`);
+            execSync(`git init ${RULES_CACHE_DIR}`, { stdio: "inherit" });
+            log(`配置 sparse-checkout...`);
+            execSync(`git -C ${RULES_CACHE_DIR} config core.sparseCheckout true`, {
+                stdio: "inherit",
+            });
+            log(`添加远程: ${GIT_REPO}`);
+            execSync(`git -C ${RULES_CACHE_DIR} remote add origin ${GIT_REPO}`, { stdio: "inherit" });
+            log(`设置只克隆 ${rulesDir} 目录...`);
+            const sparseCheckoutFile = path.join(RULES_CACHE_DIR, ".git/info/sparse-checkout");
+            fs.writeFileSync(sparseCheckoutFile, `${rulesDir}/\n`);
+            log(`sparse-checkout 文件: ${sparseCheckoutFile}`);
+            log(`拉取分支 ${GIT_BRANCH}...`);
+            execSync(`git -C ${RULES_CACHE_DIR} fetch origin ${GIT_BRANCH}`, {
+                stdio: "inherit",
+            });
+            log(`检出分支 ${GIT_BRANCH}...`);
+            execSync(`git -C ${RULES_CACHE_DIR} checkout ${GIT_BRANCH}`, {
+                stdio: "inherit",
+            });
+        }
+        else {
+            log(`缓存目录已存在，更新中...`);
+            // 更新 sparse-checkout 配置
+            const sparseCheckoutFile = path.join(RULES_CACHE_DIR, ".git/info/sparse-checkout");
+            fs.writeFileSync(sparseCheckoutFile, `${rulesDir}/\n`);
+            log(`拉取最新更改...`);
+            execSync(`git -C ${RULES_CACHE_DIR} fetch origin ${GIT_BRANCH}`, {
+                stdio: "inherit",
+            });
+            log(`检出分支 ${GIT_BRANCH}...`);
+            execSync(`git -C ${RULES_CACHE_DIR} checkout ${GIT_BRANCH}`, {
+                stdio: "inherit",
+            });
+            log(`合并最新更改...`);
+            execSync(`git -C ${RULES_CACHE_DIR} pull origin ${GIT_BRANCH}`, {
+                stdio: "inherit",
+            });
+        }
+        // 返回对应项目类型的目录路径
+        const projectRulesDir = path.join(RULES_CACHE_DIR, rulesDir);
+        if (!fs.existsSync(projectRulesDir)) {
+            throw new Error(`${rulesDir} 目录不存在: ${projectRulesDir}`);
+        }
+        log(`${rulesDir} 目录: ${projectRulesDir}`);
+        return projectRulesDir;
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        throw new Error(`从 Git 获取 Rules 失败: ${errorMsg}`);
+    }
+}
+/**
+ * 递归复制目录中的 Markdown 文件
+ */
+function copyMarkdownFiles(src, dest) {
+    if (!fs.existsSync(dest)) {
+        fs.mkdirSync(dest, { recursive: true });
+    }
+    let count = 0;
+    const files = fs.readdirSync(src);
+    for (const file of files) {
+        // 跳过隐藏文件、node_modules 和 .git
+        if (file.startsWith(".") || file === "node_modules") {
+            continue;
+        }
+        const srcPath = path.join(src, file);
+        const destPath = path.join(dest, file);
+        const stat = fs.statSync(srcPath);
+        if (stat.isDirectory()) {
+            count += copyMarkdownFiles(srcPath, destPath);
+        }
+        else if (file.endsWith(".md")) {
+            fs.copyFileSync(srcPath, destPath);
+            count++;
+        }
+    }
+    return count;
+}
+export async function syncRules(ide, rulesType) {
+    try {
+        // 确定 Rules 类型：优先使用用户指定，否则自动检测
+        let projectType;
+        if (rulesType) {
+            // 用户指定了 Rules 类型，规范化输入
+            const normalized = normalizeRulesType(rulesType);
+            if (normalized === "unknown") {
+                return `❌ 不支持的 Rules 类型: ${rulesType}\n支持的类型: iOS/Android/Web/Flutter (或其他别名)`;
+            }
+            projectType = normalized;
+            log(`使用用户指定的 Rules 类型: ${projectType}`);
+        }
+        else {
+            // 自动检测项目类型
+            projectType = detectProjectType();
+        }
+        // 如果没有指定 IDE，自动检测
+        const targetIDE = ide || detectCurrentIDE();
+        const idePathMap = IDE_PATHS[targetIDE];
+        if (!idePathMap) {
+            return `❌ 不支持的 IDE: ${targetIDE}\n支持的 IDE: kiro, cursor, windsurf`;
+        }
+        const targetPath = idePathMap[projectType];
+        // 从 Git 获取对应项目类型的 Rules
+        console.error("[bmall-mcp] Fetching rules from git...");
+        const rulesSourceDir = await fetchRulesFromGit(projectType);
+        // 复制文件
+        console.error(`[bmall-mcp] Copying files to ${targetPath}...`);
+        const copiedCount = copyMarkdownFiles(rulesSourceDir, targetPath);
+        if (copiedCount === 0) {
+            return `⚠️ 未找到任何 Markdown 文件\n源目录: ${rulesSourceDir}`;
+        }
+        return `✅ 同步完成！
+Rules 类型: ${projectType}
+IDE: ${targetIDE}
+目标目录: ${targetPath}
+复制文件数: ${copiedCount}
+缓存目录: ${RULES_CACHE_DIR}`;
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return `❌ 同步失败: ${errorMsg}`;
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/tools/sync.js.map

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

package/dist/tools/utils.d.ts

@@ -0,0 +1,34 @@
+export declare const HOME: string;
+export declare const CWD: string;
+export declare const GIT_REPO = "git@coding.jd.com:IBKFXHJDBM/RulesManager.git";
+export declare const GIT_BRANCH = "develop";
+export declare const RULES_CACHE_DIR: string;
+export type ProjectType = "ios" | "android" | "web" | "flutter" | "unknown";
+export declare const IDE_PATHS: Record<string, string>;
+export declare function log(message: string): void;
+export declare function detectProjectType(): ProjectType;
+export declare function detectProjectName(): string;
+export declare function sanitizeProjectName(name: string): string;
+export declare function normalizeRulesType(input: string): ProjectType;
+export declare function validateAndGetRulesType(rulesType?: string): {
+    type: ProjectType;
+    error?: string;
+};
+export declare function validateAndGetIDE(ide?: string): {
+    ide: string;
+    path: string;
+    error?: string;
+};
+export declare function getGitRulesDir(projectType: ProjectType): string;
+export declare function detectCurrentIDE(): string;
+export declare function initializeGitCache(): void;
+export declare function setupSparseCheckout(rulesDir: string): void;
+export declare function checkoutOrCreateBranch(branchName: string, baseBranch?: string): void;
+export declare function fetchRulesFromGit(projectType: ProjectType): Promise<string>;
+export declare function copyMarkdownFiles(src: string, dest: string, options?: {
+    backup?: boolean;
+}): {
+    count: number;
+    backups: string[];
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/tools/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,IAAI,QAAoD,CAAC;AACtE,eAAO,MAAM,GAAG,QAAgB,CAAC;AAGjC,eAAO,MAAM,QAAQ,kDAAkD,CAAC;AACxE,eAAO,MAAM,UAAU,YAAY,CAAC;AACpC,eAAO,MAAM,eAAe,QAA4C,CAAC;AAGzE,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAG5E,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI5C,CAAC;AAEF,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,QAElC;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAsC/C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAwD1C;AAGD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAiB7D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAejG;AAED,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAa7F;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAS/D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAUzC;AAGD,wBAAgB,kBAAkB,IAAI,IAAI,CAyBzC;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAY1D;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,MAAmB,GAAG,IAAI,CAmChG;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCjF;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAqB,GAC/C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAsCtC"}

package/dist/tools/utils.js

@@ -0,0 +1,324 @@
+import * as fs from "fs";
+import * as path from "path";
+import { execSync } from "child_process";
+export const HOME = process.env.HOME || process.env.USERPROFILE || "";
+export const CWD = process.cwd();
+// Git 仓库配置
+export const GIT_REPO = "git@coding.jd.com:IBKFXHJDBM/RulesManager.git";
+export const GIT_BRANCH = "develop";
+export const RULES_CACHE_DIR = path.join(HOME, ".bmall-mcp/rules-cache");
+// IDE 的 Rules 目录映射（项目级别）
+export const IDE_PATHS = {
+    kiro: path.join(CWD, ".kiro/steering/bmall"),
+    cursor: path.join(CWD, ".cursor/rules/bmall"),
+    windsurf: path.join(CWD, ".windsurfrules"),
+};
+export function log(message) {
+    console.error(`[bmall-mcp] ${message}`);
+}
+export function detectProjectType() {
+    const checks = [
+        ["ios/Podfile", "ios"],
+        ["*.xcodeproj", "ios"],
+        ["Podfile", "ios"],
+        ["android/build.gradle", "android"],
+        ["build.gradle", "android"],
+        ["AndroidManifest.xml", "android"],
+        ["package.json", "web"],
+        ["webpack.config.js", "web"],
+        ["tsconfig.json", "web"],
+        ["vite.config.ts", "web"],
+        ["pubspec.yaml", "flutter"],
+        ["flutter.yaml", "flutter"],
+    ];
+    for (const [pattern, type] of checks) {
+        try {
+            if (pattern.includes("*")) {
+                const files = fs.readdirSync(CWD);
+                if (files.some(f => f.match(pattern.replace("*", ".*")))) {
+                    log(`检测到 ${type} 项目特征: ${pattern}`);
+                    return type;
+                }
+            }
+            else {
+                const fullPath = path.join(CWD, pattern);
+                if (fs.existsSync(fullPath)) {
+                    log(`检测到 ${type} 项目特征: ${pattern}`);
+                    return type;
+                }
+            }
+        }
+        catch (e) {
+            // 继续
+        }
+    }
+    log(`未检测到项目类型，使用默认值: iOS`);
+    return "ios";
+}
+export function detectProjectName() {
+    // 优先级：package.json > Podfile > pubspec.yaml > 目录名
+    // 1. 检查 package.json
+    const packageJsonPath = path.join(CWD, "package.json");
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const content = fs.readFileSync(packageJsonPath, "utf-8");
+            const json = JSON.parse(content);
+            if (json.name) {
+                const name = sanitizeProjectName(json.name);
+                log(`从 package.json 检测到项目名: ${name}`);
+                return name;
+            }
+        }
+        catch (e) {
+            // 继续
+        }
+    }
+    // 2. 检查 Podfile
+    const podfilePath = path.join(CWD, "Podfile");
+    if (fs.existsSync(podfilePath)) {
+        try {
+            const content = fs.readFileSync(podfilePath, "utf-8");
+            const match = content.match(/platform\s*:\s*:ios.*?target\s+['"](.*?)['"]/s);
+            if (match && match[1]) {
+                const name = sanitizeProjectName(match[1]);
+                log(`从 Podfile 检测到项目名: ${name}`);
+                return name;
+            }
+        }
+        catch (e) {
+            // 继续
+        }
+    }
+    // 3. 检查 pubspec.yaml
+    const pubspecPath = path.join(CWD, "pubspec.yaml");
+    if (fs.existsSync(pubspecPath)) {
+        try {
+            const content = fs.readFileSync(pubspecPath, "utf-8");
+            const match = content.match(/^name:\s*(.+?)$/m);
+            if (match && match[1]) {
+                const name = sanitizeProjectName(match[1]);
+                log(`从 pubspec.yaml 检测到项目名: ${name}`);
+                return name;
+            }
+        }
+        catch (e) {
+            // 继续
+        }
+    }
+    // 4. 使用目录名
+    const dirName = path.basename(CWD);
+    const name = sanitizeProjectName(dirName);
+    log(`使用目录名作为项目名: ${name}`);
+    return name;
+}
+// 清理项目名，确保可以用作分支名
+export function sanitizeProjectName(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9-_]/g, "-") // 非法字符替换为 -
+        .replace(/-+/g, "-") // 多个 - 合并
+        .replace(/^-|-$/g, ""); // 去掉首尾 -
+}
+export function normalizeRulesType(input) {
+    const normalized = input.toLowerCase().trim();
+    if (["ios", "i", "iphone", "objective-c", "objc", "oc"].includes(normalized)) {
+        return "ios";
+    }
+    if (["android", "a", "kotlin", "java"].includes(normalized)) {
+        return "android";
+    }
+    if (["web", "w", "javascript", "js", "typescript", "ts", "react", "vue", "angular"].includes(normalized)) {
+        return "web";
+    }
+    if (["flutter", "f", "dart"].includes(normalized)) {
+        return "flutter";
+    }
+    return "unknown";
+}
+export function validateAndGetRulesType(rulesType) {
+    if (rulesType) {
+        const normalized = normalizeRulesType(rulesType);
+        if (normalized === "unknown") {
+            return {
+                type: "ios",
+                error: `❌ 不支持的 Rules 类型: ${rulesType}\n支持的类型: iOS/Android/Web/Flutter (或其他别名)`,
+            };
+        }
+        log(`使用用户指定的 Rules 类型: ${normalized}`);
+        return { type: normalized };
+    }
+    const projectType = detectProjectType();
+    return { type: projectType };
+}
+export function validateAndGetIDE(ide) {
+    const targetIDE = ide || detectCurrentIDE();
+    const idePath = IDE_PATHS[targetIDE];
+    if (!idePath) {
+        return {
+            ide: targetIDE,
+            path: "",
+            error: `❌ 不支持的 IDE: ${targetIDE}\n支持的 IDE: kiro, cursor, windsurf`,
+        };
+    }
+    return { ide: targetIDE, path: idePath };
+}
+export function getGitRulesDir(projectType) {
+    const dirMap = {
+        ios: "iOS",
+        android: "Android",
+        web: "Web",
+        flutter: "Flutter",
+        unknown: "iOS",
+    };
+    return dirMap[projectType];
+}
+export function detectCurrentIDE() {
+    if (process.env.KIRO_HOME)
+        return "kiro";
+    if (process.env.CURSOR_HOME)
+        return "cursor";
+    if (process.env.WINDSURF_HOME)
+        return "windsurf";
+    if (fs.existsSync(path.join(HOME, ".kiro")))
+        return "kiro";
+    if (fs.existsSync(path.join(HOME, ".cursor")))
+        return "cursor";
+    if (fs.existsSync(path.join(HOME, ".codeium/windsurf")))
+        return "windsurf";
+    return "kiro";
+}
+// Git 操作公共函数
+export function initializeGitCache() {
+    const gitDir = path.join(RULES_CACHE_DIR, ".git");
+    // 检查 .git 目录是否存在且有效
+    if (fs.existsSync(gitDir)) {
+        try {
+            execSync(`git -C ${RULES_CACHE_DIR} status`, { stdio: "pipe" });
+            return; // Git 仓库有效
+        }
+        catch (e) {
+            log(`Git 仓库损坏，重新初始化...`);
+            fs.rmSync(RULES_CACHE_DIR, { recursive: true, force: true });
+        }
+    }
+    log(`创建缓存目录: ${RULES_CACHE_DIR}`);
+    fs.mkdirSync(RULES_CACHE_DIR, { recursive: true });
+    log(`初始化 Git 仓库...`);
+    execSync(`git init ${RULES_CACHE_DIR}`, { stdio: "inherit" });
+    log(`添加远程: ${GIT_REPO}`);
+    execSync(`git -C ${RULES_CACHE_DIR} remote add origin ${GIT_REPO}`, { stdio: "inherit" });
+}
+export function setupSparseCheckout(rulesDir) {
+    log(`配置 sparse-checkout...`);
+    execSync(`git -C ${RULES_CACHE_DIR} config core.sparseCheckout true`, {
+        stdio: "inherit",
+    });
+    const sparseCheckoutFile = path.join(RULES_CACHE_DIR, ".git/info/sparse-checkout");
+    fs.writeFileSync(sparseCheckoutFile, `${rulesDir}/\n`);
+    log(`设置只克隆 ${rulesDir} 目录...`);
+}
+export function checkoutOrCreateBranch(branchName, baseBranch = GIT_BRANCH) {
+    log(`检出或创建分支 ${branchName}...`);
+    // 先尝试检出远程分支（如果存在）
+    try {
+        execSync(`git -C ${RULES_CACHE_DIR} fetch origin ${branchName}`, {
+            stdio: "pipe",
+        });
+        // 远程分支存在，检出并跟踪
+        execSync(`git -C ${RULES_CACHE_DIR} checkout -B ${branchName} origin/${branchName}`, {
+            stdio: "inherit",
+        });
+        log(`检出远程分支: ${branchName}`);
+        return;
+    }
+    catch (e) {
+        // 远程分支不存在，继续创建新分支
+    }
+    // 基于主分支创建新分支
+    log(`远程分支不存在，基于 ${baseBranch} 创建...`);
+    try {
+        execSync(`git -C ${RULES_CACHE_DIR} checkout -B ${baseBranch} origin/${baseBranch}`, {
+            stdio: "inherit",
+        });
+        execSync(`git -C ${RULES_CACHE_DIR} checkout -b ${branchName}`, {
+            stdio: "inherit",
+        });
+        log(`创建新分支: ${branchName}`);
+    }
+    catch (e2) {
+        log(`主分支不存在，创建孤立分支...`);
+        execSync(`git -C ${RULES_CACHE_DIR} checkout --orphan ${branchName}`, {
+            stdio: "inherit",
+        });
+        log(`创建孤立分支: ${branchName}`);
+    }
+}
+export async function fetchRulesFromGit(projectType) {
+    const rulesDir = getGitRulesDir(projectType);
+    log(`Git 仓库: ${GIT_REPO}`);
+    log(`分支: ${GIT_BRANCH}`);
+    log(`Rules 目录: ${rulesDir}`);
+    // 初始化缓存仓库
+    initializeGitCache();
+    // 设置 sparse-checkout
+    setupSparseCheckout(rulesDir);
+    // 拉取远程分支
+    log(`拉取分支 ${GIT_BRANCH}...`);
+    execSync(`git -C ${RULES_CACHE_DIR} fetch origin ${GIT_BRANCH}`, {
+        stdio: "inherit",
+    });
+    // 检出到 origin/develop（避免本地分支不存在的问题）
+    log(`检出 origin/${GIT_BRANCH}...`);
+    try {
+        execSync(`git -C ${RULES_CACHE_DIR} checkout -B ${GIT_BRANCH} origin/${GIT_BRANCH}`, {
+            stdio: "inherit",
+        });
+    }
+    catch (e) {
+        // 如果失败，尝试直接检出 FETCH_HEAD
+        execSync(`git -C ${RULES_CACHE_DIR} checkout FETCH_HEAD`, {
+            stdio: "inherit",
+        });
+    }
+    const projectRulesDir = path.join(RULES_CACHE_DIR, rulesDir);
+    if (!fs.existsSync(projectRulesDir)) {
+        throw new Error(`${rulesDir} 目录不存在: ${projectRulesDir}`);
+    }
+    log(`${rulesDir} 目录: ${projectRulesDir}`);
+    return projectRulesDir;
+}
+export function copyMarkdownFiles(src, dest, options = { backup: true }) {
+    if (!fs.existsSync(dest)) {
+        fs.mkdirSync(dest, { recursive: true });
+    }
+    let count = 0;
+    const backups = [];
+    const files = fs.readdirSync(src);
+    for (const file of files) {
+        if (file.startsWith(".") || file === "node_modules") {
+            continue;
+        }
+        const srcPath = path.join(src, file);
+        const destPath = path.join(dest, file);
+        const stat = fs.statSync(srcPath);
+        if (stat.isDirectory()) {
+            const result = copyMarkdownFiles(srcPath, destPath, options);
+            count += result.count;
+            backups.push(...result.backups);
+        }
+        else if (file.endsWith(".md")) {
+            // 如果目标文件已存在且需要备份
+            if (options.backup && fs.existsSync(destPath)) {
+                const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+                const backupPath = `${destPath}.backup.${timestamp}`;
+                fs.copyFileSync(destPath, backupPath);
+                backups.push(backupPath);
+                log(`备份文件: ${destPath} → ${backupPath}`);
+            }
+            fs.copyFileSync(srcPath, destPath);
+            count++;
+        }
+    }
+    return { count, backups };
+}
+//# sourceMappingURL=utils.js.map