@ppdocs/mcp 3.1.10 → 3.2.1

package/dist/tools/tasks.js

@@ -1,6 +1,6 @@
 /**
- * 任务管理工具 (4个)
- * task_create, task_get, task_update, task_archive
+ * 📝 kg_task (4→1)
+ * 合并: task_create, task_get, task_update, task_archive
  */
 import { z } from 'zod';
 import { getClient } from '../storage/httpClient.js';
@@ -8,79 +8,102 @@ import { decodeObjectStrings } from '../utils.js';
 import { wrap, safeTool } from './shared.js';
 export function registerTaskTools(server, projectId, user) {
     const client = () => getClient();
-    // 创建任务
-    server.tool('task_create', '创建开发任务', {
-        title: z.string().describe('任务标题'),
-        description: z.string().describe('任务描述(Markdown)'),
-        goals: z.array(z.string()).optional().describe('目标清单')
+    server.tool('kg_task', '📝 任务管理 — 创建、查询、更新进展、归档。action: create(创建)|get(查询)|update(添加日志)|archive(归档)', {
+        action: z.enum(['create', 'get', 'update', 'archive'])
+            .describe('操作类型'),
+        title: z.string().optional()
+            .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)'),
+        log_type: z.enum(['progress', 'issue', 'solution', 'reference']).optional()
+            .describe('日志类型 (update)'),
+        content: z.string().optional()
+            .describe('日志内容Markdown (update)'),
+        summary: z.string().optional()
+            .describe('经验总结Markdown (archive)'),
+        difficulties: z.array(z.string()).optional()
+            .describe('遇到的困难 (archive)'),
+        solutions: z.array(z.string()).optional()
+            .describe('解决方案 (archive)'),
+        status: z.enum(['active', 'archived', 'all']).optional()
+            .describe('状态筛选 (get, 默认all)'),
     }, async (args) => safeTool(async () => {
         const decoded = decodeObjectStrings(args);
-        const task = await client().createTask({
-            title: decoded.title,
-            description: decoded.description,
-            goals: decoded.goals || []
-        }, user);
-        return wrap(JSON.stringify(task, null, 2));
-    }));
-    // 读取任务
-    server.tool('task_get', '读取任务详情(按名字搜索，支持当前任务和历史任务)', {
-        title: z.string().describe('任务名称(模糊匹配)'),
-        status: z.enum(['active', 'archived', 'all']).optional().describe('状态筛选: active=进行中, archived=已归档, all=全部(默认)')
-    }, async (args) => safeTool(async () => {
-        const status = args.status || 'all';
-        const searchTitle = args.title.toLowerCase();
-        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);
+        switch (decoded.action) {
+            case 'create': {
+                if (!decoded.title)
+                    return wrap('❌ create 需要 title');
+                if (!decoded.description)
+                    return wrap('❌ create 需要 description');
+                const task = await client().createTask({
+                    title: decoded.title,
+                    description: decoded.description,
+                    goals: decoded.goals || []
+                }, user);
+                return wrap(JSON.stringify(task, null, 2));
+            }
+            case 'get': {
+                if (!decoded.title)
+                    return wrap('❌ get 需要 title');
+                const filterStatus = decoded.status || 'all';
+                const searchTitle = decoded.title.toLowerCase();
+                let tasks;
+                if (filterStatus === 'all') {
+                    const [active, archived] = await Promise.all([
+                        client().listTasks('active'),
+                        client().listTasks('archived')
+                    ]);
+                    tasks = [...active, ...archived];
+                }
+                else {
+                    tasks = await client().listTasks(filterStatus);
+                }
+                const matched = tasks.filter(t => t.title.toLowerCase().includes(searchTitle));
+                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 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请提供更精确的任务名称`);
+            }
+            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);
+                if (!task)
+                    return wrap('更新失败(任务不存在或已归档)');
+                return wrap(`✅ 日志已添加，任务共有 ${task.logs.length} 条日志`);
+            }
+            case 'archive': {
+                if (!decoded.taskId)
+                    return wrap('❌ archive 需要 taskId');
+                if (!decoded.summary)
+                    return wrap('❌ archive 需要 summary');
+                const task = await client().completeTask(decoded.taskId, {
+                    summary: decoded.summary,
+                    difficulties: decoded.difficulties || [],
+                    solutions: decoded.solutions || [],
+                    references: []
+                });
+                if (!task)
+                    return wrap('归档失败(任务不存在或已归档)');
+                return wrap(`✅ 任务已归档: ${task.title}`);
+            }
+            default:
+                return wrap(`❌ 未知 action: ${decoded.action}`);
         }
-        const matched = tasks.filter(t => t.title.toLowerCase().includes(searchTitle));
-        if (matched.length === 0)
-            return wrap(`未找到匹配 "${args.title}" 的任务`);
-        if (matched.length === 1) {
-            const task = await client().getTask(matched[0].id);
-            return wrap(task ? JSON.stringify(task, null, 2) : '任务详情获取失败');
-        }
-        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请提供更精确的任务名称`);
-    }));
-    // 更新任务
-    server.tool('task_update', '更新任务(添加进展日志)', {
-        taskId: z.string().describe('任务ID'),
-        log_type: z.enum(['progress', 'issue', 'solution', 'reference']).describe('日志类型: progress=进展, issue=问题, solution=方案, reference=参考'),
-        content: z.string().describe('日志内容(Markdown)')
-    }, async (args) => safeTool(async () => {
-        const decoded = decodeObjectStrings(args);
-        const task = await client().addTaskLog(args.taskId, decoded.log_type, decoded.content);
-        if (!task)
-            return wrap('更新失败(任务不存在或已归档)');
-        return wrap(`✅ 日志已添加，任务共有 ${task.logs.length} 条日志`);
-    }));
-    // 归档任务
-    server.tool('task_archive', '归档任务(完成并填写经验总结)', {
-        taskId: z.string().describe('任务ID'),
-        summary: z.string().describe('经验总结(Markdown)'),
-        difficulties: z.array(z.string()).optional().describe('遇到的困难'),
-        solutions: z.array(z.string()).optional().describe('解决方案')
-    }, async (args) => safeTool(async () => {
-        const decoded = decodeObjectStrings(args);
-        const task = await client().completeTask(args.taskId, {
-            summary: decoded.summary,
-            difficulties: decoded.difficulties || [],
-            solutions: decoded.solutions || [],
-            references: []
-        });
-        if (!task)
-            return wrap('归档失败(任务不存在或已归档)');
-        return wrap(`✅ 任务已归档: ${task.title}`);
     }));
 }

package/dist/web/server.d.ts

@@ -0,0 +1,43 @@
+/**
+ * PPDocs Agent V2 — Web Config Server
+ * 多项目管理 + 智能匹配 + 知识图谱预览 + MCP 安装
+ */
+export interface ProjectBinding {
+    localDir: string;
+    localName: string;
+    remote: {
+        id: string;
+        name: string;
+        password: string;
+    };
+    sync: {
+        enabled: boolean;
+        intervalSec: number;
+    };
+    createdAt: string;
+}
+export interface AgentConfig {
+    host: string;
+    port: number;
+    webPort: number;
+    projects: ProjectBinding[];
+}
+export declare function loadAgentConfig(): AgentConfig | null;
+export declare function saveAgentConfig(config: AgentConfig): void;
+interface ProjectStatus {
+    connected: boolean;
+    syncStatus: string;
+    lastSync: Date | null;
+    docCount?: number;
+}
+interface AgentState {
+    hostConnected: boolean;
+    projectStatus: Map<string, ProjectStatus>;
+    onBind?: (project: ProjectBinding) => void;
+    onUnbind?: (remoteId: string) => void;
+}
+export declare function getAgentState(): AgentState;
+export declare function setAgentState(partial: Partial<AgentState>): void;
+export declare function setProjectStatus(remoteId: string, status: Partial<ProjectStatus>): void;
+export declare function startWebServer(webPort: number): void;
+export {};