@ppdocs/mcp 3.3.0 → 3.4.0

package/dist/storage/httpClient.d.ts

@@ -29,6 +29,8 @@ export declare class PpdocsApiClient {
     saveReference(reference: Reference): Promise<boolean>;
     deleteReference(refId: string): Promise<boolean>;
     readReferenceFile(path: string): Promise<string>;
+    /** 复制本地文件到参考文件库, 返回相对路径列表 */
+    copyReferenceFiles(paths: string[], targetDir?: string): Promise<string[]>;
     listTasks(status?: 'active' | 'archived'): Promise<TaskSummary[]>;
     getTask(taskId: string, mode?: 'smart' | 'full'): Promise<Task | null>;
     createTask(task: {

package/dist/storage/httpClient.js

@@ -152,6 +152,13 @@ export class PpdocsApiClient {
     async readReferenceFile(path) {
         return this.request(`/refs/files/${cleanPath(path)}`);
     }
+    /** 复制本地文件到参考文件库, 返回相对路径列表 */
+    async copyReferenceFiles(paths, targetDir = '.') {
+        return this.request('/refs/copy-in', {
+            method: 'POST',
+            body: JSON.stringify({ paths, target_dir: targetDir }),
+        });
+    }
     // ============ 任务管理 ============
     async listTasks(status) {
         const query = status ? `?status=${status}` : '';

package/dist/tools/discussion.js

@@ -103,9 +103,9 @@ function formatDetailView(d) {
 }
 export function registerDiscussionTools(server, ctx) {
     const client = () => getClient();
-    server.tool('kg_discuss', '💬 跨项目讨论 — action: list|read|create|reply|complete|close|delete|history。权限: 仅成员可读写，仅发起人可删除/归档', {
-        action: z.enum(['list', 'read', 'create', 'reply', 'complete', 'close', 'delete', 'history'])
-            .describe('操作类型'),
+    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()
@@ -128,7 +128,13 @@ export function registerDiscussionTools(server, ctx) {
         const decoded = decodeObjectStrings(args);
         const me = sender(ctx);
         const myPid = ctx.projectId;
-        switch (decoded.action) {
+        // 智能默认：未指定 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 active = await client().discussionList();
@@ -249,7 +255,7 @@ export function registerDiscussionTools(server, ctx) {
                 return wrap(`✅ 讨论已删除 (ID: ${decoded.id})`);
             }
             default:
-                return wrap(`❌ 未知 action: ${decoded.action}`);
+                return wrap(`❌ 未知 action: ${action}`);
         }
     }));
 }

package/dist/tools/refs.js

@@ -91,6 +91,11 @@ export function registerReferenceTools(server) {
                     return wrap('❌ save 需要 title');
                 const existing = await client().getReference(decoded.id);
                 const now = new Date().toISOString();
+                // 直接传递原始路径给后端, Rust save_reference 会自动:
+                // 1. 检测绝对路径文件
+                // 2. 复制到公共文件池/外部参考/{项目名}/
+                // 3. 复制到 ref-files/ (供 read_file API 读取)
+                // 4. 替换为相对路径保存
                 await client().saveReference({
                     id: decoded.id,
                     title: decoded.title,

package/package.json

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