@ppdocs/mcp 3.2.20 → 3.2.21

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;
@@ -112,19 +101,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))
+        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;
-                    addDir(fullPath, zipPath ? `${zipPath}/${entry.name}` : entry.name);
+                    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);
+                    }
                 }
-                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) {
@@ -544,24 +521,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 +567,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.js

@@ -20,10 +20,10 @@ 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, ctx) {
     }));
     // ===== 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, ctx) {
     }));
     // ===== 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,10 +91,10 @@ export function registerAnalyzerTools(server, ctx) {
     }));
     // ===== 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 fileCtx = await client().analyzerContext(args.projectPath, args.filePath);
+        const fileCtx = await client().analyzerContext(args.projectPath || '', args.filePath);
         if (!fileCtx) {
             return wrap(`未找到文件 "${args.filePath}"。请确认路径正确, 路径格式为相对路径(如 src/main.ts)`);
         }
@@ -135,16 +135,17 @@ export function registerAnalyzerTools(server, ctx) {
     }));
     // ===== 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`);
@@ -262,10 +263,10 @@ export function registerAnalyzerTools(server, ctx) {
     }));
     // ===== code_smart_context: 代码+文档全关联上下文 =====
     server.tool('code_smart_context', '🔍 代码+文档全关联上下文 — 输入一个函数名，一次调用返回：代码依赖、关联文档、匹配规则、活跃任务、影响范围摘要。需先运行 code_scan', {
-        projectPath: z.string().describe('项目源码的绝对路径'),
+        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`);
         }
@@ -322,12 +323,12 @@ export function registerAnalyzerTools(server, ctx) {
     }));
     // ===== code_full_path: 全关联路径 =====
     server.tool('code_full_path', '🔗 全关联路径 — 两个符号之间不仅返回代码引用链路，还返回共享的KG文档、共同导入、祖先模块。需先运行 code_scan', {
-        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 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/package.json

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