@ppdocs/mcp 3.2.19 → 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;
@@ -104,6 +93,56 @@ export declare class PpdocsApiClient {
     analyzerImpactTree(projectPath: string, symbolName: string, depth?: number): Promise<unknown>;
     /** 获取文件 360° 上下文 */
     analyzerContext(projectPath: string, filePath: string): Promise<unknown>;
+    /** 智能上下文: 代码+文档+规则+任务全关联 */
+    analyzerSmartContext(projectPath: string, symbolName: string): Promise<unknown>;
+    /** 全关联路径: 两个符号之间的代码+文档路径 */
+    analyzerFullPath(projectPath: string, symbolA: string, symbolB: string, maxDepth?: number): Promise<unknown>;
+    private publicRequest;
+    /** 列出活跃讨论 (公开路由) */
+    discussionList(): Promise<unknown>;
+    /** 创建讨论 (公开路由) */
+    discussionCreate(title: string, initiator: string, participants: string[], content: string, msgSummary?: string): Promise<{
+        id: string;
+    }>;
+    /** 批量读取讨论 (公开路由, 支持已读追踪) */
+    discussionReadByIds(ids: string[], reader?: string, mode?: string): Promise<unknown>;
+    /** 列出所有讨论 (含历史, 按参与方筛选) */
+    discussionListAll(participant?: string): Promise<unknown>;
+    /** 回复讨论 (公开路由) */
+    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>;
+    meetingClaim(agentId: string, filePath: string): Promise<unknown>;
+    meetingRelease(agentId: string, filePath: string): Promise<unknown>;
+    meetingStatus(): Promise<unknown>;
 }
 export declare function initClient(apiUrl: string): void;
 export declare function getClient(): PpdocsApiClient;

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) {
@@ -509,6 +486,207 @@ export class PpdocsApiClient {
             body: JSON.stringify({ project_path: projectPath, file_path: filePath }),
         });
     }
+    /** 智能上下文: 代码+文档+规则+任务全关联 */
+    async analyzerSmartContext(projectPath, symbolName) {
+        return this.request('/analyzer/smart-context', {
+            method: 'POST',
+            body: JSON.stringify({ project_path: projectPath, symbol_name: symbolName }),
+        });
+    }
+    /** 全关联路径: 两个符号之间的代码+文档路径 */
+    async analyzerFullPath(projectPath, symbolA, symbolB, maxDepth = 3) {
+        return this.request('/analyzer/full-path', {
+            method: 'POST',
+            body: JSON.stringify({ project_path: projectPath, symbol_a: symbolA, symbol_b: symbolB, max_depth: maxDepth }),
+        });
+    }
+    // ============ 公开路由请求工具 (无需项目认证) ============
+    async publicRequest(path, options) {
+        const response = await fetch(`${this.serverUrl}${path}`, {
+            headers: { 'Content-Type': 'application/json' },
+            ...options,
+        });
+        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();
+        if (!json.success)
+            throw new Error(json.error || 'Unknown error');
+        return json.data;
+    }
+    // ============ 讨论系统 ============
+    /** 列出活跃讨论 (公开路由) */
+    async discussionList() {
+        return this.publicRequest('/api/discussions');
+    }
+    /** 创建讨论 (公开路由) */
+    async discussionCreate(title, initiator, participants, content, msgSummary) {
+        return this.publicRequest('/api/discussions', {
+            method: 'POST',
+            body: JSON.stringify({ title, initiator, participants, content, msg_summary: msgSummary }),
+        });
+    }
+    /** 批量读取讨论 (公开路由, 支持已读追踪) */
+    async discussionReadByIds(ids, reader, mode) {
+        return this.publicRequest('/api/discussions/read', {
+            method: 'POST',
+            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, msgSummary, newSummary) {
+        return this.publicRequest(`/api/discussions/${encodeURIComponent(id)}/reply`, {
+            method: 'POST',
+            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',
+        });
+    }
+    /** 删除讨论 (公开路由) */
+    async discussionDelete(id) {
+        return this.publicRequest(`/api/discussions/${encodeURIComponent(id)}`, {
+            method: 'DELETE',
+        });
+    }
+    /** 结案归档讨论 (认证路由) */
+    async discussionClose(id, conclusion) {
+        return this.request(`/discussions/${encodeURIComponent(id)}/close`, {
+            method: 'POST',
+            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', {
+            method: 'POST',
+            body: JSON.stringify({ agent_id: agentId, agent_type: agentType }),
+        });
+    }
+    async meetingLeave(agentId) {
+        return this.request('/meeting/leave', {
+            method: 'POST',
+            body: JSON.stringify({ agent_id: agentId }),
+        });
+    }
+    async meetingPost(agentId, content, msgType = 'status') {
+        return this.request('/meeting/post', {
+            method: 'POST',
+            body: JSON.stringify({ agent_id: agentId, content, msg_type: msgType }),
+        });
+    }
+    async meetingClaim(agentId, filePath) {
+        return this.request('/meeting/claim', {
+            method: 'POST',
+            body: JSON.stringify({ agent_id: agentId, file_path: filePath }),
+        });
+    }
+    async meetingRelease(agentId, filePath) {
+        return this.request('/meeting/release', {
+            method: 'POST',
+            body: JSON.stringify({ agent_id: agentId, file_path: filePath }),
+        });
+    }
+    async meetingStatus() {
+        return this.request('/meeting/status');
+    }
 }
 // ============ 模块级 API ============
 let client = null;

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

@@ -5,4 +5,5 @@
  * 让 AI Agent 通过 MCP 工具直接查询代码结构、依赖关系和影响范围
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerAnalyzerTools(server: McpServer, projectId: string): void;
+import { type McpContext } from './shared.js';
+export declare function registerAnalyzerTools(server: McpServer, ctx: McpContext): void;