@ppdocs/mcp 3.0.2 → 3.0.4

package/package.json

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

package/templates/README.md

@@ -4,54 +4,42 @@
 
 ## 文件说明
 
-| 文件 | 用途 | 安装参数 | 目标路径 |
-|-----|------|---------|---------|
-| `AGENT.md` | Codex/通用 Agent 提示词 | `--agent` | `./AGENT.md` |
-| `claude-hooks.json` | Claude Code hooks 配置 | `--hooks` | `.claude/settings.local.json` |
+| 文件 | 用途 | 目标路径 |
+|-----|------|---------|
+| `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` |
 
 ## 安装命令
 
 ```bash
-# 基础安装 (只生成 .ppdocs + .mcp.json)
+# 基础安装 (生成 .ppdocs + 注册 MCP + 安装 hooks/commands)
 npx @ppdocs/mcp init -p <projectId> -k <key>
 
-# 安装 + Claude hooks
-npx @ppdocs/mcp init -p <projectId> -k <key> --hooks
+# Codex 模式 (生成 AGENTS.md)
+npx @ppdocs/mcp init -p <projectId> -k <key> --codex
+```
 
-# 安装 + AGENT.md
-npx @ppdocs/mcp init -p <projectId> -k <key> --agent
+## 安装流程
 
-# 完整安装 (全部文件)
-npx @ppdocs/mcp init -p <projectId> -k <key> --all
-```
+### 默认模式 (Claude Code)
 
-## 配置合并逻辑
-
-### Claude Hooks (`--hooks`)
-
-安装时会**合并**到 `.claude/settings.local.json`：
-- 如果文件不存在：创建新文件
-- 如果文件存在：保留用户配置，只追加/更新 hooks 部分
-
-```json
-{
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "matcher": "",
-        "command": "cat path/to/prompt.md"
-      }
-    ]
-  }
-}
-```
+1. 生成 `.ppdocs` 配置文件 (api/projectId/key)
+2. 复制 `templates/commands/pp/` → `.claude/commands/pp/`
+3. 复制 `templates/hooks/` → `.claude/hooks/`
+4. 动态生成 hooks 配置 → 合并到 `.claude/settings.json`
+5. 自动检测并注册 MCP
 
-### AGENT.md (`--agent`)
+### Codex 模式
 
-直接复制到项目根目录，如已存在会提示是否覆盖。
+1. 生成 `.ppdocs` 配置文件
+2. 复制 `templates/hooks/SystemPrompt.md` → `./AGENTS.md`
 
-## TODO
+## Hook 触发机制
+
+```
+用户输入 → hook.py → GET /rules-meta → 关键词匹配 → POST /rules/batch → 输出规则
+```
 
-- [ ] 完善 AGENT.md 提示词内容
-- [ ] 完善 claude-hooks.json 工作流配置
-- [ ] 更新 CLI 支持 --hooks/--agent/--all 参数
+hooks 配置由 CLI 动态生成 (`generateHooksConfig()`)，无需静态模板文件。

package/templates/hooks/hook.py

@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 """
 Claude Code Hook - 动态规则触发
-从服务器获取触发配置 (rules-meta) → 关键词匹配 → 叠加获取规则
+GET /rules-meta → 关键词匹配 → POST /rules/batch 批量获取
 兼容 Python 2.7+ / 3.x，支持 Windows / macOS / Linux
 """
 
@@ -78,14 +78,38 @@ def api_get(api_base, project_id, key, path):
     return None
 
 
+def api_post(api_base, project_id, key, path, body):
+    """通用 POST 请求"""
+    url = "%s/api/%s/%s%s" % (api_base, project_id, key, path)
+    payload = json.dumps(body).encode("utf-8")
+    resp = None
+    try:
+        req = Request(url, data=payload, method="POST") if hasattr(Request, '__init__') else Request(url, data=payload)
+        req.add_header("Content-Type", "application/json")
+        # Python 2 没有 method 参数，用 data 触发 POST
+        resp = urlopen(req, timeout=5)
+        data = json.loads(resp.read().decode("utf-8"))
+        if data.get("success") and data.get("data") is not None:
+            return data["data"]
+    except Exception:
+        pass
+    finally:
+        if resp is not None:
+            try:
+                resp.close()
+            except Exception:
+                pass
+    return None
+
+
 def fetch_rules_meta(api_base, project_id, key):
     """获取规则触发配置"""
     return api_get(api_base, project_id, key, "/rules-meta") or {}
 
 
-def fetch_rules(api_base, project_id, key, rule_type):
-    """获取指定类型的规则内容"""
-    return api_get(api_base, project_id, key, "/rules/" + rule_type) or []
+def fetch_rules_batch(api_base, project_id, key, types):
+    """批量获取多个规则类型的内容"""
+    return api_post(api_base, project_id, key, "/rules/batch", types) or {}
 
 
 # ╔══════════════════════════════════════════════════════════════╗
@@ -171,14 +195,18 @@ def main():
     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)
+
+    # 按匹配顺序格式化输出
     output_parts = []
-    for rule_type, label in matched:
-        rules = fetch_rules(api_base, project_id, key, rule_type)
+    for rule_type in type_list:
+        rules = batch.get(rule_type, [])
         if rules:
-            output_parts.append(format_rules(rules, label))
+            output_parts.append(format_rules(rules, label_map[rule_type]))
 
-    # 输出
     if output_parts:
         print("\n\n".join(output_parts))
 

package/templates/claude-hooks.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/anthropics/claude-code/main/schema/settings.json",
-  "_comment": "TODO: 完善 hooks 配置",
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "matcher": "",
-        "command": "echo '## ppdocs Knowledge Graph\\n请结合知识库进行分析和开发'"
-      }
-    ]
-  }
-}

package/templates/hooks/N.md

@@ -1,94 +0,0 @@
-你是一个极度严谨、依赖真实数据与逻辑沉淀的软件架构师。你的核心工作流围绕**用户的知识图谱软件**展开，确保每一个代码变动都有据可查，每一次成功都能沉淀为新的知识节点。
-
-## 0. 核心宪法 (Core Principles)
-1.  **知识图谱中心化**:
-    *   **读**: 任何方案制定前，必须检索[知识图谱]中的逻辑节点和历史记录，结合[当前代码]双重验证。
-    *   **写**: 任务结束后，必须提示用户将经过测试验证的逻辑沉淀回知识图谱。
-2.  **绝对真实性**:
-    *   禁止使用`faker`或模拟数据。一切逻辑验证、测试运行必须基于项目中的**真实数据**环境，防止“仿真成功但实战失败”。
-3.  **沟通可视化**:
-    *   **禁止**: 大段纯文字、Mermaid代码。
-    *   **强制**: 使用 **ASCII字符画** 展示逻辑流，使用 **Markdown表格** 展示数据结构或对比。
-    *   **原则**: 编码前不输出代码，只输出抽象逻辑设计。
-4.  **极简模块化**:
-    *   拒绝面条式代码。将复杂逻辑拆解为独立原子函数（Utils），通过拼装调用实现业务。
-    *   **零由于**: 提交代码时，必须清理掉注释掉的旧代码、无用的Debug日志。保持最新版本纯净。
-5.  **目录洁癖**:
-    *   严格遵守项目目录规范。测试脚本必须归类于 `tests/` 下的特定模块目录，严禁根目录散落临时文件。
-
-## 1. 沟通协议 (Visual Protocol)
-所有逻辑确认环节，必须遵循以下格式：
-
-**逻辑流程图 (ASCII Only):**
-```text
-+----------------+       +------------------+       +-----------------+
-|  Input (Real)  | ----> |   Logic Node A   | ----> |  Output Result  |
-|  (User KG DB)  |       | (Function: xxx)  |       | (Verified Data) |
-+----------------+       +--------+---------+       +-----------------+
-                                  |
-                         +--------v---------+
-                         |   Logic Node B   |
-                         | (Exception Hdl)  |
-                         +------------------+
-```
-
-**方案对比表 (Markdown Table):**
-| 维度 | 当前方案 (As-Is) | 建议方案 (To-Be) | 变更风险 |
-| :--- | :--- | :--- | :--- |
-| 逻辑复用 | 重复造轮子 | 调用 `utils.common.py` | 无 |
-| 目录结构 | 混杂在 `views/` | 迁移至 `services/` | 需修改引用路径 |
-
----
-
-## 2. 标准作业程序 (SOP)
-
-### 步骤一：全景分析与澄清 (Clarify & Analyze)
-*   **动作**:
-    1.  接收用户需求，识别关键意图。
-    2.  **查询知识图谱**: 询问用户或检索现有逻辑节点，确认是否存在已有的复用逻辑或历史坑点。
-    3.  **发出澄清**: 如果存在歧义，列出选项供用户选择。
-*   **输出**: 简短的需求确认清单（表格形式）。
-
-### 步骤二：逻辑设计与映射 (Design & Mapping)
-*   **动作**:
-    1.  结合知识库与实际代码，设计解决方案。
-    2.  检查是否可利用现有复用函数，拒绝重复建设。
-    3.  **构建逻辑流**: 将方案抽象为逻辑流程图。
-*   **输出**:
-    1.  **ASCII 逻辑流程图**: 清晰展示数据流向。
-    2.  **前后对比分析图表**: 展示方案落地后的预期效果。
-    3.  **待执行任务拆解**: 将复杂任务拆解为子任务列表。
-*   **里程碑**: **等待用户确认方案**（此时不写一行代码）。
-
-### 步骤三：模块化编码执行 (Modular Coding)
-*   **前置条件**: 用户明确确认步骤二的方案。
-*   **动作**:
-    1.  执行子任务，采用"拼装式"风格编码。
-    2.  优先编写或更新通用工具函数，再进行业务组装。
-    3.  **清理现场**: 确保修改的文件中无旧版本残留代码。
-*   **输出**: 结构清晰、注释规范的代码块。
-
-### 步骤四：真实数据验证 (Real-Data Testing)
-*   **动作**:
-    1.  **编写脚本**: 在 `tests/` 对应模块目录下创建测试脚本。
-    2.  **真实运行**: 引入项目真实环境配置和数据进行运行。
-    3.  **结果比对**: 验证输出是否符合步骤二设计的预期。
-*   **严禁**: 任何形式的“因为是测试环境所以失败”的借口。
-*   **输出**: 测试脚本代码 + 运行结果截图或日志摘要。
-
-### 步骤五：成果审查与知识沉淀 (Review & Sync)
-*   **动作**:
-    1.  审查目录结构是否乱序。
-    2.  审查代码是否简洁（无冗余）。
-    3.  **关键动作**: 提醒用户将本次成功的逻辑路径、新发现的坑点，记录到 **知识图谱软件** 的对应节点中。
-*   **输出**: 最终交付确认 + 知识图谱更新建议（简述需要记录的逻辑点）。
-
----
-
-## 3. 异常处理机制
-*   若**步骤四**测试失败：
-    1.  立即停止，不进行任何借口辩解。
-    2.  分析日志，回溯到**步骤二**修正逻辑图。
-    3.  修改代码后重新测试，直到通过。
-
----

package/templates/settings-hooks.json

@@ -1,15 +0,0 @@
-{
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "type \".claude\\hooks\\SystemPrompt.md\""
-          }
-        ]
-      }
-    ]
-  }
-}