@ppdocs/mcp 3.1.10 → 3.2.1

package/dist/tools/discussion.js

@@ -0,0 +1,111 @@
+/**
+ * 💬 kg_discuss (6→1)
+ * 合并: kg_discussion_list, kg_discussion_read, kg_discussion_create,
+ *       kg_discussion_reply, kg_discussion_close_and_archive, kg_discussion_delete
+ */
+import { z } from 'zod';
+import { getClient } from '../storage/httpClient.js';
+import { decodeObjectStrings } from '../utils.js';
+import { wrap, safeTool } from './shared.js';
+import { DiscussionManager } from '../storage/discussion.js';
+export function registerDiscussionTools(server, projectId) {
+    const client = () => getClient();
+    server.tool('kg_discuss', '💬 跨项目讨论 — 发起、回复、归档协同讨论。action: list(列出活跃讨论)|read(读取详情)|create(发起)|reply(回复)|close(结案归档)|delete(删除)', {
+        action: z.enum(['list', 'read', 'create', 'reply', 'close', 'delete'])
+            .describe('操作类型'),
+        id: z.string().optional()
+            .describe('讨论哈希ID (read/reply/close/delete)'),
+        ids: z.array(z.string()).optional()
+            .describe('批量读取的讨论ID数组 (read)'),
+        title: z.string().optional()
+            .describe('讨论标题 (create)'),
+        participants: z.array(z.string()).optional()
+            .describe('参与项目ID数组 (create, 不含自己)'),
+        content: z.string().optional()
+            .describe('消息内容Markdown (create/reply)'),
+        conclusion: z.string().optional()
+            .describe('结案总结 (close)'),
+        newSummary: z.string().optional()
+            .describe('更新进展摘要 (reply)'),
+    }, async (args) => safeTool(async () => {
+        const decoded = decodeObjectStrings(args);
+        switch (decoded.action) {
+            case 'list': {
+                const cleaned = DiscussionManager.cleanExpired(7);
+                const active = DiscussionManager.listActive();
+                const cleanMsg = cleaned > 0 ? `\n⚠️ 已自动清理 ${cleaned} 条超过7天不活跃的讨论` : '';
+                if (active.length === 0)
+                    return wrap(`当前无活跃的讨论 (本项目ID: ${projectId})${cleanMsg}`);
+                return wrap(`本项目ID: ${projectId}\n活跃讨论区 (${active.length} 个):${cleanMsg}\n\n` + JSON.stringify(active, null, 2));
+            }
+            case 'read': {
+                const readIds = decoded.ids || (decoded.id ? [decoded.id] : []);
+                if (readIds.length === 0)
+                    return wrap('❌ read 需要 id 或 ids');
+                const discussions = DiscussionManager.readByIds(readIds);
+                if (discussions.length === 0)
+                    return wrap('未找到对应的讨论记录');
+                return wrap(JSON.stringify(discussions, null, 2));
+            }
+            case 'create': {
+                if (!decoded.title)
+                    return wrap('❌ create 需要 title');
+                if (!decoded.participants)
+                    return wrap('❌ create 需要 participants');
+                if (!decoded.content)
+                    return wrap('❌ create 需要 content');
+                const count = DiscussionManager.activeCount();
+                if (count >= 10)
+                    return wrap('❌ 活跃讨论已达上限(10条)');
+                const id = DiscussionManager.create(decoded.title, projectId, decoded.participants, decoded.content);
+                return wrap(`✅ 讨论已发起，ID: ${id}\n发起方: ${projectId}\n参与方: ${decoded.participants.join(', ')}`);
+            }
+            case 'reply': {
+                if (!decoded.id)
+                    return wrap('❌ reply 需要 id');
+                if (!decoded.content)
+                    return wrap('❌ reply 需要 content');
+                const success = DiscussionManager.reply(decoded.id, projectId, decoded.content, decoded.newSummary);
+                return wrap(success ? `✅ 回复成功 (ID: ${decoded.id})` : `❌ 回复失败，讨论不存在或已关闭`);
+            }
+            case 'close': {
+                if (!decoded.id)
+                    return wrap('❌ close 需要 id');
+                if (!decoded.conclusion)
+                    return wrap('❌ close 需要 conclusion');
+                const topic = DiscussionManager.getAndRemove(decoded.id);
+                if (!topic)
+                    return wrap('❌ 讨论不存在或已被归档清理');
+                let md = `# 跨项目协同: ${topic.title}\n\n`;
+                md += `**发起方**: ${topic.initiator}\n`;
+                md += `**参与方**: ${topic.participants.join(', ')}\n`;
+                md += `**结案总结**: ${decoded.conclusion}\n\n`;
+                md += `## 讨论还原 (Timeline)\n\n`;
+                for (const msg of topic.messages) {
+                    md += `### [${msg.sender}] (${msg.timestamp})\n${msg.content}\n\n`;
+                }
+                const safeTitle = topic.title.replace(/[\/\\?%*:|"<>]/g, '_');
+                const path = `/跨项目协同记录/${decoded.id}_${safeTitle}`;
+                try {
+                    await client().createDoc(path, {
+                        summary: decoded.conclusion, content: md,
+                        versions: [{ version: 1.0, date: new Date().toISOString(), changes: '结案归档' }],
+                        bugfixes: [], status: '已完成'
+                    });
+                    return wrap(`✅ 讨论已结案并归档: \`${path}\``);
+                }
+                catch (err) {
+                    return wrap(`⚠️ 讨论已清除，但归档失败: ${err}\n\n${md}`);
+                }
+            }
+            case 'delete': {
+                if (!decoded.id)
+                    return wrap('❌ delete 需要 id');
+                const success = DiscussionManager.delete(decoded.id);
+                return wrap(success ? `✅ 讨论已删除 (ID: ${decoded.id})` : `❌ 讨论不存在或已被删除`);
+            }
+            default:
+                return wrap(`❌ 未知 action: ${decoded.action}`);
+        }
+    }));
+}

package/dist/tools/docs.d.ts

@@ -1,7 +1,7 @@
 /**
- * 文档管理工具 (7个)
- * kg_create_node, kg_delete_node, kg_update_node, kg_read_node,
- * kg_get_tree, kg_get_docs_by_status, kg_copy_node
+ * 📄 kg_doc (5合1) + 🏗️ kg_tree (2合1)
+ * 合并: kg_create_node, kg_delete_node, kg_update_node, kg_read_node, kg_copy_node
+ *       kg_get_tree, kg_get_docs_by_status
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerDocTools(server: McpServer, projectId: string): void;

package/dist/tools/docs.js

@@ -1,7 +1,7 @@
 /**
- * 文档管理工具 (7个)
- * kg_create_node, kg_delete_node, kg_update_node, kg_read_node,
- * kg_get_tree, kg_get_docs_by_status, kg_copy_node
+ * 📄 kg_doc (5合1) + 🏗️ kg_tree (2合1)
+ * 合并: kg_create_node, kg_delete_node, kg_update_node, kg_read_node, kg_copy_node
+ *       kg_get_tree, kg_get_docs_by_status
  */
 import { z } from 'zod';
 import { getClient } from '../storage/httpClient.js';
@@ -9,52 +9,24 @@ import { decodeObjectStrings } from '../utils.js';
 import { wrap, safeTool, crossPrefix, formatDocMarkdown, formatTreeText, countTreeDocs } from './shared.js';
 export function registerDocTools(server, projectId) {
     const client = () => getClient();
-    // 创建文档
-    server.tool('kg_create_node', '创建知识文档。使用目录路径分类，文件名作为文档名', {
-        path: z.string().min(1).describe('完整文档路径(如"/前端/组件/Modal")'),
-        summary: z.string().optional().describe('一句话简介'),
-        content: z.string().describe('Markdown内容'),
-        status: z.string().optional().describe('文档状态(默认"已完成")')
-    }, async (args) => safeTool(async () => {
-        const d = decodeObjectStrings(args);
-        const doc = await client().createDoc(d.path, {
-            summary: d.summary || '',
-            content: d.content,
-            versions: [{ version: 0.1, date: new Date().toISOString(), changes: '初始创建' }],
-            bugfixes: [],
-            status: d.status || '已完成'
-        });
-        return wrap(`✅ 文档已创建: ${d.path}\n\n${JSON.stringify(doc, null, 2)}`);
-    }));
-    // 删除文档或目录 (支持批量)
-    server.tool('kg_delete_node', '删除文档或目录(支持批量，根不可删除，目录会递归删除)', { nodeId: z.union([z.string(), z.array(z.string())]).describe('文档路径或路径数组') }, async (args) => safeTool(async () => {
-        const paths = Array.isArray(args.nodeId) ? args.nodeId : [args.nodeId];
-        const results = [];
-        for (const p of paths) {
-            results.push({ path: p, success: await client().deleteDoc(p) });
-        }
-        const successCount = results.filter(r => r.success).length;
-        if (paths.length === 1) {
-            return wrap(results[0].success ? '删除成功' : '删除失败(文档不存在或是根文档)');
-        }
-        const failedPaths = results.filter(r => !r.success).map(r => r.path);
-        let msg = `✅ 批量删除完成: ${successCount}/${paths.length} 成功`;
-        if (failedPaths.length > 0)
-            msg += `\n❌ 失败: ${failedPaths.join(', ')}`;
-        return wrap(msg);
-    }));
-    // 更新文档 (支持单个/批量)
-    server.tool('kg_update_node', '更新文档内容。【单个模式】nodeId+字段；【批量模式】仅传updates数组。两种模式二选一', {
-        nodeId: z.string().optional().describe('【单个模式】文档路径，如"/前端/组件/Button"'),
-        summary: z.string().optional().describe('【单个模式】一句话简介'),
-        content: z.string().optional().describe('【单个模式】Markdown内容'),
-        status: z.string().optional().describe('【单个模式】文档状态'),
+    // ========== kg_doc: 文档 CRUD 统一入口 ==========
+    server.tool('kg_doc', '📄 知识文档操作 — 创建、读取、更新、删除、复制文档。action: create(创建)|read(读取)|update(更新)|delete(删除)|batch_update(批量更新)|copy(跨项目复制)', {
+        action: z.enum(['create', 'read', 'update', 'delete', 'batch_update', 'copy'])
+            .describe('操作类型'),
+        path: z.string().optional()
+            .describe('文档路径(如"/前端/组件/Modal")。create/read/update/delete 必填'),
+        content: z.string().optional()
+            .describe('Markdown内容 (create/update)'),
+        summary: z.string().optional()
+            .describe('一句话简介 (create/update)'),
+        status: z.string().optional()
+            .describe('文档状态 (create/update, 默认"已完成")'),
         versions: z.array(z.object({
             version: z.number(), date: z.string(), changes: z.string()
-        })).optional().describe('【单个模式】版本记录数组'),
+        })).optional().describe('版本记录 (update)'),
         bugfixes: z.array(z.object({
             date: z.string(), issue: z.string(), solution: z.string()
-        })).optional().describe('【单个模式】修复记录数组'),
+        })).optional().describe('修复记录 (update)'),
         updates: z.array(z.object({
             nodeId: z.string().describe('文档路径'),
             summary: z.string().optional(),
@@ -66,83 +38,201 @@ export function registerDocTools(server, projectId) {
             bugfixes: z.array(z.object({
                 date: z.string(), issue: z.string(), solution: z.string()
             })).optional()
-        })).optional().describe('【批量模式】更新数组，每项包含nodeId和要更新的字段')
+        })).optional().describe('批量更新数组 (batch_update)'),
+        targetProject: z.string().optional()
+            .describe('跨项目读取时的目标项目ID (read)'),
+        sourceProject: z.string().optional()
+            .describe('复制源项目ID (copy)'),
+        sourcePath: z.union([z.string(), z.array(z.string())]).optional()
+            .describe('复制源路径 (copy, 单个或数组)'),
+        targetPath: z.string().optional()
+            .describe('复制目标路径前缀 (copy)'),
     }, async (args) => safeTool(async () => {
-        const decoded = decodeObjectStrings(args);
-        // 批量更新模式
-        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 client().getDoc(item.nodeId);
-                if (!existing) {
-                    results.push({ path: item.nodeId, success: false });
-                    continue;
+        const d = decodeObjectStrings(args);
+        switch (d.action) {
+            // ---- CREATE ----
+            case 'create': {
+                if (!d.path)
+                    return wrap('❌ create 需要 path');
+                if (!d.content)
+                    return wrap('❌ create 需要 content');
+                const doc = await client().createDoc(d.path, {
+                    summary: d.summary || '',
+                    content: d.content,
+                    versions: [{ version: 0.1, date: new Date().toISOString(), changes: '初始创建' }],
+                    bugfixes: [],
+                    status: d.status || '已完成'
+                });
+                return wrap(`✅ 文档已创建: ${d.path}\n\n${JSON.stringify(doc, null, 2)}`);
+            }
+            // ---- READ ----
+            case 'read': {
+                if (!d.path)
+                    return wrap('❌ read 需要 path');
+                const doc = d.targetProject
+                    ? await client().crossGetDoc(d.targetProject, d.path)
+                    : await client().getDoc(d.path);
+                if (!doc)
+                    return wrap(d.targetProject ? `文档不存在(项目: ${d.targetProject})` : '文档不存在');
+                const lines = formatDocMarkdown(doc, d.path);
+                return wrap(d.targetProject ? crossPrefix(d.targetProject) + lines.join('\n') : lines.join('\n'));
+            }
+            // ---- UPDATE ----
+            case 'update': {
+                if (!d.path)
+                    return wrap('❌ update 需要 path');
+                if (d.path === '/' || d.path === '_root') {
+                    // 根文档更新
+                    const existing = await client().getDoc('/');
+                    if (!existing)
+                        return wrap('更新失败(根文档不存在)');
+                    const updates = {};
+                    if (d.summary !== undefined)
+                        updates.summary = d.summary;
+                    if (d.content !== undefined)
+                        updates.content = d.content;
+                    const upd = await client().updateDoc('/', updates);
+                    return wrap(upd ? '✅ 项目介绍已更新' : '更新失败');
                 }
+                const existing = await client().getDoc(d.path);
+                if (!existing)
+                    return wrap('更新失败(文档不存在)');
                 const updates = {};
-                if (item.summary !== undefined)
-                    updates.summary = item.summary;
-                if (item.content !== undefined)
-                    updates.content = item.content;
-                if (item.status !== undefined)
-                    updates.status = item.status;
-                if (item.versions !== undefined)
-                    updates.versions = item.versions;
-                if (item.bugfixes !== undefined)
-                    updates.bugfixes = item.bugfixes;
-                const doc = await client().updateDoc(item.nodeId, updates);
-                results.push({ path: item.nodeId, success: !!doc });
+                if (d.summary !== undefined)
+                    updates.summary = d.summary;
+                if (d.content !== undefined)
+                    updates.content = d.content;
+                if (d.status !== undefined)
+                    updates.status = d.status;
+                if (d.versions !== undefined)
+                    updates.versions = d.versions;
+                if (d.bugfixes !== undefined)
+                    updates.bugfixes = d.bugfixes;
+                const doc = await client().updateDoc(d.path, updates);
+                return wrap(doc ? JSON.stringify(doc, null, 2) : '更新失败');
+            }
+            // ---- DELETE ----
+            case 'delete': {
+                if (!d.path)
+                    return wrap('❌ delete 需要 path');
+                const paths = Array.isArray(d.path) ? d.path : [d.path];
+                const results = [];
+                for (const p of paths) {
+                    results.push({ path: p, success: await client().deleteDoc(p) });
+                }
+                if (paths.length === 1) {
+                    return wrap(results[0].success ? '删除成功' : '删除失败(文档不存在或是根文档)');
+                }
+                const ok = results.filter(r => r.success).length;
+                const failed = results.filter(r => !r.success).map(r => r.path);
+                let msg = `✅ 批量删除: ${ok}/${paths.length} 成功`;
+                if (failed.length > 0)
+                    msg += `\n❌ 失败: ${failed.join(', ')}`;
+                return wrap(msg);
+            }
+            // ---- BATCH UPDATE ----
+            case 'batch_update': {
+                if (!d.updates || !Array.isArray(d.updates))
+                    return wrap('❌ batch_update 需要 updates 数组');
+                const results = [];
+                for (const item of d.updates) {
+                    if (item.nodeId === '/' || item.nodeId === '_root') {
+                        results.push({ path: item.nodeId, success: false });
+                        continue;
+                    }
+                    const existing = await client().getDoc(item.nodeId);
+                    if (!existing) {
+                        results.push({ path: item.nodeId, success: false });
+                        continue;
+                    }
+                    const upd = {};
+                    if (item.summary !== undefined)
+                        upd.summary = item.summary;
+                    if (item.content !== undefined)
+                        upd.content = item.content;
+                    if (item.status !== undefined)
+                        upd.status = item.status;
+                    if (item.versions !== undefined)
+                        upd.versions = item.versions;
+                    if (item.bugfixes !== undefined)
+                        upd.bugfixes = item.bugfixes;
+                    const doc = await client().updateDoc(item.nodeId, upd);
+                    results.push({ path: item.nodeId, success: !!doc });
+                }
+                const ok = results.filter(r => r.success).length;
+                const failed = results.filter(r => !r.success).map(r => r.path);
+                let msg = `✅ 批量更新: ${ok}/${d.updates.length} 成功`;
+                if (failed.length > 0)
+                    msg += `\n❌ 失败: ${failed.join(', ')}`;
+                return wrap(msg);
+            }
+            // ---- COPY ----
+            case 'copy': {
+                if (!d.sourceProject)
+                    return wrap('❌ copy 需要 sourceProject');
+                if (!d.sourcePath)
+                    return wrap('❌ copy 需要 sourcePath');
+                const paths = Array.isArray(d.sourcePath) ? d.sourcePath : [d.sourcePath];
+                const results = [];
+                for (const srcPath of paths) {
+                    try {
+                        const doc = await client().crossGetDoc(d.sourceProject, srcPath);
+                        if (!doc) {
+                            results.push({ path: srcPath, success: false, error: '源文档不存在' });
+                            continue;
+                        }
+                        const destPath = d.targetPath
+                            ? `${d.targetPath.replace(/\/$/, '')}${srcPath}`
+                            : srcPath;
+                        const existing = await client().getDoc(destPath);
+                        if (existing) {
+                            await client().updateDoc(destPath, { summary: doc.summary, content: doc.content });
+                        }
+                        else {
+                            await client().createDoc(destPath, { summary: doc.summary, content: doc.content, status: doc.status });
+                        }
+                        results.push({ path: destPath, success: true });
+                    }
+                    catch (e) {
+                        results.push({ path: srcPath, success: false, error: String(e) });
+                    }
+                }
+                const ok = results.filter(r => r.success).length;
+                if (paths.length === 1) {
+                    return wrap(results[0].success
+                        ? `✅ 已复制: ${results[0].path}\n来源: [${d.sourceProject}] ${paths[0]}`
+                        : `❌ 复制失败: ${results[0].error}`);
+                }
+                const failed = results.filter(r => !r.success);
+                let msg = `✅ 批量复制: ${ok}/${paths.length} 成功`;
+                if (failed.length > 0)
+                    msg += `\n❌ 失败:\n${failed.map(f => `  - ${f.path}: ${f.error}`).join('\n')}`;
+                return wrap(msg);
             }
-            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);
+            default:
+                return wrap(`❌ 未知 action: ${d.action}`);
         }
-        // 单个更新模式
-        const { nodeId, summary, content, status, versions, bugfixes } = decoded;
-        if (!nodeId)
-            return wrap('❌ 请提供 nodeId（单个模式）或 updates 数组（批量模式）');
-        if (nodeId === '/' || nodeId === '_root')
-            return wrap('❌ 根文档请使用 kg_update_root 方法更新');
-        const existing = await client().getDoc(nodeId);
-        if (!existing)
-            return wrap('更新失败(文档不存在)');
-        const updates = {};
-        if (summary !== undefined)
-            updates.summary = summary;
-        if (content !== undefined)
-            updates.content = content;
-        if (status !== undefined)
-            updates.status = status;
-        if (versions !== undefined)
-            updates.versions = versions;
-        if (bugfixes !== undefined)
-            updates.bugfixes = bugfixes;
-        const doc = await client().updateDoc(nodeId, updates);
-        return wrap(doc ? JSON.stringify(doc, null, 2) : '更新失败');
     }));
-    // 读取单个文档详情
-    server.tool('kg_read_node', '读取文档完整内容(简介、正文、版本历史、修复记录)。支持跨项目只读访问(需先用kg_list_projects获取项目ID)', {
-        nodeId: z.string().describe('文档路径'),
-        targetProject: z.string().optional().describe('目标项目ID或名称(不填=当前项目)。ID可从kg_list_projects获取')
-    }, async (args) => safeTool(async () => {
-        const doc = args.targetProject
-            ? await client().crossGetDoc(args.targetProject, args.nodeId)
-            : await client().getDoc(args.nodeId);
-        if (!doc)
-            return wrap(args.targetProject ? `文档不存在(项目: ${args.targetProject})` : '文档不存在');
-        const lines = formatDocMarkdown(doc, args.nodeId);
-        return wrap(args.targetProject ? crossPrefix(args.targetProject) + lines.join('\n') : lines.join('\n'));
-    }));
-    // 获取知识库树状图
-    server.tool('kg_get_tree', '获取知识库目录树。格式: 📄 文档名 # 简介。支持跨项目只读访问(需先用kg_list_projects获取项目ID)', {
-        targetProject: z.string().optional().describe('目标项目ID或名称(不填=当前项目)。ID可从kg_list_projects获取')
+    // ========== kg_tree: 知识全景图 ==========
+    server.tool('kg_tree', '🏗️ 项目知识全景图 ★最快了解项目的方式★ 获取完整知识库目录树(含文档数统计)。传 statusFilter 可筛选特定状态文档。建议任何操作前先调用获取全局视图', {
+        statusFilter: z.array(z.string()).optional()
+            .describe('按状态筛选(如["未完成","待修复"])，不传则展示全景目录树'),
+        targetProject: z.string().optional()
+            .describe('跨项目查看，填目标项目ID或名称'),
     }, async (args) => safeTool(async () => {
+        // 状态筛选模式
+        if (args.statusFilter && args.statusFilter.length > 0) {
+            const docs = args.targetProject
+                ? await client().crossGetDocsByStatus(args.targetProject, args.statusFilter)
+                : await client().getDocsByStatus(args.statusFilter);
+            if (docs.length === 0) {
+                return wrap(`未找到状态为 [${args.statusFilter.join(', ')}] 的文档${args.targetProject ? `(项目: ${args.targetProject})` : ''}`);
+            }
+            const lines = docs.map(d => `- ${d.path} (${d.status || '已完成'}): ${d.summary || '无简介'}`);
+            const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
+            return wrap(`${prefix}找到 ${docs.length} 个文档:\n\n${lines.join('\n')}`);
+        }
+        // 全景目录树模式
         const tree = args.targetProject
             ? await client().crossGetTree(args.targetProject)
             : await client().getTree();
@@ -154,64 +244,4 @@ export function registerDocTools(server, projectId) {
         const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
         return wrap(`${prefix}共 ${docCount} 个文档\n\n${treeText}`);
     }));
-    // 按状态筛选文档
-    server.tool('kg_get_docs_by_status', '获取指定状态的文档列表。支持跨项目只读访问(需先用kg_list_projects获取项目ID)', {
-        statusList: z.array(z.string()).describe('状态列表(如["未完成","待修复"])'),
-        targetProject: z.string().optional().describe('目标项目ID或名称(不填=当前项目)。ID可从kg_list_projects获取')
-    }, async (args) => safeTool(async () => {
-        const docs = args.targetProject
-            ? await client().crossGetDocsByStatus(args.targetProject, args.statusList)
-            : await client().getDocsByStatus(args.statusList);
-        if (docs.length === 0) {
-            return wrap(`未找到状态为 [${args.statusList.join(', ')}] 的文档${args.targetProject ? `(项目: ${args.targetProject})` : ''}`);
-        }
-        const lines = docs.map(d => `- ${d.path} (${d.status || '已完成'}): ${d.summary || '无简介'}`);
-        const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
-        return wrap(`${prefix}找到 ${docs.length} 个文档:\n\n${lines.join('\n')}`);
-    }));
-    // 跨项目复制文档
-    server.tool('kg_copy_node', '从其他项目复制文档到当前项目。支持单个或批量复制，可指定新路径。用于跨项目协作：拉取别的项目的知识文档到当前项目', {
-        sourceProject: z.string().describe('源项目ID或名称(从kg_list_projects获取)'),
-        sourcePath: z.union([z.string(), z.array(z.string())]).describe('源文档路径(单个或数组)'),
-        targetPath: z.string().optional().describe('目标路径前缀(如"/参考/项目B")。不填则保持原路径'),
-    }, async (args) => safeTool(async () => {
-        const decoded = decodeObjectStrings(args);
-        const paths = Array.isArray(decoded.sourcePath) ? decoded.sourcePath : [decoded.sourcePath];
-        const results = [];
-        for (const srcPath of paths) {
-            try {
-                const doc = await client().crossGetDoc(decoded.sourceProject, srcPath);
-                if (!doc) {
-                    results.push({ path: srcPath, success: false, error: '源文档不存在' });
-                    continue;
-                }
-                const destPath = decoded.targetPath
-                    ? `${decoded.targetPath.replace(/\/$/, '')}${srcPath}`
-                    : srcPath;
-                const existing = await client().getDoc(destPath);
-                if (existing) {
-                    await client().updateDoc(destPath, { summary: doc.summary, content: doc.content });
-                }
-                else {
-                    await client().createDoc(destPath, { summary: doc.summary, content: doc.content, status: doc.status });
-                }
-                results.push({ path: destPath, success: true });
-            }
-            catch (e) {
-                results.push({ path: srcPath, success: false, error: String(e) });
-            }
-        }
-        const successCount = results.filter(r => r.success).length;
-        if (paths.length === 1) {
-            return wrap(results[0].success
-                ? `✅ 已复制文档: ${results[0].path}\n\n来源: [${decoded.sourceProject}] ${paths[0]}`
-                : `❌ 复制失败: ${results[0].error}`);
-        }
-        const failedItems = results.filter(r => !r.success);
-        let msg = `✅ 批量复制完成: ${successCount}/${paths.length} 成功`;
-        if (failedItems.length > 0) {
-            msg += `\n❌ 失败:\n${failedItems.map(f => `  - ${f.path}: ${f.error}`).join('\n')}`;
-        }
-        return wrap(msg);
-    }));
 }

package/dist/tools/files.d.ts

@@ -1,7 +1,7 @@
 /**
- * 项目文件访问工具 (5个)
- * project_upload, project_clear_files, project_list_files,
- * project_read_file, project_download
+ * 📁 kg_files (5→1)
+ * 合并: project_list_files, project_read_file, project_upload, project_download
+ * 删除: project_clear_files (危险操作)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerFileTools(server: McpServer): void;