@ppdocs/mcp 3.2.12 → 3.2.14

package/dist/cli.js

@@ -528,37 +528,57 @@ function installAntigravityTemplates(cwd, apiUrl) {
     createMcpConfigAt(path.join(cwd, '.gemini', 'settings.json'), apiUrl, { noEnv: true });
     // 2. 生成 AGENTS.md
     generateAgentsMd(cwd);
-    // 3. 安装斜杠命令 → .agents/workflows/ (Antigravity 的 slash command 机制)
+    // 3. 安装斜杠命令 → 全局目录 ~/.gemini/antigravity/global_workflows/
+    //    Antigravity 从此目录读取全局斜杠命令，文件名=命令名，必须有 YAML frontmatter
     const cmdSrcDir = path.join(TEMPLATES_DIR, 'commands', 'pp');
-    if (fs.existsSync(cmdSrcDir)) {
-        const workflowDir = path.join(cwd, '.agents', 'workflows');
-        if (!fs.existsSync(workflowDir)) {
-            fs.mkdirSync(workflowDir, { recursive: true });
-        }
-        const files = fs.readdirSync(cmdSrcDir).filter(f => f.endsWith('.md'));
-        let count = 0;
-        for (const file of files) {
-            // 命名: init.md → pp-init.md, review.md → pp-review.md
-            const baseName = path.basename(file, '.md');
-            const workflowName = `pp-${baseName.toLowerCase()}`;
-            const destFile = path.join(workflowDir, `${workflowName}.md`);
-            if (fs.existsSync(destFile))
-                continue; // 不覆盖已有的
-            const content = fs.readFileSync(path.join(cmdSrcDir, file), 'utf-8');
-            // 从第一行提取描述 (去掉 markdown 格式)
-            const firstLine = content.split('\n')[0]
-                .replace(/^\*\*[^*]+\*\*:\s*/, '') // 去掉 **角色**: 前缀
-                .replace(/^#+\s*/, '') // 去掉 # 标题前缀
-                .trim()
-                .slice(0, 80); // 限长
-            const workflow = `---\ndescription: "${firstLine}"\n---\n\n${content}`;
-            fs.writeFileSync(destFile, workflow, 'utf-8');
+    if (!fs.existsSync(cmdSrcDir))
+        return;
+    // Antigravity 全局 workflows 目录
+    const homeDir = process.env.USERPROFILE || process.env.HOME || '';
+    const globalWorkflowDir = path.join(homeDir, '.gemini', 'antigravity', 'global_workflows');
+    if (!fs.existsSync(globalWorkflowDir)) {
+        fs.mkdirSync(globalWorkflowDir, { recursive: true });
+    }
+    // 同时也安装到项目本地 .agents/workflows/ (作为备用)
+    const localWorkflowDir = path.join(cwd, '.agents', 'workflows');
+    if (!fs.existsSync(localWorkflowDir)) {
+        fs.mkdirSync(localWorkflowDir, { 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: '零缺陷创生协议' },
+    };
+    const files = fs.readdirSync(cmdSrcDir).filter(f => f.endsWith('.md'));
+    let count = 0;
+    for (const file of files) {
+        const mapping = COMMAND_MAP[file];
+        if (!mapping)
+            continue; // 未映射的模板跳过
+        const content = fs.readFileSync(path.join(cmdSrcDir, file), 'utf-8');
+        // 生成 Antigravity 格式: YAML frontmatter + 内容
+        const workflow = `---\ndescription: ${mapping.desc}\n---\n\n${content}`;
+        // 写入全局目录
+        const globalFile = path.join(globalWorkflowDir, `${mapping.name}.md`);
+        if (!fs.existsSync(globalFile)) {
+            fs.writeFileSync(globalFile, workflow, 'utf-8');
             count++;
         }
-        if (count > 0) {
-            console.log(`✅ Installed ${count} workflows to .agents/workflows/ (use /pp-sync, /pp-review ...)`);
+        // 同时写入项目本地目录
+        const localFile = path.join(localWorkflowDir, `${mapping.name}.md`);
+        if (!fs.existsSync(localFile)) {
+            fs.writeFileSync(localFile, workflow, 'utf-8');
         }
     }
+    if (count > 0) {
+        console.log(`✅ Installed ${count} slash commands to global_workflows/ (use /plan, /pp-init, /pp-fenxi ...)`);
+    }
 }
 /** 安装 Kiro 模板 */
 function installKiroTemplates(cwd, apiUrl) {

package/dist/web/server.js

@@ -563,7 +563,13 @@ export function startWebServer(webPort) {
                 key: proj.remote.password,
                 user: `Agent@${os.hostname()}`,
             }, null, 2));
-            res.json({ ok: true, message: `✅ ${platform} MCP 已安装` });
+            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) });
@@ -667,6 +673,37 @@ function removeMcpFromConfig(filePath, serverName) {
     }
     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')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ppdocs/mcp",
-  "version": "3.2.12",
+  "version": "3.2.14",
   "description": "ppdocs MCP Server - Knowledge Graph for Claude",
   "type": "module",
   "main": "dist/index.js",