@ppdocs/mcp 3.2.21 → 3.2.23

package/dist/tools/tasks.js

@@ -1,6 +1,6 @@
 /**
- * 📝 kg_task (4→1)
- * 合并: task_create, task_get, task_update, task_archive
+ * 📝 kg_task (4→1) — 极简任务管理
+ * AI 只需说人话写内容，后端负责所有格式化、分类、时间戳
  */
 import { z } from 'zod';
 import { getClient } from '../storage/httpClient.js';
@@ -8,21 +8,21 @@ import { decodeObjectStrings } from '../utils.js';
 import { wrap, safeTool } from './shared.js';
 export function registerTaskTools(server, ctx) {
     const client = () => getClient();
-    server.tool('kg_task', '📝 任务管理 — 创建、查询、更新进展、归档。action: create(创建)|get(查询)|update(添加日志)|archive(归档)', {
-        action: z.enum(['create', 'get', 'update', 'archive'])
+    server.tool('kg_task', '📝 任务记录 — action: create(创建,建议bindTo关联节点)|get(查询)|update(追加进度)|archive(归档)|delete(删除)。⚠️ 每完成一个步骤必须立即update!', {
+        action: z.enum(['create', 'get', 'update', 'archive', 'delete'])
             .describe('操作类型'),
         title: z.string().optional()
-            .describe('任务标题 (create/get)'),
+            .describe('任务标题 (create/get按标题搜)'),
         description: z.string().optional()
             .describe('任务描述Markdown (create)'),
         goals: z.array(z.string()).optional()
             .describe('目标清单 (create)'),
         taskId: z.string().optional()
-            .describe('任务ID (update/archive)'),
+            .describe('任务ID (get/update/archive)'),
         log_type: z.enum(['progress', 'issue', 'solution', 'reference']).optional()
-            .describe('日志类型 (update)'),
+            .describe('日志类型 (update, 可选-不传则自动检测)'),
         content: z.string().optional()
-            .describe('日志内容Markdown (update)'),
+            .describe('日志内容Markdown (update, 内容长短由AI决定,支持完整Markdown)'),
         summary: z.string().optional()
             .describe('经验总结Markdown (archive)'),
         difficulties: z.array(z.string()).optional()
@@ -30,7 +30,11 @@ export function registerTaskTools(server, ctx) {
         solutions: z.array(z.string()).optional()
             .describe('解决方案 (archive)'),
         status: z.enum(['active', 'archived', 'all']).optional()
-            .describe('状态筛选 (get, 默认all)'),
+            .describe('状态筛选 (get, 默认active)'),
+        bindTo: z.string().optional()
+            .describe('绑定到流程图节点ID (create, 如"n_entry")'),
+        bindChart: z.string().optional()
+            .describe('绑定目标流程图ID (create, 默认"main")'),
     }, async (args) => safeTool(async () => {
         const decoded = decodeObjectStrings(args);
         switch (decoded.action) {
@@ -44,13 +48,85 @@ export function registerTaskTools(server, ctx) {
                     description: decoded.description,
                     goals: decoded.goals || []
                 }, ctx.user);
-                return wrap(JSON.stringify(task, null, 2));
+                // 自动绑定到流程图节点
+                let bindMsg = '';
+                if (decoded.bindTo) {
+                    try {
+                        const chartId = decoded.bindChart || 'main';
+                        const chart = await client().getFlowchart(chartId);
+                        if (chart) {
+                            const node = chart.nodes?.find((n) => n.id === decoded.bindTo);
+                            if (node) {
+                                if (!node.boundTasks)
+                                    node.boundTasks = [];
+                                if (!node.boundTasks.includes(task.id)) {
+                                    node.boundTasks.push(task.id);
+                                }
+                                await client().saveFlowchart(chartId, chart);
+                                bindMsg = `\n🔗 已绑定到节点: ${decoded.bindTo} [${chartId}]`;
+                            }
+                            else {
+                                bindMsg = `\n⚠️ 节点 "${decoded.bindTo}" 不存在于流程图 "${chartId}"`;
+                            }
+                        }
+                    }
+                    catch {
+                        bindMsg = `\n⚠️ 绑定失败`;
+                    }
+                }
+                // 约束: 未绑定流程图 → 强制警告
+                if (!decoded.bindTo) {
+                    bindMsg = `\n\n⚠️ 【未关联知识锚点】此任务未绑定到任何流程图节点!\n💡 建议: 使用 kg_flowchart(get) 查看节点列表, 然后用 kg_flowchart(bind, nodeId, tasks:["${task.id}"]) 绑定\n📌 不关联的任务会成为孤岛数据, 无法被其他AI发现`;
+                }
+                return wrap(`✅ 任务已创建\nID: ${task.id}\n标题: ${task.title}\n验收标准: ${task.detail.goals.length}条${bindMsg}`);
             }
             case 'get': {
-                if (!decoded.title)
-                    return wrap('❌ get 需要 title');
-                const filterStatus = decoded.status || 'all';
+                // 无参数 = 列出活跃任务
+                if (!decoded.taskId && !decoded.title) {
+                    const status = decoded.status || 'active';
+                    let tasks;
+                    if (status === 'all') {
+                        const [active, archived] = await Promise.all([
+                            client().listTasks('active'),
+                            client().listTasks('archived')
+                        ]);
+                        tasks = [...active, ...archived];
+                    }
+                    else {
+                        tasks = await client().listTasks(status);
+                    }
+                    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}`);
+                }
+                // 有 taskId = 获取详情 (结构化摘要)
+                if (decoded.taskId) {
+                    const task = await client().getTask(decoded.taskId, 'smart');
+                    if (!task)
+                        return wrap('❌ 任务未找到');
+                    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'));
+                }
+                // 有 title = 按标题搜索
                 const searchTitle = decoded.title.toLowerCase();
+                const filterStatus = decoded.status || 'all';
                 let tasks;
                 if (filterStatus === 'all') {
                     const [active, archived] = await Promise.all([
@@ -66,26 +142,32 @@ export function registerTaskTools(server, ctx) {
                 if (matched.length === 0)
                     return wrap(`未找到匹配 "${decoded.title}" 的任务`);
                 if (matched.length === 1) {
-                    const task = await client().getTask(matched[0].id);
-                    return wrap(task ? JSON.stringify(task, null, 2) : '任务详情获取失败');
+                    const task = await client().getTask(matched[0].id, 'smart');
+                    if (!task)
+                        return wrap('任务详情获取失败');
+                    return wrap(`📝 ${task.title}\nID: ${task.id} | 状态: ${task.status}`);
                 }
-                const list = matched.map(t => ({
-                    id: t.id, title: t.title, status: t.status,
-                    creator: t.creator, created_at: t.created_at
-                }));
-                return wrap(`找到 ${matched.length} 个匹配任务:\n${JSON.stringify(list, null, 2)}\n\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 获取详情`);
             }
             case 'update': {
                 if (!decoded.taskId)
                     return wrap('❌ update 需要 taskId');
-                if (!decoded.log_type)
-                    return wrap('❌ update 需要 log_type');
                 if (!decoded.content)
                     return wrap('❌ update 需要 content');
-                const task = await client().addTaskLog(decoded.taskId, decoded.log_type, decoded.content);
+                // log_type 可选 — 不传则后端自动检测关键词
+                const task = await client().addTaskLog(decoded.taskId, decoded.content, decoded.log_type);
                 if (!task)
                     return wrap('更新失败(任务不存在或已归档)');
-                return wrap(`✅ 日志已添加，任务共有 ${task.logs.length} 条日志`);
+                const lastLog = task.logs[task.logs.length - 1];
+                // 返回任务摘要 + 验收清单，让 AI 始终知道剩余目标
+                const goalsDisplay = task.detail.goals.length > 0
+                    ? task.detail.goals.map((g, i) => `  ${i + 1}. ☐ ${g}`).join('\n')
+                    : '  (无验收标准)';
+                return wrap(`✅ 进度已记录 [${lastLog?.log_type || 'progress'}]\n` +
+                    `📋 ${task.title} | 日志: ${task.logs.length}条\n` +
+                    `\n🎯 验收标准:\n${goalsDisplay}\n` +
+                    `\n⚠️ 提示: 每完成一个步骤请立即追加进度,确保时间线完整`);
             }
             case 'archive': {
                 if (!decoded.taskId)
@@ -104,6 +186,12 @@ export function registerTaskTools(server, ctx) {
             }
             default:
                 return wrap(`❌ 未知 action: ${decoded.action}`);
+            case 'delete': {
+                if (!decoded.taskId)
+                    return wrap('❌ delete 需要 taskId');
+                const ok = await client().deleteTask(decoded.taskId);
+                return wrap(ok ? `✅ 任务已删除 (ID: ${decoded.taskId})` : '❌ 删除失败(任务不存在)');
+            }
         }
     }));
 }

package/package.json

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