@ppdocs/mcp 3.5.0 → 3.7.0

package/dist/config.d.ts

@@ -6,6 +6,7 @@ export interface PpdocsConfig {
     apiUrl: string;
     projectId: string;
     user: string;
+    agentId: string;
     source: 'env' | 'file';
 }
 export declare const PPDOCS_CONFIG_FILE = ".ppdocs";

package/dist/config.js

@@ -16,7 +16,13 @@ function readEnvConfig() {
     if (!apiUrl)
         return null;
     const match = apiUrl.match(/\/api\/([^/]+)\/[^/]+\/?$/);
-    return { apiUrl, projectId: match?.[1] || 'unknown', user: process.env.PPDOCS_USER || generateUser(), source: 'env' };
+    return {
+        apiUrl,
+        projectId: match?.[1] || 'unknown',
+        user: process.env.PPDOCS_USER || generateUser(),
+        agentId: process.env.PPDOCS_AGENT_ID || 'default',
+        source: 'env',
+    };
 }
 function readPpdocsFile() {
     const configPath = path.join(process.cwd(), '.ppdocs');
@@ -26,7 +32,7 @@ function readPpdocsFile() {
         const c = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
         if (!c.api || !c.projectId || !c.key)
             return null;
-        return { apiUrl: `${c.api}/api/${c.projectId}/${c.key}`, projectId: c.projectId, user: c.user || generateUser(), source: 'file' };
+        return { apiUrl: `${c.api}/api/${c.projectId}/${c.key}`, projectId: c.projectId, user: c.user || generateUser(), agentId: c.agentId || process.env.PPDOCS_AGENT_ID || 'default', source: 'file' };
     }
     catch {
         return null;

package/dist/index.js

@@ -39,8 +39,9 @@ async function main() {
     }
     const projectId = config?.projectId || 'pending';
     const user = config?.user || 'agent';
+    const agentId = config?.agentId || process.env.PPDOCS_AGENT_ID || 'default';
     const server = new McpServer({ name: `ppdocs [${projectId}]`, version: VERSION }, { capabilities: { tools: {} } });
-    registerTools(server, projectId, user, (newProjectId, newApiUrl) => {
+    registerTools(server, projectId, user, agentId, (newProjectId, newApiUrl) => {
         console.error(`[kg_init] 项目已切换: ${newProjectId}`);
     });
     const transport = new StdioServerTransport();

package/dist/tools/discussion.js

@@ -15,7 +15,9 @@ 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}`;
+    return ctx.agentId && ctx.agentId !== 'default'
+        ? `${ctx.projectId}:${ctx.user}:${ctx.agentId}`
+        : `${ctx.projectId}:${ctx.user}`;
 }
 /** 提取 sender 中的 projectId */
 function senderProjectId(senderStr) {

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/index.d.ts

@@ -12,4 +12,4 @@
  * 🏛️ 协作:    kg_meeting                                         (1个)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerTools(server: McpServer, projectId: string, user: string, onProjectChange?: (newProjectId: string, newApiUrl: string) => void): void;
+export declare function registerTools(server: McpServer, projectId: string, user: string, agentId: string, onProjectChange?: (newProjectId: string, newApiUrl: string) => void): void;

package/dist/tools/index.js

@@ -24,8 +24,8 @@ 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, onProjectChange) {
-    const ctx = createContext(projectId, user);
+export function registerTools(server, projectId, user, agentId, onProjectChange) {
+    const ctx = createContext(projectId, user, agentId);
     // 🔗 初始化
     registerInitTool(server, ctx, onProjectChange || (() => { }));
     // 📊 导航

package/dist/tools/init.js

@@ -60,6 +60,7 @@ export function registerInitTool(server, ctx, onProjectChange) {
         // 4. 更新共享上下文 — 所有工具立刻获得新 projectId
         ctx.projectId = config.projectId;
         ctx.user = config.user;
+        ctx.agentId = process.env.PPDOCS_AGENT_ID || 'default';
         // 5. 通知主进程
         onProjectChange(config.projectId, config.apiUrl);
         return wrap(`✅ 项目上下文已初始化\n\n` +

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/shared.d.ts

@@ -6,9 +6,10 @@
 export interface McpContext {
     projectId: string;
     user: string;
+    agentId: string;
 }
 /** 创建可变上下文对象 (工具闭包捕获此对象的引用，kg_init 更新其属性) */
-export declare function createContext(projectId: string, user: string): McpContext;
+export declare function createContext(projectId: string, user: string, agentId?: string): McpContext;
 export declare function wrap(text: string): {
     content: {
         type: "text";

package/dist/tools/shared.js

@@ -3,8 +3,8 @@
  * 合并原 helpers.ts + 新增 safeTool / withCross 模式
  */
 /** 创建可变上下文对象 (工具闭包捕获此对象的引用，kg_init 更新其属性) */
-export function createContext(projectId, user) {
-    return { projectId, user };
+export function createContext(projectId, user, agentId = 'default') {
+    return { projectId, user, agentId };
 }
 // ==================== MCP 返回包装 ====================
 export function wrap(text) {

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.5.0",
+  "version": "3.7.0",
   "description": "ppdocs MCP Server - Knowledge Graph for Claude",
   "type": "module",
   "main": "dist/index.js",