@ppdocs/mcp 3.2.37 → 3.2.38

package/README.md

@@ -114,7 +114,7 @@ npx @ppdocs/mcp init -p <projectId> -k <key> --codex
 | `kg_init` | 初始化项目连接与上下文 |
 | `kg_status` | 查看项目仪表盘与流程图概况 |
 | `kg_flowchart` | 统一的知识图谱入口，负责查询、更新、关系分析 |
-| `kg_rules` | 规则管理 |
+| `kg_workflow` | Markdown 文档工作流管理 |
 | `kg_task` | 任务管理 |
 | `kg_files` | 项目文件读写/上传下载 |
 | `kg_discuss` | 讨论区 |

package/dist/cli.js

@@ -392,11 +392,12 @@ function generateMcpPermissions() {
         'kg_status',
         // 知识管理
         'kg_projects',
-        'kg_rules',
+        'kg_workflow',
         // 工作流
         'kg_task',
         'kg_files',
         'kg_discuss',
+        'kg_ref',
         // 流程图
         'kg_flowchart',
         // 协作

package/dist/storage/httpClient.d.ts

@@ -4,19 +4,31 @@
  *
  * API URL 格式: http://localhost:20099/api/:projectId/:password/...
  */
-import type { Task, TaskSummary, TaskLogType, TaskExperience, FileInfo, RuleMeta } from './types.js';
+import type { Task, TaskSummary, TaskLogType, TaskExperience, FileInfo, WorkflowSummary, WorkflowDoc, WorkflowSelector, Reference } from './types.js';
 export declare class PpdocsApiClient {
     private baseUrl;
     private serverUrl;
     constructor(apiUrl: string);
     private request;
-    getRulesApi(ruleType: string): Promise<string[]>;
-    saveRulesApi(ruleType: string, rules: string[]): Promise<boolean>;
-    getRulesMeta(): Promise<Record<string, RuleMeta>>;
-    saveRulesMeta(meta: Record<string, RuleMeta>): Promise<boolean>;
-    crossGetRulesMeta(target: string): Promise<Record<string, RuleMeta>>;
-    getGlobalRulesMeta(): Promise<Record<string, RuleMeta>>;
-    saveGlobalRulesMeta(meta: Record<string, RuleMeta>): Promise<boolean>;
+    listWorkflows(scope?: 'all' | 'global' | 'project'): Promise<WorkflowSummary[]>;
+    getWorkflow(workflowId: string, scope?: 'all' | 'global' | 'project'): Promise<WorkflowDoc | null>;
+    getWorkflowBatch(selectors: WorkflowSelector[]): Promise<WorkflowDoc[]>;
+    saveWorkflow(workflowId: string, input: {
+        scope: 'global' | 'project';
+        title: string;
+        description: string;
+        system: string;
+        keywords: string[];
+        minHits: number;
+        always: boolean;
+        content: string;
+    }): Promise<WorkflowDoc>;
+    deleteWorkflow(workflowId: string, scope: 'global' | 'project'): Promise<boolean>;
+    listReferences(): Promise<Reference[]>;
+    getReference(refId: string): Promise<Reference | null>;
+    saveReference(reference: Reference): Promise<boolean>;
+    deleteReference(refId: string): Promise<boolean>;
+    readReferenceFile(path: string): Promise<string>;
     listTasks(status?: 'active' | 'archived'): Promise<TaskSummary[]>;
     getTask(taskId: string, mode?: 'smart' | 'full'): Promise<Task | null>;
     createTask(task: {
@@ -46,8 +58,6 @@ export declare class PpdocsApiClient {
         description: string;
         updatedAt: string;
     }[]>;
-    /** 跨项目: 获取规则 */
-    crossGetRules(target: string, ruleType: string): Promise<string[]>;
     /** 列出项目文件 */
     listFiles(dir?: string): Promise<FileInfo[]>;
     /** 读取项目文件 */
@@ -95,6 +105,10 @@ export declare class PpdocsApiClient {
     discussionReply(id: string, sender: string, content: string, msgSummary?: string, newSummary?: string): Promise<boolean>;
     /** 完成讨论 (公开路由, 标记为 completed) */
     discussionComplete(id: string): Promise<boolean>;
+    /** 归档关闭讨论 (需项目认证) */
+    discussionClose(id: string, conclusion: string): Promise<{
+        archived_path?: string;
+    }>;
     /** 删除讨论 (公开路由) */
     discussionDelete(id: string): Promise<boolean>;
     /** 列出公共文件 */

package/dist/storage/httpClient.js

@@ -99,75 +99,64 @@ export class PpdocsApiClient {
             clearTimeout(timeout);
         }
     }
-    // ============ 规则 API ============
-    async getRulesApi(ruleType) {
-        try {
-            return await this.request(`/rules/${ruleType}`);
-        }
-        catch {
-            return [];
-        }
+    // ============ 工作流 API ============
+    async listWorkflows(scope) {
+        const query = scope ? `?scope=${scope}` : '';
+        return this.request(`/workflows${query}`);
     }
-    async saveRulesApi(ruleType, rules) {
+    async getWorkflow(workflowId, scope) {
         try {
-            await this.request(`/rules/${ruleType}`, {
-                method: 'PUT',
-                body: JSON.stringify(rules)
-            });
-            return true;
+            const query = scope ? `?scope=${scope}` : '';
+            return await this.request(`/workflows/${encodeURIComponent(workflowId)}${query}`);
         }
         catch {
-            return false;
+            return null;
         }
     }
-    async getRulesMeta() {
-        try {
-            return await this.request('/rules-meta');
-        }
-        catch {
-            return {};
-        }
+    async getWorkflowBatch(selectors) {
+        return this.request('/workflows/batch', {
+            method: 'POST',
+            body: JSON.stringify(selectors),
+        });
     }
-    async saveRulesMeta(meta) {
-        try {
-            await this.request('/rules-meta', {
-                method: 'PUT',
-                body: JSON.stringify(meta)
-            });
-            return true;
-        }
-        catch {
-            return false;
-        }
+    async saveWorkflow(workflowId, input) {
+        return this.request(`/workflows/${encodeURIComponent(workflowId)}`, {
+            method: 'PUT',
+            body: JSON.stringify(input),
+        });
     }
-    async crossGetRulesMeta(target) {
-        try {
-            return await this.request(`/cross/${encodeURIComponent(target)}/rules-meta`);
-        }
-        catch {
-            return {};
-        }
+    async deleteWorkflow(workflowId, scope) {
+        return this.request(`/workflows/${encodeURIComponent(workflowId)}?scope=${scope}`, {
+            method: 'DELETE',
+        });
     }
-    async getGlobalRulesMeta() {
-        try {
-            return await this.request('/global-rules-meta');
-        }
-        catch {
-            return {};
-        }
+    // ============ 外部参考 API ============
+    async listReferences() {
+        return this.request('/refs');
     }
-    async saveGlobalRulesMeta(meta) {
+    async getReference(refId) {
         try {
-            await this.request('/global-rules-meta', {
-                method: 'PUT',
-                body: JSON.stringify(meta)
-            });
-            return true;
+            return await this.request(`/refs/${encodeURIComponent(refId)}`);
         }
         catch {
-            return false;
+            return null;
         }
     }
+    async saveReference(reference) {
+        await this.request(`/refs/${encodeURIComponent(reference.id)}`, {
+            method: 'PUT',
+            body: JSON.stringify(reference),
+        });
+        return true;
+    }
+    async deleteReference(refId) {
+        return this.request(`/refs/${encodeURIComponent(refId)}`, {
+            method: 'DELETE',
+        });
+    }
+    async readReferenceFile(path) {
+        return this.request(`/refs/files/${cleanPath(path)}`);
+    }
     // ============ 任务管理 ============
     async listTasks(status) {
         const query = status ? `?status=${status}` : '';
@@ -285,15 +274,6 @@ export class PpdocsApiClient {
     async crossListProjects() {
         return this.request('/cross/projects');
     }
-    /** 跨项目: 获取规则 */
-    async crossGetRules(target, ruleType) {
-        try {
-            return await this.request(`/cross/${encodeURIComponent(target)}/rules/${ruleType}`);
-        }
-        catch {
-            return [];
-        }
-    }
     // ============ 项目文件访问 ============
     /** 列出项目文件 */
     async listFiles(dir) {
@@ -466,6 +446,13 @@ export class PpdocsApiClient {
             method: 'POST',
         });
     }
+    /** 归档关闭讨论 (需项目认证) */
+    async discussionClose(id, conclusion) {
+        return this.request(`/discussions/${encodeURIComponent(id)}/close`, {
+            method: 'POST',
+            body: JSON.stringify({ conclusion }),
+        });
+    }
     /** 删除讨论 (公开路由) */
     async discussionDelete(id) {
         return this.publicRequest(`/api/discussions/${encodeURIComponent(id)}`, {

package/dist/storage/types.d.ts

@@ -4,6 +4,48 @@ export interface RuleMeta {
     min_hits: number;
     always?: boolean;
 }
+export interface WorkflowSummary {
+    id: string;
+    scope: 'global' | 'project';
+    title: string;
+    description: string;
+    system: string;
+    keywords: string[];
+    minHits: number;
+    always: boolean;
+    updatedAt: string;
+}
+export interface WorkflowDoc extends WorkflowSummary {
+    content: string;
+}
+export interface WorkflowSelector {
+    id: string;
+    scope?: 'global' | 'project';
+}
+export interface ReferenceLink {
+    url: string;
+    label: string;
+}
+export interface ReferenceFile {
+    name: string;
+    path: string;
+}
+export interface AdoptedNode {
+    chartId: string;
+    nodeId: string;
+    nodeLabel: string;
+}
+export interface Reference {
+    id: string;
+    title: string;
+    summary: string;
+    links: ReferenceLink[];
+    files: ReferenceFile[];
+    scripts: ReferenceFile[];
+    adoptedBy: AdoptedNode[];
+    createdAt: string;
+    updatedAt: string;
+}
 export interface FileInfo {
     name: string;
     path: string;

package/dist/tools/analyzer.d.ts

@@ -2,7 +2,7 @@
  * 代码分析引擎工具 (3个)
  * code_scan, code_smart_context, code_full_path
  *
- * code_smart_context: 代码+KG文档全关联 (含影响范围)
+ * code_smart_context: 代码+KG文档/工作流全关联 (含影响范围)
  * code_full_path: 两点间代码链路+共享KG文档
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';

package/dist/tools/analyzer.js

@@ -2,7 +2,7 @@
  * 代码分析引擎工具 (3个)
  * code_scan, code_smart_context, code_full_path
  *
- * code_smart_context: 代码+KG文档全关联 (含影响范围)
+ * code_smart_context: 代码+KG文档/工作流全关联 (含影响范围)
  * code_full_path: 两点间代码链路+共享KG文档
  */
 import { z } from 'zod';
@@ -33,7 +33,7 @@ export function registerAnalyzerTools(server, ctx) {
         ].join('\n'));
     }));
     // ===== code_smart_context: 代码+文档全关联上下文 =====
-    server.tool('code_smart_context', '🔍 代码+文档全关联上下文 — 输入一个函数名,一次调用返回:代码依赖、关联文档、匹配规则、活跃任务、影响范围摘要。需先运行 code_scan', {
+    server.tool('code_smart_context', '🔍 代码+文档全关联上下文 — 输入一个函数名,一次调用返回:代码依赖、关联文档、匹配工作流、活跃任务、影响范围摘要。需先运行 code_scan', {
         projectPath: z.string().optional().describe('项目源码的绝对路径(不传则自动解析)'),
         symbolName: z.string().describe('要查询的符号名称(如"handleLogin", "AuthService")'),
     }, async (args) => safeTool(async () => {
@@ -75,11 +75,12 @@ export function registerAnalyzerTools(server, ctx) {
             }
             lines.push('');
         }
-        // 匹配规则
-        if (smartCtx.matchedRules.length > 0) {
-            lines.push(`### 📏 匹配规则 (${smartCtx.matchedRules.length})`);
-            for (const rule of smartCtx.matchedRules) {
-                lines.push(`  [${rule.ruleType}] ${rule.content.substring(0, 100)}`);
+        // 匹配工作流
+        if (smartCtx.matchedWorkflows.length > 0) {
+            lines.push(`### 📘 匹配工作流 (${smartCtx.matchedWorkflows.length})`);
+            for (const workflow of smartCtx.matchedWorkflows) {
+                const desc = workflow.description ? ` — ${workflow.description}` : '';
+                lines.push(`  [${workflow.scope}/${workflow.system || 'general'}] ${workflow.title}${desc}`);
             }
             lines.push('');
         }

package/dist/tools/discussion.js

@@ -233,13 +233,9 @@ export function registerDiscussionTools(server, ctx) {
                 if (brief && !isInitiator(brief, me, myPid)) {
                     return wrap(`🔒 无权限: 仅发起人 (${brief.initiator}) 可归档讨论\n你的身份: ${me}`);
                 }
-                // 先追加结案总结
-                try {
-                    await client().discussionReply(decoded.id, me, `📋 结案总结:\n\n${decoded.conclusion}`, '结案总结');
-                }
-                catch { /* 忽略回复失败 */ }
-                await client().discussionComplete(decoded.id);
-                return wrap(`✅ 讨论已结案 (ID: ${decoded.id})\n📋 ${decoded.conclusion}`);
+                const result = await client().discussionClose(decoded.id, decoded.conclusion);
+                const archivePath = result?.archived_path ? `\n📦 已归档: ${result.archived_path}` : '';
+                return wrap(`✅ 讨论已结案并归档 (ID: ${decoded.id})\n📋 ${decoded.conclusion}${archivePath}`);
             }
             case 'delete': {
                 if (!decoded.id)

package/dist/tools/flowchart.js

@@ -249,7 +249,10 @@ function findDirectedPath(chart, fromId, toId) {
 }
 export function registerFlowchartTools(server, _ctx) {
     const client = () => getClient();
-    server.tool('kg_flowchart', 'Logical flowchart operations: list|get|search|get_relations|find_path|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart', {
+    server.tool('kg_flowchart', '🔀 逻辑流程图 — 项目知识图谱的核心。每个节点代表一个模块/函数/概念，节点可绑定文件、内嵌版本化文档。\n' +
+        '⚡ 开始任何任务前必须先查图谱：search 搜关键词 → get_node 看详情 → 有 subFlowchart 则递归下探。\n' +
+        '📝 完成修改后必须回写：bind 绑定文件 → update_node 更新描述和文档 → 新模块用 batch_add。\n' +
+        'actions: list|get|search|get_relations|find_path|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart', {
         action: z
             .enum(['list', 'get', 'search', 'get_relations', 'find_path', 'get_node', 'update_node', 'delete_node', 'batch_add', 'bind', 'unbind', 'orphans', 'health', 'create_chart', 'delete_chart'])
             .describe('action type'),

package/dist/tools/index.d.ts

@@ -1,11 +1,11 @@
 /**
  * MCP 工具注册入口
- * 12 个工具, 6 个子模块
+ * 13 个工具, 7 个子模块
  *
  * 🔗 初始化:   kg_init                                           (1个)
  * 📊 导航:     kg_status                                         (1个)
- * 📚 知识:     kg_projects, kg_rules                              (2个)
- * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区)     (3个)
+ * 📚 知识:     kg_projects, kg_workflow                           (2个)
+ * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区), kg_ref (4个)
  * 🔀 关系核心: kg_flowchart(逻辑流程图 — 关系型知识锚点)           (1个)
  * 🔬 代码分析: code_scan, code_smart_context, code_full_path      (3个)
  * 🏛️ 协作:    kg_meeting                                         (1个)

package/dist/tools/index.js

@@ -1,11 +1,11 @@
 /**
  * MCP 工具注册入口
- * 12 个工具, 6 个子模块
+ * 13 个工具, 7 个子模块
  *
  * 🔗 初始化:   kg_init                                           (1个)
  * 📊 导航:     kg_status                                         (1个)
- * 📚 知识:     kg_projects, kg_rules                              (2个)
- * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区)     (3个)
+ * 📚 知识:     kg_projects, kg_workflow                           (2个)
+ * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区), kg_ref (4个)
  * 🔀 关系核心: kg_flowchart(逻辑流程图 — 关系型知识锚点)           (1个)
  * 🔬 代码分析: code_scan, code_smart_context, code_full_path      (3个)
  * 🏛️ 协作:    kg_meeting                                         (1个)
@@ -14,10 +14,11 @@ import { createContext } from './shared.js';
 import { registerInitTool } from './init.js';
 import { registerStatusTool } from './kg_status.js';
 import { registerProjectTools } from './projects.js';
-import { registerRuleTools } from './rules.js';
+import { registerWorkflowTools } from './workflow.js';
 import { registerTaskTools } from './tasks.js';
 import { registerFileTools } from './files.js';
 import { registerDiscussionTools } from './discussion.js';
+import { registerReferenceTools } from './refs.js';
 import { registerAnalyzerTools } from './analyzer.js';
 import { registerMeetingTools } from './meeting.js';
 import { registerFlowchartTools } from './flowchart.js';
@@ -29,11 +30,12 @@ export function registerTools(server, projectId, user, onProjectChange) {
     registerStatusTool(server, ctx);
     // 📚 知识
     registerProjectTools(server, ctx);
-    registerRuleTools(server, ctx);
+    registerWorkflowTools(server, ctx);
     // 📝 工作流
     registerTaskTools(server, ctx);
     registerFileTools(server);
     registerDiscussionTools(server, ctx);
+    registerReferenceTools(server);
     // 🔬 代码分析
     registerAnalyzerTools(server, ctx);
     // 🏛️ 多AI协作

package/dist/tools/refs.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerReferenceTools(server: McpServer): void;

package/dist/tools/refs.js

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+import { getClient } from '../storage/httpClient.js';
+import { decodeObjectStrings } from '../utils.js';
+import { safeTool, wrap } from './shared.js';
+const linkSchema = z.object({
+    url: z.string(),
+    label: z.string(),
+});
+const fileSchema = z.object({
+    name: z.string(),
+    path: z.string(),
+});
+const adoptedNodeSchema = z.object({
+    chartId: z.string(),
+    nodeId: z.string(),
+    nodeLabel: z.string(),
+});
+export function registerReferenceTools(server) {
+    const client = () => getClient();
+    server.tool('kg_ref', '📎 外部参考 — 管理项目引用的第三方资料、链接、脚本和样例文件。\n' +
+        '涉及参考资料时主动调用：list 查看已有 → get 读详情 → read_file 读附件内容 → save 新增。\n' +
+        'actions: list|get|save|delete|read_file', {
+        action: z.enum(['list', 'get', 'save', 'delete', 'read_file']).describe('操作类型'),
+        id: z.string().optional().describe('参考 ID'),
+        title: z.string().optional().describe('参考标题 (save)'),
+        summary: z.string().optional().describe('Markdown 总结 (save)'),
+        links: z.array(linkSchema).optional().describe('参考链接 (save)'),
+        files: z.array(fileSchema).optional().describe('参考文件 (save)'),
+        scripts: z.array(fileSchema).optional().describe('解析脚本 (save)'),
+        adoptedBy: z.array(adoptedNodeSchema).optional().describe('已采用该参考的节点 (save)'),
+        path: z.string().optional().describe('参考文件路径 (read_file)'),
+    }, async (args) => safeTool(async () => {
+        const decoded = decodeObjectStrings(args);
+        switch (decoded.action) {
+            case 'list': {
+                const refs = await client().listReferences();
+                if (refs.length === 0)
+                    return wrap('当前没有外部参考');
+                const lines = [
+                    `📎 外部参考 (${refs.length})`,
+                    '',
+                    '| ID | 标题 | 链接 | 文件 | 已采用 |',
+                    '|:---|:---|---:|---:|---:|',
+                ];
+                for (const ref of refs) {
+                    lines.push(`| ${ref.id} | ${ref.title} | ${ref.links.length} | ${ref.files.length} | ${ref.adoptedBy.length} |`);
+                }
+                return wrap(lines.join('\n'));
+            }
+            case 'get': {
+                if (!decoded.id)
+                    return wrap('❌ get 需要 id');
+                const ref = await client().getReference(decoded.id);
+                if (!ref)
+                    return wrap(`未找到外部参考: ${decoded.id}`);
+                const lines = [
+                    `# ${ref.title}`,
+                    '',
+                    `- ID: ${ref.id}`,
+                    `- Links: ${ref.links.length}`,
+                    `- Files: ${ref.files.length}`,
+                    `- Scripts: ${ref.scripts.length}`,
+                    `- AdoptedBy: ${ref.adoptedBy.length}`,
+                    '',
+                    ref.summary || '(无摘要)',
+                ];
+                if (ref.links.length > 0) {
+                    lines.push('', '## Links');
+                    for (const link of ref.links) {
+                        lines.push(`- ${link.label}: ${link.url}`);
+                    }
+                }
+                if (ref.files.length > 0) {
+                    lines.push('', '## Files');
+                    for (const file of ref.files) {
+                        lines.push(`- ${file.name}: ${file.path}`);
+                    }
+                }
+                if (ref.scripts.length > 0) {
+                    lines.push('', '## Scripts');
+                    for (const script of ref.scripts) {
+                        lines.push(`- ${script.name}: ${script.path}`);
+                    }
+                }
+                return wrap(lines.join('\n'));
+            }
+            case 'save': {
+                if (!decoded.id)
+                    return wrap('❌ save 需要 id');
+                if (!decoded.title)
+                    return wrap('❌ save 需要 title');
+                const existing = await client().getReference(decoded.id);
+                const now = new Date().toISOString();
+                await client().saveReference({
+                    id: decoded.id,
+                    title: decoded.title,
+                    summary: decoded.summary || existing?.summary || '',
+                    links: decoded.links || existing?.links || [],
+                    files: decoded.files || existing?.files || [],
+                    scripts: decoded.scripts || existing?.scripts || [],
+                    adoptedBy: decoded.adoptedBy || existing?.adoptedBy || [],
+                    createdAt: existing?.createdAt || now,
+                    updatedAt: now,
+                });
+                return wrap(`✅ 外部参考已保存 (${decoded.id})`);
+            }
+            case 'delete': {
+                if (!decoded.id)
+                    return wrap('❌ delete 需要 id');
+                const ok = await client().deleteReference(decoded.id);
+                return wrap(ok ? `✅ 外部参考已删除 (${decoded.id})` : `ℹ️ 未找到外部参考 (${decoded.id})`);
+            }
+            case 'read_file': {
+                if (!decoded.path)
+                    return wrap('❌ read_file 需要 path');
+                const content = await client().readReferenceFile(decoded.path);
+                return wrap(content);
+            }
+            default:
+                return wrap(`❌ 未知 action: ${decoded.action}`);
+        }
+    }));
+}

package/dist/tools/tasks.js

@@ -184,14 +184,14 @@ export function registerTaskTools(server, ctx) {
                     return wrap('归档失败(任务不存在或已归档)');
                 return wrap(`✅ 任务已归档: ${task.title}`);
             }
-            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})` : '❌ 删除失败(任务不存在)');
             }
+            default:
+                return wrap(`❌ 未知 action: ${decoded.action}`);
         }
     }));
 }

package/dist/tools/workflow.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from './shared.js';
+export declare function registerWorkflowTools(server: McpServer, _ctx: McpContext): void;

package/dist/tools/workflow.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { getClient } from '../storage/httpClient.js';
+import { decodeObjectStrings } from '../utils.js';
+import { safeTool, wrap } from './shared.js';
+export function registerWorkflowTools(server, _ctx) {
+    const client = () => getClient();
+    server.tool('kg_workflow', '📘 文档工作流 — AI 的标准操作手册。每个工作流是一份 Markdown 文档，定义了特定场景下 AI 应该遵循的步骤和规范。\n' +
+        '调用方式：空参数=列出所有工作流；传 id=获取工作流正文；save/delete 需显式 action。\n' +
+        '典型用法：拿到任务后先 kg_workflow() 看有无相关工作流，有则 kg_workflow(id:"xxx") 读取并遵循执行。', {
+        action: z.enum(['list', 'get', 'save', 'delete']).optional().describe('省略时自动推断：无参数=list，有id=get'),
+        id: z.string().optional().describe('工作流 ID'),
+        scope: z.enum(['all', 'global', 'project']).optional().describe('范围：all(默认)|global|project'),
+        title: z.string().optional().describe('标题 (save 必填)'),
+        content: z.string().optional().describe('Markdown 正文 (save 必填)'),
+    }, async (args) => safeTool(async () => {
+        const decoded = decodeObjectStrings(args);
+        const action = decoded.action ?? (decoded.id ? 'get' : 'list');
+        if (!decoded.action && (decoded.title !== undefined || decoded.content !== undefined)) {
+            return wrap('❌ save/delete 需要显式传 action');
+        }
+        switch (action) {
+            case 'list': {
+                const workflows = await client().listWorkflows(decoded.scope ?? 'all');
+                if (workflows.length === 0)
+                    return wrap('当前没有可用文档工作流');
+                const lines = [
+                    `📘 文档工作流列表 (${workflows.length})`,
+                    '',
+                    '| ID | 范围 | 标题 |',
+                    '|:---|:---|:---|',
+                ];
+                for (const w of workflows) {
+                    lines.push(`| ${w.id} | ${w.scope} | ${w.title} |`);
+                }
+                return wrap(lines.join('\n'));
+            }
+            case 'get': {
+                if (!decoded.id)
+                    return wrap('❌ get 需要 id');
+                const doc = await client().getWorkflow(decoded.id, decoded.scope ?? 'all');
+                if (!doc)
+                    return wrap(`未找到工作流: ${decoded.id}`);
+                return wrap([
+                    `# ${doc.title}`,
+                    `> ID: ${doc.id} | 范围: ${doc.scope}`,
+                    '',
+                    doc.content,
+                ].join('\n'));
+            }
+            case 'save': {
+                if (!decoded.id)
+                    return wrap('❌ save 需要 id');
+                if (!decoded.title)
+                    return wrap('❌ save 需要 title');
+                if (!decoded.content)
+                    return wrap('❌ save 需要 content');
+                const doc = await client().saveWorkflow(decoded.id, {
+                    scope: decoded.scope === 'global' ? 'global' : 'project',
+                    title: decoded.title,
+                    description: '',
+                    system: '',
+                    keywords: [],
+                    minHits: 0,
+                    always: false,
+                    content: decoded.content,
+                });
+                return wrap(`✅ 已保存: ${doc.scope}/${doc.id} — ${doc.title}`);
+            }
+            case 'delete': {
+                if (!decoded.id)
+                    return wrap('❌ delete 需要 id');
+                const scope = decoded.scope === 'global' ? 'global' : 'project';
+                const ok = await client().deleteWorkflow(decoded.id, scope);
+                return wrap(ok ? `✅ 已删除 ${scope}/${decoded.id}` : `未找到 ${scope}/${decoded.id}`);
+            }
+            default:
+                return wrap(`❌ 未知 action: ${String(decoded.action)}`);
+        }
+    }));
+}

package/dist/utils.d.ts

@@ -1,12 +1,6 @@
 /**
  * MCP Server 工具函数
  */
-export type RuleType = string;
-export declare const RULE_TYPE_LABELS: Record<string, string>;
-/**
- * 获取指定类型的规则 (动态: 从 meta 获取标签)
- */
-export declare function getRules(projectId: string, ruleType?: string): Promise<string>;
 /**
  * 解码 Unicode 转义序列
  * 将 \uXXXX 格式的转义序列转换为实际字符

package/dist/utils.js

@@ -1,50 +1,6 @@
 /**
  * MCP Server 工具函数
  */
-import { getClient } from './storage/httpClient.js';
-// 默认规则类型标签 (fallback)
-const DEFAULT_LABELS = {
-    userStyles: '用户沟通规则',
-    codeStyle: '编码风格规则',
-    reviewRules: '代码审查规则',
-    testRules: '错误分析规则',
-    unitTests: '代码测试规则',
-};
-// 兼容导出
-export const RULE_TYPE_LABELS = DEFAULT_LABELS;
-/**
- * 将字符串数组格式化为 Markdown 列表
- */
-function formatRulesList(rules) {
-    if (!rules || rules.length === 0)
-        return '';
-    return rules.map((s, i) => `${i + 1}. ${s}`).join('\n\n');
-}
-/**
- * 获取指定类型的规则 (动态: 从 meta 获取标签)
- */
-export async function getRules(projectId, ruleType) {
-    const client = getClient();
-    const meta = await client.getRulesMeta();
-    if (ruleType) {
-        const rules = await client.getRulesApi(ruleType);
-        if (!rules || rules.length === 0)
-            return '';
-        const label = meta[ruleType]?.label || DEFAULT_LABELS[ruleType] || ruleType;
-        return `[${label}]\n${formatRulesList(rules)}`;
-    }
-    // 返回所有规则 (从 meta 获取所有类型)
-    const types = Object.keys(meta).length > 0 ? Object.keys(meta) : Object.keys(DEFAULT_LABELS);
-    const allRules = [];
-    for (const type of types) {
-        const rules = await client.getRulesApi(type);
-        if (rules && rules.length > 0) {
-            const label = meta[type]?.label || DEFAULT_LABELS[type] || type;
-            allRules.push(`[${label}]\n${formatRulesList(rules)}`);
-        }
-    }
-    return allRules.join('\n\n---\n\n');
-}
 /**
  * 解码 Unicode 转义序列
  * 将 \uXXXX 格式的转义序列转换为实际字符

package/package.json

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

package/templates/AGENT.md

@@ -12,9 +12,10 @@ kg_discuss(action:"list") -> ???????
 ## 1. ????????
 
 - ??: `kg_flowchart(action:"list|get|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart")`
-- ??: `kg_rules(action:"get|save|get_meta|save_meta")`
+- ??: `kg_workflow()` / `kg_workflow(id:"...")` / `kg_workflow(action:"save|delete")`
 - ??: `kg_task(action:"create|get|update|archive|delete")`
 - ??: `kg_files(action:"list|read|upload|download|public_*")`
+- ??: `kg_ref(action:"list|get|save|delete|read_file")`
 - ??/??: `kg_discuss(...)`, `kg_meeting(...)`
 - ????: `code_scan()`, `code_smart_context(symbolName)`, `code_full_path(symbolA, symbolB)`
 - ????: ?????????????????????????????? fallback????????????
@@ -22,7 +23,7 @@ kg_discuss(action:"list") -> ???????
 ## 2. ?????
 
 ### Step 1: ????
-1. ?? `kg_flowchart(get)` ????????? `kg_rules(get)` ?????
+1. ?? `kg_flowchart(get)` ????????? `kg_workflow()` ?????
 2. ???????? `kg_flowchart(get_node, expand:2, includeDoc:true, includeFiles:true)`?
 3. ????? `subFlowchart`???????????????
 4. ??????????? `code_scan()`??? `code_smart_context` / `code_full_path`?

package/templates/README.md

@@ -6,7 +6,7 @@
 
 | 文件 | 用途 | 目标路径 |
 |-----|------|---------|
-| `hooks/hook.py` | 动态规则触发脚本 (关键词匹配 + 批量获取) | `.claude/hooks/hook.py` |
+| `hooks/hook.py` | 动态文档工作流触发脚本 (关键词匹配 + 批量获取) | `.claude/hooks/hook.py` |
 | `hooks/SystemPrompt.md` | 系统提示词模板 | `.claude/hooks/SystemPrompt.md` |
 | `commands/pp/` | Claude Code 自定义命令 | `.claude/commands/pp/` |
 | `AGENT.md` | Codex/通用 Agent 提示词 | `./AGENTS.md` |
@@ -45,7 +45,7 @@ CLI 通过 `detectIDEs()` 扫描项目目录，自动为检测到的 IDE 安装
 ## Hook 触发机制
 
 ```
-用户输入 → hook.py → GET /rules-meta → 关键词匹配 → POST /rules/batch → 输出规则
+用户输入 → hook.py → GET /workflows → 关键词匹配 → POST /workflows/batch → 输出工作流
 ```
 
 hooks 配置由 CLI 动态生成 (`generateHooksConfig()`)，无需静态模板文件。

package/templates/commands/pp/diagnose.md

@@ -21,7 +21,7 @@
 ```
 kg_flowchart(action:"list")        → 知识图谱列表
 kg_flowchart(action:"get")         → 主图结构 (模块 + 连线)
-kg_rules(action:"get", ruleType:"errorAnalysis") → 错误分析规则
+kg_workflow(id:"review-audit") → 诊断工作流
 ```
 
 **1.2 关键词定位模块**
@@ -68,7 +68,7 @@ Step 3: 输出疑点路径
 
 ```
 code_smart_context(嫌疑符号名)
-  → 代码依赖 + 关联文档 + 匹配规则 + 影响范围摘要
+  → 代码依赖 + 关联文档 + 匹配工作流 + 影响范围摘要
 
 code_impact(嫌疑符号名)
   → L1 直接引用 (必须检查)
@@ -164,7 +164,7 @@ L2: 2个间接调用方可能受影响
 |:---|:---|:---|
 | 锚定 | `kg_flowchart(list/get)` | 全景鸟瞰 |
 | 锚定 | `kg_flowchart(get)` | 主图结构 |
-| 锚定 | `kg_rules(get)` | 分析规则 |
+| 锚定 | `kg_workflow()` / `kg_workflow(id:"...")` | 分析工作流 |
 | 下探 | `kg_flowchart(get_node, expand:N)` | 节点详情+上下游 |
 | 下探 | `kg_flowchart(get, chartId:子图)` | 进入子图 |
 | 半径 | `code_smart_context(symbol)` | 全关联上下文 |

package/templates/commands/pp/review.md

@@ -4,7 +4,7 @@
 
 | 原则 | 要求 |
 |:---|:---|
-| **规则驱动** | 必须先加载 kg_rules, 以项目规则为审查标准 |
+| **工作流驱动** | 必须先加载 kg_workflow, 以 Markdown 工作流为审查标准 |
 | **4维并行** | 逻辑/清洁/极简/图谱一致性 同时扫描 |
 | **零容忍** | 任一维度 CRITICAL 即驳回, 不存在"下次再改" |
 | **健康闭环** | 审查必须包含图谱健康检查, 确保知识库同步 |
@@ -26,11 +26,10 @@
 ### Phase 0: 加载审查标准
 
 ```
-kg_rules(action:"get", ruleType:"reviewRules")  → 审查规则
-kg_rules(action:"get", ruleType:"codeStyle")    → 编码风格
-kg_rules(action:"get", ruleType:"errorAnalysis") → 错误分析规则
+kg_workflow(id:"review-audit")   → 审查/诊断工作流
+kg_workflow(id:"common-general") → 通用执行工作流
 ```
-将获取的规则作为本次审查的量化标准。
+将获取的文档工作流作为本次审查的量化标准。
 
 **确定审查范围**:
 ```
@@ -75,7 +74,7 @@ Bash: git log --oneline -3         → 近期提交
 
 #### C. 极简架构
 ```
-对照 codeStyle 规则逐条检查:
+对照已加载文档工作流中的编码约束逐条检查:
   × 函数超50行                              → 🟡 拆分建议
   × 嵌套超3层                               → 🟡 扁平化建议
   × 重复造轮子 (code_query 搜索已有实现)      → 🔴
@@ -144,9 +143,9 @@ kg_flowchart(action:"health")
 **概览**: 评分 85/100 | 🔴 0 | 🟡 2 | 🔵 1
 **状态**: ✅ 通过 / ❌ 驳回
 
-**应用规则**:
-- reviewRules: 已加载 N 条
-- codeStyle: 已加载 M 条
+**应用文档工作流**:
+- review-audit: 已加载
+- common-general: 已加载
 
 **逻辑验证图** (A维度):
 [用户输入] → [参数校验] → [业务处理] → [返回结果] ✅ 闭环
@@ -174,7 +173,7 @@ kg_flowchart(action:"health")
 
 | 阶段 | 工具 | 用途 |
 |:---|:---|:---|
-| 加载 | `kg_rules(get)` | 审查规则/编码风格 |
+| 加载 | `kg_workflow(id:"...")` | 审查/执行工作流 |
 | 范围 | `code_context(file)` | 变更文件的依赖 |
 | A逻辑 | 人工推演 + ASCII图 | 逻辑闭环验证 |
 | B清洁 | `Grep(pattern)` | 死代码/调试残留扫描 |

package/templates/cursorrules.md

@@ -12,9 +12,10 @@ kg_discuss(action:"list") -> ???????
 ## 1. ????????
 
 - ??: `kg_flowchart(action:"list|get|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart")`
-- ??: `kg_rules(action:"get|save|get_meta|save_meta")`
+- ??: `kg_workflow()` / `kg_workflow(id:"...")` / `kg_workflow(action:"save|delete")`
 - ??: `kg_task(action:"create|get|update|archive|delete")`
 - ??: `kg_files(action:"list|read|upload|download|public_*")`
+- ??: `kg_ref(action:"list|get|save|delete|read_file")`
 - ??/??: `kg_discuss(...)`, `kg_meeting(...)`
 - ????: `code_scan()`, `code_smart_context(symbolName)`, `code_full_path(symbolA, symbolB)`
 - ????: ?????????????????????????????? fallback????????????
@@ -22,7 +23,7 @@ kg_discuss(action:"list") -> ???????
 ## 2. ?????
 
 ### Step 1: ????
-1. ?? `kg_flowchart(get)` ????????? `kg_rules(get)` ?????
+1. ?? `kg_flowchart(get)` ????????? `kg_workflow()` ?????
 2. ???????? `kg_flowchart(get_node, expand:2, includeDoc:true, includeFiles:true)`?
 3. ????? `subFlowchart`???????????????
 4. ??????????? `code_scan()`??? `code_smart_context` / `code_full_path`?

package/templates/hooks/SystemPrompt.md

@@ -8,7 +8,7 @@
 |:---|:---|
 | **知识图谱中心** | 方案制定前检索图谱+代码双重验证；任务结束提示沉淀至图谱 |
 | **任务驱动开发** | 复杂任务必须 `kg_task(action:"create")`；过程记录 `kg_task(action:"update")`；完成 `kg_task(action:"archive")` |
-| **规则引用** | 编码前读 `codeStyle`；测试前读 `testRules`；审查前读 `reviewRules` |
+| **工作流引用** | 先 `kg_workflow()` 查看当前可用文档工作流；执行前优先读 `common-general`，审查/诊断前优先读 `review-audit` |
 | **绝对真实性** | 禁用 faker/模拟数据，必须真实环境验证 |
 | **沟通可视化** | 禁纯文字/Mermaid代码；强制 ASCII流程图 + Markdown表格 |
 | **极简模块化** | 拆解为原子函数，清理注释旧代码/Debug日志 |
@@ -33,14 +33,14 @@ kg_task(action:"create") → kg_task(action:"update", log_type:"progress|issue|s
 ### Step 1: 分析与澄清
 1. 接收需求，识别意图
 2. `kg_flowchart(action:"search", query:"关键词")` 检索现有节点/历史坑点
-3. `kg_rules(action:"get")` 获取项目规则
+3. `kg_workflow()` 获取全局/项目文档工作流，按需 `kg_workflow(id:"common-general")`
 4. 有歧义则列选项供用户选择
 
 **输出**: 需求确认清单 (表格)
 
 ### Step 2: 逻辑设计
 1. 结合图谱+代码设计方案
-2. `kg_rules(action:"get", ruleType:"codeStyle")` 确认编码规范
+2. `kg_workflow(id:"common-general")` 确认通用执行工作流
 3. 检查现有复用函数，拒绝重复建设
 4. 大型任务: `kg_task(action:"create")`
 
@@ -51,13 +51,13 @@ kg_task(action:"create") → kg_task(action:"update", log_type:"progress|issue|s
 **前置**: 用户确认方案
 1. `kg_task(action:"update", log_type:"progress", content:"开始编码")`
 2. 优先编写/更新工具函数，再业务组装
-3. 遵循 codeStyle 规则
+3. 遵循已加载文档工作流中的编码约束
 4. 清理现场，无残留代码
 
 **输出**: 结构清晰的代码
 
 ### Step 4: 真实验证
-1. `kg_rules(action:"get", ruleType:"testRules")` 获取测试规则
+1. `kg_workflow(id:"review-audit")` 获取验证/诊断工作流
 2. 在 `tests/` 对应目录创建测试
 3. 真实环境运行，验证输出
 4. 失败时: `kg_task(action:"update", log_type:"issue", content:"xxx失败")` → 回溯Step2
@@ -65,7 +65,7 @@ kg_task(action:"create") → kg_task(action:"update", log_type:"progress|issue|s
 **严禁**: "测试环境所以失败"借口
 
 ### Step 5: 审查与沉淀
-1. `kg_rules(action:"get", ruleType:"reviewRules")` 获取审查规则
+1. `kg_workflow(id:"review-audit")` 获取审查工作流
 2. 审查目录结构/代码简洁度
 3. 发现BUG → `kg_flowchart(action:"update_node")` 回写节点说明与文档
 4. 新逻辑 → `kg_flowchart(action:"batch_add")` 新增节点，或 `kg_flowchart(action:"update_node")` 追加文档/版本

package/templates/hooks/hook.py

@@ -1,8 +1,8 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 """
-Claude Code Hook - 动态规则触发
-GET /rules-meta → 关键词匹配 → POST /rules/batch 批量获取
+Claude Code Hook - 动态工作流触发
+GET /workflows → 关键词匹配 → POST /workflows/batch 批量获取 Markdown 工作流
 兼容 Python 2.7+ / 3.x，支持 Windows / macOS / Linux
 """
 
@@ -123,14 +123,14 @@ def api_post(api_base, project_id, key, path, body):
     return None
 
 
-def fetch_rules_meta(api_base, project_id, key):
-    """获取规则触发配置"""
-    return api_get(api_base, project_id, key, "/rules-meta") or {}
+def fetch_workflows(api_base, project_id, key):
+    """获取可用工作流摘要"""
+    return api_get(api_base, project_id, key, "/workflows") or []
 
 
-def fetch_rules_batch(api_base, project_id, key, types):
-    """批量获取多个规则类型的内容"""
-    return api_post(api_base, project_id, key, "/rules/batch", types) or {}
+def fetch_workflows_batch(api_base, project_id, key, items):
+    """批量获取工作流正文"""
+    return api_post(api_base, project_id, key, "/workflows/batch", items) or []
 
 
 # ╔══════════════════════════════════════════════════════════════╗
@@ -143,27 +143,36 @@ def count_hits(text, keywords):
     return sum(1 for kw in keywords if kw.lower() in text)
 
 
-def match_all(text, meta):
-    """匹配所有触发的规则类型，返回 [(rule_type, label), ...]"""
+def match_all(text, workflows):
+    """匹配所有触发的工作流，返回工作流摘要列表"""
     matched = []
-    for rule_type, config in meta.items():
-        if config.get("always"):
-            matched.append((rule_type, config.get("label", rule_type)))
+    for wf in workflows:
+        if wf.get("always"):
+            matched.append(wf)
             continue
-        keywords = config.get("keywords", [])
-        min_hits = config.get("min_hits", 1)
+        keywords = wf.get("keywords", [])
+        min_hits = wf.get("minHits", 1)
         if keywords and count_hits(text, keywords) >= min_hits:
-            matched.append((rule_type, config.get("label", rule_type)))
+            matched.append(wf)
     return matched
 
 
-def format_rules(items, label):
-    """格式化规则输出"""
-    if not items:
+def format_workflow(item):
+    """格式化工作流输出"""
+    content = item.get("content", "")
+    if not content:
         return ""
-    lines = ["# %s\n" % label]
-    for item in items:
-        lines.append("- %s" % item)
+    lines = ["# %s" % item.get("title", item.get("id", "workflow"))]
+    meta = []
+    if item.get("scope"):
+        meta.append("scope=%s" % item.get("scope"))
+    if item.get("system"):
+        meta.append("system=%s" % item.get("system"))
+    if meta:
+        lines.append("")
+        lines.append("> %s" % " | ".join(meta))
+    lines.append("")
+    lines.append(content)
     return "\n".join(lines)
 
 
@@ -204,27 +213,35 @@ def main():
     if not project_id or not key:
         return
 
-    # 从服务器获取触发配置
-    meta = fetch_rules_meta(api_base, project_id, key)
-    if not meta:
+    # 从服务器获取工作流摘要
+    workflows = fetch_workflows(api_base, project_id, key)
+    if not workflows:
         return
 
-    # 匹配所有触发的规则
-    matched = match_all(user_input_lower, meta)
+    # 匹配所有触发的工作流
+    matched = match_all(user_input_lower, workflows)
     if not matched:
         return
 
-    # 批量获取所有命中的规则内容 (单次请求)
-    type_list = [rule_type for rule_type, _ in matched]
-    label_map = {rule_type: label for rule_type, label in matched}
-    batch = fetch_rules_batch(api_base, project_id, key, type_list)
+    # 批量获取所有命中的工作流正文
+    selectors = [{"id": wf.get("id", ""), "scope": wf.get("scope", "")} for wf in matched if wf.get("id")]
+    batch = fetch_workflows_batch(api_base, project_id, key, selectors)
+    if not batch:
+        return
+
+    batch_map = {}
+    for item in batch:
+        batch_map["%s:%s" % (item.get("scope", ""), item.get("id", ""))] = item
 
     # 按匹配顺序格式化输出
     output_parts = []
-    for rule_type in type_list:
-        rules = batch.get(rule_type, [])
-        if rules:
-            output_parts.append(format_rules(rules, label_map[rule_type]))
+    for wf in matched:
+        key_name = "%s:%s" % (wf.get("scope", ""), wf.get("id", ""))
+        item = batch_map.get(key_name)
+        if item:
+            rendered = format_workflow(item)
+            if rendered:
+                output_parts.append(rendered)
 
     if output_parts:
         print("\n\n".join(output_parts))

package/templates/kiro-rules/ppdocs.md

@@ -12,9 +12,10 @@ kg_discuss(action:"list") -> ???????
 ## 1. ????????
 
 - ??: `kg_flowchart(action:"list|get|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart")`
-- ??: `kg_rules(action:"get|save|get_meta|save_meta")`
+- ??: `kg_workflow()` / `kg_workflow(id:"...")` / `kg_workflow(action:"save|delete")`
 - ??: `kg_task(action:"create|get|update|archive|delete")`
 - ??: `kg_files(action:"list|read|upload|download|public_*")`
+- ??: `kg_ref(action:"list|get|save|delete|read_file")`
 - ??/??: `kg_discuss(...)`, `kg_meeting(...)`
 - ????: `code_scan()`, `code_smart_context(symbolName)`, `code_full_path(symbolA, symbolB)`
 - ????: ?????????????????????????????? fallback????????????
@@ -22,7 +23,7 @@ kg_discuss(action:"list") -> ???????
 ## 2. ?????
 
 ### Step 1: ????
-1. ?? `kg_flowchart(get)` ????????? `kg_rules(get)` ?????
+1. ?? `kg_flowchart(get)` ????????? `kg_workflow()` ?????
 2. ???????? `kg_flowchart(get_node, expand:2, includeDoc:true, includeFiles:true)`?
 3. ????? `subFlowchart`???????????????
 4. ??????????? `code_scan()`??? `code_smart_context` / `code_full_path`?

package/dist/tools/rules.d.ts

@@ -1,7 +0,0 @@
-/**
- * 📏 kg_rules
- * 统一规则入口: get | save | get_meta | save_meta | delete
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type McpContext } from './shared.js';
-export declare function registerRuleTools(server: McpServer, ctx: McpContext): void;

package/dist/tools/rules.js

@@ -1,120 +0,0 @@
-/**
- * 📏 kg_rules
- * 统一规则入口: get | save | get_meta | save_meta | delete
- */
-import { z } from 'zod';
-import { getClient } from '../storage/httpClient.js';
-import { decodeObjectStrings, getRules, RULE_TYPE_LABELS } from '../utils.js';
-import { wrap, safeTool, crossPrefix } from './shared.js';
-export function registerRuleTools(server, ctx) {
-    const client = () => getClient();
-    server.tool('kg_rules', '📏 项目规则管理 — 读取或保存代码风格、审查规则等。action: get(读取规则)|save(保存规则)|get_meta(读取触发配置)|save_meta(保存触发配置)', {
-        action: z.enum(['get', 'save', 'get_meta', 'save_meta', 'delete'])
-            .describe('操作类型'),
-        ruleType: z.string().optional()
-            .describe('规则类型(如 userStyles, codeStyle, reviewRules)。get/save 时使用，不传则获取全部'),
-        rules: z.array(z.string()).optional()
-            .describe('save 时的规则数组'),
-        meta: z.record(z.string(), z.object({
-            label: z.string().describe('规则显示名称'),
-            keywords: z.array(z.string()).default([]).describe('触发关键词列表'),
-            min_hits: z.number().default(1).describe('最低触发关键词数'),
-            always: z.boolean().default(false).describe('是否始终触发')
-        })).optional().describe('save_meta 时的触发配置映射'),
-        targetProject: z.string().optional()
-            .describe('跨项目读取 (get)'),
-    }, async (args) => safeTool(async () => {
-        const decoded = decodeObjectStrings(args);
-        switch (decoded.action) {
-            case 'get': {
-                if (decoded.targetProject) {
-                    const crossMeta = await client().crossGetRulesMeta(decoded.targetProject);
-                    if (decoded.ruleType) {
-                        const rules = await client().crossGetRules(decoded.targetProject, decoded.ruleType);
-                        if (rules.length === 0) {
-                            const label = crossMeta[decoded.ruleType]?.label || decoded.ruleType;
-                            return wrap(`暂无${label}规则(项目: ${decoded.targetProject})`);
-                        }
-                        return wrap(`${crossPrefix(decoded.targetProject)}${rules.join('\n')}`);
-                    }
-                    const types = Object.keys(crossMeta).length > 0 ? Object.keys(crossMeta) : Object.keys(RULE_TYPE_LABELS);
-                    const allRules = [];
-                    for (const type of types) {
-                        const rules = await client().crossGetRules(decoded.targetProject, type);
-                        if (rules.length > 0) {
-                            const label = crossMeta[type]?.label || RULE_TYPE_LABELS[type] || type;
-                            allRules.push(`## ${label}\n${rules.join('\n')}`);
-                        }
-                    }
-                    if (allRules.length === 0)
-                        return wrap(`暂无项目规则(项目: ${decoded.targetProject})`);
-                    return wrap(`${crossPrefix(decoded.targetProject)}${allRules.join('\n\n')}`);
-                }
-                const rules = await getRules(ctx.projectId, decoded.ruleType || undefined);
-                if (!rules || rules.trim() === '') {
-                    const meta = await client().getRulesMeta();
-                    const typeName = decoded.ruleType ? (meta[decoded.ruleType]?.label || decoded.ruleType) : '项目';
-                    return wrap(`暂无${typeName}规则`);
-                }
-                return wrap(rules);
-            }
-            case 'save': {
-                if (!decoded.ruleType)
-                    return wrap('❌ save 需要 ruleType');
-                if (!decoded.rules)
-                    return wrap('❌ save 需要 rules 数组');
-                const existing = await client().getRulesApi(decoded.ruleType);
-                const existingSet = new Set(existing.map(r => r.trim()));
-                const toAdd = decoded.rules.filter((r) => !existingSet.has(r.trim()));
-                const merged = [...existing, ...toAdd];
-                const success = await client().saveRulesApi(decoded.ruleType, merged);
-                if (!success)
-                    return wrap('❌ 保存失败');
-                const meta = await client().getRulesMeta();
-                const label = meta[decoded.ruleType]?.label || decoded.ruleType;
-                return wrap(`✅ ${label}已保存 (新增${toAdd.length}条, 共${merged.length}条)`);
-            }
-            case 'get_meta': {
-                const meta = await client().getRulesMeta();
-                if (Object.keys(meta).length === 0)
-                    return wrap('暂无规则配置');
-                const lines = Object.entries(meta).map(([type, m]) => {
-                    const kw = m.keywords.length > 0 ? m.keywords.join(', ') : '(无)';
-                    const trigger = m.always ? '始终触发' : `关键词≥${m.min_hits}: ${kw}`;
-                    return `- **${m.label}** (${type}): ${trigger}`;
-                });
-                return wrap(`规则触发配置:\n\n${lines.join('\n')}`);
-            }
-            case 'save_meta': {
-                if (!decoded.meta)
-                    return wrap('❌ save_meta 需要 meta');
-                const existing = await client().getRulesMeta();
-                const merged = { ...existing, ...decoded.meta };
-                const success = await client().saveRulesMeta(merged);
-                if (!success)
-                    return wrap('❌ 保存失败');
-                return wrap(`✅ 触发配置已保存 (更新${Object.keys(decoded.meta).length}个类型, 共${Object.keys(merged).length}个类型)`);
-            }
-            case 'delete': {
-                if (!decoded.ruleType)
-                    return wrap('❌ delete 需要 ruleType');
-                if (!decoded.rules || decoded.rules.length === 0)
-                    return wrap('❌ delete 需要 rules 数组(要删除的规则内容)');
-                const existing = await client().getRulesApi(decoded.ruleType);
-                const toDelete = new Set(decoded.rules.map((r) => r.trim()));
-                const filtered = existing.filter((r) => !toDelete.has(r.trim()));
-                const removed = existing.length - filtered.length;
-                if (removed === 0)
-                    return wrap('ℹ️ 未找到匹配的规则');
-                const success = await client().saveRulesApi(decoded.ruleType, filtered);
-                if (!success)
-                    return wrap('❌ 删除失败');
-                const meta = await client().getRulesMeta();
-                const label = meta[decoded.ruleType]?.label || decoded.ruleType;
-                return wrap(`✅ ${label}: 已删除${removed}条, 剩余${filtered.length}条`);
-            }
-            default:
-                return wrap(`❌ 未知 action: ${decoded.action}`);
-        }
-    }));
-}