@ppdocs/mcp 3.2.37 → 3.3.0

package/README.md

@@ -114,7 +114,7 @@ npx @ppdocs/mcp init -p <projectId> -k <key> --codex
 | `kg_init` | 初始化项目连接与上下文 |
 | `kg_status` | 查看项目仪表盘与流程图概况 |
 | `kg_flowchart` | 统一的知识图谱入口，负责查询、更新、关系分析 |
-| `kg_rules` | 规则管理 |
+| `kg_workflow` | Markdown 文档工作流管理 |
 | `kg_task` | 任务管理 |
 | `kg_files` | 项目文件读写/上传下载 |
 | `kg_discuss` | 讨论区 |

package/dist/cli.js

@@ -392,11 +392,12 @@ function generateMcpPermissions() {
         'kg_status',
         // 知识管理
         'kg_projects',
-        'kg_rules',
+        'kg_workflow',
         // 工作流
         'kg_task',
         'kg_files',
         'kg_discuss',
+        'kg_ref',
         // 流程图
         'kg_flowchart',
         // 协作

package/dist/index.js

@@ -45,21 +45,7 @@ async function main() {
     });
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    // [M2 修复] beacon 变量提升到外部，支持优雅关闭
-    let beacon = null;
-    // 启动后台代码同步引擎 (Code Beacon) — 仅在有配置时启动
-    if (config) {
-        try {
-            const { SyncBeacon } = await import('./sync/beacon.js');
-            beacon = new SyncBeacon(process.cwd(), config.projectId);
-            beacon.start();
-        }
-        catch (err) {
-            console.error(`[Code Beacon] Failed to start:`, err);
-        }
-    }
-    // 优雅关闭：进程退出时停止 watcher，防止上传截断
-    const shutdown = () => { beacon?.stop(); process.exit(0); };
+    const shutdown = () => { process.exit(0); };
     process.on('SIGINT', shutdown);
     process.on('SIGTERM', shutdown);
 }

package/dist/storage/httpClient.d.ts

@@ -4,19 +4,31 @@
  *
  * API URL 格式: http://localhost:20099/api/:projectId/:password/...
  */
-import type { Task, TaskSummary, TaskLogType, TaskExperience, FileInfo, RuleMeta } from './types.js';
+import type { Task, TaskSummary, TaskLogType, TaskExperience, FileInfo, WorkflowSummary, WorkflowDoc, WorkflowSelector, Reference } from './types.js';
 export declare class PpdocsApiClient {
     private baseUrl;
     private serverUrl;
     constructor(apiUrl: string);
     private request;
-    getRulesApi(ruleType: string): Promise<string[]>;
-    saveRulesApi(ruleType: string, rules: string[]): Promise<boolean>;
-    getRulesMeta(): Promise<Record<string, RuleMeta>>;
-    saveRulesMeta(meta: Record<string, RuleMeta>): Promise<boolean>;
-    crossGetRulesMeta(target: string): Promise<Record<string, RuleMeta>>;
-    getGlobalRulesMeta(): Promise<Record<string, RuleMeta>>;
-    saveGlobalRulesMeta(meta: Record<string, RuleMeta>): Promise<boolean>;
+    listWorkflows(scope?: 'all' | 'global' | 'project'): Promise<WorkflowSummary[]>;
+    getWorkflow(workflowId: string, scope?: 'all' | 'global' | 'project'): Promise<WorkflowDoc | null>;
+    getWorkflowBatch(selectors: WorkflowSelector[]): Promise<WorkflowDoc[]>;
+    saveWorkflow(workflowId: string, input: {
+        scope: 'global' | 'project';
+        title: string;
+        description: string;
+        system: string;
+        keywords: string[];
+        minHits: number;
+        always: boolean;
+        content: string;
+    }): Promise<WorkflowDoc>;
+    deleteWorkflow(workflowId: string, scope: 'global' | 'project'): Promise<boolean>;
+    listReferences(): Promise<Reference[]>;
+    getReference(refId: string): Promise<Reference | null>;
+    saveReference(reference: Reference): Promise<boolean>;
+    deleteReference(refId: string): Promise<boolean>;
+    readReferenceFile(path: string): Promise<string>;
     listTasks(status?: 'active' | 'archived'): Promise<TaskSummary[]>;
     getTask(taskId: string, mode?: 'smart' | 'full'): Promise<Task | null>;
     createTask(task: {
@@ -46,8 +58,6 @@ export declare class PpdocsApiClient {
         description: string;
         updatedAt: string;
     }[]>;
-    /** 跨项目: 获取规则 */
-    crossGetRules(target: string, ruleType: string): Promise<string[]>;
     /** 列出项目文件 */
     listFiles(dir?: string): Promise<FileInfo[]>;
     /** 读取项目文件 */
@@ -57,14 +67,6 @@ export declare class PpdocsApiClient {
         localPath: string;
         fileCount: number;
     }>;
-    /** 上传本地目录或单文件到中心服务器 (打包 zip → POST) */
-    uploadFiles(localPath: string, remoteDir?: string): Promise<{
-        fileCount: number;
-    }>;
-    /** 上传已打包好的 zip 数据到本项目 files/ (供 Code Beacon 使用) */
-    uploadRawZip(zipData: Buffer | Uint8Array | any, remoteDir?: string): Promise<{
-        fileCount: number;
-    }>;
     /** 跨项目: 列出文件 */
     crossListFiles(target: string, dir?: string): Promise<FileInfo[]>;
     /** 跨项目: 读取文件 */
@@ -95,6 +97,10 @@ export declare class PpdocsApiClient {
     discussionReply(id: string, sender: string, content: string, msgSummary?: string, newSummary?: string): Promise<boolean>;
     /** 完成讨论 (公开路由, 标记为 completed) */
     discussionComplete(id: string): Promise<boolean>;
+    /** 归档关闭讨论 (需项目认证) */
+    discussionClose(id: string, conclusion: string): Promise<{
+        archived_path?: string;
+    }>;
     /** 删除讨论 (公开路由) */
     discussionDelete(id: string): Promise<boolean>;
     /** 列出公共文件 */
@@ -112,10 +118,6 @@ export declare class PpdocsApiClient {
         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

@@ -9,11 +9,6 @@
 function cleanPath(p) {
     return p.replace(/^\//, '');
 }
-/** 排除的目录 (与 Rust 端 EXCLUDED_DIRS 保持一致) */
-const EXCLUDED_DIRS = new Set([
-    'node_modules', '.git', 'target', 'dist', 'build', '.next',
-    '__pycache__', '.venv', 'venv', '.idea', '.vs', '.vscode',
-]);
 /** 下载 zip 并解压到指定目录或 temp 目录 */
 async function fetchAndExtractZip(url, localPath) {
     const controller = new AbortController();
@@ -99,75 +94,64 @@ export class PpdocsApiClient {
             clearTimeout(timeout);
         }
     }
-    // ============ 规则 API ============
-    async getRulesApi(ruleType) {
-        try {
-            return await this.request(`/rules/${ruleType}`);
-        }
-        catch {
-            return [];
-        }
+    // ============ 工作流 API ============
+    async listWorkflows(scope) {
+        const query = scope ? `?scope=${scope}` : '';
+        return this.request(`/workflows${query}`);
     }
-    async saveRulesApi(ruleType, rules) {
+    async getWorkflow(workflowId, scope) {
         try {
-            await this.request(`/rules/${ruleType}`, {
-                method: 'PUT',
-                body: JSON.stringify(rules)
-            });
-            return true;
+            const query = scope ? `?scope=${scope}` : '';
+            return await this.request(`/workflows/${encodeURIComponent(workflowId)}${query}`);
         }
         catch {
-            return false;
+            return null;
         }
     }
-    async getRulesMeta() {
-        try {
-            return await this.request('/rules-meta');
-        }
-        catch {
-            return {};
-        }
+    async getWorkflowBatch(selectors) {
+        return this.request('/workflows/batch', {
+            method: 'POST',
+            body: JSON.stringify(selectors),
+        });
     }
-    async saveRulesMeta(meta) {
-        try {
-            await this.request('/rules-meta', {
-                method: 'PUT',
-                body: JSON.stringify(meta)
-            });
-            return true;
-        }
-        catch {
-            return false;
-        }
+    async saveWorkflow(workflowId, input) {
+        return this.request(`/workflows/${encodeURIComponent(workflowId)}`, {
+            method: 'PUT',
+            body: JSON.stringify(input),
+        });
     }
-    async crossGetRulesMeta(target) {
-        try {
-            return await this.request(`/cross/${encodeURIComponent(target)}/rules-meta`);
-        }
-        catch {
-            return {};
-        }
+    async deleteWorkflow(workflowId, scope) {
+        return this.request(`/workflows/${encodeURIComponent(workflowId)}?scope=${scope}`, {
+            method: 'DELETE',
+        });
     }
-    async getGlobalRulesMeta() {
-        try {
-            return await this.request('/global-rules-meta');
-        }
-        catch {
-            return {};
-        }
+    // ============ 外部参考 API ============
+    async listReferences() {
+        return this.request('/refs');
     }
-    async saveGlobalRulesMeta(meta) {
+    async getReference(refId) {
         try {
-            await this.request('/global-rules-meta', {
-                method: 'PUT',
-                body: JSON.stringify(meta)
-            });
-            return true;
+            return await this.request(`/refs/${encodeURIComponent(refId)}`);
         }
         catch {
-            return false;
+            return null;
         }
     }
+    async saveReference(reference) {
+        await this.request(`/refs/${encodeURIComponent(reference.id)}`, {
+            method: 'PUT',
+            body: JSON.stringify(reference),
+        });
+        return true;
+    }
+    async deleteReference(refId) {
+        return this.request(`/refs/${encodeURIComponent(refId)}`, {
+            method: 'DELETE',
+        });
+    }
+    async readReferenceFile(path) {
+        return this.request(`/refs/files/${cleanPath(path)}`);
+    }
     // ============ 任务管理 ============
     async listTasks(status) {
         const query = status ? `?status=${status}` : '';
@@ -285,15 +269,6 @@ export class PpdocsApiClient {
     async crossListProjects() {
         return this.request('/cross/projects');
     }
-    /** 跨项目: 获取规则 */
-    async crossGetRules(target, ruleType) {
-        try {
-            return await this.request(`/cross/${encodeURIComponent(target)}/rules/${ruleType}`);
-        }
-        catch {
-            return [];
-        }
-    }
     // ============ 项目文件访问 ============
     /** 列出项目文件 */
     async listFiles(dir) {
@@ -308,74 +283,6 @@ export class PpdocsApiClient {
     async download(remotePath, localPath) {
         return fetchAndExtractZip(`${this.baseUrl}/files-download/${cleanPath(remotePath)}`, localPath);
     }
-    /** 上传本地目录或单文件到中心服务器 (打包 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(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.baseUrl}/files${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 };
-    }
-    // ============ 直接上传已打包的 ZIP ============
-    /** 上传已打包好的 zip 数据到本项目 files/ (供 Code Beacon 使用) */
-    async uploadRawZip(zipData, remoteDir) {
-        const query = remoteDir ? `?dir=${encodeURIComponent(remoteDir)}` : '';
-        const response = await fetch(`${this.baseUrl}/files${query}`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/octet-stream' },
-            body: Buffer.isBuffer(zipData) ? new Uint8Array(zipData) : zipData,
-        });
-        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 };
-    }
     // ============ 跨项目文件访问 (只读) ============
     /** 跨项目: 列出文件 */
     async crossListFiles(target, dir) {
@@ -466,6 +373,13 @@ export class PpdocsApiClient {
             method: 'POST',
         });
     }
+    /** 归档关闭讨论 (需项目认证) */
+    async discussionClose(id, conclusion) {
+        return this.request(`/discussions/${encodeURIComponent(id)}/close`, {
+            method: 'POST',
+            body: JSON.stringify({ conclusion }),
+        });
+    }
     /** 删除讨论 (公开路由) */
     async discussionDelete(id) {
         return this.publicRequest(`/api/discussions/${encodeURIComponent(id)}`, {
@@ -506,58 +420,6 @@ export class PpdocsApiClient {
     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

@@ -4,6 +4,48 @@ export interface RuleMeta {
     min_hits: number;
     always?: boolean;
 }
+export interface WorkflowSummary {
+    id: string;
+    scope: 'global' | 'project';
+    title: string;
+    description: string;
+    system: string;
+    keywords: string[];
+    minHits: number;
+    always: boolean;
+    updatedAt: string;
+}
+export interface WorkflowDoc extends WorkflowSummary {
+    content: string;
+}
+export interface WorkflowSelector {
+    id: string;
+    scope?: 'global' | 'project';
+}
+export interface ReferenceLink {
+    url: string;
+    label: string;
+}
+export interface ReferenceFile {
+    name: string;
+    path: string;
+}
+export interface AdoptedNode {
+    chartId: string;
+    nodeId: string;
+    nodeLabel: string;
+}
+export interface Reference {
+    id: string;
+    title: string;
+    summary: string;
+    links: ReferenceLink[];
+    files: ReferenceFile[];
+    scripts: ReferenceFile[];
+    adoptedBy: AdoptedNode[];
+    createdAt: string;
+    updatedAt: string;
+}
 export interface FileInfo {
     name: string;
     path: string;

package/dist/tools/analyzer.d.ts

@@ -2,7 +2,7 @@
  * 代码分析引擎工具 (3个)
  * code_scan, code_smart_context, code_full_path
  *
- * code_smart_context: 代码+KG文档全关联 (含影响范围)
+ * code_smart_context: 代码+KG文档/工作流全关联 (含影响范围)
  * code_full_path: 两点间代码链路+共享KG文档
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';

package/dist/tools/analyzer.js

@@ -2,7 +2,7 @@
  * 代码分析引擎工具 (3个)
  * code_scan, code_smart_context, code_full_path
  *
- * code_smart_context: 代码+KG文档全关联 (含影响范围)
+ * code_smart_context: 代码+KG文档/工作流全关联 (含影响范围)
  * code_full_path: 两点间代码链路+共享KG文档
  */
 import { z } from 'zod';
@@ -33,7 +33,7 @@ export function registerAnalyzerTools(server, ctx) {
         ].join('\n'));
     }));
     // ===== code_smart_context: 代码+文档全关联上下文 =====
-    server.tool('code_smart_context', '🔍 代码+文档全关联上下文 — 输入一个函数名,一次调用返回:代码依赖、关联文档、匹配规则、活跃任务、影响范围摘要。需先运行 code_scan', {
+    server.tool('code_smart_context', '🔍 代码+文档全关联上下文 — 输入一个函数名,一次调用返回:代码依赖、关联文档、匹配工作流、活跃任务、影响范围摘要。需先运行 code_scan', {
         projectPath: z.string().optional().describe('项目源码的绝对路径(不传则自动解析)'),
         symbolName: z.string().describe('要查询的符号名称(如"handleLogin", "AuthService")'),
     }, async (args) => safeTool(async () => {
@@ -75,11 +75,12 @@ export function registerAnalyzerTools(server, ctx) {
             }
             lines.push('');
         }
-        // 匹配规则
-        if (smartCtx.matchedRules.length > 0) {
-            lines.push(`### 📏 匹配规则 (${smartCtx.matchedRules.length})`);
-            for (const rule of smartCtx.matchedRules) {
-                lines.push(`  [${rule.ruleType}] ${rule.content.substring(0, 100)}`);
+        // 匹配工作流
+        if (smartCtx.matchedWorkflows.length > 0) {
+            lines.push(`### 📘 匹配工作流 (${smartCtx.matchedWorkflows.length})`);
+            for (const workflow of smartCtx.matchedWorkflows) {
+                const desc = workflow.description ? ` — ${workflow.description}` : '';
+                lines.push(`  [${workflow.scope}/${workflow.system || 'general'}] ${workflow.title}${desc}`);
             }
             lines.push('');
         }

package/dist/tools/discussion.js

@@ -233,13 +233,9 @@ export function registerDiscussionTools(server, ctx) {
                 if (brief && !isInitiator(brief, me, myPid)) {
                     return wrap(`🔒 无权限: 仅发起人 (${brief.initiator}) 可归档讨论\n你的身份: ${me}`);
                 }
-                // 先追加结案总结
-                try {
-                    await client().discussionReply(decoded.id, me, `📋 结案总结:\n\n${decoded.conclusion}`, '结案总结');
-                }
-                catch { /* 忽略回复失败 */ }
-                await client().discussionComplete(decoded.id);
-                return wrap(`✅ 讨论已结案 (ID: ${decoded.id})\n📋 ${decoded.conclusion}`);
+                const result = await client().discussionClose(decoded.id, decoded.conclusion);
+                const archivePath = result?.archived_path ? `\n📦 已归档: ${result.archived_path}` : '';
+                return wrap(`✅ 讨论已结案并归档 (ID: ${decoded.id})\n📋 ${decoded.conclusion}${archivePath}`);
             }
             case 'delete': {
                 if (!decoded.id)

package/dist/tools/files.d.ts

@@ -1,7 +1,6 @@
 /**
- * 📁 kg_files (5→1)
- * 合并: project_list_files, project_read_file, project_upload, project_download
- * + 公共文件池: public_list, public_read, public_upload, public_download, public_delete
+ * 📁 kg_files — 文件浏览/读取/下载 (上传已移除，全部本地化)
+ * 公共文件池: public_list, public_read, public_download, public_delete, public_mkdir, public_rename
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerFileTools(server: McpServer): void;

package/dist/tools/files.js

@@ -1,26 +1,21 @@
 /**
- * 📁 kg_files (5→1)
- * 合并: project_list_files, project_read_file, project_upload, project_download
- * + 公共文件池: public_list, public_read, public_upload, public_download, public_delete
+ * 📁 kg_files — 文件浏览/读取/下载 (上传已移除，全部本地化)
+ * 公共文件池: public_list, public_read, public_download, public_delete, public_mkdir, public_rename
  */
 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(下载文件)|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'])
+    server.tool('kg_files', '📁 项目文件操作 — 浏览目录、读取文件、下载。action: list(目录浏览)|read(读取文件)|download(下载文件)|public_list(公共文件池浏览)|public_read(读取公共文件)|public_download(下载公共文件)|public_delete(删除公共文件)|public_mkdir(创建公共池子目录)|public_rename(重命名公共文件)', {
+        action: z.enum(['list', 'read', 'download', 'public_list', 'public_read', 'public_download', 'public_delete', 'public_mkdir', 'public_rename'])
             .describe('操作类型'),
         path: z.string().optional()
             .describe('文件路径 (read/download/public_read/public_download/public_delete/public_mkdir, 如"src/main.ts")'),
         dir: z.string().optional()
             .describe('子目录路径 (list/public_list, 如"src/components")'),
-        localDir: z.string().optional()
-            .describe('本地路径(目录或单文件) (upload/public_upload)'),
         localPath: z.string().optional()
             .describe('本地保存路径 (download/public_download)'),
-        remoteDir: z.string().optional()
-            .describe('远程目标子目录 (upload/public_upload)'),
         newName: z.string().optional()
             .describe('新名称 (public_rename)'),
         targetProject: z.string().optional()
@@ -51,12 +46,6 @@ export function registerFileTools(server) {
                 const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
                 return wrap(`${prefix}📄 ${args.path}\n\n\`\`\`\n${content}\n\`\`\``);
             }
-            case 'upload': {
-                if (!args.localDir)
-                    return wrap('❌ upload 需要 localDir');
-                const result = await client().uploadFiles(args.localDir, args.remoteDir);
-                return wrap(`✅ 上传成功\n\n- 文件数量: ${result.fileCount}\n- 目标目录: ${args.remoteDir || '/'}`);
-            }
             case 'download': {
                 if (!args.path)
                     return wrap('❌ download 需要 path');
@@ -85,12 +74,6 @@ export function registerFileTools(server) {
                 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');

package/dist/tools/flowchart.js

@@ -249,7 +249,10 @@ function findDirectedPath(chart, fromId, toId) {
 }
 export function registerFlowchartTools(server, _ctx) {
     const client = () => getClient();
-    server.tool('kg_flowchart', 'Logical flowchart operations: list|get|search|get_relations|find_path|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart', {
+    server.tool('kg_flowchart', '🔀 逻辑流程图 — 项目知识图谱的核心。每个节点代表一个模块/函数/概念，节点可绑定文件、内嵌版本化文档。\n' +
+        '⚡ 开始任何任务前必须先查图谱：search 搜关键词 → get_node 看详情 → 有 subFlowchart 则递归下探。\n' +
+        '📝 完成修改后必须回写：bind 绑定文件 → update_node 更新描述和文档 → 新模块用 batch_add。\n' +
+        'actions: list|get|search|get_relations|find_path|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart', {
         action: z
             .enum(['list', 'get', 'search', 'get_relations', 'find_path', 'get_node', 'update_node', 'delete_node', 'batch_add', 'bind', 'unbind', 'orphans', 'health', 'create_chart', 'delete_chart'])
             .describe('action type'),

package/dist/tools/index.d.ts

@@ -1,11 +1,11 @@
 /**
  * MCP 工具注册入口
- * 12 个工具, 6 个子模块
+ * 13 个工具, 7 个子模块
  *
  * 🔗 初始化:   kg_init                                           (1个)
  * 📊 导航:     kg_status                                         (1个)
- * 📚 知识:     kg_projects, kg_rules                              (2个)
- * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区)     (3个)
+ * 📚 知识:     kg_projects, kg_workflow                           (2个)
+ * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区), kg_ref (4个)
  * 🔀 关系核心: kg_flowchart(逻辑流程图 — 关系型知识锚点)           (1个)
  * 🔬 代码分析: code_scan, code_smart_context, code_full_path      (3个)
  * 🏛️ 协作:    kg_meeting                                         (1个)