feihong-code 7.2.0 → 7.6.0

package/dist/integrations/feishu-bridge.js

@@ -0,0 +1,348 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFeishuConfig = loadFeishuConfig;
+exports.isFeishuEnabled = isFeishuEnabled;
+exports.decryptFeishuEvent = decryptFeishuEvent;
+exports.parseFeishuEvent = parseFeishuEvent;
+exports.setFeishuBridgeDeps = setFeishuBridgeDeps;
+exports.handleFeishuCallback = handleFeishuCallback;
+exports.sendFeishuReply = sendFeishuReply;
+exports.initFeishuBridge = initFeishuBridge;
+/**
+ * 飞虹 Code (对标 Muse Code · 自研内核)
+ * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+ *
+ * 飞书桥接（Feishu/Lark Bridge）：
+ *  - 入站：飞书事件订阅（im.message.receive_v1），URL 验证 + 消息接收 + 签名校验 + 解密
+ *  - 出站：复用 FeishuIntegration 发送文本/卡片消息
+ *  - 桥接：消息 → TaskQueue → 结果主动推送
+ *
+ * 环境变量配置：
+ *  FH_FEISHU_ENABLED=true
+ *  FH_FEISHU_APP_ID=飞书应用App ID
+ *  FH_FEISHU_APP_SECRET=飞书应用App Secret
+ *  FH_FEISHU_VERIFICATION_TOKEN=事件订阅验证Token
+ *  FH_FEISHU_ENCRYPT_KEY=事件加密Key（可选，配置后消息需解密）
+ *  FH_FEISHU_WORKSPACE=飞书任务工作目录（默认 ~/.fhcode/feishu-workspace）
+ *
+ * 飞书开放平台配置：
+ *  - 事件订阅请求地址：https://your-domain:8080/api/feishu/callback
+ *  - 订阅事件：接收消息 im.message.receive_v1
+ *  - 权限：im:message（获取与发送消息）、im:message:send_as_bot（以应用身份发消息）
+ *
+ * 安全：
+ *  - verification_token 校验（fail-closed）
+ *  - encrypt_key AES-256-CBC 解密（配置后强制）
+ *  - event_id 幂等去重
+ *  - 用户会话隔离
+ */
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const logger_1 = require("../shared/logger");
+const collaboration_1 = require("./collaboration");
+function loadFeishuConfig() {
+    const enabled = process.env.FH_FEISHU_ENABLED === 'true';
+    const workspace = process.env.FH_FEISHU_WORKSPACE || (0, path_1.join)((0, os_1.homedir)(), '.fhcode', 'feishu-workspace');
+    if (enabled && !(0, fs_1.existsSync)(workspace))
+        (0, fs_1.mkdirSync)(workspace, { recursive: true });
+    return {
+        enabled,
+        appId: process.env.FH_FEISHU_APP_ID || '',
+        appSecret: process.env.FH_FEISHU_APP_SECRET || '',
+        verificationToken: process.env.FH_FEISHU_VERIFICATION_TOKEN || '',
+        encryptKey: process.env.FH_FEISHU_ENCRYPT_KEY,
+        workspace,
+    };
+}
+function isFeishuEnabled(cfg) {
+    return cfg.enabled && !!cfg.appId && !!cfg.appSecret && !!cfg.verificationToken;
+}
+/* ===================== 飞书事件解密 ===================== */
+/**
+ * 飞书事件加密解密（AES-256-CBC）。
+ * 规范：key = sha256(encrypt_key) 前 32 字节；IV = 密文 base64 解码后前 16 字节；
+ * 密文 = IV + 加密内容；PKCS7 填充。
+ */
+function decryptFeishuEvent(encryptKey, encryptedBase64) {
+    const key = (0, crypto_1.createHash)('sha256').update(encryptKey).digest();
+    const encrypted = Buffer.from(encryptedBase64, 'base64');
+    const iv = encrypted.subarray(0, 16);
+    const data = encrypted.subarray(16);
+    const decipher = (0, crypto_1.createDecipheriv)('aes-256-cbc', key, iv);
+    decipher.setAutoPadding(true);
+    const decrypted = Buffer.concat([decipher.update(data), decipher.final()]);
+    return decrypted.toString('utf8');
+}
+/** 解析飞书事件订阅 v2.0 消息 */
+function parseFeishuEvent(body) {
+    // URL 验证事件
+    if (body.type === 'url_verification')
+        return null;
+    // v2.0 事件格式
+    const header = (body.header || {});
+    const event = (body.event || {});
+    const eventType = header.event_type;
+    if (eventType !== 'im.message.receive_v1') {
+        logger_1.logger.info('feishu: ignoring non-message event', { eventType });
+        return null;
+    }
+    const sender = (event.sender || {});
+    const senderId = (sender.sender_id || {});
+    const message = (event.message || {});
+    const openId = (senderId.open_id || '');
+    const messageId = (message.message_id || '');
+    const messageType = (message.message_type || '');
+    const chatType = (message.chat_type || 'p2p');
+    const chatId = (message.chat_id || '');
+    // 解析文本内容（content 是 JSON 字符串）
+    let text;
+    if (messageType === 'text' && message.content) {
+        try {
+            const content = JSON.parse(message.content);
+            text = content.text || '';
+        }
+        catch {
+            text = message.content;
+        }
+    }
+    return {
+        eventId: (header.event_id || ''),
+        openId,
+        userId: senderId.user_id || undefined,
+        messageId,
+        messageType,
+        text,
+        chatType,
+        chatId,
+        raw: body,
+    };
+}
+const feishuSessions = new Map();
+const FEISHU_SESSION_FILE = (0, path_1.join)((0, os_1.homedir)(), '.fhcode', 'feishu-sessions.json');
+function loadFeishuSessions() {
+    if ((0, fs_1.existsSync)(FEISHU_SESSION_FILE)) {
+        try {
+            const data = JSON.parse((0, fs_1.readFileSync)(FEISHU_SESSION_FILE, 'utf8'));
+            for (const [k, v] of Object.entries(data))
+                feishuSessions.set(k, v);
+        }
+        catch (e) {
+            logger_1.logger.warn('feishu sessions load failed', { error: e instanceof Error ? e.message : String(e) });
+        }
+    }
+}
+function saveFeishuSessions() {
+    try {
+        const dir = (0, path_1.join)((0, os_1.homedir)(), '.fhcode');
+        if (!(0, fs_1.existsSync)(dir))
+            (0, fs_1.mkdirSync)(dir, { recursive: true });
+        const data = {};
+        for (const [k, v] of feishuSessions)
+            data[k] = v;
+        (0, fs_1.writeFileSync)(FEISHU_SESSION_FILE, JSON.stringify(data, null, 2), 'utf8');
+    }
+    catch (e) {
+        logger_1.logger.warn('feishu sessions save failed', { error: e instanceof Error ? e.message : String(e) });
+    }
+}
+function getFeishuSession(openId) {
+    let s = feishuSessions.get(openId);
+    if (!s) {
+        s = { openId, lastActive: new Date().toISOString(), eventIds: [] };
+        feishuSessions.set(openId, s);
+    }
+    return s;
+}
+function isFeishuDuplicate(session, eventId) {
+    if (!eventId)
+        return false;
+    if (session.eventIds.includes(eventId))
+        return true;
+    session.eventIds.push(eventId);
+    if (session.eventIds.length > 100)
+        session.eventIds = session.eventIds.slice(-100);
+    return false;
+}
+/* ===================== 桥接核心 ===================== */
+let taskQueueRef = null;
+let feishuIntegration = null;
+/** 注入 TaskQueue 引用和 FeishuIntegration（web server 启动时调用） */
+function setFeishuBridgeDeps(queue, integration) {
+    taskQueueRef = queue;
+    feishuIntegration = integration;
+}
+/**
+ * 处理飞书事件订阅回调：
+ *  1. URL 验证（type=url_verification）→ 返回 challenge
+ *  2. 解密（如配置了 encrypt_key）
+ *  3. verification_token 校验（fail-closed）
+ *  4. 消息解析（im.message.receive_v1）
+ *  5. 幂等去重（event_id）
+ *  6. 转发到 TaskQueue
+ *  7. 立即返回 200，结果异步推送
+ */
+async function handleFeishuCallback(cfg, body) {
+    if (!isFeishuEnabled(cfg)) {
+        return { status: 404, body: { error: 'feishu bridge not configured' }, contentType: 'application/json' };
+    }
+    try {
+        let eventBody = body;
+        // 加密消息解密
+        if (body.encrypt && cfg.encryptKey) {
+            try {
+                const decrypted = decryptFeishuEvent(cfg.encryptKey, body.encrypt);
+                eventBody = JSON.parse(decrypted);
+            }
+            catch (e) {
+                logger_1.logger.error('feishu event decrypt failed', { error: e instanceof Error ? e.message : String(e) });
+                return { status: 400, body: { error: 'decrypt failed' }, contentType: 'application/json' };
+            }
+        }
+        // URL 验证
+        if (eventBody.type === 'url_verification') {
+            const token = (eventBody.token || '');
+            if (token !== cfg.verificationToken) {
+                logger_1.logger.warn('feishu url_verification token mismatch');
+                return { status: 403, body: { error: 'invalid token' }, contentType: 'application/json' };
+            }
+            return { status: 200, body: { challenge: eventBody.challenge }, contentType: 'application/json' };
+        }
+        // verification_token 校验（v2.0 header.token）
+        const header = (eventBody.header || {});
+        const headerToken = (header.token || '');
+        if (headerToken && headerToken !== cfg.verificationToken) {
+            logger_1.logger.warn('feishu event token mismatch', { expected: cfg.verificationToken.slice(0, 4) + '...' });
+            return { status: 403, body: { error: 'invalid verification token' }, contentType: 'application/json' };
+        }
+        // 解析消息
+        const msg = parseFeishuEvent(eventBody);
+        if (!msg) {
+            // 非消息事件（如关注、群聊加入等），返回 200 确认
+            return { status: 200, body: { code: 0, msg: 'ok' }, contentType: 'application/json' };
+        }
+        logger_1.logger.info('feishu inbound message', { openId: msg.openId, type: msg.messageType, chatType: msg.chatType, eventId: msg.eventId });
+        // 非文本消息 → 提示
+        if (msg.messageType !== 'text' || !msg.text) {
+            await sendFeishuReply(cfg, msg.openId, '目前仅支持文本消息，请输入文字描述您的需求。');
+            return { status: 200, body: { code: 0, msg: 'ok' }, contentType: 'application/json' };
+        }
+        // 幂等去重
+        const session = getFeishuSession(msg.openId);
+        if (isFeishuDuplicate(session, msg.eventId)) {
+            logger_1.logger.info('feishu duplicate event ignored', { eventId: msg.eventId });
+            return { status: 200, body: { code: 0, msg: 'ok' }, contentType: 'application/json' };
+        }
+        session.lastActive = new Date().toISOString();
+        saveFeishuSessions();
+        // 转发到 TaskQueue
+        if (!taskQueueRef) {
+            logger_1.logger.error('feishu bridge: taskQueue not initialized');
+            await sendFeishuReply(cfg, msg.openId, '服务未就绪，请稍后重试。');
+            return { status: 200, body: { code: 0, msg: 'ok' }, contentType: 'application/json' };
+        }
+        const goal = msg.text.trim();
+        let record;
+        // 多轮续接
+        if (session.taskId) {
+            const existing = taskQueueRef.get(session.taskId);
+            if (existing && (existing.status === 'done' || existing.status === 'failed')) {
+                const continued = taskQueueRef.continueTask(session.taskId, goal);
+                if (continued) {
+                    record = continued;
+                }
+                else {
+                    record = taskQueueRef.submit(goal, { workspaceDir: cfg.workspace });
+                    session.taskId = record.id;
+                }
+            }
+            else if (existing && (existing.status === 'queued' || existing.status === 'running')) {
+                await sendFeishuReply(cfg, msg.openId, '上一个任务仍在处理中，请稍候...');
+                return { status: 200, body: { code: 0, msg: 'ok' }, contentType: 'application/json' };
+            }
+            else {
+                record = taskQueueRef.submit(goal, { workspaceDir: cfg.workspace });
+                session.taskId = record.id;
+            }
+        }
+        else {
+            record = taskQueueRef.submit(goal, { workspaceDir: cfg.workspace });
+            session.taskId = record.id;
+        }
+        saveFeishuSessions();
+        // 异步推送结果
+        void pushFeishuResult(cfg, msg.openId, record.id);
+        // 立即返回确认（飞书要求 3 秒内响应）
+        await sendFeishuReply(cfg, msg.openId, '⏳ 已收到，正在处理中... 完成后将主动推送结果。');
+        return { status: 200, body: { code: 0, msg: 'ok' }, contentType: 'application/json' };
+    }
+    catch (e) {
+        logger_1.logger.error('feishu callback handler error', { error: e instanceof Error ? e.message : String(e) });
+        return { status: 500, body: { error: 'internal error' }, contentType: 'application/json' };
+    }
+}
+/** 发送飞书文本消息（通过 FeishuIntegration 或直接 API） */
+async function sendFeishuReply(cfg, openId, content) {
+    if (feishuIntegration) {
+        await feishuIntegration.sendMessage({
+            title: '飞虹 Code',
+            content,
+            receiver: openId,
+        });
+        return;
+    }
+    // 降级：直接调用 API
+    const feishuCfg = { appId: cfg.appId, appSecret: cfg.appSecret, defaultReceiver: openId };
+    const integration = new collaboration_1.FeishuIntegration(feishuCfg);
+    await integration.sendMessage({ title: '飞虹 Code', content, receiver: openId });
+}
+/** 异步轮询任务结果并推送到飞书 */
+async function pushFeishuResult(cfg, openId, taskId) {
+    if (!taskQueueRef)
+        return;
+    for (let i = 0; i < 60; i++) {
+        await new Promise((r) => setTimeout(r, 10000));
+        const record = taskQueueRef.get(taskId);
+        if (!record)
+            return;
+        if (record.status === 'done') {
+            const answer = record.result?.finalAnswer || '任务完成，但未生成结果。';
+            const maxLen = 3000; // 飞书消息长度限制较宽松
+            const truncated = answer.length > maxLen ? answer.slice(0, maxLen) + '\n\n...（结果过长，已截断，请在 Web 控制台查看完整内容）' : answer;
+            try {
+                await sendFeishuReply(cfg, openId, truncated);
+            }
+            catch (e) {
+                logger_1.logger.error('feishu result push failed', { error: e instanceof Error ? e.message : String(e) });
+            }
+            return;
+        }
+        if (record.status === 'failed') {
+            try {
+                await sendFeishuReply(cfg, openId, `❌ 任务失败: ${(record.error || '未知错误').slice(0, 300)}`);
+            }
+            catch (e) {
+                logger_1.logger.error('feishu failure push failed', { error: e instanceof Error ? e.message : String(e) });
+            }
+            return;
+        }
+    }
+    try {
+        await sendFeishuReply(cfg, openId, '⏱️ 任务处理超时，请在 Web 控制台查看进度。');
+    }
+    catch { /* 忽略 */ }
+}
+/* ===================== 初始化 ===================== */
+function initFeishuBridge() {
+    loadFeishuSessions();
+    const cfg = loadFeishuConfig();
+    if (isFeishuEnabled(cfg)) {
+        logger_1.logger.info('feishu bridge enabled', { appId: cfg.appId, workspace: cfg.workspace });
+    }
+    else {
+        logger_1.logger.info('feishu bridge disabled (set FH_FEISHU_ENABLED=true and configure credentials)');
+    }
+    return cfg;
+}
+//# sourceMappingURL=feishu-bridge.js.map

package/dist/integrations/feishu-bridge.js.map

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

package/dist/integrations/github-mcp.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GITHUB_MCP_TOOL_CATALOG = void 0;
+exports.loadGithubMcpConfig = loadGithubMcpConfig;
+exports.isValidGithubToken = isValidGithubToken;
+exports.isGithubMcpAvailable = isGithubMcpAvailable;
+exports.buildGithubMcpConfig = buildGithubMcpConfig;
+exports.getGithubMcpServers = getGithubMcpServers;
+exports.detectNpxAvailable = detectNpxAvailable;
+exports.getGithubMcpStatus = getGithubMcpStatus;
+/**
+ * 飞虹 Code (对标 Muse Code · 自研内核)
+ * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+ *
+ * GitHub MCP Server 接入：
+ *  - 官方包：@modelcontextprotocol/server-github
+ *  - 启动方式：npx -y @modelcontextprotocol/server-github
+ *  - 认证：GITHUB_PERSONAL_ACCESS_TOKEN 环境变量
+ *  - 能力：仓库管理、Issue/PR、代码搜索、文件读写、推送等
+ *
+ * 环境变量配置：
+ *  FH_GITHUB_MCP_ENABLED=true          # 启用 GitHub MCP（默认 false）
+ *  GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxx # GitHub Personal Access Token（必需）
+ *  FH_GITHUB_MCP_PACKAGE=@modelcontextprotocol/server-github  # 自定义包名（可选）
+ *  FH_GITHUB_MCP_COMMAND=npx           # 启动命令（默认 npx）
+ *
+ * 配置文件方式（fhcode.config.json）：
+ *  {
+ *    "githubMcp": { "enabled": true, "token": "ghp_xxx" }
+ *  }
+ *
+ * 安全：
+ *  - Token 仅通过环境变量传递给 MCP 子进程，不落盘
+ *  - 启用前校验 Token 格式（ghp_ 前缀，长度 >= 40）
+ *  - MCP 工具受 ToolRegistry 沙箱/守卫统一约束
+ */
+const fs_1 = require("fs");
+const path_1 = require("path");
+const logger_1 = require("../shared/logger");
+function loadGithubMcpConfig(fileCfg) {
+    const file = (fileCfg?.githubMcp ?? {});
+    return {
+        enabled: process.env.FH_GITHUB_MCP_ENABLED === 'true' || file.enabled === true,
+        token: process.env.GITHUB_PERSONAL_ACCESS_TOKEN || file.token || '',
+        packageName: process.env.FH_GITHUB_MCP_PACKAGE || file.packageName || '@modelcontextprotocol/server-github',
+        command: process.env.FH_GITHUB_MCP_COMMAND || file.command || 'npx',
+        args: file.args,
+    };
+}
+/** 校验 GitHub Personal Access Token 格式（ghp_ 前缀，经典 Token；github_pat_ 前缀，细粒度 Token） */
+function isValidGithubToken(token) {
+    if (!token || token.length < 40)
+        return false;
+    return token.startsWith('ghp_') || token.startsWith('github_pat_') || token.startsWith('gho_') || token.startsWith('ghu_') || token.startsWith('ghs_') || token.startsWith('ghr_');
+}
+/** GitHub MCP 是否可用（启用 + Token 有效） */
+function isGithubMcpAvailable(cfg) {
+    if (!cfg.enabled)
+        return false;
+    if (!isValidGithubToken(cfg.token)) {
+        logger_1.logger.warn('GitHub MCP token 格式无效，已跳过', { tokenPrefix: cfg.token.slice(0, 4) + '...' });
+        return false;
+    }
+    return true;
+}
+/* ===================== McpServerConfig 生成 ===================== */
+/**
+ * 生成 GitHub MCP Server 的 McpServerConfig。
+ * 工具名会以 github_<toolName> 前缀注册（如 github_create_issue）。
+ */
+function buildGithubMcpConfig(cfg) {
+    return {
+        name: 'github',
+        command: cfg.command,
+        args: cfg.args ?? ['-y', cfg.packageName],
+        env: {
+            GITHUB_PERSONAL_ACCESS_TOKEN: cfg.token,
+            // 禁用 npm  fund/audit 提示，减少 stderr 噪音
+            npm_config_fund: 'false',
+            npm_config_audit: 'false',
+        },
+        initTimeoutMs: 60000, // 首次 npx 下载包可能较慢
+        callTimeoutMs: 120000,
+    };
+}
+/**
+ * 从配置生成 GitHub MCP 服务器列表（可用时返回单元素数组，否则空数组）。
+ * 供 config.ts 叠加到 mcp.servers。
+ */
+function getGithubMcpServers(fileCfg) {
+    const cfg = loadGithubMcpConfig(fileCfg);
+    if (!isGithubMcpAvailable(cfg))
+        return [];
+    const mcpCfg = buildGithubMcpConfig(cfg);
+    logger_1.logger.info('GitHub MCP Server 已启用', { package: cfg.packageName, command: cfg.command });
+    return [mcpCfg];
+}
+/* ===================== GitHub MCP 工具清单（参考） ===================== */
+/**
+ * GitHub MCP Server 提供的主要工具（实际工具列表以运行时 tools/list 为准）。
+ * 用于文档说明和前端展示，不影响实际注册。
+ */
+exports.GITHUB_MCP_TOOL_CATALOG = [
+    { category: '仓库', tools: ['get_repository', 'list_repositories', 'search_repositories', 'create_repository'] },
+    { category: 'Issue', tools: ['create_issue', 'get_issue', 'list_issues', 'search_issues', 'update_issue', 'add_issue_comment'] },
+    { category: 'Pull Request', tools: ['create_pull_request', 'get_pull_request', 'list_pull_requests', 'search_pull_requests', 'merge_pull_request', 'update_pull_request'] },
+    { category: '代码', tools: ['get_file_contents', 'create_or_update_file', 'push_files', 'search_code', 'get_commit', 'list_commits'] },
+    { category: '分支/标签', tools: ['list_branches', 'create_branch', 'list_tags', 'create_release'] },
+    { category: '工作流', tools: ['list_workflow_runs', 'get_workflow_run', 'trigger_workflow_dispatch'] },
+];
+/* ===================== 环境检测 ===================== */
+/** 检测 npx 是否可用（同步检查 node_modules/.bin 或全局） */
+function detectNpxAvailable() {
+    // npx 随 npm 一起安装，检查 npm 是否可用即可
+    try {
+        // 简单检查：npm 根目录是否存在
+        const npmRoot = process.env.npm_config_prefix || (0, path_1.join)(process.env.APPDATA || '', 'npm');
+        return (0, fs_1.existsSync)((0, path_1.join)(npmRoot, 'npx.cmd')) || (0, fs_1.existsSync)((0, path_1.join)(npmRoot, 'npx'));
+    }
+    catch {
+        return true; // 假设可用，实际启动失败时 attachMcpTools 会容错跳过
+    }
+}
+/** 生成 GitHub MCP 接入状态报告（用于 /api/health 或诊断） */
+function getGithubMcpStatus(fileCfg) {
+    const cfg = loadGithubMcpConfig(fileCfg);
+    return {
+        enabled: cfg.enabled,
+        available: isGithubMcpAvailable(cfg),
+        tokenConfigured: !!cfg.token,
+        tokenValid: isValidGithubToken(cfg.token),
+        package: cfg.packageName,
+        command: cfg.command,
+        toolCount: exports.GITHUB_MCP_TOOL_CATALOG.reduce((sum, c) => sum + c.tools.length, 0),
+    };
+}
+//# sourceMappingURL=github-mcp.js.map

package/dist/integrations/github-mcp.js.map

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