@ppdocs/mcp 3.12.0 → 3.13.1

package/dist/tools/discussion.d.ts

@@ -1,15 +0,0 @@
-/**
- * 💬 kg_discuss (8 actions)
- * 合并: list, read, create, reply, close, delete, complete, history
- * 统一走 HTTP → Rust 后端 (单一写入者)
- * sender 格式: "projectId:user" (如 "p-ca3sgejg:张三")
- *
- * 权限模型:
- *   list/history  — 任何人可列出(全局可见)
- *   create        — 任何人可发起(指定参与项目ID)
- *   read/reply    — 仅讨论组内成员(initiator + participants)
- *   complete/close/delete — 仅发起人
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type McpContext } from './shared.js';
-export declare function registerDiscussionTools(server: McpServer, ctx: McpContext): void;

package/dist/tools/discussion.js

@@ -1,264 +0,0 @@
-/**
- * 💬 kg_discuss (8 actions)
- * 合并: list, read, create, reply, close, delete, complete, history
- * 统一走 HTTP → Rust 后端 (单一写入者)
- * sender 格式: "projectId:user" (如 "p-ca3sgejg:张三")
- *
- * 权限模型:
- *   list/history  — 任何人可列出(全局可见)
- *   create        — 任何人可发起(指定参与项目ID)
- *   read/reply    — 仅讨论组内成员(initiator + participants)
- *   complete/close/delete — 仅发起人
- */
-import { z } from 'zod';
-import { getClient } from '../storage/httpClient.js';
-import { decodeObjectStrings } from '../utils.js';
-import { wrap, safeTool } from './shared.js';
-function sender(ctx) {
-    return `${ctx.projectId}:${ctx.user}:${ctx.agentId}`;
-}
-/** 提取 sender 中的 projectId */
-function senderProjectId(senderStr) {
-    return senderStr.split(':')[0] || senderStr;
-}
-/** 检查项目是否是讨论的成员 (发起方 或 参与方) */
-function isMember(brief, projectId) {
-    const initiatorPid = senderProjectId(brief.initiator);
-    if (initiatorPid === projectId)
-        return true;
-    return brief.participants.some(p => {
-        // participants 可能是 "projectId" 或 "projectId:user"
-        return senderProjectId(p) === projectId;
-    });
-}
-/** 检查是否是讨论的发起人 */
-function isInitiator(brief, me, projectId) {
-    return brief.initiator === me || senderProjectId(brief.initiator) === projectId;
-}
-/** 根据 ID 获取讨论摘要 (用于权限检查) */
-async function getBrief(discussionId) {
-    try {
-        const all = await getClient().discussionList();
-        return all.find(d => d.id === discussionId) || null;
-    }
-    catch {
-        return null;
-    }
-}
-function relativeTime(iso) {
-    try {
-        const diff = Date.now() - new Date(iso).getTime();
-        if (diff < 60000)
-            return '刚刚';
-        if (diff < 3600000)
-            return `${Math.floor(diff / 60000)}分钟前`;
-        if (diff < 86400000)
-            return `${Math.floor(diff / 3600000)}小时前`;
-        return `${Math.floor(diff / 86400000)}天前`;
-    }
-    catch {
-        return iso;
-    }
-}
-function formatList(items, ctx) {
-    const lines = [
-        `本项目: ${sender(ctx)}`,
-        ``,
-        `📋 活跃讨论 (${items.length}个)`,
-        ``,
-        `| ID | 标题 | 发起方 | 参与方 | 摘要 | 回复 | 更新 |`,
-        `|:---|:---|:---|:---|:---|:---:|:---|`,
-    ];
-    for (const d of items) {
-        const others = d.participants.filter(p => p !== d.initiator).join(', ') || '—';
-        const memberTag = isMember(d, ctx.projectId) ? '✅' : '🔒';
-        lines.push(`| ${d.id} | ${memberTag} ${d.title} | ${d.initiator} | ${others} | ${d.summary} | ${d.status} | ${relativeTime(d.updatedAt)} |`);
-    }
-    lines.push('');
-    lines.push('✅ = 你是成员(可读写) | 🔒 = 非成员(仅可查看标题)');
-    return lines.join('\n');
-}
-function formatDetailView(d) {
-    const msgs = d.messages || [];
-    const lines = [
-        `💬 ${d.title}`,
-        `发起: ${d.initiator} | 参与: ${d.participants.length}方 | 状态: ${d.status}`,
-        `📌 ${d.summary}`,
-        `📊 总消息: ${d.totalCount} | 未读: ${d.unreadCount}`,
-        ``,
-    ];
-    msgs.forEach((m, i) => {
-        const readTag = m.isRead ? '📖' : '🆕';
-        lines.push(`--- ${readTag} 消息 ${i + 1}/${msgs.length} [${m.sender}] ${relativeTime(m.timestamp)} ---`);
-        // 已读且无 content → 显示摘要
-        if (m.isRead && !m.content) {
-            lines.push(`[摘要] ${m.summary}`);
-        }
-        else {
-            lines.push(m.content || m.summary || '(无内容)');
-        }
-        lines.push('');
-    });
-    return lines.join('\n');
-}
-export function registerDiscussionTools(server, ctx) {
-    const client = () => getClient();
-    server.tool('kg_discuss', '💬 跨项目讨论 — action 可选: 省略时无 id/ids 则列出讨论，有 id/ids 则读取详情。亦可显式指定 list|read|create|reply|complete|close|delete|history。权限: 仅成员可读写，仅发起人可删除/归档', {
-        action: z.enum(['list', 'read', 'create', 'reply', 'complete', 'close', 'delete', 'history']).optional()
-            .describe('操作类型（可选：省略时根据 id/ids 自动为 read，否则为 list）'),
-        id: z.string().optional()
-            .describe('讨论哈希ID (read/reply/complete/close/delete)'),
-        ids: z.array(z.string()).optional()
-            .describe('批量读取的讨论ID数组 (read)'),
-        title: z.string().optional()
-            .describe('讨论标题 (create)'),
-        participants: z.array(z.string()).optional()
-            .describe('参与项目ID数组 (create, 不含自己)'),
-        summary: z.string().optional()
-            .describe('消息摘要 (create/reply, 不传则自动截取content前50字)'),
-        content: z.string().optional()
-            .describe('消息详细内容Markdown (create/reply)'),
-        conclusion: z.string().optional()
-            .describe('结案总结 (close)'),
-        newSummary: z.string().optional()
-            .describe('更新讨论进展摘要 (reply)'),
-        mode: z.enum(['auto', 'full']).optional()
-            .describe('读取模式 (read, 默认auto: 已读消息仅返回摘要)'),
-    }, async (args) => safeTool(async () => {
-        const decoded = decodeObjectStrings(args);
-        const me = sender(ctx);
-        const myPid = ctx.projectId;
-        // 智能默认：未指定 action 时，有 id/ids → read，否则 → list
-        let action = decoded.action;
-        if (!action) {
-            const hasIds = Boolean(decoded.id) || (Array.isArray(decoded.ids) && decoded.ids.length > 0);
-            action = hasIds ? 'read' : 'list';
-        }
-        switch (action) {
-            // ============ 公开操作 ============
-            case 'list': {
-                const all = await client().discussionList();
-                if (!Array.isArray(all))
-                    return wrap(`当前无活跃的讨论 (本项目: ${me})`);
-                const active = all.filter(d => isMember(d, myPid));
-                if (active.length === 0)
-                    return wrap(`当前无参与的活跃讨论 (本项目: ${myPid})`);
-                return wrap(formatList(active, ctx));
-            }
-            case 'history': {
-                const all = await client().discussionListAll(me);
-                if (!Array.isArray(all) || all.length === 0)
-                    return wrap(`暂无参与过的讨论记录 (身份: ${me})`);
-                const lines = [
-                    `本项目: ${me}`,
-                    ``,
-                    `📋 讨论历史 (${all.length}个)`,
-                    ``,
-                    `| ID | 标题 | 发起方 | 状态 | 消息数 | 更新 |`,
-                    `|:---|:---|:---|:---|:---:|:---|`,
-                ];
-                for (const d of all) {
-                    const statusIcon = d.status === 'active' ? '🟢' : '⚪';
-                    lines.push(`| ${d.id} | ${d.title} | ${d.initiator} | ${statusIcon} ${d.status} | ${d.messageCount ?? 0} | ${relativeTime(d.updatedAt)} |`);
-                }
-                return wrap(lines.join('\n'));
-            }
-            case 'create': {
-                if (!decoded.title)
-                    return wrap('❌ create 需要 title');
-                if (!decoded.participants)
-                    return wrap('❌ create 需要 participants');
-                if (!decoded.content)
-                    return wrap('❌ create 需要 content');
-                const result = await client().discussionCreate(decoded.title, me, decoded.participants, decoded.content, decoded.summary);
-                return wrap(`✅ 讨论已发起\nID: ${result.id}\n发起方: ${me}\n参与方: ${decoded.participants.join(', ')}\n\n🔒 权限: 仅以上项目可读写此讨论，仅发起方可删除/归档`);
-            }
-            // ============ 成员操作 (需验证成员身份) ============
-            case 'read': {
-                const readIds = decoded.ids || (decoded.id ? [decoded.id] : []);
-                if (readIds.length === 0)
-                    return wrap('❌ read 需要 id 或 ids');
-                // 权限检查: 逐个验证成员身份
-                const allActive = await client().discussionList();
-                const deniedIds = [];
-                const allowedIds = [];
-                for (const rid of readIds) {
-                    const brief = allActive.find(d => d.id === rid);
-                    if (!brief) {
-                        allowedIds.push(rid); // 找不到就放行(可能是历史讨论)
-                    }
-                    else if (isMember(brief, myPid)) {
-                        allowedIds.push(rid);
-                    }
-                    else {
-                        deniedIds.push(rid);
-                    }
-                }
-                if (deniedIds.length > 0 && allowedIds.length === 0) {
-                    return wrap(`🔒 无权限: 你 (${myPid}) 不是这些讨论的成员\n拒绝: ${deniedIds.join(', ')}`);
-                }
-                const readMode = decoded.mode || 'auto';
-                const discussions = await client().discussionReadByIds(allowedIds, me, readMode);
-                if (!Array.isArray(discussions) || discussions.length === 0)
-                    return wrap('未找到对应的讨论记录');
-                let result = discussions.map(formatDetailView).join('\n\n━━━━━━━━━━━━━━━━━━━━\n\n');
-                if (deniedIds.length > 0) {
-                    result += `\n\n🔒 已跳过 ${deniedIds.length} 个无权限的讨论: ${deniedIds.join(', ')}`;
-                }
-                return wrap(result);
-            }
-            case 'reply': {
-                if (!decoded.id)
-                    return wrap('❌ reply 需要 id');
-                if (!decoded.content)
-                    return wrap('❌ reply 需要 content');
-                // 权限检查: 仅成员可回复
-                const brief = await getBrief(decoded.id);
-                if (brief && !isMember(brief, myPid)) {
-                    return wrap(`🔒 无权限: 你 (${myPid}) 不是讨论 "${brief.title}" 的成员\n成员: ${brief.initiator}, ${brief.participants.join(', ')}`);
-                }
-                await client().discussionReply(decoded.id, me, decoded.content, decoded.summary, decoded.newSummary);
-                return wrap(`✅ 回复成功 (ID: ${decoded.id}, 身份: ${me})`);
-            }
-            // ============ 发起人操作 (需验证发起人身份) ============
-            case 'complete': {
-                if (!decoded.id)
-                    return wrap('❌ complete 需要 id');
-                // 权限检查: 仅发起人可标记完成
-                const brief = await getBrief(decoded.id);
-                if (brief && !isInitiator(brief, me, myPid)) {
-                    return wrap(`🔒 无权限: 仅发起人 (${brief.initiator}) 可标记完成\n你的身份: ${me}`);
-                }
-                await client().discussionComplete(decoded.id);
-                return wrap(`✅ 讨论已标记完成 (ID: ${decoded.id})`);
-            }
-            case 'close': {
-                if (!decoded.id)
-                    return wrap('❌ close 需要 id');
-                if (!decoded.conclusion)
-                    return wrap('❌ close 需要 conclusion');
-                // 权限检查: 仅发起人可归档
-                const brief = await getBrief(decoded.id);
-                if (brief && !isInitiator(brief, me, myPid)) {
-                    return wrap(`🔒 无权限: 仅发起人 (${brief.initiator}) 可归档讨论\n你的身份: ${me}`);
-                }
-                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)
-                    return wrap('❌ delete 需要 id');
-                // 权限检查: 仅发起人可删除
-                const brief = await getBrief(decoded.id);
-                if (brief && !isInitiator(brief, me, myPid)) {
-                    return wrap(`🔒 无权限: 仅发起人 (${brief.initiator}) 可删除讨论\n你的身份: ${me}`);
-                }
-                await client().discussionDelete(decoded.id);
-                return wrap(`✅ 讨论已删除 (ID: ${decoded.id})`);
-            }
-            default:
-                return wrap(`❌ 未知 action: ${action}`);
-        }
-    }));
-}

package/dist/tools/doc_query.d.ts

@@ -1,10 +0,0 @@
-/**
- * kg_doc — 文档查询视图
- * 纯查询工具，数据来源为流程图节点的 docEntries + description
- * 不创建独立文档，只是提供面向文档的查询入口
- *
- * read 默认返回当前文档，history=true 返回历史列表，index=N 返回指定历史条目
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type McpContext } from './shared.js';
-export declare function registerDocQueryTools(server: McpServer, _ctx: McpContext): void;

package/dist/tools/doc_query.js

@@ -1,185 +0,0 @@
-/**
- * kg_doc — 文档查询视图
- * 纯查询工具，数据来源为流程图节点的 docEntries + description
- * 不创建独立文档，只是提供面向文档的查询入口
- *
- * read 默认返回当前文档，history=true 返回历史列表，index=N 返回指定历史条目
- */
-import { z } from 'zod';
-import { getClient } from '../storage/httpClient.js';
-import { decodeObjectStrings } from '../utils.js';
-import { wrap, safeTool } from './shared.js';
-function normalizeText(value) {
-    return (value ?? '').trim().toLowerCase();
-}
-/** 文档专用评分 — 侧重 summary/content/description */
-function scoreDocMatch(node, terms) {
-    const description = normalizeText(node.description);
-    const entries = node.docEntries ?? [];
-    const allSummaries = entries.map((e) => e.summary).join(' ').toLowerCase();
-    const allContents = entries.map((e) => e.content).join(' ').toLowerCase();
-    const label = normalizeText(node.label);
-    let score = 0;
-    let matched = 0;
-    for (const term of terms) {
-        let hit = false;
-        if (allSummaries.includes(term)) {
-            score += 40;
-            hit = true;
-        }
-        if (allContents.includes(term)) {
-            score += 30;
-            hit = true;
-        }
-        if (description.includes(term)) {
-            score += 20;
-            hit = true;
-        }
-        if (label.includes(term)) {
-            score += 10;
-            hit = true;
-        }
-        if (hit)
-            matched += 1;
-    }
-    return matched === 0 ? 0 : score + matched * 50;
-}
-/** 加载所有流程图的完整数据 */
-async function loadAllCharts() {
-    const client = getClient();
-    const briefs = (await client.listFlowcharts());
-    const loaded = await Promise.all(briefs.map(async (b) => (await client.getFlowchart(b.id))));
-    return loaded.filter((c) => Boolean(c));
-}
-/** 格式化日期为简短形式 */
-function shortDate(iso) {
-    try {
-        return iso.slice(0, 10);
-    }
-    catch {
-        return iso;
-    }
-}
-export function registerDocQueryTools(server, _ctx) {
-    server.tool('kg_doc', '📘 文档查询视图 — 跨流程图搜索和阅读节点内嵌文档(docEntries + description)。纯查询，不创建独立文档。\n' +
-        '调用方式：search(query:"关键词") 全文搜索 | list 列出有文档的节点 | read(nodeId) 读取当前文档。\n' +
-        'read(nodeId, history:true) 查看历史列表(标题+日期) | read(nodeId, index:N) 读取第N条历史详情(0=最新)。\n' +
-        'actions: search(全文搜索)|list(文档列表)|read(读取文档,支持history/index参数)', {
-        action: z.enum(['search', 'list', 'read']).describe('操作类型 (Allowed: search, list, read)'),
-        query: z.string().optional().describe('搜索关键词 (search)'),
-        nodeId: z.string().optional().describe('节点ID (read)'),
-        chartId: z.string().optional().describe('限定流程图ID'),
-        history: z.boolean().optional().describe('read时传true返回历史列表(标题+日期)'),
-        index: z.number().optional().describe('read时指定历史条目序号(0=最新, 1=次新...)'),
-        limit: z.number().optional().describe('搜索结果限制, default 10'),
-    }, async (args) => safeTool(async () => {
-        const decoded = decodeObjectStrings(args);
-        switch (decoded.action) {
-            case 'search': {
-                const rawQuery = decoded.query?.trim();
-                if (!rawQuery)
-                    return wrap('search requires query.');
-                const terms = rawQuery.toLowerCase().split(/\s+/).filter(Boolean);
-                const charts = decoded.chartId
-                    ? [(await getClient().getFlowchart(decoded.chartId))].filter((c) => Boolean(c))
-                    : await loadAllCharts();
-                const matches = charts
-                    .flatMap((chart) => chart.nodes
-                    .filter((n) => (n.docEntries && n.docEntries.length > 0) || n.description)
-                    .map((node) => ({ chart, node, score: scoreDocMatch(node, terms) })))
-                    .filter((m) => m.score > 0)
-                    .sort((a, b) => b.score - a.score)
-                    .slice(0, decoded.limit ?? 10);
-                if (matches.length === 0)
-                    return wrap(`No docs matched: ${rawQuery}`);
-                const lines = [`Doc search: "${rawQuery}" (${matches.length} results)`, ''];
-                for (const { chart, node } of matches) {
-                    const docCount = node.docEntries?.length ?? 0;
-                    const latest = docCount > 0 ? node.docEntries[docCount - 1] : null;
-                    lines.push(`- **${node.label}** [${chart.id}/${node.id}] history=${docCount}`);
-                    if (latest)
-                        lines.push(`  current: ${shortDate(latest.date)} — ${latest.summary}`);
-                    if (node.description)
-                        lines.push(`  desc: ${node.description.slice(0, 80)}${node.description.length > 80 ? '...' : ''}`);
-                }
-                return wrap(lines.join('\n'));
-            }
-            case 'list': {
-                const charts = decoded.chartId
-                    ? [(await getClient().getFlowchart(decoded.chartId))].filter((c) => Boolean(c))
-                    : await loadAllCharts();
-                const nodesWithDocs = charts.flatMap((chart) => chart.nodes
-                    .filter((n) => (n.docEntries && n.docEntries.length > 0) || n.description)
-                    .map((n) => ({ chart, node: n })));
-                if (nodesWithDocs.length === 0)
-                    return wrap('No nodes with documentation found.');
-                const lines = [`Documented nodes: ${nodesWithDocs.length}`, ''];
-                for (const { chart, node } of nodesWithDocs) {
-                    const docCount = node.docEntries?.length ?? 0;
-                    const latest = docCount > 0 ? node.docEntries[docCount - 1] : null;
-                    const latestInfo = latest ? ` | ${shortDate(latest.date)} ${latest.summary}` : '';
-                    lines.push(`- ${node.label} [${chart.id}/${node.id}] history=${docCount}${latestInfo}`);
-                }
-                return wrap(lines.join('\n'));
-            }
-            case 'read': {
-                if (!decoded.nodeId)
-                    return wrap('read requires nodeId.');
-                const chartId = decoded.chartId || 'main';
-                const chart = (await getClient().getFlowchart(chartId));
-                if (!chart)
-                    return wrap(`Flowchart not found: ${chartId}`);
-                const node = chart.nodes.find((n) => n.id === decoded.nodeId);
-                if (!node)
-                    return wrap(`Node not found: ${decoded.nodeId} in ${chartId}`);
-                const entries = node.docEntries ?? [];
-                // history=true → 列出历史记录(标题+日期)
-                if (decoded.history) {
-                    if (entries.length === 0)
-                        return wrap(`No history for ${node.label} [${chartId}/${decoded.nodeId}]`);
-                    const lines = [`## ${node.label} — history (${entries.length})`, ''];
-                    for (let i = entries.length - 1; i >= 0; i--) {
-                        const e = entries[i];
-                        const tag = i === entries.length - 1 ? ' (current)' : '';
-                        lines.push(`${entries.length - 1 - i}. ${shortDate(e.date)} — ${e.summary}${tag}`);
-                    }
-                    lines.push('', '_Use read(nodeId, index:N) to view specific entry._');
-                    return wrap(lines.join('\n'));
-                }
-                // index=N → 读取指定历史条目 (0=最新)
-                if (decoded.index !== undefined) {
-                    const idx = entries.length - 1 - decoded.index;
-                    if (idx < 0 || idx >= entries.length) {
-                        return wrap(`Index out of range: ${decoded.index} (total: ${entries.length})`);
-                    }
-                    const entry = entries[idx];
-                    const lines = [
-                        `## ${node.label} — #${decoded.index}`,
-                        `${shortDate(entry.date)} — ${entry.summary}`,
-                        '',
-                        entry.content,
-                    ];
-                    return wrap(lines.join('\n'));
-                }
-                // 默认: 返回当前文档 (description + 最新 docEntry)
-                const lines = [`## ${node.label} [${chartId}/${node.id}]`, ''];
-                if (node.description) {
-                    lines.push(node.description, '');
-                }
-                if (entries.length > 0) {
-                    const latest = entries[entries.length - 1];
-                    lines.push(`---`, `**${latest.summary}** (${shortDate(latest.date)})`, '', latest.content);
-                    if (entries.length > 1) {
-                        lines.push('', `_${entries.length - 1} older entries. Use read(nodeId, history:true) to browse._`);
-                    }
-                }
-                else if (!node.description) {
-                    lines.push('_No documentation._');
-                }
-                return wrap(lines.join('\n'));
-            }
-            default:
-                return wrap(`Unknown action: ${String(decoded.action)}`);
-        }
-    }));
-}

package/dist/tools/files.d.ts

@@ -1,6 +0,0 @@
-/**
- * 📁 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,107 +0,0 @@
-/**
- * 📁 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(读取文件)|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")'),
-        localPath: z.string().optional()
-            .describe('本地保存路径 (download/public_download)'),
-        newName: z.string().optional()
-            .describe('新名称 (public_rename)'),
-        targetProject: z.string().optional()
-            .describe('跨项目操作的目标项目ID'),
-    }, async (args) => safeTool(async () => {
-        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 '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}`);
-            }
-            // ===== 公共文件池 =====
-            case 'public_list': {
-                const files = await client().publicFilesList(args.dir);
-                if (files.length === 0)
-                    return wrap('📦 公共文件池' + (args.dir ? ` /${args.dir}` : '') + ' 为空');
-                const lines = files.map(f => {
-                    const icon = f.isDir ? '📁' : '📄';
-                    const size = f.isDir ? '' : ` (${formatFileSize(f.size)})`;
-                    return `${icon} ${f.name}${size}`;
-                });
-                const dirLabel = args.dir || '/';
-                return wrap(`📦 公共文件池 ${dirLabel} (${files.length} 项)\n\n${lines.join('\n')}`);
-            }
-            case 'public_read': {
-                if (!args.path)
-                    return wrap('❌ public_read 需要 path');
-                const content = await client().publicFilesRead(args.path);
-                return wrap(`📦 公共文件 ${args.path}\n\n\`\`\`\n${content}\n\`\`\``);
-            }
-            case 'public_download': {
-                if (!args.path)
-                    return wrap('❌ public_download 需要 path');
-                const result = await client().publicFilesDownload(args.path, args.localPath);
-                return wrap(`✅ 已从公共文件池下载\n\n- 本地路径: ${result.localPath}\n- 文件数量: ${result.fileCount}`);
-            }
-            case 'public_delete': {
-                if (!args.path)
-                    return wrap('❌ public_delete 需要 path');
-                await client().publicFilesDelete(args.path);
-                return wrap(`✅ 已从公共文件池删除: ${args.path}`);
-            }
-            case 'public_mkdir': {
-                if (!args.path)
-                    return wrap('❌ public_mkdir 需要 path');
-                await client().publicFilesMkdir(args.path);
-                return wrap(`✅ 已创建公共文件池目录: /${args.path}`);
-            }
-            case 'public_rename': {
-                if (!args.path)
-                    return wrap('❌ public_rename 需要 path');
-                if (!args.newName)
-                    return wrap('❌ public_rename 需要 newName');
-                await client().publicFilesRename(args.path, args.newName);
-                return wrap(`✅ 已重命名: ${args.path} → ${args.newName}`);
-            }
-            default:
-                return wrap(`❌ 未知 action: ${args.action}`);
-        }
-    }));
-}

package/dist/tools/init.d.ts

@@ -1,12 +0,0 @@
-/**
- * kg_init 工具 — 项目上下文初始化
- *
- * 解决全局共用 MCP 进程时的多项目隔离问题：
- * - 智能体调用 kg_init 传入 projectPath
- * - MCP 从该路径读取 .ppdocs 配置
- * - 重新初始化 HTTP Client 指向正确项目
- * - 更新共享 McpContext，所有工具自动获取新 projectId
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type McpContext } from './shared.js';
-export declare function registerInitTool(server: McpServer, ctx: McpContext, onProjectChange: (newProjectId: string, newApiUrl: string) => void): void;