@ppdocs/mcp 2.8.1 → 2.8.3

package/dist/tools/helpers.js

@@ -55,7 +55,7 @@ export function formatTreeText(tree) {
             const connector = isLast ? '└── ' : '├── ';
             const childPrefix = isLast ? '    ' : '│   ';
             const icon = node.isDir ? '📁' : '📄';
-            const summary = node.summary ? ` - ${node.summary}` : '';
+            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));

package/dist/tools/index.js

@@ -23,8 +23,8 @@ export function registerTools(server, projectId, _user) {
         });
         return wrap(`✅ 文档已创建: ${decoded.path}\n\n${JSON.stringify(doc, null, 2)}`);
     });
-    // 2. 删除文档 (支持批量)
-    server.tool('kg_delete_node', '删除文档(支持批量，根文档不可删除)', { nodeId: z.union([z.string(), z.array(z.string())]).describe('文档路径或路径数组') }, async (args) => {
+    // 2. 删除文档或目录 (支持批量)
+    server.tool('kg_delete_node', '删除文档或目录(支持批量，根不可删除，目录会递归删除)', { nodeId: z.union([z.string(), z.array(z.string())]).describe('文档路径或路径数组') }, async (args) => {
         const paths = Array.isArray(args.nodeId) ? args.nodeId : [args.nodeId];
         const results = [];
         for (const path of paths) {
@@ -42,24 +42,21 @@ export function registerTools(server, projectId, _user) {
         }
         return wrap(msg);
     });
-    // 3. 更新文档 (支持批量)
-    server.tool('kg_update_node', '更新文档内容(支持批量)', {
-        nodeId: z.union([
-            z.string(),
-            z.array(z.string())
-        ]).describe('文档路径或路径数组'),
-        summary: z.string().optional().describe('一句话简介'),
-        content: z.string().optional().describe('Markdown内容'),
+    // 3. 更新文档 (支持单个/批量两种模式)
+    server.tool('kg_update_node', '更新文档内容。【单个模式】nodeId+字段；【批量模式】仅传updates数组。两种模式二选一', {
+        nodeId: z.string().optional().describe('【单个模式】文档路径，如"/前端/组件/Button"'),
+        summary: z.string().optional().describe('【单个模式】一句话简介'),
+        content: z.string().optional().describe('【单个模式】Markdown内容'),
         versions: z.array(z.object({
             version: z.number(),
             date: z.string(),
             changes: z.string()
-        })).optional().describe('版本记录'),
+        })).optional().describe('【单个模式】版本记录数组'),
         bugfixes: z.array(z.object({
             date: z.string(),
             issue: z.string(),
             solution: z.string()
-        })).optional().describe('修复记录'),
+        })).optional().describe('【单个模式】修复记录数组'),
         updates: z.array(z.object({
             nodeId: z.string().describe('文档路径'),
             summary: z.string().optional(),
@@ -74,7 +71,7 @@ export function registerTools(server, projectId, _user) {
                 issue: z.string(),
                 solution: z.string()
             })).optional()
-        })).optional().describe('批量更新数组(每项独立配置)')
+        })).optional().describe('【批量模式】更新数组，每项包含nodeId和要更新的字段')
     }, async (args) => {
         const decoded = decodeObjectStrings(args);
         // 批量更新模式: 使用 updates 数组
@@ -110,15 +107,17 @@ export function registerTools(server, projectId, _user) {
             }
             return wrap(msg);
         }
-        // 单个更新模式
+        // 单个更新模式: 必须提供 nodeId
         const { nodeId, summary, content, versions, bugfixes } = decoded;
-        const singleNodeId = Array.isArray(nodeId) ? nodeId[0] : nodeId;
+        if (!nodeId) {
+            return wrap('❌ 请提供 nodeId（单个模式）或 updates 数组（批量模式）');
+        }
         // 根文档必须使用 kg_update_root 更新
-        if (singleNodeId === '/' || singleNodeId === '_root') {
+        if (nodeId === '/' || nodeId === '_root') {
             return wrap('❌ 根文档请使用 kg_update_root 方法更新');
         }
         // 获取现有文档
-        const existing = await storage.getDoc(projectId, singleNodeId);
+        const existing = await storage.getDoc(projectId, nodeId);
         if (!existing) {
             return wrap('更新失败(文档不存在)');
         }
@@ -132,7 +131,7 @@ export function registerTools(server, projectId, _user) {
             updates.versions = versions;
         if (bugfixes !== undefined)
             updates.bugfixes = bugfixes;
-        const doc = await storage.updateDoc(projectId, singleNodeId, updates);
+        const doc = await storage.updateDoc(projectId, nodeId, updates);
         return wrap(doc ? JSON.stringify(doc, null, 2) : '更新失败');
     });
     // 3.5 更新根文档 (项目介绍)

package/package.json

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