@ppdocs/mcp 3.2.30 → 3.2.32

package/dist/cli.js

@@ -155,6 +155,20 @@ function writePpdocsConfig(cwd, opts) {
 }
 async function initProject(opts) {
     const cwd = process.cwd();
+    // ★ 版本检查: 防止 npx 缓存导致安装旧版
+    const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8'));
+    const currentVersion = pkg.version;
+    try {
+        const latest = execSync('npm view @ppdocs/mcp version', { encoding: 'utf-8', timeout: 5000 }).trim();
+        if (latest && latest !== currentVersion) {
+            console.log(`\n⚠️  当前版本 ${currentVersion}, 最新版本 ${latest}`);
+            console.log(`   npx 缓存了旧版本, 请运行:\n`);
+            console.log(`   npx -y @ppdocs/mcp@${latest} init ${process.argv.slice(3).join(' ')}\n`);
+            console.log(`   或清除缓存: rm -rf ~/.npm/_npx && npx -y @ppdocs/mcp@latest init ...\n`);
+            process.exit(1);
+        }
+    }
+    catch { /* 离线或超时, 跳过检查 */ }
     const apiUrl = writePpdocsConfig(cwd, opts);
     // Install workflow templates based on IDE detection
     const detectedIdes = detectIDEs(cwd);
@@ -539,21 +553,23 @@ function installCursorTemplates(cwd, apiUrl, user) {
 //  ★ 通用工作流安装 — 全平台共享 (删旧 + 写新)
 //  所有 IDE 最终都通过此函数安装 .agents/workflows/ 下的工作流文件
 // ========================================================================
-/** 工作流版本映射表: 模板文件名 → { 工作流命令名, 描述 } */
+/** 工作流版本映射表: 模板文件名 → { 工作流命令名, 描述 } — 仅保留 5 个核心 */
 const WORKFLOW_MAP = {
-    'protocol.md': { name: 'pp-task', desc: '知识驱动任务协议 — 图谱先查→任务追踪→逐步验证→实时回写' },
-    'init.md': { name: 'pp-init', desc: 'System Genesis Architect - 从文件系统提取秩序，构建知识图谱，重点识别**复用性资产**' },
-    'sync.md': { name: 'pp-sync', desc: 'Knowledge Graph Deep-Sync Protocol' },
-    'review.md': { name: 'pp-shencha', desc: '审查任务成果' },
+    'init.md': { name: 'pp-init', desc: '知识图谱初始化' },
+    'sync.md': { name: 'pp-sync', desc: '知识图谱同步' },
     'diagnose.md': { name: 'pp-diagnose', desc: '深度问题诊断' },
-    'execute.md': { name: 'pp-execute', desc: '执行开发任务' },
-    'audit.md': { name: 'pp-audit', desc: '多Agent代码审计' },
-    'discuss.md': { name: 'pp-discuss', desc: '讨论响应与协作' },
-    'Zero_Defec_Genesis.md': { name: 'plan', desc: '零缺陷创生协议' },
-    'SynchronizationProtocol.md': { name: 'pp-syncpro', desc: 'Knowledge Graph Quick-Sync Protocol' },
+    'Zero_Defec_Genesis.md': { name: 'plan', desc: '方案制定' },
+    'review.md': { name: 'pp-shencha', desc: '任务成果审查' },
 };
-/** 已废弃的旧版工作流文件名 (从早期 COMMAND_MAP 残留, 安装时自动清理) */
-const LEGACY_WORKFLOW_NAMES = ['pp-fenxi.md', 'pp-review.md'];
+/** 已废弃的旧版工作流文件名 (安装时自动清理) */
+const LEGACY_WORKFLOW_NAMES = [
+    // 旧版中文名
+    'pp-fenxi.md', 'pp-review.md',
+    // 旧版英文名
+    'diagnosticprotocol.md', 'zhixing.md', 'paln.md', 'fenxi.md', 'shencha.md',
+    // v3.2.31 移除的工作流
+    'pp-task.md', 'pp-execute.md', 'pp-audit.md', 'pp-discuss.md', 'pp-syncpro.md',
+];
 /**
  * 通用工作流安装: 删除旧版 → 写入最新版到 .agents/workflows/
  * 全平台共享: Antigravity / Claude Code / Cursor / Codex / Kiro

package/package.json

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

package/templates/cursorrules.md

@@ -26,6 +26,53 @@ kg_discuss(action:"list")                          → 检查待回复讨论
 
 ---
 
+## 方案制定 (第一性原理)
+
+**任何需求，先设计逻辑流程，再写代码。禁止跳过设计直接编码。**
+
+### Phase A: 第一性原理分析
+```
+1. 拆解需求本质: 这个功能的核心目的是什么？
+2. 识别输入/输出: 进什么 → 出什么？
+3. 查图谱现状:   kg_flowchart(get) → 哪些模块已存在可复用？
+4. 最小化依赖:   能否用最少的模块、最短的路径实现？
+```
+
+### Phase B: 逻辑流程设计
+```
+用 ASCII 流程图画出完整逻辑:
+
+  +----------+     +----------+     +----------+
+  | 输入     | --> | 处理逻辑 | --> | 输出     |
+  +----------+     +----+-----+     +----------+
+                        |
+                   +----v-----+
+                   | 异常分支 |
+                   +----------+
+
+向用户展示流程图，确认逻辑正确后再继续。
+```
+
+### Phase C: 细化逻辑节点
+```
+对流程图中每个节点，依次向下细化:
+  1. 定义接口: 输入参数 + 返回值
+  2. 选择实现: 复用现有 / 新建模块
+  3. 标注依赖: 上游数据来源 + 下游消费者
+  4. 异常处理: 每个节点的失败路径
+```
+
+### Phase D: 按流程执行 + 审查
+```
+按 Phase B 确认的逻辑流程，逐节点实现:
+  使用 Step 3 的逐步执行循环 (执行→验证→记录→回写)
+
+全部完成后:
+  对照逻辑流程图进行审查，确保实现与设计一致
+```
+
+---
+
 ## 标准执行流程
 
 ### Step 1: 知识锚定 (理解需求时)

package/templates/kiro-rules/ppdocs.md

@@ -26,6 +26,53 @@ kg_discuss(action:"list")                          → 检查待回复讨论
 
 ---
 
+## 方案制定 (第一性原理)
+
+**任何需求，先设计逻辑流程，再写代码。禁止跳过设计直接编码。**
+
+### Phase A: 第一性原理分析
+```
+1. 拆解需求本质: 这个功能的核心目的是什么？
+2. 识别输入/输出: 进什么 → 出什么？
+3. 查图谱现状:   kg_flowchart(get) → 哪些模块已存在可复用？
+4. 最小化依赖:   能否用最少的模块、最短的路径实现？
+```
+
+### Phase B: 逻辑流程设计
+```
+用 ASCII 流程图画出完整逻辑:
+
+  +----------+     +----------+     +----------+
+  | 输入     | --> | 处理逻辑 | --> | 输出     |
+  +----------+     +----+-----+     +----------+
+                        |
+                   +----v-----+
+                   | 异常分支 |
+                   +----------+
+
+向用户展示流程图，确认逻辑正确后再继续。
+```
+
+### Phase C: 细化逻辑节点
+```
+对流程图中每个节点，依次向下细化:
+  1. 定义接口: 输入参数 + 返回值
+  2. 选择实现: 复用现有 / 新建模块
+  3. 标注依赖: 上游数据来源 + 下游消费者
+  4. 异常处理: 每个节点的失败路径
+```
+
+### Phase D: 按流程执行 + 审查
+```
+按 Phase B 确认的逻辑流程，逐节点实现:
+  使用 Step 3 的逐步执行循环 (执行→验证→记录→回写)
+
+全部完成后:
+  对照逻辑流程图进行审查，确保实现与设计一致
+```
+
+---
+
 ## 标准执行流程
 
 ### Step 1: 知识锚定 (理解需求时)