@ppdocs/mcp 3.2.20 → 3.2.22

package/dist/storage/httpClient.d.ts

@@ -4,7 +4,7 @@
  *
  * API URL 格式: http://localhost:20001/api/:projectId/:password/...
  */
-import type { DocData, DocNode, DocSearchResult, Task, TaskSummary, TaskLogType, TaskExperience, FileInfo, RuleMeta } from './types.js';
+import type { DocData, DocNode, Task, TaskSummary, TaskLogType, TaskExperience, FileInfo, RuleMeta } from './types.js';
 interface TreeNode {
     path: string;
     name: string;
@@ -22,7 +22,6 @@ export declare class PpdocsApiClient {
     createDoc(docPath: string, doc: Partial<DocData>): Promise<DocData>;
     updateDoc(docPath: string, updates: Partial<DocData>): Promise<DocData | null>;
     deleteDoc(docPath: string): Promise<boolean>;
-    searchDocs(keywords: string[], limit?: number): Promise<DocSearchResult[]>;
     /** 按状态筛选文档 */
     getDocsByStatus(statusList: string[]): Promise<DocNode[]>;
     /** 获取目录树结构 */
@@ -43,14 +42,6 @@ export declare class PpdocsApiClient {
     }, creator: string): Promise<Task>;
     addTaskLog(taskId: string, logType: TaskLogType, content: string): Promise<Task | null>;
     completeTask(taskId: string, experience: TaskExperience): Promise<Task | null>;
-    /** 创建项目 (公开路由，无需认证) */
-    createProject(id: string, name: string, description?: string, projectPath?: string): Promise<{
-        project: {
-            id: string;
-            name: string;
-        };
-        password: string;
-    }>;
     /** 列出所有可访问的项目 */
     crossListProjects(): Promise<{
         id: string;
@@ -77,12 +68,10 @@ export declare class PpdocsApiClient {
         localPath: string;
         fileCount: number;
     }>;
-    /** 上传本地目录到中心服务器 (打包 zip → POST) */
-    uploadFiles(localDir: string, remoteDir?: string): Promise<{
+    /** 上传本地目录或单文件到中心服务器 (打包 zip → POST) */
+    uploadFiles(localPath: string, remoteDir?: string): Promise<{
         fileCount: number;
     }>;
-    /** 清空项目文件存储区 */
-    clearFiles(): Promise<void>;
     /** 上传已打包好的 zip 数据到本项目 files/ (供 Code Beacon 使用) */
     uploadRawZip(zipData: Buffer | Uint8Array | any, remoteDir?: string): Promise<{
         fileCount: number;
@@ -98,12 +87,6 @@ export declare class PpdocsApiClient {
     }>;
     /** 扫描项目代码, 构建/更新索引 */
     analyzerScan(projectPath: string, force?: boolean): Promise<unknown>;
-    /** 查询代码符号 (模糊匹配) */
-    analyzerQuery(projectPath: string, query: string): Promise<unknown>;
-    /** 分层影响分析 (BFS 递归, 可指定深度) */
-    analyzerImpactTree(projectPath: string, symbolName: string, depth?: number): Promise<unknown>;
-    /** 获取文件 360° 上下文 */
-    analyzerContext(projectPath: string, filePath: string): Promise<unknown>;
     /** 智能上下文: 代码+文档+规则+任务全关联 */
     analyzerSmartContext(projectPath: string, symbolName: string): Promise<unknown>;
     /** 全关联路径: 两个符号之间的代码+文档路径 */
@@ -112,19 +95,42 @@ export declare class PpdocsApiClient {
     /** 列出活跃讨论 (公开路由) */
     discussionList(): Promise<unknown>;
     /** 创建讨论 (公开路由) */
-    discussionCreate(title: string, initiator: string, participants: string[], content: string): Promise<{
+    discussionCreate(title: string, initiator: string, participants: string[], content: string, msgSummary?: string): Promise<{
         id: string;
     }>;
-    /** 批量读取讨论 (公开路由) */
-    discussionReadByIds(ids: string[]): Promise<unknown>;
+    /** 批量读取讨论 (公开路由, 支持已读追踪) */
+    discussionReadByIds(ids: string[], reader?: string, mode?: string): Promise<unknown>;
+    /** 列出所有讨论 (含历史, 按参与方筛选) */
+    discussionListAll(participant?: string): Promise<unknown>;
     /** 回复讨论 (公开路由) */
-    discussionReply(id: string, sender: string, content: string, newSummary?: string): Promise<boolean>;
+    discussionReply(id: string, sender: string, content: string, msgSummary?: string, newSummary?: string): Promise<boolean>;
+    /** 完成讨论 (公开路由, 标记为 completed) */
+    discussionComplete(id: string): Promise<boolean>;
     /** 删除讨论 (公开路由) */
     discussionDelete(id: string): Promise<boolean>;
     /** 结案归档讨论 (认证路由) */
     discussionClose(id: string, conclusion: string): Promise<{
         archived_path: string;
     }>;
+    /** 列出公共文件 */
+    publicFilesList(dir?: string): Promise<FileInfo[]>;
+    /** 读取公共文件 (文本) */
+    publicFilesRead(filePath: string): Promise<string>;
+    /** 创建公共文件池子目录 */
+    publicFilesMkdir(dirPath: string): Promise<boolean>;
+    /** 重命名公共文件或目录 */
+    publicFilesRename(filePath: string, newName: string): Promise<boolean>;
+    /** 删除公共文件 */
+    publicFilesDelete(filePath: string): Promise<boolean>;
+    /** 下载公共文件或目录 */
+    publicFilesDownload(remotePath: string, localPath?: string): Promise<{
+        localPath: string;
+        fileCount: number;
+    }>;
+    /** 上传本地目录或单文件到公共文件池 */
+    publicFilesUpload(localPath: string, remoteDir?: string): Promise<{
+        fileCount: number;
+    }>;
     meetingJoin(agentId: string, agentType: string): Promise<unknown>;
     meetingLeave(agentId: string): Promise<unknown>;
     meetingPost(agentId: string, content: string, msgType?: string): Promise<unknown>;

package/dist/storage/httpClient.js

@@ -191,12 +191,6 @@ export class PpdocsApiClient {
             return false;
         }
     }
-    async searchDocs(keywords, limit = 20) {
-        return this.request('/docs/search', {
-            method: 'POST',
-            body: JSON.stringify({ keywords, limit })
-        });
-    }
     /** 按状态筛选文档 */
     async getDocsByStatus(statusList) {
         return this.request('/docs/by-status', {
@@ -328,22 +322,6 @@ export class PpdocsApiClient {
             return null;
         }
     }
-    // ============ 项目管理 ============
-    /** 创建项目 (公开路由，无需认证) */
-    async createProject(id, name, description, projectPath) {
-        const url = `${this.serverUrl}/api/projects`;
-        const response = await fetch(url, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ id, name, description: description || '', project_path: projectPath || '' }),
-        });
-        if (!response.ok) {
-            const error = await response.json().catch(() => ({ error: response.statusText }));
-            throw new Error(error.error || `HTTP ${response.status}`);
-        }
-        const json = await response.json();
-        return json.data;
-    }
     // ============ 跨项目只读访问 ============
     /** 列出所有可访问的项目 */
     async crossListProjects() {
@@ -397,33 +375,41 @@ export class PpdocsApiClient {
     async download(remotePath, localPath) {
         return fetchAndExtractZip(`${this.baseUrl}/files-download/${cleanPath(remotePath)}`, localPath);
     }
-    /** 上传本地目录到中心服务器 (打包 zip → POST) */
-    async uploadFiles(localDir, remoteDir) {
+    /** 上传本地目录或单文件到中心服务器 (打包 zip → POST) */
+    async uploadFiles(localPath, remoteDir) {
         const fs = await import('fs');
         const path = await import('path');
         const AdmZip = (await import('adm-zip')).default;
-        if (!fs.existsSync(localDir) || !fs.statSync(localDir).isDirectory()) {
-            throw new Error(`本地目录不存在: ${localDir}`);
+        if (!fs.existsSync(localPath)) {
+            throw new Error(`本地路径不存在: ${localPath}`);
         }
         const zip = new AdmZip();
-        const addDir = (dirPath, zipPath) => {
-            for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
-                if (entry.name.startsWith('.'))
-                    continue;
-                const fullPath = path.join(dirPath, entry.name);
-                if (entry.isDirectory()) {
-                    if (EXCLUDED_DIRS.has(entry.name))
-                        continue;
-                    addDir(fullPath, zipPath ? `${zipPath}/${entry.name}` : entry.name);
-                }
-                else {
-                    if (fs.statSync(fullPath).size > 10_485_760)
+        const stat = fs.statSync(localPath);
+        if (stat.isDirectory()) {
+            const addDir = (dirPath, zipPath) => {
+                for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
+                    if (entry.name.startsWith('.'))
                         continue;
-                    zip.addLocalFile(fullPath, zipPath || undefined);
+                    const fullPath = path.join(dirPath, entry.name);
+                    if (entry.isDirectory()) {
+                        if (EXCLUDED_DIRS.has(entry.name))
+                            continue;
+                        addDir(fullPath, zipPath ? `${zipPath}/${entry.name}` : entry.name);
+                    }
+                    else {
+                        if (fs.statSync(fullPath).size > 10_485_760)
+                            continue;
+                        zip.addLocalFile(fullPath, zipPath || undefined);
+                    }
                 }
-            }
-        };
-        addDir(localDir, '');
+            };
+            addDir(localPath, '');
+        }
+        else {
+            if (stat.size > 10_485_760)
+                throw new Error('文件超过 10MB 限制');
+            zip.addLocalFile(localPath);
+        }
         const buffer = zip.toBuffer();
         if (buffer.length > 104_857_600) {
             throw new Error('打包后超过 100MB 限制，请缩小目录范围');
@@ -441,15 +427,6 @@ export class PpdocsApiClient {
         const result = await response.json();
         return { fileCount: result.data?.fileCount || 0 };
     }
-    /** 清空项目文件存储区 */
-    async clearFiles() {
-        const url = `${this.baseUrl}/files`;
-        const response = await fetch(url, { method: 'DELETE' });
-        if (!response.ok) {
-            const error = await response.json().catch(() => ({ error: response.statusText }));
-            throw new Error(error.error || `HTTP ${response.status}`);
-        }
-    }
     // ============ 直接上传已打包的 ZIP ============
     /** 上传已打包好的 zip 数据到本项目 files/ (供 Code Beacon 使用) */
     async uploadRawZip(zipData, remoteDir) {
@@ -488,27 +465,6 @@ export class PpdocsApiClient {
             body: JSON.stringify({ project_path: projectPath, force }),
         });
     }
-    /** 查询代码符号 (模糊匹配) */
-    async analyzerQuery(projectPath, query) {
-        return this.request('/analyzer/query', {
-            method: 'POST',
-            body: JSON.stringify({ project_path: projectPath, query }),
-        });
-    }
-    /** 分层影响分析 (BFS 递归, 可指定深度) */
-    async analyzerImpactTree(projectPath, symbolName, depth = 2) {
-        return this.request('/analyzer/impact-tree', {
-            method: 'POST',
-            body: JSON.stringify({ project_path: projectPath, symbol_name: symbolName, depth }),
-        });
-    }
-    /** 获取文件 360° 上下文 */
-    async analyzerContext(projectPath, filePath) {
-        return this.request('/analyzer/context', {
-            method: 'POST',
-            body: JSON.stringify({ project_path: projectPath, file_path: filePath }),
-        });
-    }
     /** 智能上下文: 代码+文档+规则+任务全关联 */
     async analyzerSmartContext(projectPath, symbolName) {
         return this.request('/analyzer/smart-context', {
@@ -544,24 +500,37 @@ export class PpdocsApiClient {
         return this.publicRequest('/api/discussions');
     }
     /** 创建讨论 (公开路由) */
-    async discussionCreate(title, initiator, participants, content) {
+    async discussionCreate(title, initiator, participants, content, msgSummary) {
         return this.publicRequest('/api/discussions', {
             method: 'POST',
-            body: JSON.stringify({ title, initiator, participants, content }),
+            body: JSON.stringify({ title, initiator, participants, content, msg_summary: msgSummary }),
         });
     }
-    /** 批量读取讨论 (公开路由) */
-    async discussionReadByIds(ids) {
+    /** 批量读取讨论 (公开路由, 支持已读追踪) */
+    async discussionReadByIds(ids, reader, mode) {
         return this.publicRequest('/api/discussions/read', {
             method: 'POST',
-            body: JSON.stringify({ ids }),
+            body: JSON.stringify({ ids, reader, mode }),
+        });
+    }
+    /** 列出所有讨论 (含历史, 按参与方筛选) */
+    async discussionListAll(participant) {
+        return this.publicRequest('/api/discussions/all', {
+            method: 'POST',
+            body: JSON.stringify({ participant }),
         });
     }
     /** 回复讨论 (公开路由) */
-    async discussionReply(id, sender, content, newSummary) {
+    async discussionReply(id, sender, content, msgSummary, newSummary) {
         return this.publicRequest(`/api/discussions/${encodeURIComponent(id)}/reply`, {
             method: 'POST',
-            body: JSON.stringify({ sender, content, new_summary: newSummary }),
+            body: JSON.stringify({ sender, content, msg_summary: msgSummary, new_summary: newSummary }),
+        });
+    }
+    /** 完成讨论 (公开路由, 标记为 completed) */
+    async discussionComplete(id) {
+        return this.publicRequest(`/api/discussions/${encodeURIComponent(id)}/complete`, {
+            method: 'POST',
         });
     }
     /** 删除讨论 (公开路由) */
@@ -577,6 +546,92 @@ export class PpdocsApiClient {
             body: JSON.stringify({ conclusion }),
         });
     }
+    // ============ 公共文件池 ============
+    /** 列出公共文件 */
+    async publicFilesList(dir) {
+        const query = dir ? `?dir=${encodeURIComponent(dir)}` : '';
+        return this.publicRequest(`/api/public-files${query}`);
+    }
+    /** 读取公共文件 (文本) */
+    async publicFilesRead(filePath) {
+        return this.publicRequest(`/api/public-files/read/${cleanPath(filePath)}`);
+    }
+    /** 创建公共文件池子目录 */
+    async publicFilesMkdir(dirPath) {
+        return this.publicRequest(`/api/public-files/mkdir`, {
+            method: 'POST',
+            body: JSON.stringify({ path: dirPath }),
+        });
+    }
+    /** 重命名公共文件或目录 */
+    async publicFilesRename(filePath, newName) {
+        return this.publicRequest(`/api/public-files/rename`, {
+            method: 'POST',
+            body: JSON.stringify({ path: filePath, new_name: newName }),
+        });
+    }
+    /** 删除公共文件 */
+    async publicFilesDelete(filePath) {
+        return this.publicRequest(`/api/public-files/${cleanPath(filePath)}`, {
+            method: 'DELETE',
+        });
+    }
+    /** 下载公共文件或目录 */
+    async publicFilesDownload(remotePath, localPath) {
+        return fetchAndExtractZip(`${this.serverUrl}/api/public-files/download/${cleanPath(remotePath)}`, localPath);
+    }
+    /** 上传本地目录或单文件到公共文件池 */
+    async publicFilesUpload(localPath, remoteDir) {
+        const fs = await import('fs');
+        const path = await import('path');
+        const AdmZip = (await import('adm-zip')).default;
+        if (!fs.existsSync(localPath)) {
+            throw new Error(`本地路径不存在: ${localPath}`);
+        }
+        const zip = new AdmZip();
+        const stat = fs.statSync(localPath);
+        if (stat.isDirectory()) {
+            const addDir = (dirPath, zipPath) => {
+                for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
+                    if (entry.name.startsWith('.'))
+                        continue;
+                    const fullPath = path.join(dirPath, entry.name);
+                    if (entry.isDirectory()) {
+                        if (EXCLUDED_DIRS.has(entry.name))
+                            continue;
+                        addDir(fullPath, zipPath ? `${zipPath}/${entry.name}` : entry.name);
+                    }
+                    else {
+                        if (fs.statSync(fullPath).size > 10_485_760)
+                            continue;
+                        zip.addLocalFile(fullPath, zipPath || undefined);
+                    }
+                }
+            };
+            addDir(localPath, '');
+        }
+        else {
+            if (stat.size > 10_485_760)
+                throw new Error('文件超过 10MB 限制');
+            zip.addLocalFile(localPath);
+        }
+        const buffer = zip.toBuffer();
+        if (buffer.length > 104_857_600) {
+            throw new Error('打包后超过 100MB 限制');
+        }
+        const query = remoteDir ? `?dir=${encodeURIComponent(remoteDir)}` : '';
+        const response = await fetch(`${this.serverUrl}/api/public-files/upload${query}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/octet-stream' },
+            body: new Uint8Array(buffer),
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: response.statusText }));
+            throw new Error(error.error || `HTTP ${response.status}`);
+        }
+        const result = await response.json();
+        return { fileCount: result.data?.fileCount || 0 };
+    }
     // ============ 多AI协作会议 ============
     async meetingJoin(agentId, agentType) {
         return this.request('/meeting/join', {

package/dist/storage/types.d.ts

@@ -26,27 +26,6 @@ export interface DocNode {
     isDir: boolean;
     status?: string;
 }
-/** 文档搜索结果 */
-export interface DocSearchResult {
-    path: string;
-    name: string;
-    summary: string;
-    score: number;
-}
-export interface ProjectMeta {
-    projectId: string;
-    projectName: string;
-    updatedAt: string;
-    password?: string;
-}
-export interface Project {
-    id: string;
-    name: string;
-    description?: string;
-    updatedAt: string;
-    createdAt?: string;
-    projectPath?: string;
-}
 export interface RuleMeta {
     label: string;
     keywords: string[];

package/dist/tools/analyzer.d.ts

@@ -1,8 +1,9 @@
 /**
- * 代码分析引擎工具 (4个)
- * code_scan, code_query, code_impact, code_context
+ * 代码分析引擎工具 (3个)
+ * code_scan, code_smart_context, code_full_path
  *
- * 让 AI Agent 通过 MCP 工具直接查询代码结构、依赖关系和影响范围
+ * code_smart_context: 代码+KG文档全关联 (含影响范围)
+ * code_full_path: 两点间代码链路+共享KG文档
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { type McpContext } from './shared.js';

package/dist/tools/analyzer.js

@@ -1,8 +1,9 @@
 /**
- * 代码分析引擎工具 (4个)
- * code_scan, code_query, code_impact, code_context
+ * 代码分析引擎工具 (3个)
+ * code_scan, code_smart_context, code_full_path
  *
- * 让 AI Agent 通过 MCP 工具直接查询代码结构、依赖关系和影响范围
+ * code_smart_context: 代码+KG文档全关联 (含影响范围)
+ * code_full_path: 两点间代码链路+共享KG文档
  */
 import { z } from 'zod';
 import { getClient } from '../storage/httpClient.js';
@@ -13,17 +14,14 @@ const SYMBOL_ICONS = {
     type_alias: '𝐓', enum: '𝐄', struct: '𝐒', trait: '⚡',
     constant: '𝐊', variable: '𝑣',
 };
-const SEVERITY_ICONS = {
-    critical: '🔴', warning: '🟡', info: '🟢',
-};
 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")'),
+    server.tool('code_scan', '📡 扫描项目代码, 构建索引。返回文件数、符号数、语言统计。★首次使用 code_smart_context/code_full_path 前必须先执行★', {
+        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([
             `✅ 代码扫描完成`,
             ``,
@@ -34,238 +32,12 @@ export function registerAnalyzerTools(server, ctx) {
             `- 索引时间: ${result.indexedAt}`,
         ].join('\n'));
     }));
-    // ===== code_query: 搜索代码符号 =====
-    server.tool('code_query', '🔤 搜索代码符号(函数/类/方法/接口/类型)。返回匹配列表+文件路径+行号。定位代码位置的最快方式。需先运行 code_scan', {
-        projectPath: z.string().describe('项目源码的绝对路径'),
-        query: z.string().describe('搜索关键词(函数名/类名/方法名等)'),
-    }, async (args) => safeTool(async () => {
-        const results = await client().analyzerQuery(args.projectPath, args.query);
-        if (!results || results.length === 0) {
-            return wrap(`未找到匹配 "${args.query}" 的符号。请确认已运行 code_scan`);
-        }
-        const lines = results.map(r => {
-            const icon = SYMBOL_ICONS[r.symbol.kind] || '?';
-            const exp = r.symbol.exported ? ' [export]' : '';
-            const parent = r.symbol.parent ? ` ◀ ${r.symbol.parent}` : '';
-            return `  ${icon} ${r.symbol.name}${parent}${exp}  →  ${r.filePath}:${r.symbol.lineStart}`;
-        });
-        return wrap([
-            `🔤 找到 ${results.length} 个匹配符号:`,
-            ``,
-            ...lines,
-        ].join('\n'));
-    }));
-    // ===== code_impact: 分层影响分析 =====
-    server.tool('code_impact', '💥 爆炸半径分析 ★修改代码前必查★ 分析修改一个函数/类/类型会影响多少文件。BFS分层输出: L1🔴直接引用=必须检查, L2🟡间接引用=建议检查, L3🟢传递引用=注意。修改任何公共接口、函数签名、类型定义前务必先运行!', {
-        projectPath: z.string().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);
-        if (!result) {
-            return wrap(`未找到符号 "${args.symbolName}"。请确认名称正确且已运行 code_scan`);
-        }
-        if (result.levels.length === 0) {
-            return wrap(`✅ "${args.symbolName}" 没有被其他文件引用, 修改安全`);
-        }
-        // 生成分层树形输出
-        const lines = [
-            `🎯 ${result.symbolName} (${result.symbolKind})`,
-            `📍 定义: ${result.definedIn}:${result.lineStart}`,
-            ``,
-            `📊 ${result.summary}`,
-            ``,
-        ];
-        for (const level of result.levels) {
-            const icon = SEVERITY_ICONS[level.severity] || '⚪';
-            const label = level.depth === 1 ? '直接引用 (必须检查)' :
-                level.depth === 2 ? '间接引用 (建议检查)' :
-                    '传递引用 (注意)';
-            lines.push(`### ${icon} L${level.depth} ${label} (${level.count}个)`);
-            for (const entry of level.entries) {
-                lines.push(`  ${entry.filePath}:${entry.line}  [${entry.refKind}]  ${entry.context}`);
-            }
-            lines.push('');
-        }
-        return wrap(lines.join('\n'));
-    }));
-    // ===== code_context: 文件360°上下文 =====
-    server.tool('code_context', '🔍 文件360°上下文 — 定义了什么符号、导入了什么、被谁引用。修改文件前使用, 快速了解所有依赖关系, 避免遗漏', {
-        projectPath: z.string().describe('项目源码的绝对路径'),
-        filePath: z.string().describe('目标文件的相对路径(如"src/services/auth.ts")'),
-    }, async (args) => safeTool(async () => {
-        const fileCtx = await client().analyzerContext(args.projectPath, args.filePath);
-        if (!fileCtx) {
-            return wrap(`未找到文件 "${args.filePath}"。请确认路径正确, 路径格式为相对路径(如 src/main.ts)`);
-        }
-        const lines = [
-            `📄 ${fileCtx.filePath}`,
-            `语言: ${fileCtx.language} | ${fileCtx.linesTotal} 行`,
-            ``,
-        ];
-        // 定义的符号
-        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}`);
-            }
-            lines.push('');
-        }
-        // 导入
-        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 (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}`);
-            }
-            lines.push('');
-        }
-        return wrap(lines.join('\n'));
-    }));
-    // ===== code_path: 两点间链路追踪 =====
-    server.tool('code_path', '🔗 两点链路追踪 — 给定两个符号(如 fileA.funcA 和 fileB.funcB)，自动搜索中间的引用链路，返回完整路径 + 绑定的知识图谱文档', {
-        projectPath: z.string().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));
-        // 1. 获取两个符号的影响树
-        const [treeA, treeB] = await Promise.all([
-            client().analyzerImpactTree(args.projectPath, args.symbolA, depth),
-            client().analyzerImpactTree(args.projectPath, args.symbolB, depth),
-        ]);
-        if (!treeA)
-            return wrap(`❌ 未找到起点符号 "${args.symbolA}"。请确认名称正确且已运行 code_scan`);
-        if (!treeB)
-            return wrap(`❌ 未找到终点符号 "${args.symbolB}"。请确认名称正确且已运行 code_scan`);
-        const graphA = new Map(); // 从 A 出发可达的文件
-        const graphB = new Map(); // 从 B 出发可达的文件
-        const buildGraph = (tree, graph) => {
-            graph.set(tree.definedIn, []);
-            for (const level of tree.levels) {
-                for (const entry of level.entries) {
-                    if (!graph.has(entry.filePath))
-                        graph.set(entry.filePath, []);
-                    graph.get(entry.filePath).push({
-                        file: entry.filePath,
-                        line: entry.line,
-                        depth: level.depth,
-                        from: tree.symbolName,
-                    });
-                }
-            }
-        };
-        buildGraph(treeA, graphA);
-        buildGraph(treeB, graphB);
-        // 3. 查找交集: A 和 B 都能到达的文件
-        const intersection = [];
-        for (const [fileA] of graphA) {
-            if (graphB.has(fileA)) {
-                const refsA = graphA.get(fileA);
-                const refsB = graphB.get(fileA);
-                const minDepthA = refsA.length > 0 ? Math.min(...refsA.map(r => r.depth)) : 0;
-                const minDepthB = refsB.length > 0 ? Math.min(...refsB.map(r => r.depth)) : 0;
-                intersection.push({ file: fileA, depthFromA: minDepthA, depthFromB: minDepthB });
-            }
-        }
-        // 4. 尝试获取 KG 文档绑定
-        let docBindings = {};
-        try {
-            const docClient = client();
-            const allDocs = await docClient.listDocs();
-            for (const doc of allDocs) {
-                if (!doc.isDir && doc.summary) {
-                    docBindings[doc.name] = doc.summary;
-                }
-            }
-        }
-        catch { /* KG 不可用时忽略 */ }
-        // 5. 格式化输出
-        const lines = [
-            `🔗 两点链路追踪`,
-            ``,
-            `📍 起点: ${treeA.symbolName} (${treeA.symbolKind}) → ${treeA.definedIn}:${treeA.lineStart}`,
-            `📍 终点: ${treeB.symbolName} (${treeB.symbolKind}) → ${treeB.definedIn}:${treeB.lineStart}`,
-            ``,
-        ];
-        // 直接引用关系
-        if (treeA.definedIn === treeB.definedIn) {
-            lines.push(`✅ 两个符号定义在同一文件中！`);
-            lines.push('');
-        }
-        // 检查 A 的影响树是否直接包含 B 的文件
-        const directAtoB = graphA.has(treeB.definedIn);
-        const directBtoA = graphB.has(treeA.definedIn);
-        if (directAtoB || directBtoA) {
-            lines.push(`### ✅ 发现直接链路`);
-            if (directAtoB) {
-                const refs = graphA.get(treeB.definedIn);
-                lines.push(`  ${treeA.symbolName} → [L${refs[0]?.depth || 1}] → ${treeB.definedIn} (含 ${treeB.symbolName})`);
-            }
-            if (directBtoA) {
-                const refs = graphB.get(treeA.definedIn);
-                lines.push(`  ${treeB.symbolName} → [L${refs[0]?.depth || 1}] → ${treeA.definedIn} (含 ${treeA.symbolName})`);
-            }
-            lines.push('');
-        }
-        if (intersection.length > 0) {
-            // 按总深度排序
-            intersection.sort((a, b) => (a.depthFromA + a.depthFromB) - (b.depthFromA + b.depthFromB));
-            lines.push(`### 🔗 共经文件 (${intersection.length}个)`);
-            lines.push(`| 文件 | 距${treeA.symbolName} | 距${treeB.symbolName} | 📚 绑定文档 |`);
-            lines.push(`|:---|:---:|:---:|:---|`);
-            for (const node of intersection.slice(0, 20)) {
-                const fileName = node.file.split('/').pop() || node.file;
-                const docBind = docBindings[fileName] || '—';
-                lines.push(`| ${node.file} | L${node.depthFromA} | L${node.depthFromB} | ${docBind} |`);
-            }
-            if (intersection.length > 20) {
-                lines.push(`| ... | | | (还有 ${intersection.length - 20} 个) |`);
-            }
-            lines.push('');
-        }
-        else if (!directAtoB && !directBtoA) {
-            lines.push(`⚠️ 在 ${depth} 层深度内未发现 ${treeA.symbolName} 与 ${treeB.symbolName} 的引用链路`);
-            lines.push(`建议: 增加 maxDepth 参数(当前=${depth}, 最大=5) 重试`);
-            lines.push('');
-        }
-        // 附加: 各符号的影响概要
-        lines.push(`### 📊 影响概要`);
-        lines.push(`- ${treeA.symbolName}: ${treeA.summary}`);
-        lines.push(`- ${treeB.symbolName}: ${treeB.summary}`);
-        // 附加: 绑定的 KG 文档
-        const relevantDocs = [];
-        const symbolNames = [treeA.symbolName, treeB.symbolName];
-        for (const [docName, docSummary] of Object.entries(docBindings)) {
-            if (symbolNames.some(s => docName.toLowerCase().includes(s.toLowerCase()) || s.toLowerCase().includes(docName.toLowerCase()))) {
-                relevantDocs.push(`  📚 ${docName}: ${docSummary}`);
-            }
-        }
-        if (relevantDocs.length > 0) {
-            lines.push('');
-            lines.push(`### 📚 相关知识图谱文档`);
-            lines.push(...relevantDocs);
-        }
-        return wrap(lines.join('\n'));
-    }));
     // ===== code_smart_context: 代码+文档全关联上下文 =====
-    server.tool('code_smart_context', '🔍 代码+文档全关联上下文 — 输入一个函数名，一次调用返回：代码依赖、关联文档、匹配规则、活跃任务、影响范围摘要。需先运行 code_scan', {
-        projectPath: z.string().describe('项目源码的绝对路径'),
+    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);
+        const smartCtx = await client().analyzerSmartContext(args.projectPath || '', args.symbolName);
         if (!smartCtx) {
             return wrap(`未找到符号 "${args.symbolName}"。请确认名称正确且已运行 code_scan`);
         }
@@ -321,13 +93,13 @@ export function registerAnalyzerTools(server, ctx) {
         return wrap(lines.join('\n'));
     }));
     // ===== code_full_path: 全关联路径 =====
-    server.tool('code_full_path', '🔗 全关联路径 — 两个符号之间不仅返回代码引用链路，还返回共享的KG文档、共同导入、祖先模块。需先运行 code_scan', {
-        projectPath: z.string().describe('项目源码的绝对路径'),
+    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);
+        const result = await client().analyzerFullPath(args.projectPath || '', args.symbolA, args.symbolB, args.maxDepth ?? 3);
         if (!result) {
             return wrap(`❌ 无法构建路径。请确认两个符号名称正确且已运行 code_scan`);
         }

package/dist/tools/discussion.js

@@ -41,40 +41,52 @@ function formatList(items, ctx) {
     }
     return lines.join('\n');
 }
-function formatDetail(d) {
+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) => {
-        lines.push(`--- 消息 ${i + 1}/${msgs.length} [${m.sender}] ${relativeTime(m.timestamp)} ---`);
-        lines.push(m.content);
+        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);
@@ -89,10 +101,11 @@ export function registerDiscussionTools(server, ctx) {
                 const readIds = decoded.ids || (decoded.id ? [decoded.id] : []);
                 if (readIds.length === 0)
                     return wrap('❌ read 需要 id 或 ids');
-                const discussions = await client().discussionReadByIds(readIds);
+                const readMode = decoded.mode || 'auto';
+                const discussions = await client().discussionReadByIds(readIds, me, readMode);
                 if (!Array.isArray(discussions) || discussions.length === 0)
                     return wrap('未找到对应的讨论记录');
-                return wrap(discussions.map(formatDetail).join('\n\n━━━━━━━━━━━━━━━━━━━━\n\n'));
+                return wrap(discussions.map(formatDetailView).join('\n\n━━━━━━━━━━━━━━━━━━━━\n\n'));
             }
             case 'create': {
                 if (!decoded.title)
@@ -101,7 +114,7 @@ export function registerDiscussionTools(server, ctx) {
                     return wrap('❌ create 需要 participants');
                 if (!decoded.content)
                     return wrap('❌ create 需要 content');
-                const result = await client().discussionCreate(decoded.title, me, decoded.participants, decoded.content);
+                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': {
@@ -109,9 +122,33 @@ export function registerDiscussionTools(server, ctx) {
                     return wrap('❌ reply 需要 id');
                 if (!decoded.content)
                     return wrap('❌ reply 需要 content');
-                await client().discussionReply(decoded.id, me, decoded.content, decoded.newSummary);
+                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');

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,12 @@
 /**
  * MCP 工具注册入口
- * 18 个工具, 7 个子模块
+ * 14 个工具, 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, code_smart_context, code_full_path (7个)
+ * 🔬 代码分析: code_scan, code_smart_context, code_full_path (3个)
  * 🏛️ 协作:    kg_meeting                    (1个)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';

package/dist/tools/index.js

@@ -1,12 +1,12 @@
 /**
  * MCP 工具注册入口
- * 18 个工具, 7 个子模块
+ * 14 个工具, 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, code_smart_context, code_full_path (7个)
+ * 🔬 代码分析: code_scan, code_smart_context, code_full_path (3个)
  * 🏛️ 协作:    kg_meeting                    (1个)
  */
 import { createContext } from './shared.js';
@@ -35,7 +35,7 @@ export function registerTools(server, projectId, user, onProjectChange) {
     registerTaskTools(server, ctx);
     registerFileTools(server);
     registerDiscussionTools(server, ctx);
-    // 🔬 代码分析 (code_scan, code_query, code_impact, code_context, code_path, code_smart_context, code_full_path)
+    // 🔬 代码分析 (code_scan, code_smart_context, code_full_path)
     registerAnalyzerTools(server, ctx);
     // 🏛️ 多AI协作 (kg_meeting)
     registerMeetingTools(server, ctx);

package/package.json

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