@ppdocs/mcp 3.12.0 → 3.13.0

package/README.md

@@ -116,9 +116,7 @@ npx @ppdocs/mcp init -p <projectId> -k <key> --codex
 | `kg_flowchart` | 统一的知识图谱入口，负责查询、更新、关系分析 |
 | `kg_workflow` | Markdown 文档工作流管理 |
 | `kg_task` | 任务管理 |
-| `kg_files` | 项目文件读写/上传下载 |
-| `kg_discuss` | 讨论区 |
-| `kg_meeting` | 多 AI 协作会议 |
+| `kg_ref` | 外部参考资料（URL拉取、查看、删除） |
 | `code_scan` | 代码扫描 |
 | `code_smart_context` | 获取符号的智能上下文 |
 | `code_full_path` | 获取两个符号之间的全路径 |
@@ -207,6 +205,12 @@ kg_flowchart(action:"update_node", chartId:"main", nodeId:"n_storage",
 
 ## 更新日志
 
+### v3.3.0
+- 移除 6 个低使用率工具: `kg_doc`, `kg_discuss`, `kg_meeting`, `kg_files`, `kg_projects`, `kg_pitfall`
+- `kg_ref` 精简为 4 个 action: `list|get|fetch|delete`
+- 所有工具描述精简，减少 token 开销
+- 移除前端孤立组件: FloatingDiscussion, PitfallRecord, ImpactGraph
+
 ### v3.2.36
 - 统一为 `flowchart-first` MCP 接口模型
 - `kg_flowchart` 新增 `search` / `get_relations` / `find_path`

package/dist/tools/analyzer.d.ts

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

package/dist/tools/analyzer.js

@@ -1,9 +1,6 @@
 /**
- * 代码分析引擎工具 (3个)
+ * 代码分析引擎工具
  * code_scan, code_smart_context, code_full_path
- *
- * code_smart_context: 代码+KG文档/工作流全关联 (含影响范围)
- * code_full_path: 两点间代码链路+共享KG文档
  */
 import { z } from 'zod';
 import { getClient } from '../storage/httpClient.js';
@@ -17,7 +14,7 @@ const SYMBOL_ICONS = {
 export function registerAnalyzerTools(server, ctx) {
     const client = () => getClient();
     // ===== code_scan: 扫描项目代码 =====
-    server.tool('code_scan', '📡 扫描项目代码, 构建索引。返回文件数、符号数、语言统计。★首次使用 code_smart_context/code_full_path 前必须先执行★', {
+    server.tool('code_scan', '扫描项目代码并构建索引。返回文件数、符号数、语言统计。首次使用 code_smart_context/code_full_path 前需先执行', {
         projectPath: z.string().optional().describe('项目源码的绝对路径(如"D:/projects/myapp")。不传则自动从Beacon同步目录或项目配置解析'),
         force: z.boolean().optional().describe('是否强制全量重建(默认false, 增量更新)'),
     }, async (args) => safeTool(async () => {
@@ -33,7 +30,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 () => {
@@ -94,7 +91,7 @@ export function registerAnalyzerTools(server, ctx) {
         return wrap(lines.join('\n'));
     }));
     // ===== code_full_path: 全关联路径 =====
-    server.tool('code_full_path', '🔗 全关联路径 — 两个符号之间不仅返回代码引用链路,还返回共享的KG文档、共同导入、祖先模块。需先运行 code_scan', {
+    server.tool('code_full_path', '全关联路径。查找两个符号之间的代码引用链路、共享KG文档、共同导入。需先运行 code_scan', {
         projectPath: z.string().optional().describe('项目源码的绝对路径(不传则自动解析)'),
         symbolA: z.string().describe('起点符号名(如 "handleLogin")'),
         symbolB: z.string().describe('终点符号名(如 "AuthService")'),

package/dist/tools/flowchart.js

@@ -317,10 +317,7 @@ function findDirectedPath(chart, fromId, toId) {
 }
 export function registerFlowchartTools(server, _ctx) {
     const client = () => getClient();
-    server.tool('kg_flowchart', '🔀 逻辑流程图 — 项目知识图谱的核心。每个节点代表一个模块/函数/概念，节点可绑定文件、内嵌版本化文档。\n' +
-        '★★ 编码前必须先设计：用 batch_add/update_node 在流程图中设计逻辑并验证每个节点正确后才能编码。执行 kg_workflow(id:"design-first") 查看完整工作流 ★★\n' +
-        '⚡ 开始任何任务前必须先查图谱：search 搜关键词 → get_node 看详情 → 有 subFlowchart 则递归下探。\n' +
-        '📝 完成修改后必须回写：bind 绑定文件 → update_node 更新描述和文档 → 新模块用 batch_add。\n' +
+    server.tool('kg_flowchart', '知识图谱核心。查询/更新流程图节点、关系、绑定文件和内嵌文档。' +
         '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'])

package/dist/tools/index.d.ts

@@ -1,15 +1,14 @@
 /**
  * MCP 工具注册入口
- * 15 个工具, 9 个子模块
+ * 7 个工具, 6 个子模块
  *
- * 🔗 初始化:   kg_init                                           (1个)
- * 📊 导航:     kg_status                                         (1个)
- * 📚 知识:     kg_projects, kg_workflow                           (2个)
- * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区), kg_ref, kg_pitfall (5个)
- * 🔀 关系核心: kg_flowchart(逻辑流程图 — 关系型知识锚点)           (1个)
- * 📘 文档查询: kg_doc(节点文档搜索/阅读/历史)                      (1个)
- * 🔬 代码分析: code_scan, code_smart_context, code_full_path      (3个)
- * 🏛️ 协作:    kg_meeting                                         (1个)
+ * kg_init       — 项目初始化
+ * kg_status     — 仪表盘
+ * kg_flowchart  — 知识图谱核心
+ * kg_workflow   — AI 工作流
+ * kg_task       — 任务管理
+ * kg_ref        — 外部参考 (fetch/list/get/delete)
+ * code_scan/code_smart_context/code_full_path — 代码分析 (可选)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerTools(server: McpServer, projectId: string, user: string, agentId: string, onProjectChange?: (newProjectId: string, newApiUrl: string) => void): void;

package/dist/tools/index.js

@@ -1,51 +1,30 @@
 /**
  * MCP 工具注册入口
- * 15 个工具, 9 个子模块
+ * 7 个工具, 6 个子模块
  *
- * 🔗 初始化:   kg_init                                           (1个)
- * 📊 导航:     kg_status                                         (1个)
- * 📚 知识:     kg_projects, kg_workflow                           (2个)
- * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区), kg_ref, kg_pitfall (5个)
- * 🔀 关系核心: kg_flowchart(逻辑流程图 — 关系型知识锚点)           (1个)
- * 📘 文档查询: kg_doc(节点文档搜索/阅读/历史)                      (1个)
- * 🔬 代码分析: code_scan, code_smart_context, code_full_path      (3个)
- * 🏛️ 协作:    kg_meeting                                         (1个)
+ * kg_init       — 项目初始化
+ * kg_status     — 仪表盘
+ * kg_flowchart  — 知识图谱核心
+ * kg_workflow   — AI 工作流
+ * kg_task       — 任务管理
+ * kg_ref        — 外部参考 (fetch/list/get/delete)
+ * code_scan/code_smart_context/code_full_path — 代码分析 (可选)
  */
 import { createContext } from './shared.js';
 import { registerInitTool } from './init.js';
 import { registerStatusTool } from './kg_status.js';
-import { registerProjectTools } from './projects.js';
 import { registerWorkflowTools } from './workflow.js';
 import { registerTaskTools } from './tasks.js';
-import { registerFileTools } from './files.js';
-import { registerDiscussionTools } from './discussion.js';
 import { registerReferenceTools } from './refs.js';
-import { registerPitfallTools } from './pitfalls.js';
 import { registerAnalyzerTools } from './analyzer.js';
-import { registerMeetingTools } from './meeting.js';
 import { registerFlowchartTools } from './flowchart.js';
-import { registerDocQueryTools } from './doc_query.js';
 export function registerTools(server, projectId, user, agentId, onProjectChange) {
     const ctx = createContext(projectId, user, agentId);
-    // 🔗 初始化
     registerInitTool(server, ctx, onProjectChange || (() => { }));
-    // 📊 导航
     registerStatusTool(server, ctx);
-    // 📚 知识
-    registerProjectTools(server, ctx);
     registerWorkflowTools(server, ctx);
-    // 📝 工作流
     registerTaskTools(server, ctx);
-    registerFileTools(server);
-    registerDiscussionTools(server, ctx);
     registerReferenceTools(server);
-    registerPitfallTools(server);
-    // 🔬 代码分析
     registerAnalyzerTools(server, ctx);
-    // 🏛️ 多AI协作
-    registerMeetingTools(server, ctx);
-    // 🔀 流程图
     registerFlowchartTools(server, ctx);
-    // 📘 文档查询
-    registerDocQueryTools(server, ctx);
 }

package/dist/tools/init.js

@@ -49,7 +49,7 @@ function readPpdocsFrom(dir) {
     }
 }
 export function registerInitTool(server, ctx, onProjectChange) {
-    server.tool('kg_init', '🔗 项目上下文初始化 — 读取指定目录的 .ppdocs 配置，切换 MCP 连接到对应项目。首次对话必须调用。不传 projectPath 则使用当前工作目录', {
+    server.tool('kg_init', '项目上下文初始化。读取指定目录的 .ppdocs 配置，切换 MCP 连接到对应项目。首次对话必须调用。不传 projectPath 则使用当前工作目录', {
         projectPath: z.string().optional().describe('项目根目录的绝对路径(含 .ppdocs 文件)，不传则使用 cwd'),
     }, async ({ projectPath }) => safeTool(async () => {
         const targetDir = projectPath || process.cwd();

package/dist/tools/kg_status.d.ts

@@ -1,5 +1,5 @@
 /**
- * 📊 kg_status — 项目速览仪表盘
+ * kg_status — 项目速览仪表盘
  * 一次调用返回项目全貌：摘要、核心模块、活跃任务、快速导航
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';

package/dist/tools/kg_status.js

@@ -1,20 +1,18 @@
 /**
- * 📊 kg_status — 项目速览仪表盘
+ * kg_status — 项目速览仪表盘
  * 一次调用返回项目全貌：摘要、核心模块、活跃任务、快速导航
  */
 import { getClient } from '../storage/httpClient.js';
 import { wrap, safeTool } from './shared.js';
 export function registerStatusTool(server, ctx) {
     const client = () => getClient();
-    server.tool('kg_status', '📊 项目速览仪表盘 — 一键了解项目健康。返回: 流程图节点数、活跃任务数、最近变更。每次对话开始建议首先调用', {}, async () => safeTool(async () => {
-        const [charts, activeTasks, discussions, mainChart] = await Promise.all([
+    server.tool('kg_status', '项目速览仪表盘。返回流程图节点数、活跃任务数、最近变更。每次对话开始建议首先调用', {}, async () => safeTool(async () => {
+        const [charts, activeTasks, mainChart] = await Promise.all([
             client().listFlowcharts(),
             client().listTasks('active'),
-            client().discussionList().catch(() => []),
             client().getFlowchart('main').catch(() => null),
         ]);
         const nodeCount = charts.reduce((sum, c) => sum + (c.nodeCount || 0), 0);
-        const activeDiscussions = discussions.filter((d) => d.status === 'active');
         const lines = [
             `# 项目速览 [${ctx.projectId}]`,
             `身份: ${ctx.user}:${ctx.agentId}`,
@@ -42,7 +40,7 @@ export function registerStatusTool(server, ctx) {
             }
         }
         // --- 当前状态 ---
-        lines.push('', '## 当前状态', `- 流程图: ${charts.length} 张 | 节点: ${nodeCount} 个`, `- 活跃任务: ${activeTasks.length} 个`, `- 活跃讨论: ${activeDiscussions.length} 个`);
+        lines.push('', '## 当前状态', `- 流程图: ${charts.length} 张 | 节点: ${nodeCount} 个`, `- 活跃任务: ${activeTasks.length} 个`);
         if (activeTasks.length > 0) {
             lines.push('', '### 进行中的任务');
             for (const t of activeTasks.slice(0, 5)) {

package/dist/tools/refs.js

@@ -9,36 +9,12 @@ function formatBytes(bytes) {
         return `${(bytes / 1024).toFixed(1)} KB`;
     return `${(bytes / 1048576).toFixed(1)} MB`;
 }
-const linkSchema = z.object({
-    url: z.string(),
-    label: z.string(),
-});
-const fileSchema = z.object({
-    name: z.string(),
-    path: z.string(),
-});
-const adoptedNodeSchema = z.object({
-    chartId: z.string(),
-    nodeId: z.string(),
-    nodeLabel: z.string(),
-});
 export function registerReferenceTools(server) {
     const client = () => getClient();
-    server.tool('kg_ref', '📎 外部参考 — 管理项目引用的第三方资料、链接、脚本和样例文件。\n' +
-        '涉及参考资料时主动调用：list 查看已有 → get 读详情 → read_file 读附件内容 → save 新增。\n' +
-        '★ fetch: 输入URL自动拉取网页内容到本地，生成解析报告，支持持续更新（refetch）。\n' +
-        '★ import_file: 导入本地文件内容到参考系统（自动保存内容副本+版本追踪）。\n' +
-        'actions: list|get|save|delete|read_file|fetch|refetch|import_file|reimport', {
-        action: z.enum(['list', 'get', 'save', 'delete', 'read_file', 'fetch', 'refetch', 'import_file', 'reimport']).describe('操作类型'),
-        id: z.string().optional().describe('参考 ID'),
-        title: z.string().optional().describe('参考标题 (save)'),
-        summary: z.string().optional().describe('Markdown 总结 (save)'),
-        links: z.array(linkSchema).optional().describe('参考链接 (save)'),
-        files: z.array(fileSchema).optional().describe('参考文件 (save)'),
-        scripts: z.array(fileSchema).optional().describe('解析脚本 (save)'),
-        adoptedBy: z.array(adoptedNodeSchema).optional().describe('已采用该参考的节点 (save)'),
-        path: z.string().optional().describe('参考文件路径 (read_file/import_file)'),
-        url: z.string().optional().describe('要拉取的文档 URL (fetch/refetch)'),
+    server.tool('kg_ref', '外部参考管理。fetch: 输入URL拉取网页内容到本地持久化。list/get/delete: 管理已有参考。\nactions: list|get|fetch|delete', {
+        action: z.enum(['list', 'get', 'fetch', 'delete']).describe('操作类型'),
+        id: z.string().optional().describe('参考 ID (get/delete/fetch时指定ID则为refetch)'),
+        url: z.string().optional().describe('要拉取的文档 URL (fetch)'),
     }, async (args) => safeTool(async () => {
         const decoded = decodeObjectStrings(args);
         switch (decoded.action) {
@@ -47,20 +23,20 @@ export function registerReferenceTools(server) {
                 if (refs.length === 0)
                     return wrap('当前没有外部参考');
                 const lines = [
-                    `📎 外部参考 (${refs.length})`,
+                    `外部参考 (${refs.length})`,
                     '',
-                    '| ID | 标题 | 链接 | 文件 | 拉取 | 已采用 |',
-                    '|:---|:---|---:|---:|---:|---:|',
+                    '| ID | 标题 | 链接 | 文件 | 拉取次数 |',
+                    '|:---|:---|---:|---:|---:|',
                 ];
                 for (const ref of refs) {
                     const fetchCount = ref.fetchHistory?.length || 0;
-                    lines.push(`| ${ref.id} | ${ref.title} | ${ref.links.length} | ${ref.files.length} | ${fetchCount} | ${ref.adoptedBy.length} |`);
+                    lines.push(`| ${ref.id} | ${ref.title} | ${ref.links.length} | ${ref.files.length} | ${fetchCount} |`);
                 }
                 return wrap(lines.join('\n'));
             }
             case 'get': {
                 if (!decoded.id)
-                    return wrap('❌ get 需要 id');
+                    return wrap('get 需要 id');
                 const ref = await client().getReference(decoded.id);
                 if (!ref)
                     return wrap(`未找到外部参考: ${decoded.id}`);
@@ -70,8 +46,6 @@ export function registerReferenceTools(server) {
                     `- ID: ${ref.id}`,
                     `- Links: ${ref.links.length}`,
                     `- Files: ${ref.files.length}`,
-                    `- Scripts: ${ref.scripts.length}`,
-                    `- AdoptedBy: ${ref.adoptedBy.length}`,
                 ];
                 if (ref.sourceUrl) {
                     lines.push(`- SourceURL: ${ref.sourceUrl}`);
@@ -95,12 +69,6 @@ export function registerReferenceTools(server) {
                         lines.push(`- ${file.name}: ${file.path}`);
                     }
                 }
-                if (ref.scripts.length > 0) {
-                    lines.push('', '## Scripts');
-                    for (const script of ref.scripts) {
-                        lines.push(`- ${script.name}: ${script.path}`);
-                    }
-                }
                 if (ref.fetchHistory && ref.fetchHistory.length > 0) {
                     lines.push('', '## Fetch History');
                     lines.push('| # | 时间 | 标题 | 大小 | 文件 |');
@@ -109,160 +77,58 @@ export function registerReferenceTools(server) {
                         lines.push(`| ${i + 1} | ${h.fetchedAt.substring(0, 19)} | ${h.title} | ${formatBytes(h.contentLength)} | ${h.contentFile} |`);
                     });
                 }
-                if (ref.adoptedBy.length > 0) {
-                    lines.push('', '## AdoptedBy');
-                    for (const node of ref.adoptedBy) {
-                        lines.push(`- ${node.nodeLabel} [${node.chartId}/${node.nodeId}]`);
-                    }
-                }
                 return wrap(lines.join('\n'));
             }
-            case 'save': {
-                if (!decoded.id)
-                    return wrap('❌ save 需要 id');
-                if (!decoded.title)
-                    return wrap('❌ save 需要 title');
-                const existing = await client().getReference(decoded.id);
-                const now = new Date().toISOString();
-                // 直接传递原始路径给后端, Rust save_reference 会自动:
-                // 1. 检测绝对路径文件
-                // 2. 复制到公共文件池/外部参考/{项目名}/
-                // 3. 复制到 ref-files/ (供 read_file API 读取)
-                // 4. 替换为相对路径保存
-                await client().saveReference({
-                    id: decoded.id,
-                    title: decoded.title,
-                    summary: decoded.summary || existing?.summary || '',
-                    links: decoded.links || existing?.links || [],
-                    files: decoded.files || existing?.files || [],
-                    scripts: decoded.scripts || existing?.scripts || [],
-                    adoptedBy: decoded.adoptedBy || existing?.adoptedBy || [],
-                    createdAt: existing?.createdAt || now,
-                    updatedAt: now,
-                });
-                return wrap(`✅ 外部参考已保存 (${decoded.id})`);
-            }
-            case 'delete': {
-                if (!decoded.id)
-                    return wrap('❌ delete 需要 id');
-                const ok = await client().deleteReference(decoded.id);
-                return wrap(ok ? `✅ 外部参考已删除 (${decoded.id})` : `ℹ️ 未找到外部参考 (${decoded.id})`);
-            }
-            case 'read_file': {
-                if (!decoded.path)
-                    return wrap('❌ read_file 需要 path');
-                const content = await client().readReferenceFile(decoded.path);
-                return wrap(content);
-            }
             case 'fetch': {
+                // 如果提供了 id 但没有 url，视为 refetch（从已有参考的 sourceUrl 重新拉取）
+                if (!decoded.url && decoded.id) {
+                    const ref = await client().getReference(decoded.id);
+                    if (!ref)
+                        return wrap(`未找到参考: ${decoded.id}`);
+                    if (!ref.sourceUrl)
+                        return wrap(`参考 ${decoded.id} 没有 sourceUrl，请提供 url 参数`);
+                    const result = await client().fetchRefUrl(ref.sourceUrl, decoded.id);
+                    return wrap([
+                        `文档已重新拉取 (第 ${result.fetchCount} 次)`,
+                        '',
+                        `| 字段 | 值 |`,
+                        `|:---|:---|`,
+                        `| 参考 ID | ${result.refId} |`,
+                        `| 标题 | ${result.title} |`,
+                        `| 内容大小 | ${formatBytes(result.contentLength)} |`,
+                        '',
+                        '### 内容预览',
+                        '',
+                        result.contentPreview.substring(0, 300),
+                    ].join('\n'));
+                }
                 if (!decoded.url)
-                    return wrap('❌ fetch 需要 url (要拉取的文档地址)');
+                    return wrap('fetch 需要 url (要拉取的文档地址)');
                 const result = await client().fetchRefUrl(decoded.url, decoded.id);
                 const lines = [
-                    `✅ 文档已拉取并保存`,
+                    `文档已拉取并保存`,
                     '',
                     `| 字段 | 值 |`,
                     `|:---|:---|`,
                     `| 参考 ID | ${result.refId} |`,
                     `| 标题 | ${result.title} |`,
-                    `| 内容文件 | ${result.contentFile} |`,
                     `| 内容大小 | ${formatBytes(result.contentLength)} |`,
                     `| 累计拉取 | ${result.fetchCount} 次 |`,
                     '',
                     '### 内容预览',
                     '',
                     result.contentPreview.substring(0, 500),
-                    '',
-                    `> 💡 用 \`kg_ref(get, id:"${result.refId}")\` 查看完整详情`,
-                    `> 💡 用 \`kg_ref(read_file, path:"${result.contentFile}")\` 读取完整内容`,
-                    `> 💡 用 \`kg_ref(refetch, id:"${result.refId}")\` 重新拉取最新版本`,
-                ];
-                return wrap(lines.join('\n'));
-            }
-            case 'refetch': {
-                if (!decoded.id)
-                    return wrap('❌ refetch 需要 id (参考 ID)');
-                const ref = await client().getReference(decoded.id);
-                if (!ref)
-                    return wrap(`❌ 未找到参考: ${decoded.id}`);
-                const refetchUrl = decoded.url || ref.sourceUrl;
-                if (!refetchUrl)
-                    return wrap(`❌ 参考 ${decoded.id} 没有 sourceUrl，请提供 url 参数`);
-                const result = await client().fetchRefUrl(refetchUrl, decoded.id);
-                const lines = [
-                    `✅ 文档已重新拉取 (第 ${result.fetchCount} 次)`,
-                    '',
-                    `| 字段 | 值 |`,
-                    `|:---|:---|`,
-                    `| 参考 ID | ${result.refId} |`,
-                    `| 标题 | ${result.title} |`,
-                    `| 新内容文件 | ${result.contentFile} |`,
-                    `| 内容大小 | ${formatBytes(result.contentLength)} |`,
-                    '',
-                    '### 内容预览',
-                    '',
-                    result.contentPreview.substring(0, 300),
                 ];
                 return wrap(lines.join('\n'));
             }
-            case 'import_file': {
-                if (!decoded.id)
-                    return wrap('❌ import_file 需要 id (参考 ID)');
-                if (!decoded.path)
-                    return wrap('❌ import_file 需要 path (本地文件路径)');
-                const result = await client().importLocalFile(decoded.id, decoded.path);
-                const lines = [
-                    `✅ 文件内容已导入参考系统`,
-                    '',
-                    `| 字段 | 值 |`,
-                    `|:---|:---|`,
-                    `| 参考 ID | ${result.refId} |`,
-                    `| 源文件 | ${result.sourcePath} |`,
-                    `| 存储文件 | ${result.storedFile} |`,
-                    `| 内容大小 | ${formatBytes(result.contentLength)} |`,
-                    `| 累计导入 | ${result.importCount} 次 |`,
-                    '',
-                    '### 内容预览',
-                    '',
-                    result.contentPreview.substring(0, 300),
-                    '',
-                    `> 💡 用 \`kg_ref(read_file, path:"${result.storedFile}")\` 读取完整内容`,
-                    `> 💡 用 \`kg_ref(reimport, id:"${result.refId}", path:"${result.sourcePath}")\` 重新导入最新版本`,
-                ];
-                return wrap(lines.join('\n'));
-            }
-            case 'reimport': {
+            case 'delete': {
                 if (!decoded.id)
-                    return wrap('❌ reimport 需要 id (参考 ID)');
-                const ref = await client().getReference(decoded.id);
-                if (!ref)
-                    return wrap(`❌ 未找到参考: ${decoded.id}`);
-                // 获取源文件路径: 优先使用参数中的 path, 否则取最后一次导入的源路径
-                const reimportPath = decoded.path ||
-                    (ref.fileImportHistory && ref.fileImportHistory.length > 0
-                        ? ref.fileImportHistory[ref.fileImportHistory.length - 1].sourcePath
-                        : null);
-                if (!reimportPath)
-                    return wrap(`❌ 参考 ${decoded.id} 没有导入历史，请提供 path 参数`);
-                const result = await client().importLocalFile(decoded.id, reimportPath);
-                const lines = [
-                    `✅ 文件已重新导入 (第 ${result.importCount} 次)`,
-                    '',
-                    `| 字段 | 值 |`,
-                    `|:---|:---|`,
-                    `| 参考 ID | ${result.refId} |`,
-                    `| 源文件 | ${result.sourcePath} |`,
-                    `| 新存储文件 | ${result.storedFile} |`,
-                    `| 内容大小 | ${formatBytes(result.contentLength)} |`,
-                    '',
-                    '### 内容预览',
-                    '',
-                    result.contentPreview.substring(0, 300),
-                ];
-                return wrap(lines.join('\n'));
+                    return wrap('delete 需要 id');
+                const ok = await client().deleteReference(decoded.id);
+                return wrap(ok ? `外部参考已删除 (${decoded.id})` : `未找到外部参考 (${decoded.id})`);
             }
             default:
-                return wrap(`❌ 未知 action: ${decoded.action}`);
+                return wrap(`未知 action: ${decoded.action}`);
         }
     }));
 }

package/dist/tools/tasks.d.ts

@@ -1,6 +1,5 @@
 /**
- * 📝 kg_task (4→1) — 极简任务管理
- * AI 只需说人话写内容，后端负责所有格式化、分类、时间戳
+ * kg_task — 任务管理
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { type McpContext } from './shared.js';