@ppdocs/mcp 2.6.20 → 2.6.21

package/dist/cli.js

@@ -232,12 +232,10 @@ function copyDirRecursive(src, dest) {
         }
     }
 }
-/** 生成跨平台的 hooks 配置 */
+/** 生成跨平台的 hooks 配置 (调用 python hook.py) */
 function generateHooksConfig() {
-    const isWindows = process.platform === 'win32';
-    const command = isWindows
-        ? 'type ".claude\\hooks\\SystemPrompt.md"'
-        : 'cat ".claude/hooks/SystemPrompt.md"';
+    // hook.py 支持关键词动态匹配，比静态读取 MD 更灵活
+    const command = 'python .claude/hooks/hook.py';
     return {
         hooks: {
             UserPromptSubmit: [

package/dist/tools/index.js

@@ -21,18 +21,19 @@ export function registerTools(server, projectId, _user) {
         })).optional().describe('依赖列表(自动生成连线)'),
         relatedFiles: z.array(z.string()).optional().describe('关联的源文件路径数组，如 ["src/auth.ts"]')
     }, async (args) => {
+        const decoded = decodeObjectStrings(args);
         const node = await storage.createNode(projectId, {
-            title: args.title,
-            type: args.type,
+            title: decoded.title,
+            type: decoded.type,
             status: 'incomplete',
-            description: args.description || '',
+            description: decoded.description || '',
             // x, y 不传递，由 httpClient 智能计算位置
             locked: false,
-            signature: args.signature || args.title,
-            categories: args.tags,
-            path: args.path,
-            dependencies: args.dependencies || [],
-            relatedFiles: args.relatedFiles || []
+            signature: decoded.signature || decoded.title,
+            categories: decoded.tags,
+            path: decoded.path,
+            dependencies: decoded.dependencies || [],
+            relatedFiles: decoded.relatedFiles || []
         });
         return wrap(projectId, JSON.stringify(node, null, 2));
     });
@@ -70,7 +71,8 @@ export function registerTools(server, projectId, _user) {
             impact: z.string().optional()
         })).optional().describe('修复记录')
     }, async (args) => {
-        const { nodeId, tags, relatedFiles, versions, bugfixes, path, ...rest } = args;
+        const decoded = decodeObjectStrings(args);
+        const { nodeId, tags, relatedFiles, versions, bugfixes, path, ...rest } = decoded;
         // 根节点必须使用 kg_update_root 更新
         if (nodeId === 'root') {
             return wrap(projectId, '❌ 根节点请使用 kg_update_root 方法更新');
@@ -95,19 +97,20 @@ export function registerTools(server, projectId, _user) {
         title: z.string().optional().describe('项目标题'),
         description: z.string().optional().describe('项目介绍(Markdown)')
     }, async (args) => {
-        if (args.title === undefined && args.description === undefined) {
-            return wrap(projectId, '❌ 请至少提供 title 或 description');
+        const decoded = decodeObjectStrings(args);
+        if (decoded.title === undefined && decoded.description === undefined) {
+            return wrap(projectId, '❌ ���至少提供 title 或 description');
         }
         const node = await storage.updateRoot(projectId, {
-            title: args.title,
-            description: args.description
+            title: decoded.title,
+            description: decoded.description
         });
         return wrap(projectId, node ? '✅ 项目介绍已更新' : '更新失败(根节点已锁定)');
     });
     // 3.6 获取项目规则 (独立方法，按需调用)
     server.tool('kg_get_rules', '获取项目规则(可指定类型或获取全部)', {
-        ruleType: z.enum(['userStyles', 'testRules', 'reviewRules', 'codeStyle']).optional()
-            .describe('规则类型: userStyles=项目规则, testRules=测试规则, reviewRules=审查规则, codeStyle=编码风格。不传则返回全部')
+        ruleType: z.enum(['userStyles', 'testRules', 'reviewRules', 'codeStyle', 'unitTests']).optional()
+            .describe('规则类型: userStyles=用户沟通规则, codeStyle=编码风格规则, reviewRules=代码审查规则, testRules=错误分析规则, unitTests=代码测试规则。不传则返回全部')
     }, async (args) => {
         const rules = await getRules(projectId, args.ruleType);
         if (!rules || rules.trim() === '') {
@@ -118,15 +121,16 @@ export function registerTools(server, projectId, _user) {
     });
     // 3.7 保存项目规则 (独立存储)
     server.tool('kg_save_rules', '保存单个类型的项目规则(独立文件存储)', {
-        ruleType: z.enum(['userStyles', 'testRules', 'reviewRules', 'codeStyle'])
-            .describe('规则类型: userStyles=项目规则, testRules=测试规则, reviewRules=审查规则, codeStyle=编码风格'),
+        ruleType: z.enum(['userStyles', 'testRules', 'reviewRules', 'codeStyle', 'unitTests'])
+            .describe('规则类型: userStyles=用户沟通规则, codeStyle=编码风格规则, reviewRules=代码审查规则, testRules=错误分析规则, unitTests=代码测试规则'),
         rules: z.array(z.string()).describe('规则数组')
     }, async (args) => {
-        const success = await storage.saveRules(projectId, args.ruleType, args.rules);
+        const decoded = decodeObjectStrings(args);
+        const success = await storage.saveRules(projectId, decoded.ruleType, decoded.rules);
         if (!success) {
             return wrap(projectId, '❌ 保存失败');
         }
-        return wrap(projectId, `✅ ${RULE_TYPE_LABELS[args.ruleType]}已保存 (${args.rules.length} 条)`);
+        return wrap(projectId, `✅ ${RULE_TYPE_LABELS[decoded.ruleType]}已保存 (${decoded.rules.length} 条)`);
     });
     // 4. 锁定节点 (只能锁定，解锁需用户在前端手动操作)
     server.tool('kg_lock_node', '锁定节点(锁定后只能读取，解锁需用户在前端手动操作)', {

package/dist/utils.d.ts

@@ -1,7 +1,7 @@
 /**
  * MCP Server 工具函数
  */
-export type RuleType = 'userStyles' | 'testRules' | 'reviewRules' | 'codeStyle';
+export type RuleType = 'userStyles' | 'testRules' | 'reviewRules' | 'codeStyle' | 'unitTests';
 export declare const RULE_TYPE_LABELS: Record<RuleType, string>;
 /**
  * 获取指定类型的规则 (从独立文件读取)

package/dist/utils.js

@@ -4,10 +4,11 @@
 import * as storage from './storage/httpClient.js';
 // 规则类型显示名
 export const RULE_TYPE_LABELS = {
-    userStyles: '项目规则',
-    testRules: '测试规则',
-    reviewRules: '审查规则',
-    codeStyle: '编码风格',
+    userStyles: '用户沟通规则',
+    codeStyle: '编码风格规则',
+    reviewRules: '代码审查规则',
+    testRules: '错误分析规则',
+    unitTests: '代码测试规则',
 };
 /**
  * 将字符串数组格式化为 Markdown 列表

package/package.json

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

package/templates/hooks/hook.py

@@ -0,0 +1,186 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""
+Claude Code Hook - 关键词触发 + API 动态获取规则
+"""
+
+import io
+import json
+import os
+import sys
+import urllib.request
+
+# Windows 编码修复
+sys.stdin = io.TextIOWrapper(sys.stdin.buffer, encoding="utf-8", errors="replace")
+sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
+sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8", errors="replace")
+
+
+# ╔══════════════════════════════════════════════════════════════╗
+# ║  配置区                                                       ║
+# ╚══════════════════════════════════════════════════════════════╝
+
+# 关键词规则 (触发关键词 → 请求对应规则类型)
+RULES = [
+    {
+        "keywords": ["bug","修复","错误","报错","失败","异常","严重","存在","还是","有"],
+        "min_hits": 2,
+        "rule_type": "testRules",  # 错误分析规则
+        "label": "错误分析规则",
+    },
+    {
+        "keywords": ["审查", "审核", "review", "检查"],
+        "min_hits": 1,
+        "rule_type": "reviewRules",  # 审查规则
+        "label": "代码审查规则",
+    },
+    {
+        "keywords": ["编码", "风格", "格式", "命名", "编写", "开始", "代码"],
+        "min_hits": 2,
+        "rule_type": "codeStyle",  # 编码风格
+        "label": "编码风格规则",
+    },
+    {
+        "keywords": ["开始", "进行", "准备", "测试", "单元", "用例", "test", "覆盖率"],
+        "min_hits": 2,
+        "rule_type": "unitTests",  # 代码测试
+        "label": "代码测试规则",
+    },
+]
+
+# 绕过词列表
+BYPASS = [
+    "补充",
+    "确定",
+    "确认",
+    "继续",
+    "好的",
+    "可以",
+    "ok",
+    "yes",
+    "hi",
+    "hello",
+    "你好",
+]
+
+
+# ╔══════════════════════════════════════════════════════════════╗
+# ║  API 请求函数                                                  ║
+# ╚══════════════════════════════════════════════════════════════╝
+
+
+def load_ppdocs_config():
+    """读取 .ppdocs 配置"""
+    config_path = os.path.join(os.getcwd(), ".ppdocs")
+    if not os.path.exists(config_path):
+        return None
+    try:
+        with open(config_path, "r", encoding="utf-8") as f:
+            return json.load(f)
+    except:
+        return None
+
+
+def fetch_rules(api_base: str, project_id: str, key: str, rule_type: str) -> list:
+    """通过 HTTP API 获取指定类型的规则"""
+    url = f"{api_base}/api/{project_id}/{key}/rules/{rule_type}"
+    try:
+        req = urllib.request.Request(url, method="GET")
+        req.add_header("Content-Type", "application/json")
+        with urllib.request.urlopen(req, timeout=3) as resp:
+            data = json.loads(resp.read().decode("utf-8"))
+            if data.get("success") and data.get("data"):
+                return data["data"]
+    except:
+        pass
+    return []
+
+
+# ╔══════════════════════════════════════════════════════════════╗
+# ║  匹配逻辑                                                      ║
+# ╚══════════════════════════════════════════════════════════════╝
+
+
+def count_hits(text: str, keywords: list) -> int:
+    """计算关键词命中数量"""
+    return sum(1 for kw in keywords if kw.lower() in text)
+
+
+def match_rule(text: str):
+    """匹配规则，返回 (rule, matched)"""
+    for rule in RULES:
+        hits = count_hits(text, rule["keywords"])
+        if hits >= rule.get("min_hits", 1):
+            return rule, True
+    return None, False
+
+
+def format_rules(items: list, label: str) -> str:
+    """格式化规则输出"""
+    if not items:
+        return ""
+    lines = [f"# {label}\n"]
+    for item in items:
+        lines.append(f"- {item}")
+    return "\n".join(lines)
+
+
+# ╔══════════════════════════════════════════════════════════════╗
+# ║  主入口                                                        ║
+# ╚══════════════════════════════════════════════════════════════╝
+
+
+def main():
+    try:
+        data = json.load(sys.stdin)
+    except:
+        return
+
+    if data.get("hook_event_name") != "UserPromptSubmit":
+        return
+
+    user_input = data.get("prompt", "").strip()
+    if not user_input:
+        return
+
+    user_input_lower = user_input.lower()
+
+    # 短输入包含绕过词 → 跳过
+    if len(user_input) <= 15:
+        for word in BYPASS:
+            if word.lower() in user_input_lower:
+                return
+
+    # 读取配置
+    config = load_ppdocs_config()
+    if not config:
+        return
+
+    api_base = config.get("api", "http://localhost:20001")
+    project_id = config.get("projectId", "")
+    key = config.get("key", "")
+
+    if not project_id or not key:
+        return
+
+    output_parts = []
+
+    # 1. 强制获取 userStyles (用户沟通规则)
+    user_styles = fetch_rules(api_base, project_id, key, "userStyles")
+    if user_styles:
+        output_parts.append(format_rules(user_styles, "用户沟通规则"))
+
+    # 2. 根据关键词匹配额外规则
+    rule, matched = match_rule(user_input_lower)
+    if matched and rule["rule_type"] != "userStyles":
+        extra_rules = fetch_rules(api_base, project_id, key, rule["rule_type"])
+        if extra_rules:
+            output_parts.append(format_rules(extra_rules, rule["label"]))
+
+    # 输出
+    if output_parts:
+        print("\n\n".join(output_parts))
+
+
+if __name__ == "__main__":
+    main()