@ppdocs/mcp 3.1.10 → 3.2.1

package/dist/tools/files.js

@@ -1,66 +1,71 @@
 /**
- * 项目文件访问工具 (5个)
- * project_upload, project_clear_files, project_list_files,
- * project_read_file, project_download
+ * 📁 kg_files (5→1)
+ * 合并: project_list_files, project_read_file, project_upload, project_download
+ * 删除: project_clear_files (危险操作)
  */
 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('project_upload', '上传本地项目目录到中心服务器(打包zip上传，自动排除node_modules/.git等)。上传后其他客户端可通过跨项目访问下载', {
-        localDir: z.string().describe('本地目录的绝对路径(如"/home/user/project/src")'),
-        remoteDir: z.string().optional().describe('上传到服务器的目标子目录(如"src")，不填则上传到根目录'),
+    server.tool('kg_files', '📁 项目文件操作 — 浏览目录、读取文件、上传下载。action: list(目录浏览)|read(读取文件)|upload(上传目录)|download(下载文件)', {
+        action: z.enum(['list', 'read', 'upload', 'download'])
+            .describe('操作类型'),
+        path: z.string().optional()
+            .describe('文件路径 (read/download, 如"src/main.ts")'),
+        dir: z.string().optional()
+            .describe('子目录路径 (list, 如"src/components")'),
+        localDir: z.string().optional()
+            .describe('本地目录绝对路径 (upload)'),
+        localPath: z.string().optional()
+            .describe('本地保存路径 (download)'),
+        remoteDir: z.string().optional()
+            .describe('远程目标子目录 (upload)'),
+        targetProject: z.string().optional()
+            .describe('跨项目操作的目标项目ID'),
     }, async (args) => safeTool(async () => {
-        const result = await client().uploadFiles(args.localDir, args.remoteDir);
-        return wrap(`✅ 上传成功\n\n- 文件数量: ${result.fileCount}\n- 目标目录: ${args.remoteDir || '/'}\n\n其他客户端可通过 project_read_file / project_download 访问`);
-    }));
-    // 清空项目文件存储区
-    server.tool('project_clear_files', '清空当前项目在中心服务器上的文件存储区', {}, async () => safeTool(async () => {
-        await client().clearFiles();
-        return wrap('✅ 文件存储已清空');
-    }));
-    // 列出项目文件
-    server.tool('project_list_files', '浏览项目源码目录结构(仅列出文件名和大小，不读内容)。目标项目需已上传文件或关联源码目录。跨项目时先用kg_list_projects获取项目ID。查看文件内容请用project_read_file', {
-        dir: z.string().optional().describe('子目录路径(如"src/components")，不填则列出根目录'),
-        targetProject: z.string().optional().describe('目标项目ID或名称(不填=当前项目)。ID可从kg_list_projects获取')
-    }, async (args) => safeTool(async () => {
-        const files = args.targetProject
-            ? await client().crossListFiles(args.targetProject, args.dir)
-            : await client().listFiles(args.dir);
-        if (files.length === 0)
-            return wrap('目录为空');
-        const lines = files.map(f => {
-            const icon = f.isDir ? '📁' : '📄';
-            const size = f.isDir ? '' : ` (${formatFileSize(f.size)})`;
-            return `${icon} ${f.name}${size}`;
-        });
-        const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
-        const dirLabel = args.dir || '/';
-        return wrap(`${prefix}📂 ${dirLabel} (${files.length} 项)\n\n${lines.join('\n')}`);
-    }));
-    // 读取项目文件
-    server.tool('project_read_file', '读取单个源码文件的文本内容(限1MB)。适合查看具体代码实现。跨项目时先用kg_list_projects获取项目ID。浏览目录结构请用project_list_files', {
-        path: z.string().describe('文件路径(如"src/main.ts")'),
-        targetProject: z.string().optional().describe('目标项目ID或名称(不填=当前项目)。ID可从kg_list_projects获取')
-    }, async (args) => safeTool(async () => {
-        const content = args.targetProject
-            ? await client().crossReadFile(args.targetProject, args.path)
-            : await client().readFile(args.path);
-        const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
-        return wrap(`${prefix}📄 ${args.path}\n\n\`\`\`\n${content}\n\`\`\``);
-    }));
-    // 下载项目文件或目录
-    server.tool('project_download', '下载项目源码到本地(自动识别文件/目录，打包zip解压)。目标项目需已上传文件或关联源码目录。跨项目时先用kg_list_projects获取项目ID', {
-        remotePath: z.string().describe('远程路径，可以是目录(如"src")或单个文件(如"src/main.ts")'),
-        localPath: z.string().optional().describe('本地保存路径(不填则保存到系统临时目录，目录不存在会自动创建)'),
-        targetProject: z.string().optional().describe('目标项目ID或名称(不填=当前项目)。ID可从kg_list_projects获取')
-    }, async (args) => safeTool(async () => {
-        const result = args.targetProject
-            ? await client().crossDownload(args.targetProject, args.remotePath, args.localPath)
-            : await client().download(args.remotePath, args.localPath);
-        const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
-        return wrap(`${prefix}✅ 已下载并解压\n\n- 本地路径: ${result.localPath}\n- 文件数量: ${result.fileCount}`);
+        switch (args.action) {
+            case 'list': {
+                const files = args.targetProject
+                    ? await client().crossListFiles(args.targetProject, args.dir)
+                    : await client().listFiles(args.dir);
+                if (files.length === 0)
+                    return wrap('目录为空');
+                const lines = files.map(f => {
+                    const icon = f.isDir ? '📁' : '📄';
+                    const size = f.isDir ? '' : ` (${formatFileSize(f.size)})`;
+                    return `${icon} ${f.name}${size}`;
+                });
+                const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
+                const dirLabel = args.dir || '/';
+                return wrap(`${prefix}📂 ${dirLabel} (${files.length} 项)\n\n${lines.join('\n')}`);
+            }
+            case 'read': {
+                if (!args.path)
+                    return wrap('❌ read 需要 path');
+                const content = args.targetProject
+                    ? await client().crossReadFile(args.targetProject, args.path)
+                    : await client().readFile(args.path);
+                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');
+                const result = args.targetProject
+                    ? await client().crossDownload(args.targetProject, args.path, args.localPath)
+                    : await client().download(args.path, args.localPath);
+                const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
+                return wrap(`${prefix}✅ 已下载\n\n- 本地路径: ${result.localPath}\n- 文件数量: ${result.fileCount}`);
+            }
+            default:
+                return wrap(`❌ 未知 action: ${args.action}`);
+        }
     }));
 }

package/dist/tools/index.d.ts

@@ -1,6 +1,11 @@
 /**
  * MCP 工具注册入口
- * 将 25 个工具拆分为 5 个子模块，统一在此注册
+ * 精简后: 12 个工具, 5 个子模块
+ *
+ * 📊 导航:     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 (4个)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerTools(server: McpServer, projectId: string, user: string): void;

package/dist/tools/index.js

@@ -1,16 +1,31 @@
 /**
  * MCP 工具注册入口
- * 将 25 个工具拆分为 5 个子模块，统一在此注册
+ * 精简后: 12 个工具, 5 个子模块
+ *
+ * 📊 导航:     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 (4个)
  */
+import { registerStatusTool } from './kg_status.js';
 import { registerDocTools } from './docs.js';
+import { registerProjectTools } from './projects.js';
 import { registerRuleTools } from './rules.js';
 import { registerTaskTools } from './tasks.js';
 import { registerFileTools } from './files.js';
-import { registerProjectTools } from './projects.js';
+import { registerDiscussionTools } from './discussion.js';
+import { registerAnalyzerTools } from './analyzer.js';
 export function registerTools(server, projectId, user) {
-    registerProjectTools(server, projectId);
+    // 📊 导航 (kg_status + kg_tree在docs中)
+    registerStatusTool(server, projectId);
+    // 📚 知识 (kg_doc + kg_tree + kg_projects + kg_rules)
     registerDocTools(server, projectId);
+    registerProjectTools(server, projectId);
     registerRuleTools(server, projectId);
+    // 📝 工作流 (kg_task + kg_files + kg_discuss)
     registerTaskTools(server, projectId, user);
     registerFileTools(server);
+    registerDiscussionTools(server, projectId);
+    // 🔬 代码分析 (不变)
+    registerAnalyzerTools(server, projectId);
 }

package/dist/tools/kg_status.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 📊 kg_status — 项目速览仪表盘 (新增)
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerStatusTool(server: McpServer, projectId: string): void;

package/dist/tools/kg_status.js

@@ -0,0 +1,42 @@
+/**
+ * 📊 kg_status — 项目速览仪表盘 (新增)
+ */
+import { getClient } from '../storage/httpClient.js';
+import { wrap, safeTool } from './shared.js';
+export function registerStatusTool(server, projectId) {
+    const client = () => getClient();
+    server.tool('kg_status', '📊 项目速览仪表盘 — 一键了解项目健康。返回: 文档总数、目录数、活跃任务数、最近变更。每次对话开始建议首先调用', {}, async () => safeTool(async () => {
+        const [docs, activeTasks] = await Promise.all([
+            client().listDocs(),
+            client().listTasks('active'),
+        ]);
+        const dirCount = docs.filter(d => d.isDir).length;
+        const docCount = docs.filter(d => !d.isDir).length;
+        const statusMap = new Map();
+        for (const d of docs) {
+            if (d.isDir)
+                continue;
+            const s = d.status || '已完成';
+            statusMap.set(s, (statusMap.get(s) || 0) + 1);
+        }
+        const lines = [
+            `📊 项目速览 [${projectId}]`,
+            ``,
+            `📄 文档: ${docCount} 个 | 📁 目录: ${dirCount} 个`,
+            `📝 活跃任务: ${activeTasks.length} 个`,
+        ];
+        if (statusMap.size > 0) {
+            const statusLine = Array.from(statusMap.entries())
+                .map(([s, c]) => `${s}(${c})`)
+                .join(' | ');
+            lines.push(`📋 状态分布: ${statusLine}`);
+        }
+        if (activeTasks.length > 0) {
+            lines.push(``, `🔧 进行中的任务:`);
+            for (const t of activeTasks.slice(0, 5)) {
+                lines.push(`  - ${t.title} (${t.id})`);
+            }
+        }
+        return wrap(lines.join('\n'));
+    }));
+}

package/dist/tools/projects.d.ts

@@ -1,6 +1,7 @@
 /**
- * 项目管理工具 (3个)
- * kg_list_projects, kg_create_project, kg_update_root
+ * 📋 kg_projects (3→1)
+ * 合并: kg_list_projects, kg_update_root → kg_doc 处理
+ * 删除: kg_create_project (桌面端操作)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerProjectTools(server: McpServer, projectId: string): void;

package/dist/tools/projects.js

@@ -1,15 +1,13 @@
 /**
- * 项目管理工具 (3个)
- * kg_list_projects, kg_create_project, kg_update_root
+ * 📋 kg_projects (3→1)
+ * 合并: kg_list_projects, kg_update_root → kg_doc 处理
+ * 删除: kg_create_project (桌面端操作)
  */
-import { z } from 'zod';
 import { getClient } from '../storage/httpClient.js';
-import { decodeObjectStrings } from '../utils.js';
 import { wrap, safeTool } from './shared.js';
 export function registerProjectTools(server, projectId) {
     const client = () => getClient();
-    // 列出所有可访问的项目
-    server.tool('kg_list_projects', '列出所有可访问的项目(返回name和id)。跨项目操作的第一步：先调用此工具获取项目ID，再作为其他工具的targetProject参数', {}, async () => safeTool(async () => {
+    server.tool('kg_projects', '📋 列出所有可访问的项目(返回名称和ID)。跨项目操作的第一步: 获取项目ID后用于其他工具的 targetProject 参数', {}, async () => safeTool(async () => {
         const projects = await client().crossListProjects();
         if (projects.length === 0)
             return wrap('暂无可访问的项目');
@@ -19,38 +17,4 @@ export function registerProjectTools(server, projectId) {
         });
         return wrap(`可访问的项目 (${projects.length} 个):\n\n${lines.join('\n')}`);
     }));
-    // 创建项目
-    server.tool('kg_create_project', '创建新项目。返回项目ID和密码(密码用于MCP连接)', {
-        id: z.string().optional().describe('项目ID(可选，不填则自动生成随机ID)'),
-        name: z.string().describe('项目名称'),
-        description: z.string().optional().describe('项目简介'),
-        projectPath: z.string().optional().describe('项目源码路径(本地绝对路径)'),
-    }, async (args) => safeTool(async () => {
-        // 如果未提供 ID，自动生成随机ID
-        const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
-        const randomPart = Array.from({ length: 8 }, () => chars[Math.floor(Math.random() * chars.length)]).join('');
-        const id = args.id || `p-${randomPart}`;
-        const result = await client().createProject(id, args.name, args.description, args.projectPath || process.cwd());
-        return wrap(`✅ 项目创建成功\n\n- 项目ID: ${result.project.id}\n- 项目名: ${result.project.name}\n- 密码: ${result.password}\n\nMCP 连接地址: http://<服务器IP>:20001/api/${result.project.id}/${result.password}`);
-    }));
-    // 更新根文档 (项目介绍)
-    server.tool('kg_update_root', '更新项目介绍(根文档)', {
-        title: z.string().optional().describe('项目标题'),
-        description: z.string().optional().describe('项目介绍(Markdown)')
-    }, async (args) => safeTool(async () => {
-        const decoded = decodeObjectStrings(args);
-        if (decoded.title === undefined && decoded.description === undefined) {
-            return wrap('❌ 请至少提供 title 或 description');
-        }
-        const existing = await client().getDoc('/');
-        if (!existing)
-            return wrap('更新失败(根文档不存在)');
-        const updates = {};
-        if (decoded.title !== undefined)
-            updates.summary = decoded.title;
-        if (decoded.description !== undefined)
-            updates.content = decoded.description;
-        const doc = await client().updateDoc('/', updates);
-        return wrap(doc ? '✅ 项目介绍已更新' : '更新失败');
-    }));
 }

package/dist/tools/rules.d.ts

@@ -1,7 +1,7 @@
 /**
- * 规则管理工具 (6个)
- * kg_get_rules, kg_save_rules, kg_get_rules_meta, kg_save_rules_meta,
- * kg_get_global_rules_meta, kg_save_global_rules_meta
+ * 📏 kg_rules (6→1)
+ * 合并: kg_get_rules, kg_save_rules, kg_get_rules_meta, kg_save_rules_meta
+ * 删除: kg_get_global_rules_meta, kg_save_global_rules_meta (管理员操作)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerRuleTools(server: McpServer, projectId: string): void;

package/dist/tools/rules.js

@@ -1,7 +1,7 @@
 /**
- * 规则管理工具 (6个)
- * kg_get_rules, kg_save_rules, kg_get_rules_meta, kg_save_rules_meta,
- * kg_get_global_rules_meta, kg_save_global_rules_meta
+ * 📏 kg_rules (6→1)
+ * 合并: kg_get_rules, kg_save_rules, kg_get_rules_meta, kg_save_rules_meta
+ * 删除: kg_get_global_rules_meta, kg_save_global_rules_meta (管理员操作)
  */
 import { z } from 'zod';
 import { getClient } from '../storage/httpClient.js';
@@ -9,117 +9,95 @@ import { decodeObjectStrings, getRules, RULE_TYPE_LABELS } from '../utils.js';
 import { wrap, safeTool, crossPrefix } from './shared.js';
 export function registerRuleTools(server, projectId) {
     const client = () => getClient();
-    // 获取项目规则
-    server.tool('kg_get_rules', '获取项目规则(可指定类型或获取全部)。支持跨项目只读访问(需先用kg_list_projects获取项目ID)', {
-        ruleType: z.string().optional().describe('规则类型(如 userStyles, codeStyle, reviewRules, testRules, unitTests, 或自定义类型)。不传则返回全部'),
-        targetProject: z.string().optional().describe('目标项目ID或名称(不填=当前项目)。ID可从kg_list_projects获取')
-    }, async (args) => safeTool(async () => {
-        if (args.targetProject) {
-            const crossMeta = await client().crossGetRulesMeta(args.targetProject);
-            if (args.ruleType) {
-                const rules = await client().crossGetRules(args.targetProject, args.ruleType);
-                if (rules.length === 0) {
-                    const label = crossMeta[args.ruleType]?.label || args.ruleType;
-                    return wrap(`暂无${label}规则(项目: ${args.targetProject})`);
-                }
-                return wrap(`${crossPrefix(args.targetProject)}${rules.join('\n')}`);
-            }
-            const types = Object.keys(crossMeta).length > 0 ? Object.keys(crossMeta) : Object.keys(RULE_TYPE_LABELS);
-            const allRules = [];
-            for (const type of types) {
-                const rules = await client().crossGetRules(args.targetProject, type);
-                if (rules.length > 0) {
-                    const label = crossMeta[type]?.label || RULE_TYPE_LABELS[type] || type;
-                    allRules.push(`## ${label}\n${rules.join('\n')}`);
-                }
-            }
-            if (allRules.length === 0)
-                return wrap(`暂无项目规则(项目: ${args.targetProject})`);
-            return wrap(`${crossPrefix(args.targetProject)}${allRules.join('\n\n')}`);
-        }
-        const rules = await getRules(projectId, args.ruleType || undefined);
-        if (!rules || rules.trim() === '') {
-            const meta = await client().getRulesMeta();
-            const typeName = args.ruleType ? (meta[args.ruleType]?.label || args.ruleType) : '项目';
-            return wrap(`暂无${typeName}规则`);
-        }
-        return wrap(rules);
-    }));
-    // 保存项目规则 (自动合并,去重追加)
-    server.tool('kg_save_rules', '保存单个类型的项目规则(自动合并:已有规则保留,新规则去重追加)', {
-        ruleType: z.string().describe('规则类型(如 userStyles, codeStyle, reviewRules, testRules, unitTests, 或自定义类型)'),
-        rules: z.array(z.string()).describe('规则数组')
-    }, async (args) => safeTool(async () => {
-        const decoded = decodeObjectStrings(args);
-        // appendRules 逻辑内联（原 httpClient 包装函数）
-        const existing = await client().getRulesApi(decoded.ruleType);
-        const existingSet = new Set(existing.map(r => r.trim()));
-        const toAdd = decoded.rules.filter(r => !existingSet.has(r.trim()));
-        const merged = [...existing, ...toAdd];
-        const success = await client().saveRulesApi(decoded.ruleType, merged);
-        if (!success)
-            return wrap('❌ 保存失败');
-        const meta = await client().getRulesMeta();
-        const label = meta[decoded.ruleType]?.label || decoded.ruleType;
-        return wrap(`✅ ${label}已保存 (新增${toAdd.length}条, 共${merged.length}条)`);
-    }));
-    // 获取规则触发配置
-    server.tool('kg_get_rules_meta', '获取规则触发配置(所有类型的标签、关键词、触发数)。用于查看/编辑 hooks 触发条件', {}, async () => safeTool(async () => {
-        const meta = await client().getRulesMeta();
-        if (Object.keys(meta).length === 0)
-            return wrap('暂无规则配置');
-        const lines = Object.entries(meta).map(([type, m]) => {
-            const kw = m.keywords.length > 0 ? m.keywords.join(', ') : '(无)';
-            const trigger = m.always ? '始终触发' : `关键词≥${m.min_hits}: ${kw}`;
-            return `- **${m.label}** (${type}): ${trigger}`;
-        });
-        return wrap(`规则触发配置:\n\n${lines.join('\n')}`);
-    }));
-    // 保存规则触发配置 (自动合并)
-    server.tool('kg_save_rules_meta', '保存规则触发配置(自动合并:已有类型更新,新类型创建,其他类型不受影响)', {
+    server.tool('kg_rules', '📏 项目规则管理 — 读取或保存代码风格、审查规则等。action: get(读取规则)|save(保存规则)|get_meta(读取触发配置)|save_meta(保存触发配置)', {
+        action: z.enum(['get', 'save', 'get_meta', 'save_meta'])
+            .describe('操作类型'),
+        ruleType: z.string().optional()
+            .describe('规则类型(如 userStyles, codeStyle, reviewRules)。get/save 时使用，不传则获取全部'),
+        rules: z.array(z.string()).optional()
+            .describe('save 时的规则数组'),
         meta: z.record(z.string(), z.object({
             label: z.string().describe('规则显示名称'),
             keywords: z.array(z.string()).default([]).describe('触发关键词列表'),
             min_hits: z.number().default(1).describe('最低触发关键词数'),
-            always: z.boolean().default(false).describe('是否始终触发(如 userStyles)')
-        })).describe('规则类型 → 触发配置的映射')
+            always: z.boolean().default(false).describe('是否始终触发')
+        })).optional().describe('save_meta 时的触发配置映射'),
+        targetProject: z.string().optional()
+            .describe('跨项目读取 (get)'),
     }, async (args) => safeTool(async () => {
-        const decoded = decodeObjectStrings(args.meta);
-        // mergeRulesMeta 逻辑内联
-        const existing = await client().getRulesMeta();
-        const merged = { ...existing, ...decoded };
-        const success = await client().saveRulesMeta(merged);
-        if (!success)
-            return wrap('❌ 保存失败');
-        return wrap(`✅ 触发配置已保存 (更新${Object.keys(decoded).length}个类型, 共${Object.keys(merged).length}个类型)`);
-    }));
-    // 获取全局默认规则触发配置
-    server.tool('kg_get_global_rules_meta', '获取全局默认规则触发配置(新项目创建时继承此配置)', {}, async () => safeTool(async () => {
-        const meta = await client().getGlobalRulesMeta();
-        if (Object.keys(meta).length === 0)
-            return wrap('暂无全局默认规则配置');
-        const lines = Object.entries(meta).map(([type, m]) => {
-            const kw = m.keywords.length > 0 ? m.keywords.join(', ') : '(无)';
-            const trigger = m.always ? '始终触发' : `关键词≥${m.min_hits}: ${kw}`;
-            return `- **${m.label}** (${type}): ${trigger}`;
-        });
-        return wrap(`全局默认规则触发配置:\n\n${lines.join('\n')}`);
-    }));
-    // 保存全局默认规则触发配置 (自动合并)
-    server.tool('kg_save_global_rules_meta', '保存全局默认触发配置(自动合并:已有类型更新,新类型创建,其他类型不受影响)', {
-        meta: z.record(z.string(), z.object({
-            label: z.string().describe('规则显示名称'),
-            keywords: z.array(z.string()).default([]).describe('触发关键词列表'),
-            min_hits: z.number().default(1).describe('最低触发关键词数'),
-            always: z.boolean().default(false).describe('是否始终触发(如 userStyles)')
-        })).describe('规则类型 → 触发配置的映射')
-    }, async (args) => safeTool(async () => {
-        const decoded = decodeObjectStrings(args.meta);
-        const existing = await client().getGlobalRulesMeta();
-        const merged = { ...existing, ...decoded };
-        const success = await client().saveGlobalRulesMeta(merged);
-        if (!success)
-            return wrap('❌ 保存失败');
-        return wrap(`✅ 全局触发配置已保存 (更新${Object.keys(decoded).length}个类型, 共${Object.keys(merged).length}个类型)`);
+        const decoded = decodeObjectStrings(args);
+        switch (decoded.action) {
+            case 'get': {
+                if (decoded.targetProject) {
+                    const crossMeta = await client().crossGetRulesMeta(decoded.targetProject);
+                    if (decoded.ruleType) {
+                        const rules = await client().crossGetRules(decoded.targetProject, decoded.ruleType);
+                        if (rules.length === 0) {
+                            const label = crossMeta[decoded.ruleType]?.label || decoded.ruleType;
+                            return wrap(`暂无${label}规则(项目: ${decoded.targetProject})`);
+                        }
+                        return wrap(`${crossPrefix(decoded.targetProject)}${rules.join('\n')}`);
+                    }
+                    const types = Object.keys(crossMeta).length > 0 ? Object.keys(crossMeta) : Object.keys(RULE_TYPE_LABELS);
+                    const allRules = [];
+                    for (const type of types) {
+                        const rules = await client().crossGetRules(decoded.targetProject, type);
+                        if (rules.length > 0) {
+                            const label = crossMeta[type]?.label || RULE_TYPE_LABELS[type] || type;
+                            allRules.push(`## ${label}\n${rules.join('\n')}`);
+                        }
+                    }
+                    if (allRules.length === 0)
+                        return wrap(`暂无项目规则(项目: ${decoded.targetProject})`);
+                    return wrap(`${crossPrefix(decoded.targetProject)}${allRules.join('\n\n')}`);
+                }
+                const rules = await getRules(projectId, decoded.ruleType || undefined);
+                if (!rules || rules.trim() === '') {
+                    const meta = await client().getRulesMeta();
+                    const typeName = decoded.ruleType ? (meta[decoded.ruleType]?.label || decoded.ruleType) : '项目';
+                    return wrap(`暂无${typeName}规则`);
+                }
+                return wrap(rules);
+            }
+            case 'save': {
+                if (!decoded.ruleType)
+                    return wrap('❌ save 需要 ruleType');
+                if (!decoded.rules)
+                    return wrap('❌ save 需要 rules 数组');
+                const existing = await client().getRulesApi(decoded.ruleType);
+                const existingSet = new Set(existing.map(r => r.trim()));
+                const toAdd = decoded.rules.filter((r) => !existingSet.has(r.trim()));
+                const merged = [...existing, ...toAdd];
+                const success = await client().saveRulesApi(decoded.ruleType, merged);
+                if (!success)
+                    return wrap('❌ 保存失败');
+                const meta = await client().getRulesMeta();
+                const label = meta[decoded.ruleType]?.label || decoded.ruleType;
+                return wrap(`✅ ${label}已保存 (新增${toAdd.length}条, 共${merged.length}条)`);
+            }
+            case 'get_meta': {
+                const meta = await client().getRulesMeta();
+                if (Object.keys(meta).length === 0)
+                    return wrap('暂无规则配置');
+                const lines = Object.entries(meta).map(([type, m]) => {
+                    const kw = m.keywords.length > 0 ? m.keywords.join(', ') : '(无)';
+                    const trigger = m.always ? '始终触发' : `关键词≥${m.min_hits}: ${kw}`;
+                    return `- **${m.label}** (${type}): ${trigger}`;
+                });
+                return wrap(`规则触发配置:\n\n${lines.join('\n')}`);
+            }
+            case 'save_meta': {
+                if (!decoded.meta)
+                    return wrap('❌ save_meta 需要 meta');
+                const existing = await client().getRulesMeta();
+                const merged = { ...existing, ...decoded.meta };
+                const success = await client().saveRulesMeta(merged);
+                if (!success)
+                    return wrap('❌ 保存失败');
+                return wrap(`✅ 触发配置已保存 (更新${Object.keys(decoded.meta).length}个类型, 共${Object.keys(merged).length}个类型)`);
+            }
+            default:
+                return wrap(`❌ 未知 action: ${decoded.action}`);
+        }
     }));
 }

package/dist/tools/tasks.d.ts

@@ -1,6 +1,6 @@
 /**
- * 任务管理工具 (4个)
- * task_create, task_get, task_update, task_archive
+ * 📝 kg_task (4→1)
+ * 合并: task_create, task_get, task_update, task_archive
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerTaskTools(server: McpServer, projectId: string, user: string): void;