@ppdocs/mcp 3.2.19 → 3.2.21

package/dist/tools/analyzer.js

@@ -16,14 +16,14 @@ const SYMBOL_ICONS = {
 const SEVERITY_ICONS = {
     critical: '🔴', warning: '🟡', info: '🟢',
 };
-export function registerAnalyzerTools(server, projectId) {
+export function registerAnalyzerTools(server, ctx) {
     const client = () => getClient();
     // ===== code_scan: 扫描项目代码 =====
     server.tool('code_scan', '📡 扫描项目代码, 构建索引。返回文件数、符号数、语言统计。★首次使用 code_query/code_impact/code_context 前必须先执行★', {
-        projectPath: z.string().describe('项目源码的绝对路径(如"D:/projects/myapp")'),
+        projectPath: z.string().optional().describe('项目源码的绝对路径(如"D:/projects/myapp")。不传则自动从Beacon同步目录或项目配置解析'),
         force: z.boolean().optional().describe('是否强制全量重建(默认false, 增量更新)'),
     }, async (args) => safeTool(async () => {
-        const result = await client().analyzerScan(args.projectPath, args.force ?? false);
+        const result = await client().analyzerScan(args.projectPath || '', args.force ?? false);
         return wrap([
             `✅ 代码扫描完成`,
             ``,
@@ -36,10 +36,10 @@ export function registerAnalyzerTools(server, projectId) {
     }));
     // ===== code_query: 搜索代码符号 =====
     server.tool('code_query', '🔤 搜索代码符号(函数/类/方法/接口/类型)。返回匹配列表+文件路径+行号。定位代码位置的最快方式。需先运行 code_scan', {
-        projectPath: z.string().describe('项目源码的绝对路径'),
+        projectPath: z.string().optional().describe('项目源码的绝对路径(不传则自动解析)'),
         query: z.string().describe('搜索关键词(函数名/类名/方法名等)'),
     }, async (args) => safeTool(async () => {
-        const results = await client().analyzerQuery(args.projectPath, args.query);
+        const results = await client().analyzerQuery(args.projectPath || '', args.query);
         if (!results || results.length === 0) {
             return wrap(`未找到匹配 "${args.query}" 的符号。请确认已运行 code_scan`);
         }
@@ -57,11 +57,11 @@ export function registerAnalyzerTools(server, projectId) {
     }));
     // ===== code_impact: 分层影响分析 =====
     server.tool('code_impact', '💥 爆炸半径分析 ★修改代码前必查★ 分析修改一个函数/类/类型会影响多少文件。BFS分层输出: L1🔴直接引用=必须检查, L2🟡间接引用=建议检查, L3🟢传递引用=注意。修改任何公共接口、函数签名、类型定义前务必先运行!', {
-        projectPath: z.string().describe('项目源码的绝对路径'),
+        projectPath: z.string().optional().describe('项目源码的绝对路径(不传则自动解析)'),
         symbolName: z.string().describe('要分析的符号名称(如"AuthService", "handleLogin")'),
         depth: z.number().optional().describe('分析深度层级(1-5, 默认2)。1=仅直接引用, 3=深度追踪'),
     }, async (args) => safeTool(async () => {
-        const result = await client().analyzerImpactTree(args.projectPath, args.symbolName, args.depth ?? 2);
+        const result = await client().analyzerImpactTree(args.projectPath || '', args.symbolName, args.depth ?? 2);
         if (!result) {
             return wrap(`未找到符号 "${args.symbolName}"。请确认名称正确且已运行 code_scan`);
         }
@@ -91,22 +91,22 @@ export function registerAnalyzerTools(server, projectId) {
     }));
     // ===== code_context: 文件360°上下文 =====
     server.tool('code_context', '🔍 文件360°上下文 — 定义了什么符号、导入了什么、被谁引用。修改文件前使用, 快速了解所有依赖关系, 避免遗漏', {
-        projectPath: z.string().describe('项目源码的绝对路径'),
+        projectPath: z.string().optional().describe('项目源码的绝对路径(不传则自动解析)'),
         filePath: z.string().describe('目标文件的相对路径(如"src/services/auth.ts")'),
     }, async (args) => safeTool(async () => {
-        const ctx = await client().analyzerContext(args.projectPath, args.filePath);
-        if (!ctx) {
+        const fileCtx = await client().analyzerContext(args.projectPath || '', args.filePath);
+        if (!fileCtx) {
             return wrap(`未找到文件 "${args.filePath}"。请确认路径正确, 路径格式为相对路径(如 src/main.ts)`);
         }
         const lines = [
-            `📄 ${ctx.filePath}`,
-            `语言: ${ctx.language} | ${ctx.linesTotal} 行`,
+            `📄 ${fileCtx.filePath}`,
+            `语言: ${fileCtx.language} | ${fileCtx.linesTotal} 行`,
             ``,
         ];
         // 定义的符号
-        if (ctx.symbolsDefined.length > 0) {
-            lines.push(`### 🔤 定义的符号 (${ctx.symbolsDefined.length})`);
-            for (const sym of ctx.symbolsDefined) {
+        if (fileCtx.symbolsDefined.length > 0) {
+            lines.push(`### 🔤 定义的符号 (${fileCtx.symbolsDefined.length})`);
+            for (const sym of fileCtx.symbolsDefined) {
                 const icon = SYMBOL_ICONS[sym.kind] || '?';
                 const exp = sym.exported ? ' [export]' : '';
                 lines.push(`  ${icon} ${sym.name}${exp}  L${sym.lineStart}-L${sym.lineEnd}`);
@@ -114,18 +114,18 @@ export function registerAnalyzerTools(server, projectId) {
             lines.push('');
         }
         // 导入
-        if (ctx.imports.length > 0) {
-            lines.push(`### 📥 导入 (${ctx.imports.length})`);
-            for (const imp of ctx.imports) {
+        if (fileCtx.imports.length > 0) {
+            lines.push(`### 📥 导入 (${fileCtx.imports.length})`);
+            for (const imp of fileCtx.imports) {
                 const specs = imp.specifiers.length > 0 ? `{ ${imp.specifiers.join(', ')} }` : '*';
                 lines.push(`  → ${imp.source}  ${specs}  L${imp.line}`);
             }
             lines.push('');
         }
         // 被谁引用
-        if (ctx.importedBy.length > 0) {
-            lines.push(`### 📤 被引用 (${ctx.importedBy.length})`);
-            for (const by of ctx.importedBy) {
+        if (fileCtx.importedBy.length > 0) {
+            lines.push(`### 📤 被引用 (${fileCtx.importedBy.length})`);
+            for (const by of fileCtx.importedBy) {
                 const specs = by.specifiers.length > 0 ? `{ ${by.specifiers.join(', ')} }` : '';
                 lines.push(`  ← ${by.filePath}  ${specs}`);
             }
@@ -135,16 +135,17 @@ export function registerAnalyzerTools(server, projectId) {
     }));
     // ===== code_path: 两点间链路追踪 =====
     server.tool('code_path', '🔗 两点链路追踪 — 给定两个符号(如 fileA.funcA 和 fileB.funcB)，自动搜索中间的引用链路，返回完整路径 + 绑定的知识图谱文档', {
-        projectPath: z.string().describe('项目源码的绝对路径'),
+        projectPath: z.string().optional().describe('项目源码的绝对路径(不传则自动解析)'),
         symbolA: z.string().describe('起点符号名(如 "handleLogin")'),
         symbolB: z.string().describe('终点符号名(如 "AuthService")'),
         maxDepth: z.number().optional().describe('最大搜索深度(1-5, 默认3)'),
     }, async (args) => safeTool(async () => {
         const depth = Math.min(5, Math.max(1, args.maxDepth ?? 3));
+        const pp = args.projectPath || '';
         // 1. 获取两个符号的影响树
         const [treeA, treeB] = await Promise.all([
-            client().analyzerImpactTree(args.projectPath, args.symbolA, depth),
-            client().analyzerImpactTree(args.projectPath, args.symbolB, depth),
+            client().analyzerImpactTree(pp, args.symbolA, depth),
+            client().analyzerImpactTree(pp, args.symbolB, depth),
         ]);
         if (!treeA)
             return wrap(`❌ 未找到起点符号 "${args.symbolA}"。请确认名称正确且已运行 code_scan`);
@@ -260,4 +261,117 @@ export function registerAnalyzerTools(server, projectId) {
         }
         return wrap(lines.join('\n'));
     }));
+    // ===== code_smart_context: 代码+文档全关联上下文 =====
+    server.tool('code_smart_context', '🔍 代码+文档全关联上下文 — 输入一个函数名，一次调用返回：代码依赖、关联文档、匹配规则、活跃任务、影响范围摘要。需先运行 code_scan', {
+        projectPath: z.string().optional().describe('项目源码的绝对路径(不传则自动解析)'),
+        symbolName: z.string().describe('要查询的符号名称(如"handleLogin", "AuthService")'),
+    }, async (args) => safeTool(async () => {
+        const smartCtx = await client().analyzerSmartContext(args.projectPath || '', args.symbolName);
+        if (!smartCtx) {
+            return wrap(`未找到符号 "${args.symbolName}"。请确认名称正确且已运行 code_scan`);
+        }
+        const lines = [
+            `🔍 智能上下文: ${smartCtx.symbol.name}`,
+            ``,
+        ];
+        // 符号信息
+        const icon = SYMBOL_ICONS[smartCtx.symbol.kind] || '?';
+        const exp = smartCtx.symbol.exported ? ' [export]' : '';
+        lines.push(`### ${icon} 符号信息`);
+        lines.push(`  ${smartCtx.symbol.name}${exp} (${smartCtx.symbol.kind})`);
+        lines.push(`  📍 ${smartCtx.symbol.filePath}:${smartCtx.symbol.lineStart}-${smartCtx.symbol.lineEnd}`);
+        if (smartCtx.symbol.signature)
+            lines.push(`  📝 ${smartCtx.symbol.signature}`);
+        lines.push('');
+        // 文件上下文
+        lines.push(`### 📄 文件上下文: ${smartCtx.fileContext.filePath}`);
+        lines.push(`  语言: ${smartCtx.fileContext.language} | ${smartCtx.fileContext.linesTotal} 行`);
+        lines.push(`  定义: ${smartCtx.fileContext.symbolsDefined.length} 个符号 | 导入: ${smartCtx.fileContext.imports.length} | 被引用: ${smartCtx.fileContext.importedBy.length}`);
+        lines.push('');
+        // 影响范围
+        if (smartCtx.impactSummary.totalFiles > 0) {
+            lines.push(`### 💥 影响范围: ${smartCtx.impactSummary.totalFiles} 个文件`);
+            for (const f of smartCtx.impactSummary.l1Files.slice(0, 10)) {
+                lines.push(`  🔴 ${f}`);
+            }
+            lines.push('');
+        }
+        // 关联文档
+        if (smartCtx.relatedDocs.length > 0) {
+            lines.push(`### 📚 关联知识文档 (${smartCtx.relatedDocs.length})`);
+            for (const doc of smartCtx.relatedDocs) {
+                lines.push(`  📄 ${doc.path} — ${doc.summary}`);
+            }
+            lines.push('');
+        }
+        // 匹配规则
+        if (smartCtx.matchedRules.length > 0) {
+            lines.push(`### 📏 匹配规则 (${smartCtx.matchedRules.length})`);
+            for (const rule of smartCtx.matchedRules) {
+                lines.push(`  [${rule.ruleType}] ${rule.content.substring(0, 100)}`);
+            }
+            lines.push('');
+        }
+        // 活跃任务
+        if (smartCtx.activeTasks.length > 0) {
+            lines.push(`### 📝 活跃任务 (${smartCtx.activeTasks.length})`);
+            for (const task of smartCtx.activeTasks) {
+                lines.push(`  🔵 [${task.id}] ${task.title}`);
+            }
+        }
+        return wrap(lines.join('\n'));
+    }));
+    // ===== code_full_path: 全关联路径 =====
+    server.tool('code_full_path', '🔗 全关联路径 — 两个符号之间不仅返回代码引用链路，还返回共享的KG文档、共同导入、祖先模块。需先运行 code_scan', {
+        projectPath: z.string().optional().describe('项目源码的绝对路径(不传则自动解析)'),
+        symbolA: z.string().describe('起点符号名(如 "handleLogin")'),
+        symbolB: z.string().describe('终点符号名(如 "AuthService")'),
+        maxDepth: z.number().optional().describe('最大搜索深度(1-5, 默认3)'),
+    }, async (args) => safeTool(async () => {
+        const result = await client().analyzerFullPath(args.projectPath || '', args.symbolA, args.symbolB, args.maxDepth ?? 3);
+        if (!result) {
+            return wrap(`❌ 无法构建路径。请确认两个符号名称正确且已运行 code_scan`);
+        }
+        const lines = [
+            `🔗 全关联路径`,
+            ``,
+            `📍 ${result.symbolA.name} (${result.symbolA.kind}) → ${result.symbolA.filePath}:${result.symbolA.lineStart}`,
+            `📍 ${result.symbolB.name} (${result.symbolB.kind}) → ${result.symbolB.filePath}:${result.symbolB.lineStart}`,
+            ``,
+            `📊 ${result.pathSummary}`,
+            ``,
+        ];
+        // 代码路径
+        if (result.codePath.length > 0) {
+            lines.push(`### 🔗 代码引用链路 (${result.codePath.length} 步)`);
+            for (const step of result.codePath.slice(0, 20)) {
+                lines.push(`  L${step.depth} ${step.filePath} [${step.refKind}] ← ${step.symbolName}`);
+            }
+            lines.push('');
+        }
+        // 共享文档
+        if (result.sharedDocs.length > 0) {
+            lines.push(`### 📚 共享KG文档 (${result.sharedDocs.length})`);
+            for (const doc of result.sharedDocs) {
+                lines.push(`  📄 ${doc.path} — ${doc.summary}`);
+            }
+            lines.push('');
+        }
+        // 共同导入
+        if (result.commonImports.length > 0) {
+            lines.push(`### 📥 共同导入 (${result.commonImports.length})`);
+            for (const imp of result.commonImports) {
+                lines.push(`  → ${imp}`);
+            }
+            lines.push('');
+        }
+        // 共同祖先
+        if (result.commonAncestors.length > 0) {
+            lines.push(`### 📁 共同祖先目录`);
+            for (const anc of result.commonAncestors) {
+                lines.push(`  📂 ${anc}`);
+            }
+        }
+        return wrap(lines.join('\n'));
+    }));
 }

package/dist/tools/discussion.d.ts

@@ -1,7 +1,8 @@
 /**
  * 💬 kg_discuss (6→1)
- * 合并: kg_discussion_list, kg_discussion_read, kg_discussion_create,
- *       kg_discussion_reply, kg_discussion_close_and_archive, kg_discussion_delete
+ * 合并: list, read, create, reply, close, delete
+ * 统一走 HTTP → Rust 后端 (单一写入者)
+ * sender 格式: "projectId:user" (如 "p-ca3sgejg:张三")
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { type McpContext } from './shared.js';

package/dist/tools/discussion.js

@@ -1,51 +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
+ * 合并: list, read, create, reply, close, delete
+ * 统一走 HTTP → Rust 后端 (单一写入者)
+ * sender 格式: "projectId:user" (如 "p-ca3sgejg:张三")
  */
 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';
+function sender(ctx) {
+    return `${ctx.projectId}:${ctx.user}`;
+}
+function relativeTime(iso) {
+    try {
+        const diff = Date.now() - new Date(iso).getTime();
+        if (diff < 60000)
+            return '刚刚';
+        if (diff < 3600000)
+            return `${Math.floor(diff / 60000)}分钟前`;
+        if (diff < 86400000)
+            return `${Math.floor(diff / 3600000)}小时前`;
+        return `${Math.floor(diff / 86400000)}天前`;
+    }
+    catch {
+        return iso;
+    }
+}
+function formatList(items, ctx) {
+    const lines = [
+        `本项目: ${sender(ctx)}`,
+        ``,
+        `📋 活跃讨论 (${items.length}个)`,
+        ``,
+        `| ID | 标题 | 发起方 | 参与方 | 摘要 | 回复 | 更新 |`,
+        `|:---|:---|:---|:---|:---|:---:|:---|`,
+    ];
+    for (const d of items) {
+        const others = d.participants.filter(p => p !== d.initiator).join(', ') || '—';
+        lines.push(`| ${d.id} | ${d.title} | ${d.initiator} | ${others} | ${d.summary} | ${d.status} | ${relativeTime(d.updatedAt)} |`);
+    }
+    return lines.join('\n');
+}
+function formatDetailView(d) {
+    const msgs = d.messages || [];
+    const lines = [
+        `💬 ${d.title}`,
+        `发起: ${d.initiator} | 参与: ${d.participants.length}方 | 状态: ${d.status}`,
+        `📌 ${d.summary}`,
+        `📊 总消息: ${d.totalCount} | 未读: ${d.unreadCount}`,
+        ``,
+    ];
+    msgs.forEach((m, i) => {
+        const readTag = m.isRead ? '📖' : '🆕';
+        lines.push(`--- ${readTag} 消息 ${i + 1}/${msgs.length} [${m.sender}] ${relativeTime(m.timestamp)} ---`);
+        // 已读且无 content → 显示摘要
+        if (m.isRead && !m.content) {
+            lines.push(`[摘要] ${m.summary}`);
+        }
+        else {
+            lines.push(m.content || m.summary || '(无内容)');
+        }
+        lines.push('');
+    });
+    return lines.join('\n');
+}
 export function registerDiscussionTools(server, ctx) {
     const client = () => getClient();
-    server.tool('kg_discuss', '💬 跨项目讨论 — 发起、回复、归档协同讨论。action: list(列出活跃讨论)|read(读取详情)|create(发起)|reply(回复)|close(结案归档)|delete(删除)', {
-        action: z.enum(['list', 'read', 'create', 'reply', 'close', 'delete'])
+    server.tool('kg_discuss', '💬 跨项目讨论 — 发起、回复、归档协同讨论。action: list(列出活跃讨论)|read(读取详情,自动追踪已读)|create(发起)|reply(回复)|complete(标记完成)|close(结案归档)|delete(删除)|history(查看历史讨论)', {
+        action: z.enum(['list', 'read', 'create', 'reply', 'complete', 'close', 'delete', 'history'])
             .describe('操作类型'),
         id: z.string().optional()
-            .describe('讨论哈希ID (read/reply/close/delete)'),
+            .describe('讨论哈希ID (read/reply/complete/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, 不含自己)'),
+        summary: z.string().optional()
+            .describe('消息摘要 (create/reply, 不传则自动截取content前50字)'),
         content: z.string().optional()
-            .describe('消息内容Markdown (create/reply)'),
+            .describe('消息详细内容Markdown (create/reply)'),
         conclusion: z.string().optional()
             .describe('结案总结 (close)'),
         newSummary: z.string().optional()
-            .describe('更新进展摘要 (reply)'),
+            .describe('更新讨论进展摘要 (reply)'),
+        mode: z.enum(['auto', 'full']).optional()
+            .describe('读取模式 (read, 默认auto: 已读消息仅返回摘要)'),
     }, async (args) => safeTool(async () => {
         const decoded = decodeObjectStrings(args);
+        const me = sender(ctx);
         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: ${ctx.projectId})${cleanMsg}`);
-                return wrap(`本项目ID: ${ctx.projectId}\n活跃讨论区 (${active.length} 个):${cleanMsg}\n\n` + JSON.stringify(active, null, 2));
+                const active = await client().discussionList();
+                if (!Array.isArray(active) || active.length === 0)
+                    return wrap(`当前无活跃的讨论 (本项目: ${me})`);
+                return wrap(formatList(active, ctx));
             }
             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)
+                const readMode = decoded.mode || 'auto';
+                const discussions = await client().discussionReadByIds(readIds, me, readMode);
+                if (!Array.isArray(discussions) || discussions.length === 0)
                     return wrap('未找到对应的讨论记录');
-                return wrap(JSON.stringify(discussions, null, 2));
+                return wrap(discussions.map(formatDetailView).join('\n\n━━━━━━━━━━━━━━━━━━━━\n\n'));
             }
             case 'create': {
                 if (!decoded.title)
@@ -54,55 +114,54 @@ export function registerDiscussionTools(server, ctx) {
                     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, ctx.projectId, decoded.participants, decoded.content);
-                return wrap(`✅ 讨论已发起，ID: ${id}\n发起方: ${ctx.projectId}\n参与方: ${decoded.participants.join(', ')}`);
+                const result = await client().discussionCreate(decoded.title, me, decoded.participants, decoded.content, decoded.summary);
+                return wrap(`✅ 讨论已发起\nID: ${result.id}\n发起方: ${me}\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, ctx.projectId, decoded.content, decoded.newSummary);
-                return wrap(success ? `✅ 回复成功 (ID: ${decoded.id})` : `❌ 回复失败，讨论不存在或已关闭`);
+                await client().discussionReply(decoded.id, me, decoded.content, decoded.summary, decoded.newSummary);
+                return wrap(`✅ 回复成功 (ID: ${decoded.id}, 身份: ${me})`);
+            }
+            case 'history': {
+                const all = await client().discussionListAll(me);
+                if (!Array.isArray(all) || all.length === 0)
+                    return wrap(`暂无参与过的讨论记录 (身份: ${me})`);
+                const lines = [
+                    `本项目: ${me}`,
+                    ``,
+                    `📋 讨论历史 (${all.length}个)`,
+                    ``,
+                    `| ID | 标题 | 发起方 | 状态 | 消息数 | 更新 |`,
+                    `|:---|:---|:---|:---|:---:|:---|`,
+                ];
+                for (const d of all) {
+                    const statusIcon = d.status === 'active' ? '🟢' : '⚪';
+                    lines.push(`| ${d.id} | ${d.title} | ${d.initiator} | ${statusIcon} ${d.status} | ${d.messageCount ?? 0} | ${relativeTime(d.updatedAt)} |`);
+                }
+                return wrap(lines.join('\n'));
+            }
+            case 'complete': {
+                if (!decoded.id)
+                    return wrap('❌ complete 需要 id');
+                await client().discussionComplete(decoded.id);
+                return wrap(`✅ 讨论已标记完成 (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}`);
-                }
+                const result = await client().discussionClose(decoded.id, decoded.conclusion);
+                return wrap(`✅ 讨论已结案并归档: \`${result.archived_path}\``);
             }
             case 'delete': {
                 if (!decoded.id)
                     return wrap('❌ delete 需要 id');
-                const success = DiscussionManager.delete(decoded.id);
-                return wrap(success ? `✅ 讨论已删除 (ID: ${decoded.id})` : `❌ 讨论不存在或已被删除`);
+                await client().discussionDelete(decoded.id);
+                return wrap(`✅ 讨论已删除 (ID: ${decoded.id})`);
             }
             default:
                 return wrap(`❌ 未知 action: ${decoded.action}`);

package/dist/tools/docs.d.ts

@@ -4,4 +4,5 @@
  *       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;
+import { type McpContext } from './shared.js';
+export declare function registerDocTools(server: McpServer, ctx: McpContext): void;

package/dist/tools/docs.js

@@ -7,7 +7,7 @@ import { z } from 'zod';
 import { getClient } from '../storage/httpClient.js';
 import { decodeObjectStrings } from '../utils.js';
 import { wrap, safeTool, crossPrefix, formatDocMarkdown, formatTreeText, countTreeDocs } from './shared.js';
-export function registerDocTools(server, projectId) {
+export function registerDocTools(server, ctx) {
     const client = () => getClient();
     // ========== kg_doc: 文档 CRUD 统一入口 ==========
     server.tool('kg_doc', '📄 知识文档操作 — 创建、读取、更新、删除、复制文档。action: create(创建)|read(读取)|update(更新)|delete(删除)|batch_update(批量更新)|copy(跨项目复制)', {

package/dist/tools/files.d.ts

@@ -1,7 +1,7 @@
 /**
  * 📁 kg_files (5→1)
  * 合并: project_list_files, project_read_file, project_upload, project_download
- * 删除: project_clear_files (危险操作)
+ * + 公共文件池: public_list, public_read, public_upload, public_download, public_delete
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerFileTools(server: McpServer): void;

package/dist/tools/files.js

@@ -1,26 +1,28 @@
 /**
  * 📁 kg_files (5→1)
  * 合并: project_list_files, project_read_file, project_upload, project_download
- * 删除: project_clear_files (危险操作)
+ * + 公共文件池: public_list, public_read, public_upload, public_download, public_delete
  */
 import { z } from 'zod';
 import { getClient } from '../storage/httpClient.js';
 import { wrap, safeTool, crossPrefix, formatFileSize } from './shared.js';
 export function registerFileTools(server) {
     const client = () => getClient();
-    server.tool('kg_files', '📁 项目文件操作 — 浏览目录、读取文件、上传下载。action: list(目录浏览)|read(读取文件)|upload(上传目录)|download(下载文件)', {
-        action: z.enum(['list', 'read', 'upload', 'download'])
+    server.tool('kg_files', '📁 项目文件操作 — 浏览目录、读取文件、上传下载。action: list(目录浏览)|read(读取文件)|upload(上传)|download(下载文件)|public_list(公共文件池浏览)|public_read(读取公共文件)|public_upload(上传到公共池)|public_download(下载公共文件)|public_delete(删除公共文件)|public_mkdir(创建公共池子目录)|public_rename(重命名公共文件)', {
+        action: z.enum(['list', 'read', 'upload', 'download', 'public_list', 'public_read', 'public_upload', 'public_download', 'public_delete', 'public_mkdir', 'public_rename'])
             .describe('操作类型'),
         path: z.string().optional()
-            .describe('文件路径 (read/download, 如"src/main.ts")'),
+            .describe('文件路径 (read/download/public_read/public_download/public_delete/public_mkdir, 如"src/main.ts")'),
         dir: z.string().optional()
-            .describe('子目录路径 (list, 如"src/components")'),
+            .describe('子目录路径 (list/public_list, 如"src/components")'),
         localDir: z.string().optional()
-            .describe('本地目录绝对路径 (upload)'),
+            .describe('本地路径(目录或单文件) (upload/public_upload)'),
         localPath: z.string().optional()
-            .describe('本地保存路径 (download)'),
+            .describe('本地保存路径 (download/public_download)'),
         remoteDir: z.string().optional()
-            .describe('远程目标子目录 (upload)'),
+            .describe('远程目标子目录 (upload/public_upload)'),
+        newName: z.string().optional()
+            .describe('新名称 (public_rename)'),
         targetProject: z.string().optional()
             .describe('跨项目操作的目标项目ID'),
     }, async (args) => safeTool(async () => {
@@ -64,6 +66,57 @@ export function registerFileTools(server) {
                 const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
                 return wrap(`${prefix}✅ 已下载\n\n- 本地路径: ${result.localPath}\n- 文件数量: ${result.fileCount}`);
             }
+            // ===== 公共文件池 =====
+            case 'public_list': {
+                const files = await client().publicFilesList(args.dir);
+                if (files.length === 0)
+                    return wrap('📦 公共文件池' + (args.dir ? ` /${args.dir}` : '') + ' 为空');
+                const lines = files.map(f => {
+                    const icon = f.isDir ? '📁' : '📄';
+                    const size = f.isDir ? '' : ` (${formatFileSize(f.size)})`;
+                    return `${icon} ${f.name}${size}`;
+                });
+                const dirLabel = args.dir || '/';
+                return wrap(`📦 公共文件池 ${dirLabel} (${files.length} 项)\n\n${lines.join('\n')}`);
+            }
+            case 'public_read': {
+                if (!args.path)
+                    return wrap('❌ public_read 需要 path');
+                const content = await client().publicFilesRead(args.path);
+                return wrap(`📦 公共文件 ${args.path}\n\n\`\`\`\n${content}\n\`\`\``);
+            }
+            case 'public_upload': {
+                if (!args.localDir)
+                    return wrap('❌ public_upload 需要 localDir');
+                const result = await client().publicFilesUpload(args.localDir, args.remoteDir);
+                return wrap(`✅ 已上传到公共文件池\n\n- 文件数量: ${result.fileCount}\n- 目标目录: ${args.remoteDir || '/'}`);
+            }
+            case 'public_download': {
+                if (!args.path)
+                    return wrap('❌ public_download 需要 path');
+                const result = await client().publicFilesDownload(args.path, args.localPath);
+                return wrap(`✅ 已从公共文件池下载\n\n- 本地路径: ${result.localPath}\n- 文件数量: ${result.fileCount}`);
+            }
+            case 'public_delete': {
+                if (!args.path)
+                    return wrap('❌ public_delete 需要 path');
+                await client().publicFilesDelete(args.path);
+                return wrap(`✅ 已从公共文件池删除: ${args.path}`);
+            }
+            case 'public_mkdir': {
+                if (!args.path)
+                    return wrap('❌ public_mkdir 需要 path');
+                await client().publicFilesMkdir(args.path);
+                return wrap(`✅ 已创建公共文件池目录: /${args.path}`);
+            }
+            case 'public_rename': {
+                if (!args.path)
+                    return wrap('❌ public_rename 需要 path');
+                if (!args.newName)
+                    return wrap('❌ public_rename 需要 newName');
+                await client().publicFilesRename(args.path, args.newName);
+                return wrap(`✅ 已重命名: ${args.path} → ${args.newName}`);
+            }
             default:
                 return wrap(`❌ 未知 action: ${args.action}`);
         }

package/dist/tools/index.d.ts

@@ -1,12 +1,13 @@
 /**
  * MCP 工具注册入口
- * 精简后: 14 个工具, 6 个子模块
+ * 18 个工具, 7 个子模块
  *
  * 🔗 初始化:   kg_init                       (1个)
  * 📊 导航:     kg_status, kg_tree          (2个)
  * 📚 知识:     kg_doc, kg_projects, kg_rules (3个)
  * 📝 工作流:   kg_task, kg_files, kg_discuss (3个)
- * 🔬 代码分析: code_scan, code_query, code_impact, code_context, code_path (5个)
+ * 🔬 代码分析: code_scan, code_query, code_impact, code_context, code_path, code_smart_context, code_full_path (7个)
+ * 🏛️ 协作:    kg_meeting                    (1个)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerTools(server: McpServer, projectId: string, user: string, onProjectChange?: (newProjectId: string, newApiUrl: string) => void): void;