@ppdocs/mcp 3.1.10 → 3.2.0

package/dist/web/server.js

@@ -0,0 +1,611 @@
+/**
+ * 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));
+}
+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());
+    // GET / → UI
+    app.get('/', (_req, res) => {
+        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: [] });
+        }
+    });
+    // ============ 服务端授权流程 ============
+    // POST /api/auth/start → 发起授权请求 (代理转发到主机)
+    app.post('/api/auth/start', async (req, res) => {
+        const { localDir } = req.body;
+        if (!localDir) {
+            res.json({ ok: false, error: '缺少本地目录' });
+            return;
+        }
+        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 (!localDir || !remoteId) {
+            res.json({ ok: false, error: '缺少参数' });
+            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,
+            localName: path.basename(localDir),
+            remote: { id: remoteId, name: remoteName || remoteId, password: password || '' },
+            sync: { enabled: true, intervalSec: 15 },
+            createdAt: new Date().toISOString(),
+        };
+        config.projects.push(binding);
+        saveAgentConfig(config);
+        // 通知 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: '知识库为空', docCount: 0, dirCount: 0, readOnly });
+                return;
+            }
+            const lines = docs
+                .sort((a, b) => a.path.localeCompare(b.path))
+                .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 = docs.filter(d => !d.isDir).length;
+            const dirCount = docs.filter(d => d.isDir).length;
+            res.json({ tree: lines.join('\n'), docCount, dirCount, readOnly });
+        }
+        catch (e) {
+            res.json({ tree: `连接失败: ${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' },
+        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));
+            res.json({ ok: true, message: `✅ ${platform} MCP 已安装` });
+        }
+        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 配置对象 */
+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: {
+            PPDOCS_API_URL: apiUrl,
+            PATH: `${process.env.PATH || '/usr/bin:/bin'}:/usr/local/bin:/opt/homebrew/bin`,
+        },
+    };
+}
+/** 写入 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 */ }
+}
+/** 获取 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');
+}

package/dist/web/ui.d.ts

@@ -0,0 +1,5 @@
+/**
+ * PPDocs Agent V3 — Multi-Page SPA UI
+ * 页面: 项目列表 / 添加项目 / 项目详情 (标签页: 概览/MCP/提示词)
+ */
+export declare function getAgentHtml(): string;