@ppdocs/mcp 3.6.0 → 3.7.0

package/dist/tools/doc_query.js

@@ -92,17 +92,13 @@ export function registerDocQueryTools(server, _ctx) {
                     .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 rows = matches.map(({ chart, node }) => {
                     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'));
+                    const summary = latest ? latest.summary.substring(0, 50) : (node.description?.substring(0, 50) || '');
+                    return `| ${node.label} | ${chart.id}/${node.id} | ${docCount} | ${latest ? shortDate(latest.date).slice(5) : '-'} | ${summary} |`;
+                }).join('\n');
+                return wrap(`Doc search: "${rawQuery}" (${matches.length} results)\n\n| 节点 | 图谱 | 文档数 | 日期 | 摘要 |\n|:-----|:-----|:-------|:-----|:-----|\n${rows}`);
             }
             case 'list': {
                 const charts = decoded.chartId
@@ -113,30 +109,43 @@ export function registerDocQueryTools(server, _ctx) {
                     .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 rows = nodesWithDocs.map(({ chart, node }) => {
                     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'));
+                    const summary = latest ? latest.summary.substring(0, 50) : '';
+                    return `| ${node.label} | ${chart.id}/${node.id} | ${docCount} | ${latest ? shortDate(latest.date).slice(5) : '-'} | ${summary} |`;
+                }).join('\n');
+                return wrap(`Documented nodes: ${nodesWithDocs.length}\n\n| 节点 | 图谱 | 文档数 | 日期 | 摘要 |\n|:-----|:-----|:-------|:-----|:-----|\n${rows}`);
             }
             case 'read': {
                 if (!decoded.nodeId)
                     return wrap('read requires nodeId.');
-                const chartId = decoded.chartId || 'main';
-                const chart = (await getClient().getFlowchart(chartId));
+                let chart = null;
+                let foundChartId = decoded.chartId || '';
+                if (foundChartId) {
+                    chart = (await getClient().getFlowchart(foundChartId));
+                }
+                else {
+                    // 不指定 chartId 时自动搜全部图
+                    const all = await loadAllCharts();
+                    for (const c of all) {
+                        if (c.nodes.some(n => n.id === decoded.nodeId)) {
+                            chart = c;
+                            foundChartId = c.id;
+                            break;
+                        }
+                    }
+                }
                 if (!chart)
-                    return wrap(`Flowchart not found: ${chartId}`);
+                    return wrap(`Node not found: ${decoded.nodeId}${decoded.chartId ? ` in ${decoded.chartId}` : ' (searched all charts)'}`);
                 const node = chart.nodes.find((n) => n.id === decoded.nodeId);
                 if (!node)
-                    return wrap(`Node not found: ${decoded.nodeId} in ${chartId}`);
+                    return wrap(`Node not found: ${decoded.nodeId} in ${foundChartId}`);
                 const entries = node.docEntries ?? [];
                 // history=true → 列出历史记录(标题+日期)
                 if (decoded.history) {
                     if (entries.length === 0)
-                        return wrap(`No history for ${node.label} [${chartId}/${decoded.nodeId}]`);
+                        return wrap(`No history for ${node.label} [${foundChartId}/${decoded.nodeId}]`);
                     const lines = [`## ${node.label} — history (${entries.length})`, ''];
                     for (let i = entries.length - 1; i >= 0; i--) {
                         const e = entries[i];
@@ -162,7 +171,7 @@ export function registerDocQueryTools(server, _ctx) {
                     return wrap(lines.join('\n'));
                 }
                 // 默认: 返回当前文档 (description + 最新 docEntry)
-                const lines = [`## ${node.label} [${chartId}/${node.id}]`, ''];
+                const lines = [`## ${node.label} [${foundChartId}/${node.id}]`, ''];
                 if (node.description) {
                     lines.push(node.description, '');
                 }

package/dist/tools/kg_status.js

@@ -6,16 +6,20 @@ import { wrap, safeTool } from './shared.js';
 export function registerStatusTool(server, ctx) {
     const client = () => getClient();
     server.tool('kg_status', '📊 项目速览仪表盘 — 一键了解项目健康。返回: 流程图节点数、活跃任务数、最近变更。每次对话开始建议首先调用', {}, async () => safeTool(async () => {
-        const [charts, activeTasks] = await Promise.all([
+        const [charts, activeTasks, discussions] = await Promise.all([
             client().listFlowcharts(),
             client().listTasks('active'),
+            client().discussionList().catch(() => []),
         ]);
         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 !== 'default' ? ':' + ctx.agentId : ''}`,
             ``,
             `🔀 流程图: ${charts.length} 张 | 📦 节点: ${nodeCount} 个`,
             `📝 活跃任务: ${activeTasks.length} 个`,
+            `📨 活跃讨论: ${activeDiscussions.length} 个`,
         ];
         if (activeTasks.length > 0) {
             lines.push(``, `🔧 进行中的任务:`);

package/dist/tools/tasks.js

@@ -97,8 +97,13 @@ export function registerTaskTools(server, ctx) {
                     }
                     if (tasks.length === 0)
                         return wrap(`📋 ${status === 'archived' ? '归档' : '活跃'}任务为空`);
-                    const list = tasks.map(t => `• [${t.status}] ${t.title}\n  ID: ${t.id} | 更新: ${t.updated_at.split('T')[0]} | ${t.last_log || ''}`).join('\n');
-                    return wrap(`📋 共 ${tasks.length} 个任务:\n\n${list}`);
+                    const rows = tasks.map(t => {
+                        const icon = t.status === 'active' ? '🟢' : '⚪';
+                        const date = t.updated_at?.split('T')[0]?.slice(5) || '';
+                        const log = (t.last_log || '').substring(0, 40);
+                        return `| ${icon} | ${t.title} | ${t.id} | ${date} | ${log} |`;
+                    }).join('\n');
+                    return wrap(`📋 共 ${tasks.length} 个任务\n\n| 状态 | 标题 | ID | 更新 | 最近日志 |\n|:-----|:-----|:---|:-----|:---------|\n${rows}`);
                 }
                 // 有 taskId = 获取详情 (结构化摘要)
                 if (decoded.taskId) {
@@ -145,7 +150,24 @@ export function registerTaskTools(server, ctx) {
                     const task = await client().getTask(matched[0].id, 'smart');
                     if (!task)
                         return wrap('任务详情获取失败');
-                    return wrap(`📝 ${task.title}\nID: ${task.id} | 状态: ${task.status}`);
+                    const lines = [
+                        `📝 ${task.title}`,
+                        `ID: ${task.id} | 状态: ${task.status}`,
+                        `创建: ${task.created_at?.split('T')[0] || ''}`,
+                    ];
+                    if (task.detail?.description)
+                        lines.push(`\n📋 ${task.detail.description}`);
+                    if (task.detail?.goals?.length) {
+                        lines.push(`\n🎯 验收标准:`);
+                        task.detail.goals.forEach((g, i) => lines.push(`  ${i + 1}. ☐ ${g}`));
+                    }
+                    if (task.logs?.length) {
+                        lines.push(`\n📊 进度日志 (${task.logs.length}条, 最近3条):`);
+                        for (const log of task.logs.slice(-3)) {
+                            lines.push(`  [${log.log_type}] ${log.time?.split('T')[0] || ''}: ${log.content?.substring(0, 120)}`);
+                        }
+                    }
+                    return wrap(lines.join('\n'));
                 }
                 const list = matched.map(t => `• [${t.status}] ${t.title}\n  ID: ${t.id}`).join('\n');
                 return wrap(`找到 ${matched.length} 个匹配任务:\n\n${list}\n\n请使用 taskId 获取详情`);
@@ -166,8 +188,7 @@ export function registerTaskTools(server, ctx) {
                     : '  (无验收标准)';
                 return wrap(`✅ 进度已记录 [${lastLog?.log_type || 'progress'}]\n` +
                     `📋 ${task.title} | 日志: ${task.logs.length}条\n` +
-                    `\n🎯 验收标准:\n${goalsDisplay}\n` +
-                    `\n⚠️ 提示: 每完成一个步骤请立即追加进度,确保时间线完整`);
+                    `\n🎯 验收标准:\n${goalsDisplay}`);
             }
             case 'archive': {
                 if (!decoded.taskId)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ppdocs/mcp",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "description": "ppdocs MCP Server - Knowledge Graph for Claude",
   "type": "module",
   "main": "dist/index.js",