@ppdocs/mcp 3.2.34 → 3.2.36

package/templates/kiro-rules/ppdocs.md

@@ -1,142 +1,63 @@
-你是严谨的软件架构师，以**知识图谱流程图**为唯一真理源，以**任务系统**为记忆链。确保每个变动有据可查，每步执行都有验证和记录。
-
-## 核心铁律 (全局强制)
-
-| 铁律 | 要求 |
-|:---|:---|
-| **图谱先行** | 动手前必须查流程图 `kg_flowchart(get/get_node)` + 节点文档，禁止凭记忆或猜测 |
-| **任务驱动** | 所有工作必须 `kg_task(create)` 创建记录，每完成一步立即 `kg_task(update)` |
-| **逐步闭环** | 执行一步 → 验证一步 → 记录一步，禁止批量执行后补记 |
-| **实时回写** | 代码变更后立即 `kg_flowchart(bind/update_node)` 更新流程图，不留脱节 |
-| **规则引用** | 编码前 `kg_rules(get, "codeStyle")`；审查前 `kg_rules(get, "reviewRules")` |
-
----
-
-## 会话启动 (每次对话必执行)
-
-```
-kg_init()                                          → 连接项目
-kg_status()                                        → 仪表盘
-kg_task(action:"get", status:"active")             → 检查未完成任务
-kg_discuss(action:"list")                          → 检查待回复讨论
-```
-
-- 有活跃任务 → 提醒用户
-- 有待处理讨论 → 提醒用户
-
----
-
-## 方案制定 (第一性原理)
-
-**任何需求，先设计逻辑流程，再写代码。禁止跳过设计直接编码。**
-
-### Phase A: 第一性原理分析
-```
-1. 拆解需求本质: 这个功能的核心目的是什么？
-2. 识别输入/输出: 进什么 → 出什么？
-3. 查图谱现状:   kg_flowchart(get) → 哪些模块已存在可复用？
-4. 最小化依赖:   能否用最少的模块、最短的路径实现？
-```
-
-### Phase B: 逻辑流程设计
-```
-用 ASCII 流程图画出完整逻辑:
-
-  +----------+     +----------+     +----------+
-  | 输入     | --> | 处理逻辑 | --> | 输出     |
-  +----------+     +----+-----+     +----------+
-                        |
-                   +----v-----+
-                   | 异常分支 |
-                   +----------+
-
-向用户展示流程图，确认逻辑正确后再继续。
-```
-
-### Phase C: 细化逻辑节点
-```
-对流程图中每个节点，依次向下细化:
-  1. 定义接口: 输入参数 + 返回值
-  2. 选择实现: 复用现有 / 新建模块
-  3. 标注依赖: 上游数据来源 + 下游消费者
-  4. 异常处理: 每个节点的失败路径
-```
-
-### Phase D: 按流程执行 + 审查
-```
-按 Phase B 确认的逻辑流程，逐节点实现:
-  使用 Step 3 的逐步执行循环 (执行→验证→记录→回写)
-
-全部完成后:
-  对照逻辑流程图进行审查，确保实现与设计一致
-```
-
----
-
-## 标准执行流程
-
-### Step 1: 知识锚定 (理解需求时)
-```
-kg_flowchart(action:"get")                         → 主图全貌
-kg_flowchart(action:"get_node", nodeId:目标, expand:2,
-  includeDoc:true, includeFiles:true)              → 节点详情+上下游
-kg_tree()                                          → 文档全景
-kg_rules(action:"get")                             → 编码/审查规则
-```
-输出: 涉及模块 + 关键文档 + 现有逻辑 + 待确认点
-
-### Step 2: 创建任务 (开工前)
-```
-kg_task(action:"create", title:"...", goals:[...], bindTo:节点ID)
-```
-
-### Step 3: 逐步执行 (核心循环)
-```
-每个步骤严格执行:
-  3.1 执行 → 编码/修改
-  3.2 验证 → 编译/推演/测试
-  3.3 记录 → kg_task(action:"update", taskId, content:"做了什么+验证结果")
-  3.4 回写 → kg_flowchart(bind/update_node) + kg_doc(update)
-```
-
-### Step 4: 归档
-```
-kg_task(action:"archive", summary, difficulties, solutions)
-```
-
----
-
-## 任务日志类型
-
-| 类型 | 用途 | 何时记录 |
-|:---|:---|:---|
-| `progress` | 阶段进度 | 每完成一个步骤 |
-| `issue` | 遇到问题 | 发现问题时**立即** |
-| `solution` | 解决方案 | 找到方案时**立即** |
-| `reference` | 参考资料 | 发现有用资料时 |
-
----
-
-## 流程图回写规则
-
-| 场景 | 操作 |
-|:---|:---|
-| 修改已有文件 | `kg_flowchart(action:"bind", nodeId, files:[...])` |
-| 功能逻辑变更 | `kg_flowchart(action:"update_node", nodeId, description, docContent)` |
-| 创建新文件/模块 | `kg_flowchart(action:"batch_add")` + `bind` + `kg_doc(create)` |
-| 删除文件 | `kg_flowchart(action:"unbind")` + 标记废弃 |
-
----
-
-## 异常处理
-
-| 场景 | 处理 |
-|:---|:---|
-| 图谱找不到节点 | 询问用户，不猜测 |
-| 测试失败 | `kg_task(update, log_type:"issue")` → 分析 → 修复 |
-| 重复造轮子 | 终止 → 指出现有实现 → 复用 |
-
-## 沟通规范
-- 逻辑流程: ASCII 流程图
-- 对比分析: Markdown 表格
-- 代码: 极简模块化，清理残留
+????????????**????**????????**????**????????????????????????
+
+## 0. ????
+
+```text
+kg_init()                 -> ????
+kg_status()               -> ???????
+kg_task(action:"get")     -> ?? active ??
+kg_discuss(action:"list") -> ???????
+```
+
+## 1. ????????
+
+- ??: `kg_flowchart(action:"list|get|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart")`
+- ??: `kg_rules(action:"get|save|get_meta|save_meta")`
+- ??: `kg_task(action:"create|get|update|archive|delete")`
+- ??: `kg_files(action:"list|read|upload|download|public_*")`
+- ??/??: `kg_discuss(...)`, `kg_meeting(...)`
+- ????: `code_scan()`, `code_smart_context(symbolName)`, `code_full_path(symbolA, symbolB)`
+- ????: ?????????????????????????????? fallback????????????
+
+## 2. ?????
+
+### Step 1: ????
+1. ?? `kg_flowchart(get)` ????????? `kg_rules(get)` ?????
+2. ???????? `kg_flowchart(get_node, expand:2, includeDoc:true, includeFiles:true)`?
+3. ????? `subFlowchart`???????????????
+4. ??????????? `code_scan()`??? `code_smart_context` / `code_full_path`?
+5. ??????????????????????????
+
+### Step 2: ????
+1. ?????: `kg_task(create, title, goals, bindTo)`?
+2. ??? ASCII ????????????????
+3. ?????????????
+
+### Step 3: ????
+1. ????????????????
+2. ?????????????? `kg_task(update, log_type:"progress")` ???????
+3. ?????? `issue`??????? `solution`????????
+
+### Step 4: ????
+| ?? | ???? |
+|:---|:---|
+| ?????? | `kg_flowchart(bind, nodeId, files:[...])` |
+| ???? | `kg_flowchart(update_node, nodeId, description, docSummary, docContent)` |
+| ?????? | `kg_flowchart(batch_add)` + `bind` + `update_node(docSummary, docContent)` |
+| ?????? | `kg_flowchart(create_chart)`???????????? |
+| ??/???? | ?? `kg_files(upload/read/list/download)` ??????? `kg_flowchart(bind, files:[...])` |
+| ???? | ?? `kg_flowchart(update_node, docSummary, docContent)` ??? `docEntries` |
+
+## 3. ????
+
+- ?????????? -> ??????????
+- ???????/???? -> ??????????????????
+- ??????????????????JSON?????? fallback ???
+- ???? -> ??????????
+
+## 4. ????
+
+- ??????? ASCII ????
+- ???????? Markdown ???
+- ?????????????????????
+- ?????? / ????????????

package/dist/agent.d.ts

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-/**
- * PPDocs Agent V2 — 多项目管理入口
- * 功能: Web Config UI + 多 SyncBeacon + 持久后台运行
- */
-export {};

package/dist/agent.js

@@ -1,130 +0,0 @@
-#!/usr/bin/env node
-/**
- * PPDocs Agent V2 — 多项目管理入口
- * 功能: Web Config UI + 多 SyncBeacon + 持久后台运行
- */
-import { startWebServer, loadAgentConfig, setAgentState, setProjectStatus } from './web/server.js';
-import { initClient } from './storage/httpClient.js';
-import { SyncBeacon } from './sync/beacon.js';
-const DEFAULT_WEB_PORT = 20010;
-// 多项目 SyncBeacon 管理
-const beacons = new Map();
-async function main() {
-    console.log('📡 PPDocs Agent V2 starting...\n');
-    // 解析端口参数
-    let webPort = DEFAULT_WEB_PORT;
-    const args = process.argv.slice(2);
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === '--port' && args[i + 1]) {
-            webPort = parseInt(args[i + 1], 10) || DEFAULT_WEB_PORT;
-        }
-    }
-    // 加载配置
-    const config = loadAgentConfig();
-    if (config) {
-        webPort = config.webPort || webPort;
-        console.log(`📋 主机: ${config.host}:${config.port}`);
-        console.log(`📂 已绑定 ${config.projects.length} 个项目`);
-        // 测试主机连接
-        try {
-            const resp = await fetch(`http://${config.host}:${config.port}/health`);
-            setAgentState({ hostConnected: resp.ok });
-            if (resp.ok)
-                console.log('✅ 主机连接正常');
-        }
-        catch {
-            setAgentState({ hostConnected: false });
-            console.log('⚠️  主机不可达，将在后台重试');
-        }
-        // 为每个项目启动同步
-        for (const proj of config.projects) {
-            await startProjectSync(config, proj);
-        }
-    }
-    else {
-        console.log('⚙️  首次运行，请在浏览器中完成配置');
-    }
-    // 注册回调
-    setAgentState({
-        onBind: async (project) => {
-            const cfg = loadAgentConfig();
-            if (cfg)
-                await startProjectSync(cfg, project);
-        },
-        onUnbind: (remoteId) => {
-            stopProjectSync(remoteId);
-        },
-    });
-    // 启动 Web Server
-    startWebServer(webPort);
-    // 首次运行自动打开浏览器
-    if (!config) {
-        const url = `http://localhost:${webPort}`;
-        try {
-            const { exec } = await import('child_process');
-            const cmd = process.platform === 'win32' ? `start ${url}`
-                : process.platform === 'darwin' ? `open ${url}` : `xdg-open ${url}`;
-            exec(cmd);
-        }
-        catch { /* ignore */ }
-    }
-}
-async function startProjectSync(config, proj) {
-    const { host, port } = config;
-    const { remote, localDir, sync } = proj;
-    // 初始化该项目的 HTTP 连接 (验证)
-    const apiUrl = `http://${host}:${port}/api/${remote.id}/${remote.password}`;
-    try {
-        const resp = await fetch(`${apiUrl}/docs`);
-        if (resp.ok) {
-            const data = await resp.json();
-            const docCount = data.data?.length || 0;
-            setProjectStatus(remote.id, { connected: true, syncStatus: '已连接', docCount });
-            console.log(`  ✅ ${remote.name}: 已连接 (${docCount} 文档)`);
-        }
-        else {
-            setProjectStatus(remote.id, { connected: false, syncStatus: '连接失败' });
-            console.log(`  ❌ ${remote.name}: 连接失败`);
-            return;
-        }
-    }
-    catch (e) {
-        setProjectStatus(remote.id, { connected: false, syncStatus: `错误: ${e}` });
-        return;
-    }
-    // 启动 SyncBeacon
-    if (localDir && sync?.enabled) {
-        stopProjectSync(remote.id); // 先停旧的
-        // 需要临时给 httpClient 设置对应项目的 API URL
-        initClient(apiUrl);
-        const beacon = new SyncBeacon(localDir, remote.id, (sync.intervalSec || 15) * 1000);
-        beacon.start();
-        beacons.set(remote.id, beacon);
-        setProjectStatus(remote.id, { syncStatus: '同步中', lastSync: new Date() });
-        console.log(`  📂 ${remote.name}: 文件同步已启动`);
-    }
-}
-function stopProjectSync(remoteId) {
-    const beacon = beacons.get(remoteId);
-    if (beacon) {
-        beacon.stop();
-        beacons.delete(remoteId);
-        console.log(`  🛑 停止同步: ${remoteId}`);
-    }
-}
-// 优雅退出
-process.on('SIGINT', () => {
-    console.log('\n🛑 Agent 正在关闭...');
-    for (const [, beacon] of beacons)
-        beacon.stop();
-    process.exit(0);
-});
-process.on('SIGTERM', () => {
-    for (const [, beacon] of beacons)
-        beacon.stop();
-    process.exit(0);
-});
-main().catch(e => {
-    console.error('❌ Agent 启动失败:', e);
-    process.exit(1);
-});

package/dist/tools/docs.d.ts

@@ -1,8 +0,0 @@
-/**
- * 📄 kg_doc (5合1) + 🏗️ kg_tree (2合1)
- * 合并: kg_create_node, kg_delete_node, kg_update_node, kg_read_node, kg_copy_node
- *       kg_get_tree, kg_get_docs_by_status
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type McpContext } from './shared.js';
-export declare function registerDocTools(server: McpServer, ctx: McpContext): void;

package/dist/tools/docs.js

@@ -1,285 +0,0 @@
-/**
- * 📄 kg_doc (5合1) + 🏗️ kg_tree (2合1)
- * 合并: kg_create_node, kg_delete_node, kg_update_node, kg_read_node, kg_copy_node
- *       kg_get_tree, kg_get_docs_by_status
- */
-import { z } from 'zod';
-import { getClient } from '../storage/httpClient.js';
-import { decodeObjectStrings } from '../utils.js';
-import { wrap, safeTool, crossPrefix, formatDocMarkdown, formatTreeText, countTreeDocs } from './shared.js';
-export function registerDocTools(server, ctx) {
-    const client = () => getClient();
-    // ========== kg_doc: 文档 CRUD 统一入口 ==========
-    server.tool('kg_doc', '📄 参考文档 — action: create(创建,建议bindTo关联节点)|read|update|delete|batch_update|copy。⚠️ 不绑定节点的文档会成为孤岛!', {
-        action: z.enum(['create', 'read', 'update', 'delete', 'batch_update', 'copy'])
-            .describe('操作类型'),
-        path: z.string().optional()
-            .describe('文档路径(如"/前端/组件/Modal")。create/read/update/delete 必填'),
-        content: z.string().optional()
-            .describe('Markdown内容 (create/update)'),
-        summary: z.string().optional()
-            .describe('一句话简介 (create/update)'),
-        status: z.string().optional()
-            .describe('文档状态 (create/update, 默认"已完成")'),
-        versions: z.array(z.object({
-            version: z.number(), date: z.string(), changes: z.string()
-        })).optional().describe('版本记录 (update)'),
-        bugfixes: z.array(z.object({
-            date: z.string(), issue: z.string(), solution: z.string()
-        })).optional().describe('修复记录 (update)'),
-        updates: z.array(z.object({
-            nodeId: z.string().describe('文档路径'),
-            summary: z.string().optional(),
-            content: z.string().optional(),
-            status: z.string().optional(),
-            versions: z.array(z.object({
-                version: z.number(), date: z.string(), changes: z.string()
-            })).optional(),
-            bugfixes: z.array(z.object({
-                date: z.string(), issue: z.string(), solution: z.string()
-            })).optional()
-        })).optional().describe('批量更新数组 (batch_update)'),
-        targetProject: z.string().optional()
-            .describe('跨项目读取时的目标项目ID (read)'),
-        sourceProject: z.string().optional()
-            .describe('复制源项目ID (copy)'),
-        sourcePath: z.union([z.string(), z.array(z.string())]).optional()
-            .describe('复制源路径 (copy, 单个或数组)'),
-        targetPath: z.string().optional()
-            .describe('复制目标路径前缀 (copy)'),
-        bindTo: z.string().optional()
-            .describe('绑定到流程图节点ID (create/update, 如"n_frontend")'),
-        bindChart: z.string().optional()
-            .describe('绑定目标流程图ID (create/update, 默认"main")'),
-    }, async (args) => safeTool(async () => {
-        const d = decodeObjectStrings(args);
-        switch (d.action) {
-            // ---- CREATE ----
-            case 'create': {
-                if (!d.path)
-                    return wrap('❌ create 需要 path');
-                if (!d.content)
-                    return wrap('❌ create 需要 content');
-                const doc = await client().createDoc(d.path, {
-                    summary: d.summary || '',
-                    content: d.content,
-                    versions: [{ version: 0.1, date: new Date().toISOString(), changes: '初始创建' }],
-                    bugfixes: [],
-                    status: d.status || '已完成'
-                });
-                // 绑定到流程图节点
-                let bindMsg = '';
-                if (d.bindTo) {
-                    try {
-                        const chartId = d.bindChart || 'main';
-                        const chart = await client().getFlowchart(chartId);
-                        if (chart) {
-                            const node = chart.nodes?.find((n) => n.id === d.bindTo);
-                            if (node) {
-                                if (!node.boundDocs)
-                                    node.boundDocs = [];
-                                if (!node.boundDocs.includes(d.path)) {
-                                    node.boundDocs.push(d.path);
-                                }
-                                // Save back via PUT (use the existing save method)
-                                chart.id = chartId;
-                                await client().saveFlowchart(chartId, chart);
-                                bindMsg = `\n🔗 已绑定到节点: ${d.bindTo} [${chartId}]`;
-                            }
-                            else {
-                                bindMsg = `\n⚠️ 节点 "${d.bindTo}" 不存在于流程图 "${chartId}"`;
-                            }
-                        }
-                    }
-                    catch {
-                        bindMsg = `\n⚠️ 绑定失败(流程图操作异常)`;
-                    }
-                }
-                // 约束: 未绑定流程图节点 → 强制警告
-                if (!d.bindTo) {
-                    bindMsg = `\n\n⚠️ 【未关联知识锚点】文档未绑定到流程图节点!\n💡 建议: 使用 kg_flowchart(bind, nodeId, docs:["${d.path}"]) 绑定\n📌 孤立文档无法被 AI 通过节点关联发现`;
-                }
-                return wrap(`✅ 文档已创建: ${d.path}${bindMsg}`);
-            }
-            // ---- READ ----
-            case 'read': {
-                if (!d.path)
-                    return wrap('❌ read 需要 path');
-                const doc = d.targetProject
-                    ? await client().crossGetDoc(d.targetProject, d.path)
-                    : await client().getDoc(d.path);
-                if (!doc)
-                    return wrap(d.targetProject ? `文档不存在(项目: ${d.targetProject})` : '文档不存在');
-                const lines = formatDocMarkdown(doc, d.path);
-                return wrap(d.targetProject ? crossPrefix(d.targetProject) + lines.join('\n') : lines.join('\n'));
-            }
-            // ---- UPDATE ----
-            case 'update': {
-                if (!d.path)
-                    return wrap('❌ update 需要 path');
-                if (d.path === '/' || d.path === '_root') {
-                    // 根文档更新
-                    const existing = await client().getDoc('/');
-                    if (!existing)
-                        return wrap('更新失败(根文档不存在)');
-                    const updates = {};
-                    if (d.summary !== undefined)
-                        updates.summary = d.summary;
-                    if (d.content !== undefined)
-                        updates.content = d.content;
-                    const upd = await client().updateDoc('/', updates);
-                    return wrap(upd ? '✅ 项目介绍已更新' : '更新失败');
-                }
-                const existing = await client().getDoc(d.path);
-                if (!existing)
-                    return wrap('更新失败(文档不存在)');
-                const updates = {};
-                if (d.summary !== undefined)
-                    updates.summary = d.summary;
-                if (d.content !== undefined)
-                    updates.content = d.content;
-                if (d.status !== undefined)
-                    updates.status = d.status;
-                if (d.versions !== undefined)
-                    updates.versions = d.versions;
-                if (d.bugfixes !== undefined)
-                    updates.bugfixes = d.bugfixes;
-                const doc = await client().updateDoc(d.path, updates);
-                if (!doc)
-                    return wrap('更新失败');
-                return wrap(`✅ 文档已更新: ${d.path}\n状态: ${doc.status || '已完成'}\n摘要: ${doc.summary || ''}`);
-            }
-            // ---- DELETE ----
-            case 'delete': {
-                if (!d.path)
-                    return wrap('❌ delete 需要 path');
-                const paths = Array.isArray(d.path) ? d.path : [d.path];
-                const results = [];
-                for (const p of paths) {
-                    results.push({ path: p, success: await client().deleteDoc(p) });
-                }
-                if (paths.length === 1) {
-                    return wrap(results[0].success ? '删除成功' : '删除失败(文档不存在或是根文档)');
-                }
-                const ok = results.filter(r => r.success).length;
-                const failed = results.filter(r => !r.success).map(r => r.path);
-                let msg = `✅ 批量删除: ${ok}/${paths.length} 成功`;
-                if (failed.length > 0)
-                    msg += `\n❌ 失败: ${failed.join(', ')}`;
-                return wrap(msg);
-            }
-            // ---- BATCH UPDATE ----
-            case 'batch_update': {
-                if (!d.updates || !Array.isArray(d.updates))
-                    return wrap('❌ batch_update 需要 updates 数组');
-                const results = [];
-                for (const item of d.updates) {
-                    if (item.nodeId === '/' || item.nodeId === '_root') {
-                        results.push({ path: item.nodeId, success: false });
-                        continue;
-                    }
-                    const existing = await client().getDoc(item.nodeId);
-                    if (!existing) {
-                        results.push({ path: item.nodeId, success: false });
-                        continue;
-                    }
-                    const upd = {};
-                    if (item.summary !== undefined)
-                        upd.summary = item.summary;
-                    if (item.content !== undefined)
-                        upd.content = item.content;
-                    if (item.status !== undefined)
-                        upd.status = item.status;
-                    if (item.versions !== undefined)
-                        upd.versions = item.versions;
-                    if (item.bugfixes !== undefined)
-                        upd.bugfixes = item.bugfixes;
-                    const doc = await client().updateDoc(item.nodeId, upd);
-                    results.push({ path: item.nodeId, success: !!doc });
-                }
-                const ok = results.filter(r => r.success).length;
-                const failed = results.filter(r => !r.success).map(r => r.path);
-                let msg = `✅ 批量更新: ${ok}/${d.updates.length} 成功`;
-                if (failed.length > 0)
-                    msg += `\n❌ 失败: ${failed.join(', ')}`;
-                return wrap(msg);
-            }
-            // ---- COPY ----
-            case 'copy': {
-                if (!d.sourceProject)
-                    return wrap('❌ copy 需要 sourceProject');
-                if (!d.sourcePath)
-                    return wrap('❌ copy 需要 sourcePath');
-                const paths = Array.isArray(d.sourcePath) ? d.sourcePath : [d.sourcePath];
-                const results = [];
-                for (const srcPath of paths) {
-                    try {
-                        const doc = await client().crossGetDoc(d.sourceProject, srcPath);
-                        if (!doc) {
-                            results.push({ path: srcPath, success: false, error: '源文档不存在' });
-                            continue;
-                        }
-                        const destPath = d.targetPath
-                            ? `${d.targetPath.replace(/\/$/, '')}${srcPath}`
-                            : srcPath;
-                        const existing = await client().getDoc(destPath);
-                        if (existing) {
-                            await client().updateDoc(destPath, { summary: doc.summary, content: doc.content });
-                        }
-                        else {
-                            await client().createDoc(destPath, { summary: doc.summary, content: doc.content, status: doc.status });
-                        }
-                        results.push({ path: destPath, success: true });
-                    }
-                    catch (e) {
-                        results.push({ path: srcPath, success: false, error: String(e) });
-                    }
-                }
-                const ok = results.filter(r => r.success).length;
-                if (paths.length === 1) {
-                    return wrap(results[0].success
-                        ? `✅ 已复制: ${results[0].path}\n来源: [${d.sourceProject}] ${paths[0]}`
-                        : `❌ 复制失败: ${results[0].error}`);
-                }
-                const failed = results.filter(r => !r.success);
-                let msg = `✅ 批量复制: ${ok}/${paths.length} 成功`;
-                if (failed.length > 0)
-                    msg += `\n❌ 失败:\n${failed.map(f => `  - ${f.path}: ${f.error}`).join('\n')}`;
-                return wrap(msg);
-            }
-            default:
-                return wrap(`❌ 未知 action: ${d.action}`);
-        }
-    }));
-    // ========== kg_tree: 知识全景图 ==========
-    server.tool('kg_tree', '🏗️ 项目知识全景图 ★最快了解项目的方式★ 获取完整知识库目录树(含文档数统计)。传 statusFilter 可筛选特定状态文档。建议任何操作前先调用获取全局视图', {
-        statusFilter: z.array(z.string()).optional()
-            .describe('按状态筛选(如["未完成","待修复"])，不传则展示全景目录树'),
-        targetProject: z.string().optional()
-            .describe('跨项目查看，填目标项目ID或名称'),
-    }, async (args) => safeTool(async () => {
-        // 状态筛选模式
-        if (args.statusFilter && args.statusFilter.length > 0) {
-            const docs = args.targetProject
-                ? await client().crossGetDocsByStatus(args.targetProject, args.statusFilter)
-                : await client().getDocsByStatus(args.statusFilter);
-            if (docs.length === 0) {
-                return wrap(`未找到状态为 [${args.statusFilter.join(', ')}] 的文档${args.targetProject ? `(项目: ${args.targetProject})` : ''}`);
-            }
-            const lines = docs.map(d => `- ${d.path} (${d.status || '已完成'}): ${d.summary || '无简介'}`);
-            const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
-            return wrap(`${prefix}找到 ${docs.length} 个文档:\n\n${lines.join('\n')}`);
-        }
-        // 全景目录树模式
-        const tree = args.targetProject
-            ? await client().crossGetTree(args.targetProject)
-            : await client().getTree();
-        if (!tree || tree.length === 0) {
-            return wrap(args.targetProject ? `知识库为空(项目: ${args.targetProject})` : '知识库为空');
-        }
-        const treeText = formatTreeText(tree);
-        const docCount = countTreeDocs(tree);
-        const prefix = args.targetProject ? crossPrefix(args.targetProject) : '';
-        return wrap(`${prefix}共 ${docCount} 个文档\n\n${treeText}`);
-    }));
-}

package/dist/tools/helpers.d.ts

@@ -1,37 +0,0 @@
-/**
- * MCP 工具辅助函数
- */
-import type { DocData } from '../storage/types.js';
-/**
- * 包装返回结果为 MCP 格式
- */
-export declare function wrap(text: string): {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-};
-/**
- * 格式化文档为 Markdown 输出
- */
-export declare function formatDocMarkdown(doc: DocData, path: string): string[];
-interface TreeNode {
-    path: string;
-    name: string;
-    summary?: string;
-    isDir: boolean;
-    children?: TreeNode[];
-}
-/**
- * 格式化树为文本
- */
-export declare function formatTreeText(tree: TreeNode[]): string;
-/**
- * 统计树中的文档数
- */
-export declare function countTreeDocs(tree: TreeNode[]): number;
-/**
- * 格式化文件大小
- */
-export declare function formatFileSize(bytes: number): string;
-export {};