@ppdocs/mcp 2.8.0 → 2.8.2

package/dist/tools/index.js

@@ -23,29 +23,95 @@ 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.string().describe('文档路径') }, async (args) => {
-        const success = await storage.deleteDoc(projectId, args.nodeId);
-        return wrap(success ? '删除成功' : '删除失败(文档不存在或是根文档)');
+    // 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) {
+            const success = await storage.deleteDoc(projectId, path);
+            results.push({ path, success });
+        }
+        const successCount = results.filter(r => r.success).length;
+        const failedPaths = results.filter(r => !r.success).map(r => r.path);
+        if (paths.length === 1) {
+            return wrap(results[0].success ? '删除成功' : '删除失败(文档不存在或是根文档)');
+        }
+        let msg = `✅ 批量删除完成: ${successCount}/${paths.length} 成功`;
+        if (failedPaths.length > 0) {
+            msg += `\n❌ 失败: ${failedPaths.join(', ')}`;
+        }
+        return wrap(msg);
     });
-    // 3. 更新文档
-    server.tool('kg_update_node', '更新文档内容', {
-        nodeId: 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(),
+            content: z.string().optional(),
+            versions: z.array(z.object({
+                version: z.number(),
+                date: z.string(),
+                changes: z.string()
+            })).optional(),
+            bugfixes: z.array(z.object({
+                date: z.string(),
+                issue: z.string(),
+                solution: z.string()
+            })).optional()
+        })).optional().describe('【批量模式】更新数组，每项包含nodeId和要更新的字段')
     }, async (args) => {
         const decoded = decodeObjectStrings(args);
+        // 批量更新模式: 使用 updates 数组
+        if (decoded.updates && Array.isArray(decoded.updates)) {
+            const results = [];
+            for (const item of decoded.updates) {
+                if (item.nodeId === '/' || item.nodeId === '_root') {
+                    results.push({ path: item.nodeId, success: false });
+                    continue;
+                }
+                const existing = await storage.getDoc(projectId, item.nodeId);
+                if (!existing) {
+                    results.push({ path: item.nodeId, success: false });
+                    continue;
+                }
+                const updates = {};
+                if (item.summary !== undefined)
+                    updates.summary = item.summary;
+                if (item.content !== undefined)
+                    updates.content = item.content;
+                if (item.versions !== undefined)
+                    updates.versions = item.versions;
+                if (item.bugfixes !== undefined)
+                    updates.bugfixes = item.bugfixes;
+                const doc = await storage.updateDoc(projectId, item.nodeId, updates);
+                results.push({ path: item.nodeId, success: !!doc });
+            }
+            const successCount = results.filter(r => r.success).length;
+            const failedPaths = results.filter(r => !r.success).map(r => r.path);
+            let msg = `✅ 批量更新完成: ${successCount}/${decoded.updates.length} 成功`;
+            if (failedPaths.length > 0) {
+                msg += `\n❌ 失败: ${failedPaths.join(', ')}`;
+            }
+            return wrap(msg);
+        }
+        // 单个更新模式: 必须提供 nodeId
         const { nodeId, summary, content, versions, bugfixes } = decoded;
+        if (!nodeId) {
+            return wrap('❌ 请提供 nodeId（单个模式）或 updates 数组（批量模式）');
+        }
         // 根文档必须使用 kg_update_root 更新
         if (nodeId === '/' || nodeId === '_root') {
             return wrap('❌ 根文档请使用 kg_update_root 方法更新');

package/package.json

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