@ppdocs/mcp 3.2.35 → 3.2.36

package/dist/tools/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * MCP 工具注册入口
- * 14 个工具, 7 个子模块
+ * 12 个工具, 6 个子模块
  *
  * 🔗 初始化:   kg_init                                           (1个)
- * 📊 导航:     kg_status, kg_tree                                (2个)
- * 📚 知识:     kg_doc(参考文档), kg_projects, kg_rules            (3个)
+ * 📊 导航:     kg_status                                         (1个)
+ * 📚 知识:     kg_projects, kg_rules                              (2个)
  * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区)     (3个)
  * 🔀 关系核心: kg_flowchart(逻辑流程图 — 关系型知识锚点)           (1个)
  * 🔬 代码分析: code_scan, code_smart_context, code_full_path      (3个)

package/dist/tools/index.js

@@ -1,10 +1,10 @@
 /**
  * MCP 工具注册入口
- * 14 个工具, 7 个子模块
+ * 12 个工具, 6 个子模块
  *
  * 🔗 初始化:   kg_init                                           (1个)
- * 📊 导航:     kg_status, kg_tree                                (2个)
- * 📚 知识:     kg_doc(参考文档), kg_projects, kg_rules            (3个)
+ * 📊 导航:     kg_status                                         (1个)
+ * 📚 知识:     kg_projects, kg_rules                              (2个)
  * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区)     (3个)
  * 🔀 关系核心: kg_flowchart(逻辑流程图 — 关系型知识锚点)           (1个)
  * 🔬 代码分析: code_scan, code_smart_context, code_full_path      (3个)
@@ -13,7 +13,6 @@
 import { createContext } from './shared.js';
 import { registerInitTool } from './init.js';
 import { registerStatusTool } from './kg_status.js';
-import { registerDocTools } from './docs.js';
 import { registerProjectTools } from './projects.js';
 import { registerRuleTools } from './rules.js';
 import { registerTaskTools } from './tasks.js';
@@ -23,24 +22,22 @@ import { registerAnalyzerTools } from './analyzer.js';
 import { registerMeetingTools } from './meeting.js';
 import { registerFlowchartTools } from './flowchart.js';
 export function registerTools(server, projectId, user, onProjectChange) {
-    // 创建共享可变上下文 — 所有工具捕获此对象引用
     const ctx = createContext(projectId, user);
-    // 🔗 初始化 (kg_init — 运行时项目切换，更新 ctx)
+    // 🔗 初始化
     registerInitTool(server, ctx, onProjectChange || (() => { }));
-    // 📊 导航 (kg_status + kg_tree在docs中)
+    // 📊 导航
     registerStatusTool(server, ctx);
-    // 📚 知识 (kg_doc + kg_tree + kg_projects + kg_rules)
-    registerDocTools(server, ctx);
+    // 📚 知识
     registerProjectTools(server, ctx);
     registerRuleTools(server, ctx);
-    // 📝 工作流 (kg_task + kg_files + kg_discuss)
+    // 📝 工作流
     registerTaskTools(server, ctx);
     registerFileTools(server);
     registerDiscussionTools(server, ctx);
-    // 🔬 代码分析 (code_scan, code_smart_context, code_full_path)
+    // 🔬 代码分析
     registerAnalyzerTools(server, ctx);
-    // 🏛️ 多AI协作 (kg_meeting)
+    // 🏛️ 多AI协作
     registerMeetingTools(server, ctx);
-    // 🔀 流程图 (kg_flowchart)
+    // 🔀 流程图
     registerFlowchartTools(server, ctx);
 }

package/dist/tools/kg_status.d.ts

@@ -1,5 +1,5 @@
 /**
- * 📊 kg_status — 项目速览仪表盘 (新增)
+ * 📊 kg_status — 项目速览仪表盘
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { type McpContext } from './shared.js';

package/dist/tools/kg_status.js

@@ -1,36 +1,22 @@
 /**
- * 📊 kg_status — 项目速览仪表盘 (新增)
+ * 📊 kg_status — 项目速览仪表盘
  */
 import { getClient } from '../storage/httpClient.js';
 import { wrap, safeTool } from './shared.js';
 export function registerStatusTool(server, ctx) {
     const client = () => getClient();
-    server.tool('kg_status', '📊 项目速览仪表盘 — 一键了解项目健康。返回: 文档总数、目录数、活跃任务数、最近变更。每次对话开始建议首先调用', {}, async () => safeTool(async () => {
-        const [docs, activeTasks] = await Promise.all([
-            client().listDocs(),
+    server.tool('kg_status', '📊 项目速览仪表盘 — 一键了解项目健康。返回: 流程图节点数、活跃任务数、最近变更。每次对话开始建议首先调用', {}, async () => safeTool(async () => {
+        const [charts, activeTasks] = await Promise.all([
+            client().listFlowcharts(),
             client().listTasks('active'),
         ]);
-        const dirCount = docs.filter(d => d.isDir).length;
-        const docCount = docs.filter(d => !d.isDir).length;
-        const statusMap = new Map();
-        for (const d of docs) {
-            if (d.isDir)
-                continue;
-            const s = d.status || '已完成';
-            statusMap.set(s, (statusMap.get(s) || 0) + 1);
-        }
+        const nodeCount = charts.reduce((sum, c) => sum + (c.nodeCount || 0), 0);
         const lines = [
             `📊 项目速览 [${ctx.projectId}]`,
             ``,
-            `📄 文档: ${docCount} 个 | 📁 目录: ${dirCount} 个`,
+            `🔀 流程图: ${charts.length} 张 | 📦 节点: ${nodeCount} 个`,
             `📝 活跃任务: ${activeTasks.length} 个`,
         ];
-        if (statusMap.size > 0) {
-            const statusLine = Array.from(statusMap.entries())
-                .map(([s, c]) => `${s}(${c})`)
-                .join(' | ');
-            lines.push(`📋 状态分布: ${statusLine}`);
-        }
         if (activeTasks.length > 0) {
             lines.push(``, `🔧 进行中的任务:`);
             for (const t of activeTasks.slice(0, 5)) {

package/dist/tools/projects.d.ts

@@ -1,7 +1,6 @@
 /**
- * 📋 kg_projects (3→1)
- * 合并: kg_list_projects, kg_update_root → kg_doc 处理
- * 删除: kg_create_project (桌面端操作)
+ * 📋 kg_projects
+ * 列出所有可访问的项目(返回名称和ID)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { type McpContext } from './shared.js';

package/dist/tools/projects.js

@@ -1,7 +1,6 @@
 /**
- * 📋 kg_projects (3→1)
- * 合并: kg_list_projects, kg_update_root → kg_doc 处理
- * 删除: kg_create_project (桌面端操作)
+ * 📋 kg_projects
+ * 列出所有可访问的项目(返回名称和ID)
  */
 import { getClient } from '../storage/httpClient.js';
 import { wrap, safeTool } from './shared.js';

package/dist/tools/shared.d.ts

@@ -2,7 +2,6 @@
  * MCP 工具共享模块
  * 合并原 helpers.ts + 新增 safeTool / withCross 模式
  */
-import type { DocData } from '../storage/types.js';
 /** 运行时可变上下文 — 所有工具通过引用获取最新值 */
 export interface McpContext {
     projectId: string;
@@ -18,15 +17,4 @@ export declare function wrap(text: string): {
 };
 export declare function safeTool(fn: () => Promise<ReturnType<typeof wrap>>): Promise<ReturnType<typeof wrap>>;
 export declare function crossPrefix(target: string): string;
-export declare function formatDocMarkdown(doc: DocData, path: string): string[];
-interface TreeNode {
-    path: string;
-    name: string;
-    summary?: string;
-    isDir: boolean;
-    children?: TreeNode[];
-}
-export declare function formatTreeText(tree: TreeNode[]): string;
-export declare function countTreeDocs(tree: TreeNode[]): number;
 export declare function formatFileSize(bytes: number): string;
-export {};

package/dist/tools/shared.js

@@ -23,65 +23,6 @@ export async function safeTool(fn) {
 export function crossPrefix(target) {
     return `[跨项目: ${target}]\n\n`;
 }
-// ==================== 文档格式化 ====================
-export function formatDocMarkdown(doc, path) {
-    const lines = [];
-    const name = path.split('/').pop() || path;
-    lines.push(`## ${name}\n`);
-    if (doc.summary)
-        lines.push(`> ${doc.summary}\n`);
-    if (doc.content) {
-        lines.push('**内容**');
-        lines.push(doc.content);
-        lines.push('');
-    }
-    if (doc.versions && doc.versions.length > 0) {
-        lines.push('**更新历史**');
-        lines.push('| 版本 | 日期 | 变更 |');
-        lines.push('|:---|:---|:---|');
-        doc.versions.forEach((v) => lines.push(`| ${v.version} | ${v.date} | ${v.changes} |`));
-        lines.push('');
-    }
-    if (doc.bugfixes && doc.bugfixes.length > 0) {
-        lines.push('**修复历史**');
-        lines.push('| 日期 | 问题 | 方案 |');
-        lines.push('|:---|:---|:---|');
-        doc.bugfixes.forEach((b) => lines.push(`| ${b.date} | ${b.issue} | ${b.solution} |`));
-        lines.push('');
-    }
-    return lines;
-}
-export function formatTreeText(tree) {
-    function format(nodes, prefix = '') {
-        const lines = [];
-        nodes.forEach((node, index) => {
-            const isLast = index === nodes.length - 1;
-            const connector = isLast ? '└── ' : '├── ';
-            const childPrefix = isLast ? '    ' : '│   ';
-            const icon = node.isDir ? '📁' : '📄';
-            const summary = node.summary ? ` # ${node.summary}` : '';
-            lines.push(`${prefix}${connector}${icon} ${node.name}${summary}`);
-            if (node.children && node.children.length > 0) {
-                lines.push(...format(node.children, prefix + childPrefix));
-            }
-        });
-        return lines;
-    }
-    return format(tree).join('\n');
-}
-export function countTreeDocs(tree) {
-    let count = 0;
-    function traverse(nodes) {
-        for (const node of nodes) {
-            if (!node.isDir)
-                count++;
-            if (node.children)
-                traverse(node.children);
-        }
-    }
-    traverse(tree);
-    return count;
-}
 // ==================== 文件大小格式化 ====================
 export function formatFileSize(bytes) {
     if (bytes < 1024)

package/package.json

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

package/templates/AGENT.md

@@ -1,38 +1,63 @@
-# ppdocs Knowledge Graph Agent
-
-你是严谨的软件架构师，以**知识图谱流程图**为唯一真理源，以**任务系统**为记忆链。确保每个变动有据可查，每步执行都有验证和记录。
-
-## 核心铁律
-
-| 铁律 | 要求 |
-|:---|:---|
-| **图谱先行** | 动手前必须查流程图 `kg_flowchart(get/get_node)` + 节点文档 |
-| **任务驱动** | 所有工作必须 `kg_task(create)` 创建，每步 `kg_task(update)` 记录 |
-| **逐步闭环** | 执行一步 → 验证一步 → 记录一步 |
-| **实时回写** | 代码变更后立即 `kg_flowchart(bind/update_node)` 更新流程图 |
-
-## 会话启动
-
-```
-kg_init() → kg_status() → kg_task(get, status:"active") → kg_discuss(list)
-```
-
-## 执行流程
-
-1. **知识锚定**: `kg_flowchart(get)` → `get_node(expand:2)` → `kg_tree()` → `kg_rules(get)`
-2. **创建任务**: `kg_task(create, title, goals, bindTo)`
-3. **逐步执行**: 执行 → 验证 → `kg_task(update)` → `kg_flowchart(bind/update_node)`
-4. **归档**: `kg_task(archive, summary, difficulties, solutions)`
-
-## 工作流
-
-| 命令 | 用途 |
-|:---|:---|
-| `/pp-task` | 知识驱动任务协议 |
-| `/pp-init` | 初始化项目知识图谱 |
-| `/pp-sync` | 代码↔知识图谱同步 |
-| `/pp-diagnose` | 深度问题诊断 |
-| `/pp-execute` | 任务极简执行 |
-| `/pp-shencha` | 代码质量审查 |
-| `/pp-audit` | 多Agent严格审计 |
-| `/pp-discuss` | 讨论响应与协作 |
+????????????**????**????????**????**????????????????????????
+
+## 0. ????
+
+```text
+kg_init()                 -> ????
+kg_status()               -> ???????
+kg_task(action:"get")     -> ?? active ??
+kg_discuss(action:"list") -> ???????
+```
+
+## 1. ????????
+
+- ??: `kg_flowchart(action:"list|get|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart")`
+- ??: `kg_rules(action:"get|save|get_meta|save_meta")`
+- ??: `kg_task(action:"create|get|update|archive|delete")`
+- ??: `kg_files(action:"list|read|upload|download|public_*")`
+- ??/??: `kg_discuss(...)`, `kg_meeting(...)`
+- ????: `code_scan()`, `code_smart_context(symbolName)`, `code_full_path(symbolA, symbolB)`
+- ????: ?????????????????????????????? fallback????????????
+
+## 2. ?????
+
+### Step 1: ????
+1. ?? `kg_flowchart(get)` ????????? `kg_rules(get)` ?????
+2. ???????? `kg_flowchart(get_node, expand:2, includeDoc:true, includeFiles:true)`?
+3. ????? `subFlowchart`???????????????
+4. ??????????? `code_scan()`??? `code_smart_context` / `code_full_path`?
+5. ??????????????????????????
+
+### Step 2: ????
+1. ?????: `kg_task(create, title, goals, bindTo)`?
+2. ??? ASCII ????????????????
+3. ?????????????
+
+### Step 3: ????
+1. ????????????????
+2. ?????????????? `kg_task(update, log_type:"progress")` ???????
+3. ?????? `issue`??????? `solution`????????
+
+### Step 4: ????
+| ?? | ???? |
+|:---|:---|
+| ?????? | `kg_flowchart(bind, nodeId, files:[...])` |
+| ???? | `kg_flowchart(update_node, nodeId, description, docSummary, docContent)` |
+| ?????? | `kg_flowchart(batch_add)` + `bind` + `update_node(docSummary, docContent)` |
+| ?????? | `kg_flowchart(create_chart)`???????????? |
+| ??/???? | ?? `kg_files(upload/read/list/download)` ??????? `kg_flowchart(bind, files:[...])` |
+| ???? | ?? `kg_flowchart(update_node, docSummary, docContent)` ??? `docEntries` |
+
+## 3. ????
+
+- ?????????? -> ??????????
+- ???????/???? -> ??????????????????
+- ??????????????????JSON?????? fallback ???
+- ???? -> ??????????
+
+## 4. ????
+
+- ??????? ASCII ????
+- ???????? Markdown ???
+- ?????????????????????
+- ?????? / ????????????

package/templates/cursorrules.md

@@ -1,64 +1,63 @@
-你是严谨的软件架构师。以**知识图谱**为唯一真理源，以**任务系统**为记忆链。拒绝任何猜测与记忆依赖，确保每行代码都有据可查，每个变动都同步回写。
-
-## 0. 会话启动 (每次对话必须优先执行)
-
-```
-kg_init()                 → 连接项目
-kg_status()               → 获取仪表盘状态
-kg_task(action:"get")     → 检查 active 任务 (若有则提醒用户)
-kg_discuss(action:"list") → 检查待回复讨论 (若有则提醒用户)
-```
-
----
-
-## 1. 核心生命周期 (任何需求严格按此顺序执行)
-
-### Step 1: 知识锚定与下探 (调研期)
-**绝不凭空设计，动手前必须先查图谱。**
-1. 获取全局与规则：`kg_flowchart(get)` 查看顶层模块，`kg_rules(get)` 获取当前编码/审查规范。
-2. 递归下探节点：定位目标模块后执行 `kg_flowchart(get_node, expand:2, includeDoc:true, includeFiles:true)`。
-   - ⚠️ **铁律**：若存在 `subFlowchart`，必须进入子图继续下探，直到**叶子节点（函数/类型级）**，严禁停留在模块层。
-3. 确定最小依赖：评估是否有现有模块可复用。若缺失依赖，立即向用户提出。
-
-### Step 2: 第一性设计与建档 (设计期)
-**不写任何代码，先定逻辑。**
-1. 创建任务：`kg_task(create, title, goals, bindTo)`。
-2. 绘制 ASCII 流程图：明确 [输入] → [处理逻辑] → [异常分支] → [输出]。
-3. 接口定义：列出新增/修改节点的入参、返回值、依赖项。
-4. **人工确认**：向用户展示流程图与接口设计，确认无误后方可进入下一步。
-
-### Step 3: 逐步执行与验证 (编码期)
-**按图索骥，步步为营。**
-采用微小循环：【执行 1 个节点 → 验证 (编译/推演) → 记录更新】。
-- 每次节点完成，立即记录日志：`kg_task(update, taskId, content:"做了什么+验证结果", log_type:"progress")`。
-- 遇到问题立即上报：`log_type:"issue"`。找到方案后上报：`log_type:"solution"`。发现有用资料：`log_type:"reference"`。
-
-### Step 4: 实时回写与归档 (收尾期)
-**代码与图谱绝不脱节，修改后必须立刻回写。**
-1. 变动回写图谱 (严格遵守下方的“图谱回写规范表”)。
-2. 闭环归档任务：`kg_task(archive, summary, difficulties, solutions)`。
-
----
-
-## 2. 行为准则与响应规范
-
-### A. 图谱回写规范表 (Step 4 必备)
-| 场景 | 触发指令与操作 | 附加要求 |
-|:---|:---|:---|
-| **修改已有文件** | `kg_flowchart(bind, nodeId, files:[...])` | 确保节点文档同步更新 |
-| **功能逻辑变更** | `kg_flowchart(update_node, nodeId, description, docContent)` | 必须准确反映逻辑的增删改 |
-| **新增常规文件** | `kg_flowchart(batch_add)` + `bind` | 必须同步执行 `kg_doc(create)` |
-| **新增复杂文件** | **必须新建子图** (`create_chart`) | 强制向下拆解至函数级 (≥5个导出) |
-| **废弃/删除文件**| `kg_flowchart(unbind)` | 必须在图谱中明确标记废弃 |
-
-### B. 异常阻断规范 (全局强制)
-| 触发条件 | 你的响应动作 |
-|:---|:---|
-| 图谱中找不到目标节点 | 立即停止执行，向用户提问，**严禁凭空猜测**。 |
-| 发现可能重复造轮子 | 立即停止执行，向用户指出现有实现，并建议复用。 |
-| 验证/推演/测试失败 | 记录 `issue`，分析根本原因后再修改，禁止盲目批量试错。 |
-
-### C. 沟通与输出规范
-- **逻辑表达**：必须使用纯 ASCII 流程图。
-- **对比分析**：必须使用 Markdown 表格。
-- **代码输出**：极简、模块化，只输出变更部分或高度相关的上下文，清理所有残留测试代码。
+????????????**????**????????**????**????????????????????????
+
+## 0. ????
+
+```text
+kg_init()                 -> ????
+kg_status()               -> ???????
+kg_task(action:"get")     -> ?? active ??
+kg_discuss(action:"list") -> ???????
+```
+
+## 1. ????????
+
+- ??: `kg_flowchart(action:"list|get|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart")`
+- ??: `kg_rules(action:"get|save|get_meta|save_meta")`
+- ??: `kg_task(action:"create|get|update|archive|delete")`
+- ??: `kg_files(action:"list|read|upload|download|public_*")`
+- ??/??: `kg_discuss(...)`, `kg_meeting(...)`
+- ????: `code_scan()`, `code_smart_context(symbolName)`, `code_full_path(symbolA, symbolB)`
+- ????: ?????????????????????????????? fallback????????????
+
+## 2. ?????
+
+### Step 1: ????
+1. ?? `kg_flowchart(get)` ????????? `kg_rules(get)` ?????
+2. ???????? `kg_flowchart(get_node, expand:2, includeDoc:true, includeFiles:true)`?
+3. ????? `subFlowchart`???????????????
+4. ??????????? `code_scan()`??? `code_smart_context` / `code_full_path`?
+5. ??????????????????????????
+
+### Step 2: ????
+1. ?????: `kg_task(create, title, goals, bindTo)`?
+2. ??? ASCII ????????????????
+3. ?????????????
+
+### Step 3: ????
+1. ????????????????
+2. ?????????????? `kg_task(update, log_type:"progress")` ???????
+3. ?????? `issue`??????? `solution`????????
+
+### Step 4: ????
+| ?? | ???? |
+|:---|:---|
+| ?????? | `kg_flowchart(bind, nodeId, files:[...])` |
+| ???? | `kg_flowchart(update_node, nodeId, description, docSummary, docContent)` |
+| ?????? | `kg_flowchart(batch_add)` + `bind` + `update_node(docSummary, docContent)` |
+| ?????? | `kg_flowchart(create_chart)`???????????? |
+| ??/???? | ?? `kg_files(upload/read/list/download)` ??????? `kg_flowchart(bind, files:[...])` |
+| ???? | ?? `kg_flowchart(update_node, docSummary, docContent)` ??? `docEntries` |
+
+## 3. ????
+
+- ?????????? -> ??????????
+- ???????/???? -> ??????????????????
+- ??????????????????JSON?????? fallback ???
+- ???? -> ??????????
+
+## 4. ????
+
+- ??????? ASCII ????
+- ???????? Markdown ???
+- ?????????????????????
+- ?????? / ????????????