@ppdocs/mcp 3.2.29 → 3.2.30

package/dist/cli.js

@@ -486,37 +486,53 @@ function installClaudeTemplates(cwd) {
     fs.writeFileSync(settingsPath, JSON.stringify(mergedSettings, null, 2));
     console.log(`✅ Configured .claude/settings.json hooks (${process.platform})`);
     console.log(`✅ Added ${mcpPermissions.length} MCP method permissions`);
-    // 4. 安装工作流到 .agents/workflows/ (全平台通用)
+    // 4. 生成 CLAUDE.md 全局规则 (Claude Code 官方标准)
+    installGlobalRules(cwd, 'CLAUDE.md');
+    // 5. 安装工作流到 .agents/workflows/ (全平台通用)
     installWorkflows(cwd);
 }
 /** 安装 Codex 模板 (生成 AGENTS.md + 工作流) */
 function installCodexTemplates(cwd) {
-    generateAgentsMd(cwd);
+    installGlobalRules(cwd, 'AGENTS.md');
     installWorkflows(cwd);
 }
-/** 生成 AGENTS.md 工具函数 (去重) */
-function generateAgentsMd(cwd) {
-    const srcPrompt = path.join(TEMPLATES_DIR, 'hooks', 'SystemPrompt.md');
-    const destAgents = path.join(cwd, 'AGENTS.md');
-    if (fs.existsSync(srcPrompt) && !fs.existsSync(destAgents)) {
-        fs.copyFileSync(srcPrompt, destAgents);
-        console.log(`✅ Created AGENTS.md`);
+/**
+ * 生成全局规则文件 (各平台统一内容, 不同文件名)
+ * Claude Code → CLAUDE.md | Codex → AGENTS.md | Gemini → GEMINI.md
+ */
+function installGlobalRules(cwd, filename) {
+    const srcRules = path.join(TEMPLATES_DIR, 'cursorrules.md');
+    const destFile = path.join(cwd, filename);
+    if (fs.existsSync(srcRules)) {
+        // 总是覆盖写入最新版全局规则
+        fs.copyFileSync(srcRules, destFile);
+        console.log(`✅ Installed ${filename} (global rules)`);
     }
-    else if (!fs.existsSync(srcPrompt)) {
-        console.log(`⚠️  SystemPrompt.md template not found`);
+    else {
+        console.log(`⚠️  Global rules template not found`);
     }
 }
 /** 安装 Cursor 模板 */
 function installCursorTemplates(cwd, apiUrl, user) {
     createMcpConfigAt(path.join(cwd, '.cursor', 'mcp.json'), apiUrl, { user });
-    // 2. 生成 .cursorrules 提示词
+    // 2. 生成 .cursor/rules/ppdocs.md (官方标准, .cursorrules 已废弃)
+    const cursorRulesDir = path.join(cwd, '.cursor', 'rules');
+    if (!fs.existsSync(cursorRulesDir)) {
+        fs.mkdirSync(cursorRulesDir, { recursive: true });
+    }
     const srcRules = path.join(TEMPLATES_DIR, 'cursorrules.md');
-    const destRules = path.join(cwd, '.cursorrules');
-    if (fs.existsSync(srcRules) && !fs.existsSync(destRules)) {
+    const destRules = path.join(cursorRulesDir, 'ppdocs.md');
+    if (fs.existsSync(srcRules)) {
         fs.copyFileSync(srcRules, destRules);
-        console.log(`✅ Created .cursorrules`);
+        console.log(`✅ Installed .cursor/rules/ppdocs.md`);
     }
-    // 3. 安装工作流到 .agents/workflows/
+    // 3. 清理废弃的 .cursorrules 文件
+    const legacyCursorrules = path.join(cwd, '.cursorrules');
+    if (fs.existsSync(legacyCursorrules)) {
+        fs.unlinkSync(legacyCursorrules);
+        console.log(`🗑️  Removed deprecated .cursorrules`);
+    }
+    // 4. 安装工作流到 .agents/workflows/
     installWorkflows(cwd);
 }
 // ========================================================================
@@ -590,8 +606,8 @@ function installWorkflows(cwd, extraDirs = []) {
 function installAntigravityTemplates(cwd, apiUrl, user) {
     // Antigravity 由 gemini CLI 注册 env，文件配置不注入避免冲突
     createMcpConfigAt(path.join(cwd, '.gemini', 'settings.json'), apiUrl, { noEnv: true, user });
-    // 2. 生成 AGENTS.md
-    generateAgentsMd(cwd);
+    // 2. 生成 GEMINI.md 全局规则 (Gemini CLI 官方标准)
+    installGlobalRules(cwd, 'GEMINI.md');
     // 3. Antigravity 全局 workflows 目录 (额外安装目标)
     const homeDir = process.env.USERPROFILE || process.env.HOME || '';
     const globalWorkflowDir = path.join(homeDir, '.gemini', 'antigravity', 'global_workflows');
@@ -604,18 +620,24 @@ function installAntigravityTemplates(cwd, apiUrl, user) {
 /** 安装 Kiro 模板 */
 function installKiroTemplates(cwd, apiUrl, user) {
     createMcpConfigAt(path.join(cwd, '.kiro', 'settings', 'mcp.json'), apiUrl, { user });
-    // 2. 生成 Kiro Agent 规则
-    const kiroRulesDir = path.join(cwd, '.kiro', 'rules');
-    if (!fs.existsSync(kiroRulesDir)) {
-        fs.mkdirSync(kiroRulesDir, { recursive: true });
+    // 2. 生成 Kiro Steering 文件 (官方标准: .kiro/steering/ 而非 rules/)
+    const steeringDir = path.join(cwd, '.kiro', 'steering');
+    if (!fs.existsSync(steeringDir)) {
+        fs.mkdirSync(steeringDir, { recursive: true });
     }
     const srcRules = path.join(TEMPLATES_DIR, 'kiro-rules', 'ppdocs.md');
-    const destRules = path.join(kiroRulesDir, 'ppdocs.md');
-    if (fs.existsSync(srcRules) && !fs.existsSync(destRules)) {
-        fs.copyFileSync(srcRules, destRules);
-        console.log(`✅ Created .kiro/rules/ppdocs.md`);
-    }
-    // 3. 安装工作流到 .agents/workflows/
+    const destSteering = path.join(steeringDir, 'ppdocs.md');
+    if (fs.existsSync(srcRules)) {
+        fs.copyFileSync(srcRules, destSteering);
+        console.log(`✅ Installed .kiro/steering/ppdocs.md`);
+    }
+    // 3. 清理废弃的 .kiro/rules/ 旧路径
+    const legacyRules = path.join(cwd, '.kiro', 'rules', 'ppdocs.md');
+    if (fs.existsSync(legacyRules)) {
+        fs.unlinkSync(legacyRules);
+        console.log(`🗑️  Removed deprecated .kiro/rules/ppdocs.md`);
+    }
+    // 4. 安装工作流到 .agents/workflows/
     installWorkflows(cwd);
 }
 /** 检测当前工作区包含的 IDE */

package/package.json

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