@ppdocs/mcp 3.2.36 → 3.2.38

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/init.md

@@ -4,7 +4,7 @@ description: 初始化知识图谱：100%扫描代码库，为每个模块创建
 
 # /init 项目初始化
 
-执行 `task_create("项目初始化: [项目名]")` → 递归扫描全部代码文件 → 逐文件审查创建节点 → 每处理5个文件调用 `task_add_log(progress)` 同步进度 → 全部完成后 `task_complete` 输出统计报告
+执行 `kg_task(action:"create", title:"项目初始化: [项目名]")` → 递归扫描全部代码文件 → 逐文件审查创建节点 → 每处理5个文件调用 `kg_task(action:"update", log_type:"progress")` 同步进度 → 全部完成后 `kg_task(action:"archive")` 输出统计报告
 
 ## 扫描规则
 
@@ -84,11 +84,11 @@ flowchart TB
 
 ## 进度同步
 
-每处理5个文件或完成1个目录后，调用 `task_add_log("progress", "已处理: [文件列表], 创建节点: N个")`
+每处理5个文件或完成1个目录后，调用 `kg_task(action:"update", log_type:"progress", content:"已处理: [文件列表], 创建节点: N个")`
 
 ## 完成输出
 
-`task_complete` 时输出完整统计：
+`kg_task(action:"archive")` 时输出完整统计：
 
 ```markdown
 | 统计项 | 数量 |

package/templates/commands/pp/diagnose.md

@@ -19,9 +19,9 @@
 
 **1.1 建立全景**
 ```
-kg_tree()                          → 知识全景图
-kg_flowchart(action:"get")         → 主图结构 (8个模块 + 连线)
-kg_rules(action:"get", ruleType:"errorAnalysis") → 错误分析规则
+kg_flowchart(action:"list")        → 知识图谱列表
+kg_flowchart(action:"get")         → 主图结构 (模块 + 连线)
+kg_workflow(id:"review-audit") → 诊断工作流
 ```
 
 **1.2 关键词定位模块**
@@ -68,7 +68,7 @@ Step 3: 输出疑点路径
 
 ```
 code_smart_context(嫌疑符号名)
-  → 代码依赖 + 关联文档 + 匹配规则 + 影响范围摘要
+  → 代码依赖 + 关联文档 + 匹配工作流 + 影响范围摘要
 
 code_impact(嫌疑符号名)
   → L1 直接引用 (必须检查)
@@ -162,9 +162,9 @@ L2: 2个间接调用方可能受影响
 
 | 阶段 | 工具 | 用途 |
 |:---|:---|:---|
-| 锚定 | `kg_tree()` | 全景鸟瞰 |
+| 锚定 | `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/init.md

@@ -27,10 +27,10 @@
 
 ### Phase 0: 环境准备
 ```
-kg_init()              → 连接项目上下文
-kg_status()            → 查看仪表盘 (文档数/任务数/状态)
-kg_tree()              → 已有知识全景图
-kg_flowchart(action:"list")  → 已有流程图列表
+kg_init()                   → 连接项目上下文
+kg_status()                 → 查看仪表盘 (流程图/任务/状态)
+kg_flowchart(action:"list") → 已有流程图列表
+kg_flowchart(action:"get")  → 主图结构总览
 ```
 如果已有图谱 → 提示用户选择: 增量补充 or 重建
 
@@ -125,27 +125,18 @@ kg_flowchart(action:"bind", nodeId:"n_graph_store",
   dirs:["src-tauri/src/storage/"])
 ```
 
-**3.2 创建参考文档 (遵循5分类规范)**
+**3.2 写入节点内置文档 (`docEntries`)**
 ```
-文档分类:
-  /模块/后端/存储层      → 对应 n_storage
-  /模块/后端/graph_store → 对应 n_graph_store
-  /模块/前端/FlowchartView → 对应 n_flowchart_view
-  /架构/事件驱动         → 对应架构决策
-  /功能/知识图谱编辑      → 对应用户功能
-
-kg_doc(action:"create",
-  path:"/模块/后端/graph_store",
-  summary:"项目/文档/规则/搜索的核心存储, JSON持久化",
-  content:"## 职责\n...\n## 公开API\n...\n## 文件路径\n...",
-  bindTo:"n_graph_store")
+kg_flowchart(action:"update_node", chartId:"sub_storage", nodeId:"n_graph_store",
+  docSummary:"项目/规则/流程图数据持久化核心",
+  docContent:"## 职责\n...\n## 公开 API\n...\n## 文件路径\n- src-tauri/src/storage/graph_store.rs")
 ```
 
 ### Phase 4: 健康验证
 ```
 kg_flowchart(action:"orphans")    → 孤立节点 (应为0)
 kg_flowchart(action:"health")     → 冷热分布
-kg_tree()                         → 全景确认文档覆盖
+kg_flowchart(action:"get")        → 全景确认节点覆盖与连线
 kg_status()                       → 最终仪表盘
 ```
 

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/commands/pp/sync.md

@@ -7,7 +7,7 @@
 | **代码即真理** | 代码与图谱冲突时以 Git 状态为准, 强制覆写 |
 | **层级感知** | 变更定位到具体子图层级, 逐层向上验证影响链 |
 | **最小变更** | 只更新有差异的节点/文档, 不做无意义的全量覆写 |
-| **创建即关联** | 新增节点必须 bind 源码 + 创建/关联文档, 无孤立资产 |
+| **创建即关联** | 新增节点必须 bind 源码 + 写入节点文档, 无孤立资产 |
 
 ---
 
@@ -30,9 +30,9 @@
 **1.1 获取图谱现状**
 ```
 kg_init()                        → 确保项目连接
-kg_tree()                        → 文档全景
 kg_flowchart(action:"list")      → 所有流程图
 kg_flowchart(action:"get")       → 主图节点+连线
+kg_flowchart(action:"search", query:"关键词") → 快速定位相关节点
 ```
 
 **1.2 获取代码变更**
@@ -106,12 +106,10 @@ all 模式:
 3. 绑定源码:
    kg_flowchart(action:"bind", nodeId:"n_xxx", files:["src/..."])
 
-4. 创建文档 (遵循5分类):
-   kg_doc(action:"create",
-     path:"/模块/前端/xxx",
-     summary:"一句话职责",
-     content:"## 职责\n...\n## 公开API\n...\n## 文件路径\n...",
-     bindTo:"n_xxx")
+4. 写入节点文档:
+   kg_flowchart(action:"update_node", chartId:目标子图, nodeId:"n_xxx",
+     docSummary:"一句话职责",
+     docContent:"## 职责\n...\n## 公开API\n...\n## 文件路径\n...")
 ```
 
 **3.2 处理 [MOD] — 更新节点**
@@ -126,8 +124,9 @@ all 模式:
      docSummary:"更新后的摘要")
 
 3. 追加版本记录:
-   kg_doc(action:"update", path:"/模块/.../xxx",
-     versions:[{version:当前+0.1, date:"ISO日期", changes:"变更摘要"}])
+   kg_flowchart(action:"update_node", chartId:目标子图, nodeId:"n_xxx",
+     docSummary:"本次变更摘要",
+     docContent:"更新后的详细文档")
 
 4. 检查连线是否需要更新:
    code_context(filePath) → 新的import列表
@@ -142,7 +141,6 @@ all 模式:
 
 选项B - 彻底删除:
   kg_flowchart(action:"delete_node", nodeId:"n_xxx")
-  kg_doc(action:"delete", path:"/模块/.../xxx")
 ```
 
 **3.4 处理 [DRIFT] — 路径漂移**
@@ -177,7 +175,7 @@ kg_task(action:"update", taskId:"当前任务", log_type:"progress",
 ```
 kg_flowchart(action:"orphans")     → 全局孤立节点 (应为0)
 kg_flowchart(action:"health")      → 冷热分布
-kg_tree()                          → 文档覆盖确认
+kg_flowchart(action:"get")         → 节点覆盖确认
 ```
 
 ### Phase 5: 交付报告

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

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

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,8 +0,0 @@
-/**
- * 📏 kg_rules (6→1)
- * 合并: kg_get_rules, kg_save_rules, kg_get_rules_meta, kg_save_rules_meta
- * 删除: kg_get_global_rules_meta, kg_save_global_rules_meta (管理员操作)
- */
-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,121 +0,0 @@
-/**
- * 📏 kg_rules (6→1)
- * 合并: kg_get_rules, kg_save_rules, kg_get_rules_meta, kg_save_rules_meta
- * 删除: kg_get_global_rules_meta, kg_save_global_rules_meta (管理员操作)
- */
-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}`);
-        }
-    }));
-}