@ppdocs/mcp 3.2.34 → 3.2.36

package/dist/web/server.js

@@ -1,808 +0,0 @@
-/**
- * PPDocs Agent V2 — Web Config Server
- * 多项目管理 + 智能匹配 + 知识图谱预览 + MCP 安装
- */
-import express from 'express';
-import * as fs from 'fs';
-import * as path from 'path';
-import * as os from 'os';
-import { getAgentHtml } from './ui.js';
-// ============ 配置管理 ============
-const CONFIG_DIR = path.join(os.homedir(), '.ppdocs-agent');
-const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
-export function loadAgentConfig() {
-    try {
-        if (!fs.existsSync(CONFIG_FILE))
-            return null;
-        const raw = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
-        // V1 → V2 自动迁移
-        if (raw.project && !raw.projects) {
-            raw.projects = [{
-                    localDir: raw.localDir || '',
-                    localName: path.basename(raw.localDir || ''),
-                    remote: raw.project,
-                    sync: raw.sync || { enabled: true, intervalSec: 15 },
-                    createdAt: new Date().toISOString(),
-                }];
-            delete raw.project;
-            delete raw.localDir;
-            delete raw.sync;
-            saveAgentConfig(raw);
-        }
-        return raw;
-    }
-    catch {
-        return null;
-    }
-}
-export function saveAgentConfig(config) {
-    fs.mkdirSync(CONFIG_DIR, { recursive: true });
-    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
-}
-/** 写入 .ppdocs 到项目目录，供 MCP 直接读取 */
-function writePpdocsToProject(binding, host, port) {
-    if (!binding.localDir || !binding.remote.password)
-        return;
-    const configPath = path.join(binding.localDir, '.ppdocs');
-    const content = {
-        api: `http://${host}:${port}`,
-        projectId: binding.remote.id,
-        key: binding.remote.password,
-        user: `agent-${binding.localName.slice(0, 8)}`,
-    };
-    try {
-        fs.writeFileSync(configPath, JSON.stringify(content, null, 2), 'utf-8');
-        console.log(`[Config] 已写入 ${configPath}`);
-    }
-    catch (e) {
-        console.error(`[Config] 写入 .ppdocs 失败: ${e}`);
-    }
-}
-const state = {
-    hostConnected: false,
-    projectStatus: new Map(),
-};
-export function getAgentState() { return state; }
-export function setAgentState(partial) {
-    Object.assign(state, partial);
-}
-export function setProjectStatus(remoteId, status) {
-    const existing = state.projectStatus.get(remoteId) || {
-        connected: false, syncStatus: '未启动', lastSync: null,
-    };
-    state.projectStatus.set(remoteId, { ...existing, ...status });
-}
-// ============ Express 服务器 ============
-export function startWebServer(webPort) {
-    const app = express();
-    app.use(express.json());
-    app.disable('etag'); // 禁用 ETag，避免 304 缓存导致前端数据不更新
-    // GET / → UI (禁止浏览器缓存，确保加载最新版本)
-    app.get('/', (_req, res) => {
-        res.set('Cache-Control', 'no-store, no-cache, must-revalidate');
-        res.set('Pragma', 'no-cache');
-        res.type('html').send(getAgentHtml());
-    });
-    // GET /api/status → 全局+各项目状态
-    app.get('/api/status', (_req, res) => {
-        const config = loadAgentConfig();
-        const projects = (config?.projects || []).map(p => {
-            const ps = state.projectStatus.get(p.remote.id);
-            return {
-                localName: p.localName,
-                localDir: p.localDir,
-                remoteId: p.remote.id,
-                remoteName: p.remote.name,
-                connected: ps?.connected || false,
-                syncStatus: ps?.syncStatus || (p.localDir ? '待启动' : '未指定目录'),
-                docCount: ps?.docCount || 0,
-                lastSync: ps?.lastSync ? timeSince(ps.lastSync) : null,
-                hasPassword: !!p.remote.password,
-            };
-        });
-        res.json({
-            hostConnected: state.hostConnected,
-            host: config?.host || '',
-            port: config?.port || 20001,
-            projects,
-        });
-    });
-    // POST /api/host → 保存主机配置
-    app.post('/api/host', async (req, res) => {
-        const { host, port } = req.body;
-        if (!host) {
-            res.json({ ok: false, error: '缺少 host' });
-            return;
-        }
-        const config = loadAgentConfig() || { host: '', port: 20001, webPort: webPort, projects: [] };
-        config.host = host;
-        config.port = port || 20001;
-        saveAgentConfig(config);
-        res.json({ ok: true });
-    });
-    // POST /api/test → 测试远程连接
-    app.post('/api/test', async (req, res) => {
-        const { host, port } = req.body;
-        try {
-            const controller = new AbortController();
-            const timeout = setTimeout(() => controller.abort(), 5000);
-            const resp = await fetch(`http://${host}:${port}/health`, { signal: controller.signal });
-            clearTimeout(timeout);
-            state.hostConnected = resp.ok;
-            res.json({ ok: resp.ok });
-        }
-        catch {
-            state.hostConnected = false;
-            res.json({ ok: false, error: '连接超时或主机不可达' });
-        }
-    });
-    // GET /api/projects → 远程项目列表 (保留用于兼容)
-    app.get('/api/projects', async (req, res) => {
-        const config = loadAgentConfig();
-        const host = req.query.host || config?.host;
-        const port = req.query.port || String(config?.port || 20001);
-        if (!host) {
-            res.json({ projects: [] });
-            return;
-        }
-        try {
-            const resp = await fetch(`http://${host}:${port}/api/projects`);
-            if (!resp.ok) {
-                res.json({ projects: [] });
-                return;
-            }
-            const data = await resp.json();
-            res.json({ projects: data.data || [] });
-        }
-        catch {
-            res.json({ projects: [] });
-        }
-    });
-    // GET /api/browse → 服务端目录浏览 (供前端目录选择器使用)
-    app.get('/api/browse', (req, res) => {
-        const dir = req.query.dir || '';
-        try {
-            // 无参数时返回根级入口
-            if (!dir) {
-                const home = os.homedir();
-                // 常用快捷入口
-                const shortcuts = [];
-                const desktop = path.join(home, 'Desktop');
-                if (fs.existsSync(desktop))
-                    shortcuts.push({ name: '🖥️ 桌面 (Desktop)', path: desktop });
-                shortcuts.push({ name: '🏠 用户目录', path: home });
-                if (process.platform === 'darwin') {
-                    const dev = path.join(home, 'Developer');
-                    const docs = path.join(home, 'Documents');
-                    if (fs.existsSync(dev))
-                        shortcuts.push({ name: '💻 Developer', path: dev });
-                    if (fs.existsSync(docs))
-                        shortcuts.push({ name: '📄 Documents', path: docs });
-                }
-                if (process.platform === 'win32') {
-                    // Windows: 列出盘符
-                    const drives = [];
-                    for (let i = 65; i <= 90; i++) {
-                        const d = String.fromCharCode(i) + ':\\';
-                        try {
-                            fs.accessSync(d);
-                            drives.push(d);
-                        }
-                        catch { /* skip */ }
-                    }
-                    res.json({ ok: true, dir: '', dirs: drives, shortcuts, platform: 'win32' });
-                }
-                else {
-                    // Mac/Linux: 列出 home 下的子目录
-                    try {
-                        const homeDirs = fs.readdirSync(home, { withFileTypes: true })
-                            .filter(e => e.isDirectory() && !e.name.startsWith('.'))
-                            .slice(0, 20)
-                            .map(e => path.join(home, e.name));
-                        res.json({ ok: true, dir: home, dirs: homeDirs, shortcuts, platform: process.platform });
-                    }
-                    catch {
-                        res.json({ ok: true, dir: '', dirs: [home], shortcuts, platform: process.platform });
-                    }
-                }
-                return;
-            }
-            // 列出指定目录的子目录
-            if (!fs.existsSync(dir)) {
-                res.json({ ok: false, error: '目录不存在' });
-                return;
-            }
-            const entries = fs.readdirSync(dir, { withFileTypes: true })
-                .filter(e => e.isDirectory() && !e.name.startsWith('.'))
-                .sort((a, b) => a.name.localeCompare(b.name))
-                .slice(0, 100)
-                .map(e => path.join(dir, e.name));
-            res.json({ ok: true, dir, dirs: entries, platform: process.platform });
-        }
-        catch (e) {
-            res.json({ ok: false, error: String(e).slice(0, 100) });
-        }
-    });
-    // GET /api/pick-dir → 调用系统原生目录选择器
-    app.get('/api/pick-dir', async (_req, res) => {
-        try {
-            let cmd;
-            if (process.platform === 'win32') {
-                // Windows: PowerShell FolderBrowserDialog
-                cmd = `powershell -NoProfile -Command "Add-Type -AssemblyName System.Windows.Forms; $d=New-Object System.Windows.Forms.FolderBrowserDialog; $d.Description='选择项目目录'; $d.ShowNewFolderButton=$true; if($d.ShowDialog() -eq 'OK'){$d.SelectedPath}else{''}"`;
-            }
-            else if (process.platform === 'darwin') {
-                // Mac: osascript choose folder
-                cmd = `osascript -e 'try' -e 'POSIX path of (choose folder with prompt "选择项目目录")' -e 'on error' -e '""' -e 'end try'`;
-            }
-            else {
-                // Linux: zenity
-                cmd = `zenity --file-selection --directory --title="选择项目目录" 2>/dev/null || echo ""`;
-            }
-            const { execSync } = await import('child_process');
-            const result = execSync(cmd, { encoding: 'utf-8', timeout: 120000 }).trim();
-            if (result) {
-                res.json({ ok: true, dir: result });
-            }
-            else {
-                res.json({ ok: false, cancelled: true });
-            }
-        }
-        catch {
-            res.json({ ok: false, error: '目录选择器调用失败' });
-        }
-    });
-    // ============ 服务端授权流程 ============
-    // POST /api/auth/start → 发起授权请求 (代理转发到主机)
-    app.post('/api/auth/start', async (req, res) => {
-        const { localDir } = req.body;
-        // localDir 可选，用于 APP 端显示来源信息
-        const config = loadAgentConfig();
-        if (!config?.host) {
-            res.json({ ok: false, error: '请先配置主机' });
-            return;
-        }
-        try {
-            const resp = await fetch(`http://${config.host}:${config.port}/api/auth/request`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({
-                    cwd: localDir,
-                    hostname: os.hostname(),
-                }),
-            });
-            if (!resp.ok) {
-                res.json({ ok: false, error: '主机 auth API 不可用' });
-                return;
-            }
-            const data = await resp.json();
-            const requestId = data.data?.requestId;
-            if (!requestId) {
-                res.json({ ok: false, error: '未获得 requestId' });
-                return;
-            }
-            res.json({ ok: true, requestId });
-        }
-        catch (e) {
-            res.json({ ok: false, error: `连接主机失败: ${String(e).slice(0, 80)}` });
-        }
-    });
-    // GET /api/auth/status/:id → 轮询授权结果 (代理转发)
-    app.get('/api/auth/status/:id', async (req, res) => {
-        const config = loadAgentConfig();
-        if (!config?.host) {
-            res.json({ status: 'error', error: '未配置主机' });
-            return;
-        }
-        try {
-            const resp = await fetch(`http://${config.host}:${config.port}/api/auth/poll/${req.params.id}`);
-            if (!resp.ok) {
-                res.json({ status: 'error' });
-                return;
-            }
-            const data = await resp.json();
-            const d = data.data;
-            if (d?.status === 'approved' && d.result) {
-                // 授权通过，自动绑定
-                const result = d.result;
-                res.json({
-                    status: 'approved',
-                    projectId: result.project_id,
-                    projectName: result.project_name,
-                    password: result.password,
-                });
-            }
-            else {
-                res.json({ status: d?.status || 'pending' });
-            }
-        }
-        catch {
-            res.json({ status: 'error' });
-        }
-    });
-    // POST /api/bind → 绑定项目 (授权通过后调用)
-    app.post('/api/bind', async (req, res) => {
-        const { localDir, remoteId, remoteName, password } = req.body;
-        if (!remoteId) {
-            res.json({ ok: false, error: '缺少 remoteId' });
-            return;
-        }
-        const config = loadAgentConfig();
-        if (!config) {
-            res.json({ ok: false, error: '请先配置主机' });
-            return;
-        }
-        // 检查重复
-        if (config.projects.some(p => p.remote.id === remoteId)) {
-            res.json({ ok: false, error: '该远程项目已绑定' });
-            return;
-        }
-        const binding = {
-            localDir: localDir || '',
-            localName: localDir ? path.basename(localDir) : (remoteName || remoteId),
-            remote: { id: remoteId, name: remoteName || remoteId, password: password || '' },
-            sync: { enabled: true, intervalSec: 15 },
-            createdAt: new Date().toISOString(),
-        };
-        config.projects.push(binding);
-        saveAgentConfig(config);
-        // 有本地目录时才写 .ppdocs
-        if (localDir)
-            writePpdocsToProject(binding, config.host, config.port);
-        // 通知 Agent 主进程启动同步
-        if (state.onBind)
-            state.onBind(binding);
-        res.json({ ok: true, binding });
-    });
-    // DELETE /api/bind/:id → 解绑
-    app.delete('/api/bind/:id', (req, res) => {
-        const remoteId = req.params.id;
-        const config = loadAgentConfig();
-        if (!config) {
-            res.json({ ok: false });
-            return;
-        }
-        config.projects = config.projects.filter(p => p.remote.id !== remoteId);
-        saveAgentConfig(config);
-        state.projectStatus.delete(remoteId);
-        if (state.onUnbind)
-            state.onUnbind(remoteId);
-        res.json({ ok: true });
-    });
-    // PATCH /api/bind/:id → 更新绑定（用于重新授权后更新密码）
-    app.patch('/api/bind/:id', (req, res) => {
-        const remoteId = req.params.id;
-        const { password, remoteName } = req.body;
-        const config = loadAgentConfig();
-        if (!config) {
-            res.json({ ok: false });
-            return;
-        }
-        const proj = config.projects.find(p => p.remote.id === remoteId);
-        if (!proj) {
-            res.json({ ok: false, error: '项目不存在' });
-            return;
-        }
-        if (password)
-            proj.remote.password = password;
-        if (remoteName)
-            proj.remote.name = remoteName;
-        saveAgentConfig(config);
-        res.json({ ok: true });
-    });
-    // GET /api/bind/:id/tree → 项目知识图谱 (无密码时尝试跨项目只读)
-    app.get('/api/bind/:id/tree', async (req, res) => {
-        const remoteId = req.params.id;
-        const config = loadAgentConfig();
-        const proj = config?.projects.find(p => p.remote.id === remoteId);
-        if (!config || !proj) {
-            res.json({ tree: '项目不存在' });
-            return;
-        }
-        let docsUrl;
-        let readOnly = false;
-        if (proj.remote.password) {
-            // 有密码 → 直接读取（读写模式）
-            docsUrl = `http://${config.host}:${config.port}/api/${proj.remote.id}/${proj.remote.password}/docs`;
-        }
-        else {
-            // 无密码 → 尝试用其他已授权项目的跨项目只读API
-            const proxy = config.projects.find(p => p.remote.id !== remoteId && p.remote.password);
-            if (proxy) {
-                docsUrl = `http://${config.host}:${config.port}/api/${proxy.remote.id}/${proxy.remote.password}/cross/${remoteId}/docs`;
-                readOnly = true;
-            }
-            else {
-                // 无任何已授权项目 → 尝试公开API
-                docsUrl = `http://${config.host}:${config.port}/api/projects/${remoteId}/docs`;
-                readOnly = true;
-            }
-        }
-        try {
-            const resp = await fetch(docsUrl);
-            if (!resp.ok) {
-                res.json({ tree: readOnly ? '⚠️ 未授权，无法获取文档 — 请点击"申请授权"' : `获取失败 (HTTP ${resp.status})`, readOnly });
-                return;
-            }
-            const json = await resp.json();
-            const docs = json.data || [];
-            if (docs.length === 0) {
-                res.json({ tree: '知识库为空', docs: [], docCount: 0, dirCount: 0, readOnly });
-                return;
-            }
-            const sortedDocs = docs.sort((a, b) => a.path.localeCompare(b.path));
-            const lines = sortedDocs
-                .map(d => {
-                const depth = (d.path.match(/\//g) || []).length;
-                const indent = '  '.repeat(Math.max(0, depth - 1));
-                const icon = d.isDir ? '📁' : '📄';
-                const summary = d.summary ? ` — ${d.summary}` : '';
-                return `${indent}${icon} ${d.name}${summary}`;
-            });
-            const docCount = sortedDocs.filter(d => !d.isDir).length;
-            const dirCount = sortedDocs.filter(d => d.isDir).length;
-            res.json({ tree: lines.join('\n'), docs: sortedDocs, docCount, dirCount, readOnly });
-        }
-        catch (e) {
-            res.json({ tree: `连接失败: ${String(e).slice(0, 100)}` });
-        }
-    });
-    // GET /api/bind/:id/doc → 读取单篇文档内容
-    app.get('/api/bind/:id/doc', async (req, res) => {
-        const remoteId = req.params.id;
-        const docPath = req.query.path;
-        if (!docPath) {
-            res.json({ ok: false, error: '缺少 path 参数' });
-            return;
-        }
-        const config = loadAgentConfig();
-        const proj = config?.projects.find(p => p.remote.id === remoteId);
-        if (!config || !proj) {
-            res.json({ ok: false, error: '项目不存在' });
-            return;
-        }
-        let docUrl;
-        if (proj.remote.password) {
-            docUrl = `http://${config.host}:${config.port}/api/${proj.remote.id}/${proj.remote.password}/docs/${encodeURIComponent(docPath)}`;
-        }
-        else {
-            const proxy = config.projects.find(p => p.remote.id !== remoteId && p.remote.password);
-            if (proxy) {
-                docUrl = `http://${config.host}:${config.port}/api/${proxy.remote.id}/${proxy.remote.password}/cross/${remoteId}/docs/${encodeURIComponent(docPath)}`;
-            }
-            else {
-                res.json({ ok: false, error: '未授权' });
-                return;
-            }
-        }
-        try {
-            const resp = await fetch(docUrl);
-            if (!resp.ok) {
-                res.json({ ok: false, error: `HTTP ${resp.status}` });
-                return;
-            }
-            const json = await resp.json();
-            const d = json.data;
-            res.json({ ok: true, content: d?.content || '', summary: d?.summary || '', status: d?.status || '' });
-        }
-        catch (e) {
-            res.json({ ok: false, error: String(e).slice(0, 100) });
-        }
-    });
-    // GET /api/bind/:id/prompts → 读取项目提示词文件
-    app.get('/api/bind/:id/prompts', (req, res) => {
-        const config = loadAgentConfig();
-        const proj = config?.projects.find(p => p.remote.id === req.params.id);
-        if (!proj?.localDir) {
-            res.json({ files: [] });
-            return;
-        }
-        const dir = proj.localDir;
-        const names = ['CLAUDE.md', 'AGENTS.md', 'GEMINI.md', '.cursorrules', 'CONVENTIONS.md'];
-        const files = names.map(name => {
-            const fp = path.join(dir, name);
-            const exists = fs.existsSync(fp);
-            let lines = 0;
-            if (exists) {
-                try {
-                    lines = fs.readFileSync(fp, 'utf-8').split('\n').length;
-                }
-                catch { }
-            }
-            return { name, exists, lines };
-        });
-        res.json({ files });
-    });
-    // GET /api/bind/:id/prompts/:name → 读取单个提示词文件
-    app.get('/api/bind/:id/prompts/:name', (req, res) => {
-        const config = loadAgentConfig();
-        const proj = config?.projects.find(p => p.remote.id === req.params.id);
-        if (!proj?.localDir) {
-            res.json({ ok: false });
-            return;
-        }
-        const fp = path.join(proj.localDir, req.params.name);
-        if (!fs.existsSync(fp)) {
-            res.json({ ok: false, error: '文件不存在' });
-            return;
-        }
-        try {
-            res.json({ ok: true, content: fs.readFileSync(fp, 'utf-8') });
-        }
-        catch (e) {
-            res.json({ ok: false, error: String(e) });
-        }
-    });
-    // PUT /api/bind/:id/prompts/:name → 保存提示词文件
-    app.put('/api/bind/:id/prompts/:name', (req, res) => {
-        const config = loadAgentConfig();
-        const proj = config?.projects.find(p => p.remote.id === req.params.id);
-        if (!proj?.localDir) {
-            res.json({ ok: false });
-            return;
-        }
-        const allowed = ['CLAUDE.md', 'AGENTS.md', 'GEMINI.md', '.cursorrules', 'CONVENTIONS.md'];
-        if (!allowed.includes(req.params.name)) {
-            res.json({ ok: false, error: '不允许的文件名' });
-            return;
-        }
-        try {
-            fs.writeFileSync(path.join(proj.localDir, req.params.name), req.body.content || '', 'utf-8');
-            res.json({ ok: true });
-        }
-        catch (e) {
-            res.json({ ok: false, error: String(e) });
-        }
-    });
-    // GET /api/bind/:id/mcp/all → 扫描项目目录下各平台的完整 MCP 服务列表
-    app.get('/api/bind/:id/mcp/all', (req, res) => {
-        const config = loadAgentConfig();
-        const proj = config?.projects.find(p => p.remote.id === req.params.id);
-        if (!proj?.localDir) {
-            res.json({ servers: [] });
-            return;
-        }
-        const dir = proj.localDir;
-        const allServers = {}; // serverName → [platforms...]
-        const scanTargets = [
-            { platform: 'Cursor', filePath: path.join(dir, '.cursor', 'mcp.json') },
-            { platform: 'Antigravity', filePath: path.join(dir, '.gemini', 'settings.json') },
-            { platform: 'OpenCode', filePath: path.join(dir, '.vscode', 'cline_mcp_settings.json') },
-        ];
-        for (const t of scanTargets) {
-            try {
-                if (!fs.existsSync(t.filePath))
-                    continue;
-                const content = JSON.parse(fs.readFileSync(t.filePath, 'utf-8'));
-                const servers = content.mcpServers || content.servers || {};
-                for (const name of Object.keys(servers)) {
-                    if (!allServers[name])
-                        allServers[name] = [];
-                    allServers[name].push(t.platform);
-                }
-            }
-            catch { }
-        }
-        const servers = Object.entries(allServers).map(([name, platforms]) => ({ name, platforms }));
-        res.json({ servers });
-    });
-    // 获取各平台 MCP 配置的路径和服务器名称
-    const getMcpSpecs = (dir, projId) => ({
-        cursor: { path: path.join(dir, '.cursor', 'mcp.json'), name: 'ppdocs-kg' },
-        antigravity: { path: path.join(dir, '.gemini', 'settings.json'), name: `ppdocs-kg-${projId}` },
-        vscode: { path: path.join(dir, '.vscode', 'cline_mcp_settings.json'), name: 'ppdocs-kg' },
-        claude: { path: getClaudeGlobalPath(), name: `ppdocs-kg-${projId}` },
-        lobechat: { path: '', name: 'ppdocs-kg' }, // 无本地文件，靠复制配置
-    });
-    // GET /api/bind/:id/mcp → MCP 安装状态检测
-    app.get('/api/bind/:id/mcp', (req, res) => {
-        const remoteId = req.params.id;
-        const config = loadAgentConfig();
-        const proj = config?.projects.find(p => p.remote.id === remoteId);
-        if (!proj?.localDir) {
-            res.json({ platforms: {} });
-            return;
-        }
-        const specs = getMcpSpecs(proj.localDir, remoteId);
-        const platforms = {
-            cursor: hasMcpInJson(specs.cursor.path, specs.cursor.name),
-            antigravity: hasMcpInJson(specs.antigravity.path, specs.antigravity.name),
-            vscode: hasMcpInJson(specs.vscode.path, specs.vscode.name),
-            claude: hasMcpInJson(specs.claude.path, specs.claude.name),
-            lobechat: false, // 无法自动检测
-        };
-        res.json({ platforms });
-    });
-    // POST /api/bind/:id/mcp → 安装/获取 MCP 配置
-    app.post('/api/bind/:id/mcp', (req, res) => {
-        const remoteId = req.params.id;
-        const { platform } = req.body;
-        const config = loadAgentConfig();
-        const proj = config?.projects.find(p => p.remote.id === remoteId);
-        if (!config || !proj) {
-            res.json({ ok: false, error: '项目不存在' });
-            return;
-        }
-        if (!proj.localDir) {
-            res.json({ ok: false, error: '请先指定本地目录' });
-            return;
-        }
-        const apiUrl = `http://${config.host}:${config.port}/api/${proj.remote.id}/${proj.remote.password}`;
-        const dir = proj.localDir;
-        const isWin = process.platform === 'win32';
-        const ppdocsServer = buildMcpServerConfig(apiUrl, isWin);
-        // 对于 LobeChat，直接返回 JSON 供用户复制，不写入本地
-        if (platform === 'lobechat') {
-            res.json({
-                ok: true,
-                message: 'LobeChat 配置生成成功',
-                action: 'copy',
-                config: JSON.stringify({ mcpServers: { 'ppdocs-kg': ppdocsServer } }, null, 2),
-            });
-            return;
-        }
-        try {
-            const specs = getMcpSpecs(dir, remoteId);
-            const spec = specs[platform];
-            if (!spec || !spec.path) {
-                res.json({ ok: false, error: '未知平台或不支持自动安装' });
-                return;
-            }
-            writeMcpConfig(spec.path, spec.name, ppdocsServer);
-            // 同时写入 .ppdocs 配置文件
-            const ppdocsPath = path.join(dir, '.ppdocs');
-            fs.writeFileSync(ppdocsPath, JSON.stringify({
-                api: `http://${config.host}:${config.port}`,
-                projectId: proj.remote.id,
-                key: proj.remote.password,
-                user: `Agent@${os.hostname()}`,
-            }, null, 2));
-            let extra = '';
-            if (platform === 'antigravity') {
-                const cmdCount = installAntigravitySlashCommands();
-                if (cmdCount > 0)
-                    extra = ` + ${cmdCount}个斜杠命令`;
-            }
-            res.json({ ok: true, message: `✅ ${platform} MCP 已安装${extra}` });
-        }
-        catch (e) {
-            res.json({ ok: false, error: String(e) });
-        }
-    });
-    // DELETE /api/bind/:id/mcp → 卸载 MCP
-    app.delete('/api/bind/:id/mcp', (req, res) => {
-        const remoteId = req.params.id;
-        const { platform } = req.body;
-        const config = loadAgentConfig();
-        const proj = config?.projects.find(p => p.remote.id === remoteId);
-        if (!proj?.localDir) {
-            res.json({ ok: false });
-            return;
-        }
-        if (platform === 'lobechat') {
-            res.json({ ok: true, message: '请在 LobeChat 界面中手动删除' });
-            return;
-        }
-        try {
-            const specs = getMcpSpecs(proj.localDir, remoteId);
-            const spec = specs[platform];
-            if (spec && fs.existsSync(spec.path)) {
-                removeMcpFromConfig(spec.path, spec.name);
-            }
-            res.json({ ok: true, message: `✅ ${platform} MCP 已卸载` });
-        }
-        catch (e) {
-            res.json({ ok: false, error: String(e) });
-        }
-    });
-    app.listen(webPort, () => {
-        console.log(`\n📡 PPDocs Agent Web UI: http://localhost:${webPort}\n`);
-    });
-}
-function timeSince(date) {
-    const seconds = Math.floor((Date.now() - date.getTime()) / 1000);
-    if (seconds < 60)
-        return `${seconds}秒前`;
-    const minutes = Math.floor(seconds / 60);
-    if (minutes < 60)
-        return `${minutes}分钟前`;
-    return `${Math.floor(minutes / 60)}小时前`;
-}
-/** 检测 JSON 配置文件中是否有指名的 MCP */
-function hasMcpInJson(filePath, serverName) {
-    try {
-        if (!fs.existsSync(filePath))
-            return false;
-        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-        const servers = content.mcpServers || content.servers || {};
-        return serverName in servers;
-    }
-    catch {
-        return false;
-    }
-}
-/** 构建 MCP server 配置对象 (通过 PPDOCS_API_URL 环境变量隔离项目) */
-function buildMcpServerConfig(apiUrl, isWindows) {
-    return isWindows ? {
-        command: 'cmd',
-        args: ['/c', 'npx', '-y', '@ppdocs/mcp@latest'],
-        env: {
-            PPDOCS_API_URL: apiUrl,
-        },
-    } : {
-        command: 'npx',
-        args: ['-y', '@ppdocs/mcp@latest'],
-        env: {
-            PATH: `${process.env.PATH || '/usr/bin:/bin'}:/usr/local/bin:/opt/homebrew/bin`,
-            PPDOCS_API_URL: apiUrl,
-        },
-    };
-}
-/** 写入 MCP 配置到 JSON 文件 (合并已有配置) */
-function writeMcpConfig(filePath, serverName, serverConfig) {
-    let existing = {};
-    if (fs.existsSync(filePath)) {
-        try {
-            existing = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-        }
-        catch { /* ignore */ }
-    }
-    existing.mcpServers = {
-        ...(existing.mcpServers || {}),
-        [serverName]: serverConfig,
-    };
-    const dir = path.dirname(filePath);
-    if (!fs.existsSync(dir))
-        fs.mkdirSync(dir, { recursive: true });
-    fs.writeFileSync(filePath, JSON.stringify(existing, null, 2));
-}
-/** 从 JSON 配置中移除指定的 MCP */
-function removeMcpFromConfig(filePath, serverName) {
-    try {
-        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-        const servers = content.mcpServers || {};
-        delete servers[serverName];
-        content.mcpServers = servers;
-        fs.writeFileSync(filePath, JSON.stringify(content, null, 2));
-    }
-    catch { /* ignore */ }
-}
-/** 安装 Antigravity 斜杠命令到全局目录 ~/.gemini/antigravity/global_workflows/ */
-function installAntigravitySlashCommands() {
-    const templatesDir = path.join(__dirname, '..', 'templates', 'commands', 'pp');
-    if (!fs.existsSync(templatesDir))
-        return 0;
-    const globalDir = path.join(os.homedir(), '.gemini', 'antigravity', 'global_workflows');
-    fs.mkdirSync(globalDir, { recursive: true });
-    const COMMAND_MAP = {
-        'init.md': { name: 'pp-init', desc: '初始化项目知识图谱' },
-        'sync.md': { name: 'pp-sync', desc: '同步代码与知识图谱' },
-        'review.md': { name: 'pp-shencha', desc: '审查任务成果' },
-        'DiagnosticProtocol.md': { name: 'pp-fenxi', desc: '深度分析错误' },
-        'Execution_Task.md': { name: 'pp-task', desc: '执行开发任务' },
-        'Sentinel_4.md': { name: 'pp-audit', desc: '多Agent代码审计' },
-        'SynchronizationProtocol.md': { name: 'pp-syncpro', desc: '知识图谱同步协议' },
-        'Zero_Defec_Genesis.md': { name: 'plan', desc: '零缺陷创生协议' },
-    };
-    let count = 0;
-    for (const [file, mapping] of Object.entries(COMMAND_MAP)) {
-        const dest = path.join(globalDir, `${mapping.name}.md`);
-        if (fs.existsSync(dest))
-            continue;
-        const src = path.join(templatesDir, file);
-        if (!fs.existsSync(src))
-            continue;
-        const content = fs.readFileSync(src, 'utf-8');
-        fs.writeFileSync(dest, `---\ndescription: ${mapping.desc}\n---\n\n${content}`);
-        count++;
-    }
-    return count;
-}
-/** 获取 Claude Desktop 全局配置路径 */
-function getClaudeGlobalPath() {
-    if (process.platform === 'win32')
-        return path.join(process.env.APPDATA || '', 'Claude', 'claude_desktop_config.json');
-    if (process.platform === 'darwin')
-        return path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
-    return path.join(os.homedir(), '.config', 'Claude', 'claude_desktop_config.json');
-}