@szc-ft/mcp-szcd-client 0.11.0

package/scripts/lib/qoder.js

@@ -0,0 +1,426 @@
+/**
+ * qoder.js — Qoder CLI 兼容逻辑
+ *
+ * 导出 setupQoder(deps) 供 postinstall.js 调用。
+ * deps 需包含: { getMcpServerUrl, getMcpServerName, safeExecSync, isCommandAvailable, ensureDirectory, copyFile, writeFile, SKILL_SOURCE, PROJECT_ROOT, PACKAGE_ROOT }
+ *
+ * Qoder CLI 配置方式（SSE 模式，与其他客户端一致）：
+ *   - 优先使用 CLI: qoder mcp add <name> -s user -- <sse-url>
+ *   - 回退方案: 直接修改 ~/.qoder/settings.json
+ *   - Skill 复制: ~/.qoder/skills/<serverName>/SKILL.md
+ *   - Agent 复制: ~/.qoder/agents/<agentName>.md
+ *   - Command 复制: ~/.qoder/commands/<commandName>.md
+ *
+ * Qoder 目录结构：
+ *   ~/.qoder/
+ *   ├── settings.json        # 权限/Hook/MCP 配置
+ *   ├── agents/              # 子代理
+ *   │   └── <agentName>.md
+ *   ├── skills/              # Skills
+ *   │   └── <skillName>/
+ *   │       └── SKILL.md
+ *   ├── commands/            # 自定义命令
+ *   │   └── <commandName>.md
+ *   └── hooks/               # Hook 脚本
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { execSync } from "node:child_process";
+
+// ==================== 路径工具 ====================
+
+function getHomeDir() {
+    if (os.platform() === "win32") {
+        return process.env.USERPROFILE || process.env.HOME || os.homedir();
+    }
+    return process.env.HOME || os.homedir();
+}
+
+function getQoderUserDirectory() {
+    const homeDir = getHomeDir();
+    if (!homeDir) throw new Error("Home directory not found");
+    return path.join(homeDir, ".qoder");
+}
+
+function getQoderSkillsDirectory() {
+    return path.join(getQoderUserDirectory(), "skills");
+}
+
+function getQoderAgentsDirectory() {
+    return path.join(getQoderUserDirectory(), "agents");
+}
+
+function getQoderCommandsDirectory() {
+    return path.join(getQoderUserDirectory(), "commands");
+}
+
+function getQoderSettingsPath() {
+    return path.join(getQoderUserDirectory(), "settings.json");
+}
+
+function getQoderProjectSettingsPath(projectRoot) {
+    return path.join(projectRoot, ".qoder", "settings.json");
+}
+
+// ==================== JSON 读写 ====================
+
+function readJsonFile(filePath) {
+    if (!fs.existsSync(filePath)) return {};
+    try {
+        return JSON.parse(fs.readFileSync(filePath, "utf8"));
+    } catch {
+        return {};
+    }
+}
+
+function writeJsonFile(filePath, data) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+}
+
+// ==================== MCP 配置（SSE 模式） ====================
+
+/**
+ * 方式1: 通过 CLI 配置 MCP 服务器（推荐）
+ * qoder mcp add <name> -s user -- <sse-url>
+ */
+function addMcpViaCLI(deps, scope = "user") {
+    if (!deps.isCommandAvailable("qoder")) {
+        console.log(`⏭️  Skipping Qoder CLI MCP setup (${scope}): qoder command not found`);
+        return false;
+    }
+
+    const serverName = deps.getMcpServerName();
+    const sseUrl = `${deps.getMcpServerUrl()}/sse`;
+    const scopeFlag = scope === "project" ? "-s project" : "-s user";
+
+    const result = deps.safeExecSync(
+        `qoder mcp add ${serverName} ${scopeFlag} -- ${sseUrl}`,
+    );
+
+    if (result === true) {
+        console.log(`✓ Qoder CLI MCP server added (${scope}): ${serverName} (${sseUrl})`);
+        return true;
+    }
+
+    if (result === "already_exists") {
+        console.log(`✓ Qoder CLI MCP server already configured (${scope}): ${serverName}`);
+        return true;
+    }
+
+    // 尝试先移除再添加
+    if (
+        deps.safeExecSync(`qoder mcp remove ${serverName} ${scopeFlag} 2>/dev/null`) &&
+        deps.safeExecSync(`qoder mcp add ${serverName} ${scopeFlag} -- ${sseUrl}`)
+    ) {
+        console.log(`✓ Qoder CLI MCP server updated (${scope}): ${serverName} (${sseUrl})`);
+        return true;
+    }
+
+    console.warn(`⚠️  Failed to configure Qoder CLI MCP server (settings.json will be updated directly)`);
+    return false;
+}
+
+/**
+ * 方式2: 直接修改 ~/.qoder/settings.json
+ * 在 mcpServers 中添加 SSE 类型配置
+ */
+function syncQoderSettings(deps) {
+    const settingsPath = getQoderSettingsPath();
+    const serverName = deps.getMcpServerName();
+    const sseUrl = `${deps.getMcpServerUrl()}/sse`;
+
+    let settings = readJsonFile(settingsPath);
+
+    if (!settings.mcpServers) settings.mcpServers = {};
+
+    const desiredConfig = {
+        type: "sse",
+        url: sseUrl,
+    };
+
+    const current = settings.mcpServers[serverName];
+    if (current && current.type === "sse" && current.url === sseUrl) {
+        console.log(`✓ Qoder ~/.qoder/settings.json already up-to-date: ${serverName} (${sseUrl})`);
+        return;
+    }
+
+    settings.mcpServers[serverName] = desiredConfig;
+
+    writeJsonFile(settingsPath, settings);
+    console.log(`✓ Updated Qoder ~/.qoder/settings.json: ${serverName} (${sseUrl})`);
+}
+
+// ==================== Skill 复制 ====================
+
+function copySkillToQoder(deps, isProjectLevel = false) {
+    const skillName = deps.getMcpServerName();
+    let qoderSkillsDir;
+
+    if (isProjectLevel) {
+        qoderSkillsDir = path.join(deps.PROJECT_ROOT, ".qoder", "skills");
+    } else {
+        qoderSkillsDir = getQoderSkillsDirectory();
+    }
+
+    const skillDir = path.join(qoderSkillsDir, skillName);
+
+    try {
+        deps.ensureDirectory(skillDir);
+        const skillDest = path.join(skillDir, "SKILL.md");
+        deps.copyFile(deps.SKILL_SOURCE, skillDest);
+        console.log(`✓ Copied skill to Qoder ${isProjectLevel ? "project" : "user"} directory: ${skillDir}`);
+        return true;
+    } catch (error) {
+        console.log(`⚠️  Failed to copy skill to Qoder ${isProjectLevel ? "project" : "user"} directory: ${error.message}`);
+        return false;
+    }
+}
+
+// ==================== Agent 安装 ====================
+
+function copyAgentsToQoder(deps, isProjectLevel = false) {
+    const agentsSourceDir = path.join(deps.PACKAGE_ROOT, "agents");
+    if (!fs.existsSync(agentsSourceDir)) {
+        console.log("⏭️  Skipping agent install: agents source directory not found");
+        return false;
+    }
+
+    let qoderAgentsDir;
+    if (isProjectLevel) {
+        qoderAgentsDir = path.join(deps.PROJECT_ROOT, ".qoder", "agents");
+    } else {
+        qoderAgentsDir = getQoderAgentsDirectory();
+    }
+
+    // Qoder 只复制不含 .trae. 的 .md 文件（原生格式，同 Claude Code）
+    const agentFiles = fs.readdirSync(agentsSourceDir).filter(
+        (f) => f.endsWith(".md") && !f.includes(".trae."),
+    );
+
+    let copied = 0;
+    for (const agentFile of agentFiles) {
+        const sourcePath = path.join(agentsSourceDir, agentFile);
+        const destPath = path.join(qoderAgentsDir, agentFile);
+
+        try {
+            deps.ensureDirectory(qoderAgentsDir);
+            deps.copyFile(sourcePath, destPath);
+            copied++;
+        } catch (error) {
+            console.log(`⚠️  Failed to copy agent ${agentFile}: ${error.message}`);
+        }
+    }
+
+    if (copied > 0) {
+        console.log(`✓ Copied ${copied} agent(s) to Qoder ${isProjectLevel ? "project" : "user"} directory: ${qoderAgentsDir}`);
+        return true;
+    }
+    return false;
+}
+
+// ==================== Command 安装 ====================
+
+function copyCommandsToQoder(deps, isProjectLevel = false) {
+    const commandsSourceDir = path.join(deps.PACKAGE_ROOT, "commands");
+    if (!fs.existsSync(commandsSourceDir)) {
+        console.log("⏭️  Skipping command install: commands source directory not found");
+        return false;
+    }
+
+    let qoderCommandsDir;
+    if (isProjectLevel) {
+        qoderCommandsDir = path.join(deps.PROJECT_ROOT, ".qoder", "commands");
+    } else {
+        qoderCommandsDir = getQoderCommandsDirectory();
+    }
+
+    const commandFiles = fs.readdirSync(commandsSourceDir).filter((f) => f.endsWith(".md"));
+    let copied = 0;
+
+    for (const cmdFile of commandFiles) {
+        const sourcePath = path.join(commandsSourceDir, cmdFile);
+        const destPath = path.join(qoderCommandsDir, cmdFile);
+
+        try {
+            deps.ensureDirectory(qoderCommandsDir);
+
+            // 如果目标已存在且内容不同，跳过（用户可能已修改）
+            if (fs.existsSync(destPath)) {
+                const existingContent = fs.readFileSync(destPath, "utf8").trim();
+                const sourceContent = fs.readFileSync(sourcePath, "utf8").trim();
+                if (existingContent !== sourceContent) {
+                    console.log(`⏭️  Skipping Qoder command ${cmdFile}: already exists (user modified)`);
+                    continue;
+                }
+            }
+
+            deps.copyFile(sourcePath, destPath);
+            copied++;
+        } catch (error) {
+            console.log(`⚠️  Failed to copy command ${cmdFile}: ${error.message}`);
+        }
+    }
+
+    if (copied > 0) {
+        console.log(`✓ Copied ${copied} command(s) to Qoder ${isProjectLevel ? "project" : "user"} directory: ${qoderCommandsDir}`);
+        return true;
+    }
+    return false;
+}
+
+// ==================== 项目级配置 ====================
+
+function setupQoderProjectConfig(deps) {
+    const serverName = deps.getMcpServerName();
+    const sseUrl = `${deps.getMcpServerUrl()}/sse`;
+
+    // 优先 CLI
+    if (addMcpViaCLI(deps, "project")) {
+        return true;
+    }
+
+    // 回退到直接修改项目级 .qoder/settings.json
+    const projectSettingsPath = getQoderProjectSettingsPath(deps.PROJECT_ROOT);
+    const projectQoderDir = path.dirname(projectSettingsPath);
+
+    if (!fs.existsSync(projectQoderDir)) {
+        console.log("⏭️  Skipping Qoder project settings: .qoder/ directory not found in project");
+        return false;
+    }
+
+    let settings = readJsonFile(projectSettingsPath);
+    if (!settings.mcpServers) settings.mcpServers = {};
+
+    settings.mcpServers[serverName] = {
+        type: "sse",
+        url: sseUrl,
+    };
+
+    writeJsonFile(projectSettingsPath, settings);
+    console.log(`✓ Updated Qoder project .qoder/settings.json: ${serverName} (${sseUrl})`);
+    return true;
+}
+
+// ==================== MCP URL 同步（供 update-mcp-url.js 调用） ====================
+
+/**
+ * 不依赖 deps 的 CLI 可用性检测
+ */
+function isCommandAvailable(cmd) {
+    try {
+        execSync(`which ${cmd} 2>/dev/null`, { stdio: "pipe", timeout: 3000 });
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+/**
+ * 不依赖 deps 的安全命令执行
+ */
+function safeExecSync(command) {
+    try {
+        execSync(command, { stdio: "pipe", timeout: 10000 });
+        return true;
+    } catch (e) {
+        const stderr = e.stderr?.toString() || "";
+        if (stderr.includes("already exists")) return "already_exists";
+        return false;
+    }
+}
+
+/**
+ * 同步 Qoder 配置中的 MCP 服务器 URL
+ * @param {string} targetUrl - 新的 MCP 服务器基础 URL（如 http://localhost:3456）
+ * @param {string} serverName - MCP 服务器名称
+ */
+export function syncMcpUrl(targetUrl, serverName) {
+    const sseUrl = `${targetUrl}/sse`;
+
+    // 1. CLI 命令同步
+    if (isCommandAvailable("qoder")) {
+        safeExecSync(`qoder mcp remove ${serverName} -s user 2>/dev/null`);
+        const result = safeExecSync(
+            `qoder mcp add ${serverName} -s user -- ${sseUrl}`,
+        );
+        if (result === true || result === "already_exists") {
+            console.log(`✓ Qoder CLI synced: ${serverName} (${sseUrl})`);
+        } else {
+            console.warn(`⚠️  Qoder CLI sync failed (settings.json will be updated directly)`);
+        }
+    } else {
+        console.log("⏭️  Skipping Qoder CLI sync: qoder not found");
+    }
+
+    // 2. 直接文件操作同步 ~/.qoder/settings.json
+    syncQoderSettingsDirect(targetUrl, serverName);
+}
+
+/**
+ * 直接文件操作同步 ~/.qoder/settings.json（独立于 deps）
+ */
+function syncQoderSettingsDirect(targetUrl, serverName) {
+    const settingsPath = getQoderSettingsPath();
+    const sseUrl = `${targetUrl}/sse`;
+
+    let settings = readJsonFile(settingsPath);
+
+    if (!settings.mcpServers) settings.mcpServers = {};
+
+    const current = settings.mcpServers[serverName];
+    if (current && current.type === "sse" && current.url === sseUrl) {
+        console.log(`⏭️  Qoder ~/.qoder/settings.json already up-to-date: ${serverName} (${sseUrl})`);
+        return;
+    }
+
+    settings.mcpServers[serverName] = {
+        type: "sse",
+        url: sseUrl,
+    };
+
+    writeJsonFile(settingsPath, settings);
+    console.log(`✓ Updated Qoder ~/.qoder/settings.json: ${serverName} (${sseUrl})`);
+}
+
+// ==================== 导出 ====================
+
+export function setupQoder(deps) {
+    console.log("\n📦 Setting up Qoder CLI compatibility...\n");
+
+    // ---- MCP 配置（SSE 模式） ----
+    addMcpViaCLI(deps, "user");
+    syncQoderSettings(deps);
+
+    // ---- 用户级安装 ----
+    copySkillToQoder(deps, false);
+    copyAgentsToQoder(deps, false);
+    copyCommandsToQoder(deps, false);
+
+    // ---- 项目级安装（暂不启用，用户级足够） ----
+    // let qoderProjectInstalled = false;
+    // if (deps.PROJECT_ROOT && fs.existsSync(deps.PROJECT_ROOT)) {
+    //     try {
+    //         qoderProjectInstalled = setupQoderProjectConfig(deps);
+    //         if (qoderProjectInstalled) {
+    //             copySkillToQoder(deps, true);
+    //             copyAgentsToQoder(deps, true);
+    //             copyCommandsToQoder(deps, true);
+    //         }
+    //     } catch (e) {
+    //         console.log(`⚠️  Failed to install Qoder project config: ${e.message}`);
+    //     }
+    // }
+
+    return {
+        qoderProjectInstalled: false,
+        skillsDirectory: getQoderSkillsDirectory(),
+        agentsDirectory: getQoderAgentsDirectory(),
+        commandsDirectory: getQoderCommandsDirectory(),
+    };
+}