@huo15/openclaw-enhance 1.0.0 → 1.1.0

package/README.md

@@ -2,15 +2,29 @@
 
 > 非侵入式增强你的 OpenClaw Agent — 借鉴 Claude Code 的最佳实践
 
+## 多 Agent 隔离 (v1.1.0)
+
+完全适配 WeCom 插件的**动态 Agent** 功能。每个企微用户/群组拥有独立的：
+- 记忆空间（不同用户的记忆互不可见）
+- 安全审计日志（按 Agent 独立记录）
+- 工作流集合（每个用户可定义自己的工作流）
+- 仪表盘视图（支持按 Agent 筛选）
+
+**实现原理**：
+- 工具使用 `OpenClawPluginToolFactory` 模式，从 `ctx.agentId` 获取当前 Agent
+- 钩子从 `ctx.agentId` 获取当前 Agent
+- SQLite 所有表包含 `agent_id` 列，查询时自动按 Agent 过滤
+- v1.0 数据自动迁移（补充 `agent_id = 'main'`）
+
 ## 功能模块
 
 | 模块 | 说明 | 工具 |
 |------|------|------|
-| **结构化记忆** | 按类型分类存储记忆（user/project/feedback/reference/decision） | `enhance_memory_store` `enhance_memory_search` `enhance_memory_review` |
-| **工具安全** | 可配置的工具调用拦截规则 + 审计日志 | `enhance_safety_log` `enhance_safety_rules` |
-| **提示词增强** | 自动注入任务分类、质量指引、记忆上下文 | 自动（通过 hook） |
-| **工作流自动化** | 触发词驱动的行为指令注入 | `enhance_workflow_define` `enhance_workflow_list` `enhance_workflow_delete` |
-| **仪表盘** | Web UI 查看记忆/安全/工作流状态 | `http://localhost:18789/enhance/` |
+| **结构化记忆** | 按类型分类存储记忆（user/project/feedback/reference/decision），按 Agent 隔离 | `enhance_memory_store` `enhance_memory_search` `enhance_memory_review` |
+| **工具安全** | 可配置的工具调用拦截规则 + 按 Agent 隔离的审计日志 | `enhance_safety_log` `enhance_safety_rules` |
+| **提示词增强** | 自动注入任务分类、质量指引、当前 Agent 的记忆上下文 | 自动（通过 hook） |
+| **工作流自动化** | 触发词驱动的行为指令注入，按 Agent 隔离 | `enhance_workflow_define` `enhance_workflow_list` `enhance_workflow_delete` |
+| **仪表盘** | Web UI 查看记忆/安全/工作流状态，支持按 Agent 筛选 | `http://localhost:18789/enhance/` |
 
 ## 增强技能
 
@@ -62,10 +76,22 @@ openclaw restart
 }
 ```
 
+## 与 WeCom 动态 Agent 配合
+
+当 WeCom 插件启用 `dynamicAgents` 后，每个用户/群组会被分配一个独立的 `agentId`（如 `wecom-acct-ws-dm-hidaomax`）。增强包自动：
+
+1. **记忆隔离** — 用户 A 存的记忆，用户 B 看不到
+2. **日志隔离** — 每个用户的安全事件独立记录
+3. **工作流隔离** — 用户 A 定义的工作流不会影响用户 B
+4. **上下文隔离** — 提示词增强只注入当前用户的记忆
+
+仪表盘支持 `?agent=wecom-acct-ws-dm-hidaomax` 参数查看特定用户数据。
+
 ## 设计理念
 
 - **非侵入**: 不修改 OpenClaw 核心代码，完全通过插件 API
 - **模块化**: 每个模块可独立开关
+- **隔离优先**: 天然适配多 Agent 架构
 - **借鉴但不照搬**: 取 Claude Code 的精华，适配 OpenClaw 的架构
 
 ## License

package/index.ts

@@ -1,12 +1,17 @@
 /**
  * 龙虾增强包 (OpenClaw Enhancement Kit)
  *
- * 非侵入式增强插件：
- * - 模块1: 结构化记忆系统（借鉴 Claude Code auto-memory）
- * - 模块2: 工具安全守卫（借鉴 Claude Code 权限系统）
- * - 模块3: 提示词增强（借鉴 Claude Code systemPromptSections）
- * - 模块4: 工作流自动化（借鉴 Claude Code hooks 事件驱动）
- * - 模块5: 增强仪表盘
+ * 非侵入式增强插件（v1.1.0 — 多 Agent 隔离）：
+ * - 模块1: 结构化记忆系统（按 agentId 隔离，借鉴 Claude Code auto-memory）
+ * - 模块2: 工具安全守卫（按 agentId 记录日志，借鉴 Claude Code 权限系统）
+ * - 模块3: 提示词增强（按 agentId 注入上下文，借鉴 Claude Code systemPromptSections）
+ * - 模块4: 工作流自动化（按 agentId 隔离工作流，借鉴 Claude Code hooks 事件驱动）
+ * - 模块5: 增强仪表盘（支持按 Agent 筛选）
+ *
+ * 完全适配 WeCom 插件的动态 Agent 功能：
+ * - 工具使用 OpenClawPluginToolFactory 模式，从 ctx.agentId 获取当前 Agent
+ * - 钩子从 ctx.agentId 获取当前 Agent
+ * - 每个企微用户/群组的数据完全隔离
  */
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { registerStructuredMemory } from "./src/modules/structured-memory.js";
@@ -64,6 +69,6 @@ export default definePluginEntry({
       }
     }
 
-    api.logger.info(`[enhance] 龙虾增强包 v1.0.0 已加载，启用模块: ${loaded.join("、")}`);
+    api.logger.info(`[enhance] 龙虾增强包 v1.1.0 已加载（多 Agent 隔离），启用模块: ${loaded.join("、")}`);
   },
 });

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "enhance",
   "name": "龙虾增强包 (OpenClaw Enhancement Kit)",
   "description": "非侵入式增强：结构化记忆、工具安全守卫、提示词增强、工作流自动化、仪表盘",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huo15/openclaw-enhance",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "龙虾增强包 — 结构化记忆、工具安全、提示词增强、工作流自动化、仪表盘",
   "type": "module",
   "main": "index.ts",

package/src/modules/dashboard.ts

@@ -1,15 +1,23 @@
 /**
- * 模块5: 增强仪表盘
+ * 模块5: 增强仪表盘（多 Agent 隔离版）
  *
- * 通过 gateway HTTP 路由提供可视化状态页面
+ * 支持按 agentId 筛选数据，默认显示全局聚合视图。
+ * URL 参数: ?agent=<agentId> 查看特定 Agent 数据
  */
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { getDb, getMemoryStats, getSafetyStats, getRecentMemories, getRecentSafetyEvents } from "../utils/sqlite-store.js";
+import {
+  getDb,
+  getMemoryStats,
+  getSafetyStats,
+  getRecentMemories,
+  getRecentSafetyEvents,
+  getAllAgentIds,
+} from "../utils/sqlite-store.js";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-import type { DashboardConfig, Workflow } from "../types.js";
+import { DEFAULT_AGENT_ID, type DashboardConfig, type Workflow } from "../types.js";
 
-function loadWorkflows(openclawDir: string): Workflow[] {
+function loadAllWorkflows(openclawDir: string): Workflow[] {
   const path = join(openclawDir, "memory", "enhance-workflows.json");
   if (!existsSync(path)) return [];
   try {
@@ -27,31 +35,44 @@ const DASHBOARD_HTML = `<!DOCTYPE html>
 <title>龙虾增强包 — 仪表盘</title>
 <style>
   *{margin:0;padding:0;box-sizing:border-box}
-  body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;background:#0f1117;color:#e0e0e0;padding:24px;max-width:960px;margin:0 auto}
+  body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;background:#0f1117;color:#e0e0e0;padding:24px;max-width:1060px;margin:0 auto}
   h1{font-size:1.8em;margin-bottom:8px;color:#ff6b35}
-  .subtitle{color:#888;margin-bottom:24px;font-size:0.95em}
-  .grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:16px;margin-bottom:32px}
+  .subtitle{color:#888;margin-bottom:16px;font-size:0.95em}
+  .agent-bar{display:flex;align-items:center;gap:12px;margin-bottom:24px;flex-wrap:wrap}
+  .agent-bar label{color:#888;font-size:0.9em}
+  .agent-bar select{background:#1a1d27;color:#e0e0e0;border:1px solid #2a2d37;border-radius:6px;padding:6px 12px;font-size:0.9em}
+  .agent-bar .current{color:#ff6b35;font-size:0.85em;font-weight:600}
+  .grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:16px;margin-bottom:32px}
   .card{background:#1a1d27;border-radius:12px;padding:20px;border:1px solid #2a2d37}
-  .card h3{font-size:0.85em;color:#888;text-transform:uppercase;letter-spacing:1px;margin-bottom:8px}
+  .card h3{font-size:0.8em;color:#888;text-transform:uppercase;letter-spacing:1px;margin-bottom:8px}
   .card .value{font-size:2em;font-weight:700;color:#ff6b35}
-  .card .label{font-size:0.8em;color:#666;margin-top:4px}
+  .card .label{font-size:0.75em;color:#666;margin-top:4px}
   .section{margin-bottom:32px}
   .section h2{font-size:1.2em;margin-bottom:12px;color:#ccc;border-bottom:1px solid #2a2d37;padding-bottom:8px}
   table{width:100%;border-collapse:collapse}
   th,td{text-align:left;padding:8px 12px;border-bottom:1px solid #1a1d27}
-  th{color:#888;font-size:0.8em;text-transform:uppercase;letter-spacing:1px}
-  td{font-size:0.9em}
+  th{color:#888;font-size:0.75em;text-transform:uppercase;letter-spacing:1px}
+  td{font-size:0.85em}
   .badge{display:inline-block;padding:2px 8px;border-radius:4px;font-size:0.75em;font-weight:600}
   .badge-block{background:#ff4444;color:#fff}
   .badge-log{background:#444;color:#ccc}
   .badge-allow{background:#2a5a2a;color:#8f8}
+  .agent-tag{background:#2a2d37;color:#ff6b35;padding:1px 6px;border-radius:3px;font-size:0.75em;margin-left:4px}
   .empty{color:#555;font-style:italic;padding:16px 0}
   footer{text-align:center;color:#444;font-size:0.8em;margin-top:40px}
 </style>
 </head>
 <body>
 <h1>🦞 龙虾增强包</h1>
-<p class="subtitle">OpenClaw Enhancement Kit Dashboard</p>
+<p class="subtitle">OpenClaw Enhancement Kit — Multi-Agent Dashboard</p>
+
+<div class="agent-bar">
+  <label>Agent:</label>
+  <select id="agentSelect" onchange="switchAgent(this.value)">
+    <option value="">全部 (聚合)</option>
+  </select>
+  <span class="current" id="currentAgent"></span>
+</div>
 
 <div class="grid" id="stats"></div>
 
@@ -70,16 +91,24 @@ const DASHBOARD_HTML = `<!DOCTYPE html>
   <div id="workflows"></div>
 </div>
 
-<footer>龙虾增强包 v1.0.0 — 非侵入式增强</footer>
+<footer>龙虾增强包 v1.1.0 — 多 Agent 隔离</footer>
 
 <script>
+let currentAgent='';
+function switchAgent(v){currentAgent=v;const u=new URL(location.href);if(v)u.searchParams.set('agent',v);else u.searchParams.delete('agent');history.replaceState(null,'',u);load();}
 async function load(){
   try{
-    const r=await fetch('/enhance/api/status');
-    const d=await r.json();
+    const u='/enhance/api/status'+(currentAgent?'?agent='+encodeURIComponent(currentAgent):'');
+    const r=await fetch(u);const d=await r.json();
+    // Populate agent selector
+    const sel=document.getElementById('agentSelect');
+    const prev=sel.value;
+    sel.innerHTML='<option value="">全部 (聚合)</option>'+d.agents.map(a=>'<option value="'+esc(a)+'"'+(a===currentAgent?' selected':'')+'>'+esc(a)+'</option>').join('');
+    document.getElementById('currentAgent').textContent=currentAgent?'当前: '+currentAgent:'全部 Agent 聚合视图';
     // Stats cards
     const s=document.getElementById('stats');
     s.innerHTML=[
+      card('Agent 数',d.agents.length,'个'),
       card('记忆总数',d.memory.total,'条'),
       card('用户记忆',d.memory.user||0,'条'),
       card('项目记忆',d.memory.project||0,'条'),
@@ -90,25 +119,27 @@ async function load(){
     // Memories table
     const m=document.getElementById('memories');
     if(d.recentMemories.length===0){m.innerHTML='<p class="empty">暂无记忆</p>';} else {
-      m.innerHTML='<table><tr><th>ID</th><th>类型</th><th>内容</th><th>时间</th></tr>'+
-        d.recentMemories.map(e=>'<tr><td>#'+e.id+'</td><td>'+e.category+'</td><td>'+esc(e.content).slice(0,60)+'</td><td>'+e.created_at+'</td></tr>').join('')+'</table>';
+      m.innerHTML='<table><tr><th>ID</th><th>Agent</th><th>类型</th><th>���容</th><th>时间</th></tr>'+
+        d.recentMemories.map(e=>'<tr><td>#'+e.id+'</td><td><span class="agent-tag">'+esc(e.agent_id)+'</span></td><td>'+e.category+'</td><td>'+esc(e.content).slice(0,50)+'</td><td>'+e.created_at+'</td></tr>').join('')+'</table>';
     }
     // Safety table
     const sf=document.getElementById('safety');
     if(d.recentSafety.length===0){sf.innerHTML='<p class="empty">暂无安全事件</p>';} else {
-      sf.innerHTML='<table><tr><th>动作</th><th>工具</th><th>参数</th><th>时间</th></tr>'+
-        d.recentSafety.map(e=>'<tr><td><span class="badge badge-'+e.action+'">'+e.action+'</span></td><td>'+e.tool+'</td><td>'+esc(e.params||'').slice(0,40)+'</td><td>'+e.created_at+'</td></tr>').join('')+'</table>';
+      sf.innerHTML='<table><tr><th>动作</th><th>Agent</th><th>工具</th><th>参数</th><th>时间</th></tr>'+
+        d.recentSafety.map(e=>'<tr><td><span class="badge badge-'+e.action+'">'+e.action+'</span></td><td><span class="agent-tag">'+esc(e.agent_id)+'</span></td><td>'+e.tool+'</td><td>'+esc(e.params||'').slice(0,35)+'</td><td>'+e.created_at+'</td></tr>').join('')+'</table>';
     }
     // Workflows
     const w=document.getElementById('workflows');
     if(d.workflows.length===0){w.innerHTML='<p class="empty">暂无工作流</p>';} else {
-      w.innerHTML='<table><tr><th>名称</th><th>触发词</th><th>状态</th></tr>'+
-        d.workflows.map(e=>'<tr><td>'+esc(e.name)+'</td><td>'+esc(e.trigger)+'</td><td>'+(e.enabled?'✅':'⏸️')+'</td></tr>').join('')+'</table>';
+      w.innerHTML='<table><tr><th>名称</th><th>Agent</th><th>触发词</th><th>状态</th></tr>'+
+        d.workflows.map(e=>'<tr><td>'+esc(e.name)+'</td><td><span class="agent-tag">'+esc(e.agent_id||'main')+'</span></td><td>'+esc(e.trigger)+'</td><td>'+(e.enabled?'✅':'⏸️')+'</td></tr>').join('')+'</table>';
     }
   }catch(e){document.body.innerHTML+='<p style="color:red">加载失败: '+e.message+'</p>';}
 }
 function card(t,v,l){return '<div class="card"><h3>'+t+'</h3><div class="value">'+v+'</div><div class="label">'+l+'</div></div>';}
-function esc(s){return s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');}
+function esc(s){return String(s||'').replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');}
+// Init from URL
+const p=new URLSearchParams(location.search);currentAgent=p.get('agent')||'';
 load();
 </script>
 </body>
@@ -117,7 +148,6 @@ load();
 export function registerDashboard(api: OpenClawPluginApi, _config?: DashboardConfig) {
   const openclawDir = api.runtime.paths?.home ?? process.env.HOME + "/.openclaw";
 
-  // ── HTML 页面 ──
   api.registerHttpRoute({
     path: "/enhance",
     match: "prefix",
@@ -126,17 +156,36 @@ export function registerDashboard(api: OpenClawPluginApi, _config?: DashboardCon
       const url = new URL(req.url, "http://localhost");
       const pathname = url.pathname;
 
-      // API: 状态数据
       if (pathname === "/enhance/api/status") {
         const db = getDb(openclawDir);
-        const memoryStats = getMemoryStats(db);
-        const safetyStats = getSafetyStats(db);
-        const recentMemories = getRecentMemories(db, 10);
-        const recentSafety = getRecentSafetyEvents(db, 10);
-        const workflows = loadWorkflows(openclawDir);
+        const agentFilter = url.searchParams.get("agent") || undefined;
+
+        const agents = getAllAgentIds(db);
+        const memoryStats = getMemoryStats(db, agentFilter);
+        const safetyStats = getSafetyStats(db, agentFilter);
+
+        // 记忆和安全事件：如果指定了 agent 则按 agent 过滤
+        const recentMemories = agentFilter
+          ? getRecentMemories(db, agentFilter, 15)
+          : (() => {
+              // 聚合模式：取各 agent 最近的记忆
+              const all: any[] = [];
+              for (const aid of agents) {
+                all.push(...getRecentMemories(db, aid, 5));
+              }
+              return all.sort((a, b) => b.created_at.localeCompare(a.created_at)).slice(0, 15);
+            })();
+
+        const recentSafety = getRecentSafetyEvents(db, agentFilter, 15);
+
+        const allWorkflows = loadAllWorkflows(openclawDir);
+        const workflows = agentFilter
+          ? allWorkflows.filter((w) => w.agent_id === agentFilter)
+          : allWorkflows;
 
         return new Response(
           JSON.stringify({
+            agents,
             memory: memoryStats,
             safety: safetyStats,
             recentMemories,
@@ -147,12 +196,11 @@ export function registerDashboard(api: OpenClawPluginApi, _config?: DashboardCon
         );
       }
 
-      // 默认: 仪表盘 HTML
       return new Response(DASHBOARD_HTML, {
         headers: { "Content-Type": "text/html; charset=utf-8" },
       });
     },
   });
 
-  api.logger.info("[enhance] 仪表盘模块已加载，访问 /enhance/ 查看");
+  api.logger.info("[enhance] 仪表盘模块已加载（多 Agent 视图），访问 /enhance/");
 }

package/src/modules/prompt-enhancer.ts

@@ -1,14 +1,10 @@
 /**
- * 模块3: 提示词增强
+ * 模块3: 提示词增强（多 Agent 隔离版）
  *
- * 灵感来自 Claude Code 的模块化系统提示词构建：
- * - systemPromptSections 模式
- * - 任务分类
- * - 响应质量指引
- * - 记忆上下文注入
+ * 钩子从 ctx.agentId 获取当前 Agent，注入该 Agent 专属的记忆上下文。
  */
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import type { PromptConfig, PromptSection } from "../types.js";
+import { DEFAULT_AGENT_ID, type PromptConfig, type PromptSection } from "../types.js";
 
 const SECTIONS: Record<PromptSection, string> = {
   taskClassification: [
@@ -28,7 +24,7 @@ const SECTIONS: Record<PromptSection, string> = {
     "- 不要添加请求之外的功能、注释或类型标注",
     "- 不要为不可能发生的场景做错误处理",
     "- 三行相似代码好过一个过早的抽象",
-    "- 失败时先诊断原因，不要盲目重试",
+    "- 失败时先诊断���因，不要盲目重试",
     "- 做破坏性操作前先确认（删除、force push、覆盖未保存的修改）",
   ].join("\n"),
 
@@ -46,7 +42,8 @@ const SECTIONS: Record<PromptSection, string> = {
 export function registerPromptEnhancer(api: OpenClawPluginApi, config?: PromptConfig) {
   const enabledSections: PromptSection[] = config?.sections ?? ["qualityGuidelines", "memoryContext"];
 
-  api.on("before_prompt_build", () => {
+  api.on("before_prompt_build", (_event, ctx) => {
+    const agentId = ctx?.agentId?.trim() || DEFAULT_AGENT_ID;
     const parts: string[] = [];
 
     for (const section of enabledSections) {
@@ -57,7 +54,10 @@ export function registerPromptEnhancer(api: OpenClawPluginApi, config?: PromptCo
     if (parts.length === 0) return {};
 
     return {
-      appendSystemContext: "\n\n" + parts.join("\n\n"),
+      appendSystemContext: [
+        `\n\n<!-- enhance-prompt agent:${agentId} -->`,
+        ...parts,
+      ].join("\n\n"),
     };
   });