@ppdocs/mcp 2.6.10 → 2.6.12

package/dist/tools/index.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import * as storage from '../storage/httpClient.js';
-import { decodeUnicodeEscapes, decodeObjectStrings, wrapResult, clearStyleCache } from '../utils.js';
+import { decodeUnicodeEscapes, decodeObjectStrings, wrapResult, clearStyleCache, getRootStyle } from '../utils.js';
 // 辅助函数: 包装返回结果
 async function wrap(projectId, text) {
     const wrapped = await wrapResult(projectId, text);
@@ -51,19 +51,35 @@ export function registerTools(server, projectId, _user) {
             name: z.string(),
             description: z.string()
         })).optional().describe('依赖列表'),
-        relatedFiles: z.array(z.string()).optional().describe('关联的源文件路径数组')
+        relatedFiles: z.array(z.string()).optional().describe('关联的源文件路径数组'),
+        versions: z.array(z.object({
+            version: z.number(),
+            date: z.string(),
+            changes: z.string()
+        })).optional().describe('版本记录'),
+        bugfixes: z.array(z.object({
+            id: z.string(),
+            date: z.string(),
+            issue: z.string(),
+            solution: z.string(),
+            impact: z.string().optional()
+        })).optional().describe('修复记录')
     }, async (args) => {
-        const { nodeId, tags, relatedFiles, ...rest } = args;
+        const { nodeId, tags, relatedFiles, versions, bugfixes, ...rest } = args;
         // 根节点必须使用 kg_update_root 更新
         if (nodeId === 'root') {
             return wrap(projectId, '❌ 根节点请使用 kg_update_root 方法更新');
         }
-        // API 参数 tags 转换为内部字段 categories
+        // API 参数转换
         let updates = { ...rest };
         if (tags !== undefined)
             updates.categories = tags;
         if (relatedFiles !== undefined)
             updates.relatedFiles = relatedFiles;
+        if (versions !== undefined)
+            updates.versions = versions;
+        if (bugfixes !== undefined)
+            updates.bugfixes = bugfixes;
         const node = await storage.updateNode(projectId, nodeId, updates);
         return wrap(projectId, node ? JSON.stringify(node, null, 2) : '更新失败(节点不存在或已锁定)');
     });
@@ -86,6 +102,14 @@ export function registerTools(server, projectId, _user) {
             clearStyleCache();
         return wrap(projectId, node ? JSON.stringify(node, null, 2) : '更新失败(根节点已锁定)');
     });
+    // 3.6 获取项目规则 (独立方法，按需调用)
+    server.tool('kg_get_rules', '获取项目规则列表(按需调用，不再自动附加到每个方法返回)', {}, async () => {
+        const style = await getRootStyle(projectId);
+        if (!style || style.trim() === '') {
+            return { content: [{ type: 'text', text: '暂无项目规则' }] };
+        }
+        return { content: [{ type: 'text', text: `[项目规则]\n${style}` }] };
+    });
     // 4. 锁定节点 (只能锁定，解锁需用户在前端手动操作)
     server.tool('kg_lock_node', '锁定节点(锁定后只能读取，解锁需用户在前端手动操作)', {
         nodeId: z.string().describe('节点ID')

package/dist/utils.d.ts

@@ -10,9 +10,9 @@ export declare function getRootStyle(projectId: string): Promise<string>;
  */
 export declare function clearStyleCache(): void;
 /**
- * 包装工具返回结果 (注入用户风格)
+ * 包装工具返回结果 (不再自动注入规则，使用 kg_get_rules 按需获取)
  */
-export declare function wrapResult(projectId: string, result: string): Promise<string>;
+export declare function wrapResult(_projectId: string, result: string): Promise<string>;
 /**
  * 解码 Unicode 转义序列
  * 将 \uXXXX 格式的转义序列转换为实际字符

package/dist/utils.js

@@ -50,14 +50,10 @@ export function clearStyleCache() {
     cacheProjectId = null;
 }
 /**
- * 包装工具返回结果 (注入用户风格)
+ * 包装工具返回结果 (不再自动注入规则，使用 kg_get_rules 按需获取)
  */
-export async function wrapResult(projectId, result) {
-    const style = await getRootStyle(projectId);
-    if (!style || style.trim() === '') {
-        return result;
-    }
-    return `[项目规则]\n${style}\n\n---\n[结果]\n${result}`;
+export async function wrapResult(_projectId, result) {
+    return result;
 }
 /**
  * 解码 Unicode 转义序列

package/package.json

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