@ppdocs/mcp 3.2.33 → 3.2.34

package/package.json

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

package/templates/commands/pp/init.md

@@ -197,4 +197,16 @@ kg_status()                       → 最终仪表盘
 | code_scan 返回0符号 | 检查 projectPath, 可能需要指定源码目录 |
 | 已有节点与新扫描冲突 | 展示差异, 用户选择: 保留/覆盖/合并 |
 | 文件解析失败 | 跳过该文件, 记录到任务日志, 不中断整体流程 |
-| 子图嵌套过深 (>4层) | 警告用户, 建议合并或扁平化 |
+| 主图节点超10个 | 合并相关模块为 super 节点, 用子图展开细节 |
+
+## ★ 深度下探激励
+
+| 下探层级 | 评价 | 示例 |
+|:---|:---|:---|
+| 仅 main | ❌ 不合格 | 只有5个高层模块 |
+| main → L1 子图 | ⚠️ 基本 | 模块→文件级 |
+| main → L1 → L2 | ✅ 良好 | 模块→文件→函数组 |
+| main → L1 → L2 → L3 | 🌟 优秀 | 模块→文件→函数→内部逻辑 |
+| main → ... → Ln 叶子 | 🏆 卓越 | 直达最底层, 每个公开函数可查 |
+
+**下探越深 = 知识图谱价值越高。无深度限制，鼓励下探到函数级。**

package/templates/commands/pp/sync.md

@@ -226,4 +226,4 @@ kg_task(action:"archive", taskId:"当前任务",
 | 节点绑定的文件不存在 | 标记 [DRIFT], 搜索新位置, 建议 rebind |
 | 同一符号映射多个节点 | 暂停, 列出候选, 请求用户选择 |
 | code_scan 索引过旧 | 自动 code_scan() 增量更新后重试 |
-| 子图嵌套变更 (新文件导出≥5) | 建议 create_chart 升级为子图 |
+| 新文件导出≥5个符号 | **必须** create_chart 建子图, 下探到函数级, 越深越好 |

package/templates/cursorrules.md

@@ -5,6 +5,7 @@
 | 铁律 | 要求 |
 |:---|:---|
 | **图谱先行** | 动手前必须查流程图 `kg_flowchart(get/get_node)` + 节点文档，禁止凭记忆或猜测 |
+| **递归下探** | 有子图必须进入查看，层层下探直到**叶子节点(函数/类型级)**，禁止停在模块层 |
 | **任务驱动** | 所有工作必须 `kg_task(create)` 创建记录，每完成一步立即 `kg_task(update)` |
 | **逐步闭环** | 执行一步 → 验证一步 → 记录一步，禁止批量执行后补记 |
 | **实时回写** | 代码变更后立即 `kg_flowchart(bind/update_node)` 更新流程图，不留脱节 |
@@ -75,15 +76,24 @@ kg_discuss(action:"list")                          → 检查待回复讨论
 
 ## 标准执行流程
 
-### Step 1: 知识锚定 (理解需求时)
+### Step 1: 知识锚定 — 递归下探 (理解需求时)
 ```
-kg_flowchart(action:"get")                         → 主图全貌
-kg_flowchart(action:"get_node", nodeId:目标, expand:2,
-  includeDoc:true, includeFiles:true)              → 节点详情+上下游
-kg_tree()                                          → 文档全景
-kg_rules(action:"get")                             → 编码/审查规则
+1. 主图全貌:
+   kg_flowchart(action:"get")                       → 所有顶层模块
+
+2. 定位目标模块, 递归下探直到叶子:
+   kg_flowchart(action:"get_node", nodeId:目标,
+     expand:2, includeDoc:true, includeFiles:true)  → 模块详情
+
+   ★ 如果节点有 subFlowchart → 必须进入子图:
+   kg_flowchart(action:"get", chartId:子图ID)       → 子图全貌
+   → 对子图中每个节点重复此过程, 直到没有更深的子图
+
+3. 文档+规则:
+   kg_tree()                                        → 文档全景
+   kg_rules(action:"get")                           → 编码/审查规则
 ```
-输出: 涉及模块 + 关键文档 + 现有逻辑 + 待确认点
+输出: 涉及模块 + 完整下探路径 + 关键文档 + 现有逻辑 + 待确认点
 
 ### Step 2: 创建任务 (开工前)
 ```
@@ -124,6 +134,7 @@ kg_task(action:"archive", summary, difficulties, solutions)
 | 修改已有文件 | `kg_flowchart(action:"bind", nodeId, files:[...])` |
 | 功能逻辑变更 | `kg_flowchart(action:"update_node", nodeId, description, docContent)` |
 | 创建新文件/模块 | `kg_flowchart(action:"batch_add")` + `bind` + `kg_doc(create)` |
+| 新增复杂文件(≥5导出) | 必须 `create_chart` 建子图, 下探到函数级 |
 | 删除文件 | `kg_flowchart(action:"unbind")` + 标记废弃 |
 
 ---