@ppdocs/mcp 3.1.5 → 3.1.7

package/dist/cli.js

@@ -161,15 +161,15 @@ async function initProject(opts) {
         hasIdeDir = true;
     }
     if (detectedIdes.includes('cursor')) {
-        installCursorTemplates(cwd);
+        installCursorTemplates(cwd, apiUrl);
         hasIdeDir = true;
     }
     if (detectedIdes.includes('antigravity')) {
-        installAntigravityTemplates(cwd);
+        installAntigravityTemplates(cwd, apiUrl);
         hasIdeDir = true;
     }
     if (detectedIdes.includes('kiro')) {
-        installKiroTemplates(cwd);
+        installKiroTemplates(cwd, apiUrl);
         hasIdeDir = true;
     }
     // Fallback behavior: if no specific IDE config directories found
@@ -185,7 +185,7 @@ async function initProject(opts) {
     const registered = autoRegisterMcp(apiUrl, opts.user);
     // 如果没有检测到任何 AI CLI，并且也没有检测到配置文件夹，创建 .mcp.json 作为备用
     if (!registered && !hasIdeDir) {
-        createMcpJson(cwd);
+        createMcpJson(cwd, apiUrl);
     }
     // --from: 从模板项目拉取 IDE 配置文件
     if (opts.from) {
@@ -344,7 +344,7 @@ function autoRegisterMcp(apiUrl, user) {
     return true;
 }
 /** 在指定路径创建或更新 mcp.json 配置 */
-function createMcpConfigAt(mcpPath, autoCreatedTemplate) {
+function createMcpConfigAt(mcpPath, apiUrl) {
     let mcpConfig = {};
     if (fs.existsSync(mcpPath)) {
         try {
@@ -356,9 +356,13 @@ function createMcpConfigAt(mcpPath, autoCreatedTemplate) {
     }
     // Windows 需要 cmd /c 包装才能执行 npx
     const isWindows = process.platform === 'win32';
-    const ppdocsServer = isWindows
-        ? { command: 'cmd', args: ['/c', 'npx', '-y', '@ppdocs/mcp@latest'] }
-        : { command: 'npx', args: ['-y', '@ppdocs/mcp@latest'] };
+    const ppdocsServer = {
+        command: isWindows ? 'cmd' : 'npx',
+        args: isWindows ? ['/c', 'npx', '-y', '@ppdocs/mcp@latest'] : ['-y', '@ppdocs/mcp@latest'],
+        env: {
+            "PPDOCS_API_URL": apiUrl
+        }
+    };
     mcpConfig.mcpServers = {
         ...(mcpConfig.mcpServers || {}),
         "ppdocs-kg": ppdocsServer,
@@ -372,8 +376,8 @@ function createMcpConfigAt(mcpPath, autoCreatedTemplate) {
     console.log(`✅ Configured MCP in ${mcpPath}`);
 }
 /** 创建 .mcp.json (手动配置备用) */
-function createMcpJson(cwd) {
-    createMcpConfigAt(path.join(cwd, '.mcp.json'));
+function createMcpJson(cwd, apiUrl) {
+    createMcpConfigAt(path.join(cwd, '.mcp.json'), apiUrl);
 }
 /** 递归复制目录 */
 function copyDirRecursive(src, dest) {
@@ -496,9 +500,9 @@ function generateAgentsMd(cwd) {
     }
 }
 /** 安装 Cursor 模板 */
-function installCursorTemplates(cwd) {
+function installCursorTemplates(cwd, apiUrl) {
     // 1. 生成 Cursor MCP 配置
-    createMcpConfigAt(path.join(cwd, '.cursor', 'mcp.json'));
+    createMcpConfigAt(path.join(cwd, '.cursor', 'mcp.json'), apiUrl);
     // 2. 生成 .cursorrules 提示词
     const srcRules = path.join(TEMPLATES_DIR, 'cursorrules.md');
     const destRules = path.join(cwd, '.cursorrules');
@@ -508,16 +512,47 @@ function installCursorTemplates(cwd) {
     }
 }
 /** 安装 Antigravity (Gemini IDE) 模板 */
-function installAntigravityTemplates(cwd) {
+function installAntigravityTemplates(cwd, apiUrl) {
     // 1. 填充 .gemini/settings.json
-    createMcpConfigAt(path.join(cwd, '.gemini', 'settings.json'));
+    createMcpConfigAt(path.join(cwd, '.gemini', 'settings.json'), apiUrl);
     // 2. 生成 AGENTS.md
     generateAgentsMd(cwd);
+    // 3. 安装斜杠命令 → .agents/workflows/ (Antigravity 的 slash command 机制)
+    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');
+            count++;
+        }
+        if (count > 0) {
+            console.log(`✅ Installed ${count} workflows to .agents/workflows/ (use /pp-sync, /pp-review ...)`);
+        }
+    }
 }
 /** 安装 Kiro 模板 */
-function installKiroTemplates(cwd) {
+function installKiroTemplates(cwd, apiUrl) {
     // 1. 生成 Kiro MCP 配置
-    createMcpConfigAt(path.join(cwd, '.kiro', 'settings', 'mcp.json'));
+    createMcpConfigAt(path.join(cwd, '.kiro', 'settings', 'mcp.json'), apiUrl);
     // 2. 生成 Kiro Agent 规则
     const kiroRulesDir = path.join(cwd, '.kiro', 'rules');
     if (!fs.existsSync(kiroRulesDir)) {

package/package.json

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