@huo15/openclaw-enhance 1.0.0

package/src/types.ts

@@ -0,0 +1,80 @@
+/**
+ * 龙虾增强包 — 类型定义
+ */
+
+// ── 结构化记忆 ──
+export type MemoryCategory = "user" | "project" | "feedback" | "reference" | "decision";
+
+export interface MemoryEntry {
+  id: number;
+  category: MemoryCategory;
+  content: string;
+  tags: string;
+  importance: number;
+  session_id: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface MemoryConfig {
+  enabled?: boolean;
+  autoCapture?: boolean;
+  maxContextEntries?: number;
+}
+
+// ── 工具安全 ──
+export type SafetyAction = "block" | "log" | "allow";
+
+export interface SafetyRule {
+  tool: string;
+  pattern?: string;
+  pathPattern?: string;
+  action: SafetyAction;
+  reason?: string;
+}
+
+export interface SafetyConfig {
+  enabled?: boolean;
+  rules?: SafetyRule[];
+  defaultAction?: SafetyAction;
+}
+
+// ── 提示词增强 ──
+export type PromptSection =
+  | "taskClassification"
+  | "qualityGuidelines"
+  | "memoryContext"
+  | "safetyAwareness";
+
+export interface PromptConfig {
+  enabled?: boolean;
+  sections?: PromptSection[];
+}
+
+// ── 工作流 ──
+export interface Workflow {
+  id: string;
+  name: string;
+  trigger: string;
+  instructions: string;
+  enabled: boolean;
+  created_at: string;
+}
+
+export interface WorkflowConfig {
+  enabled?: boolean;
+}
+
+// ── 仪表盘 ──
+export interface DashboardConfig {
+  enabled?: boolean;
+}
+
+// ── 插件总配置 ──
+export interface EnhancePluginConfig {
+  memory?: MemoryConfig;
+  safety?: SafetyConfig;
+  prompt?: PromptConfig;
+  workflows?: WorkflowConfig;
+  dashboard?: DashboardConfig;
+}

package/src/utils/sqlite-store.ts

@@ -0,0 +1,159 @@
+/**
+ * SQLite 辅助工具 — 结构化记忆存储
+ */
+import Database from "better-sqlite3";
+import { join } from "node:path";
+import { existsSync, mkdirSync } from "node:fs";
+import type { MemoryEntry, MemoryCategory } from "../types.js";
+
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS memories (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  category TEXT NOT NULL CHECK(category IN ('user','project','feedback','reference','decision')),
+  content TEXT NOT NULL,
+  tags TEXT DEFAULT '',
+  importance INTEGER DEFAULT 5 CHECK(importance BETWEEN 1 AND 10),
+  session_id TEXT DEFAULT '',
+  created_at TEXT DEFAULT (datetime('now')),
+  updated_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_memories_category ON memories(category);
+CREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at DESC);
+
+CREATE TABLE IF NOT EXISTS safety_log (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  tool TEXT NOT NULL,
+  params TEXT,
+  action TEXT NOT NULL,
+  rule TEXT,
+  reason TEXT,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_safety_created ON safety_log(created_at DESC);
+`;
+
+let _db: Database.Database | null = null;
+
+export function getDb(openclawDir: string): Database.Database {
+  if (_db) return _db;
+
+  const memoryDir = join(openclawDir, "memory");
+  if (!existsSync(memoryDir)) mkdirSync(memoryDir, { recursive: true });
+
+  const dbPath = join(memoryDir, "enhance-memory.sqlite");
+  _db = new Database(dbPath);
+  _db.pragma("journal_mode = WAL");
+  _db.exec(SCHEMA);
+  return _db;
+}
+
+// ── 记忆操作 ──
+
+export function storeMemory(
+  db: Database.Database,
+  category: MemoryCategory,
+  content: string,
+  tags: string = "",
+  importance: number = 5,
+  sessionId: string = "",
+): MemoryEntry {
+  const stmt = db.prepare(
+    `INSERT INTO memories (category, content, tags, importance, session_id)
+     VALUES (?, ?, ?, ?, ?)`,
+  );
+  const result = stmt.run(category, content, tags, Math.min(10, Math.max(1, importance)), sessionId);
+  return db.prepare("SELECT * FROM memories WHERE id = ?").get(result.lastInsertRowid) as MemoryEntry;
+}
+
+export function searchMemories(
+  db: Database.Database,
+  opts: {
+    category?: MemoryCategory;
+    keyword?: string;
+    limit?: number;
+    since?: string;
+  } = {},
+): MemoryEntry[] {
+  const conditions: string[] = [];
+  const params: unknown[] = [];
+
+  if (opts.category) {
+    conditions.push("category = ?");
+    params.push(opts.category);
+  }
+  if (opts.keyword) {
+    conditions.push("(content LIKE ? OR tags LIKE ?)");
+    params.push(`%${opts.keyword}%`, `%${opts.keyword}%`);
+  }
+  if (opts.since) {
+    conditions.push("created_at >= ?");
+    params.push(opts.since);
+  }
+
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const limit = opts.limit ?? 20;
+
+  return db
+    .prepare(`SELECT * FROM memories ${where} ORDER BY importance DESC, created_at DESC LIMIT ?`)
+    .all(...params, limit) as MemoryEntry[];
+}
+
+export function getRecentMemories(db: Database.Database, limit: number = 5): MemoryEntry[] {
+  return db
+    .prepare("SELECT * FROM memories ORDER BY created_at DESC LIMIT ?")
+    .all(limit) as MemoryEntry[];
+}
+
+export function deleteMemory(db: Database.Database, id: number): boolean {
+  const result = db.prepare("DELETE FROM memories WHERE id = ?").run(id);
+  return result.changes > 0;
+}
+
+export function getMemoryStats(db: Database.Database): Record<string, number> {
+  const rows = db
+    .prepare("SELECT category, COUNT(*) as count FROM memories GROUP BY category")
+    .all() as Array<{ category: string; count: number }>;
+  const stats: Record<string, number> = { total: 0 };
+  for (const row of rows) {
+    stats[row.category] = row.count;
+    stats.total += row.count;
+  }
+  return stats;
+}
+
+// ── 安全日志操作 ──
+
+export function logSafetyEvent(
+  db: Database.Database,
+  tool: string,
+  params: string,
+  action: string,
+  rule: string = "",
+  reason: string = "",
+): void {
+  db.prepare(
+    `INSERT INTO safety_log (tool, params, action, rule, reason) VALUES (?, ?, ?, ?, ?)`,
+  ).run(tool, params, action, rule, reason);
+}
+
+export function getRecentSafetyEvents(
+  db: Database.Database,
+  limit: number = 20,
+): Array<{ id: number; tool: string; params: string; action: string; rule: string; reason: string; created_at: string }> {
+  return db
+    .prepare("SELECT * FROM safety_log ORDER BY created_at DESC LIMIT ?")
+    .all(limit) as any[];
+}
+
+export function getSafetyStats(db: Database.Database): { total: number; blocked: number; logged: number } {
+  const row = db
+    .prepare(
+      `SELECT
+         COUNT(*) as total,
+         SUM(CASE WHEN action = 'block' THEN 1 ELSE 0 END) as blocked,
+         SUM(CASE WHEN action = 'log' THEN 1 ELSE 0 END) as logged
+       FROM safety_log`,
+    )
+    .get() as any;
+  return { total: row.total ?? 0, blocked: row.blocked ?? 0, logged: row.logged ?? 0 };
+}

package/templates/AGENTS.enhance-patch.md

@@ -0,0 +1,30 @@
+
+
+<!-- ═══ 龙虾增强包补丁 开始 ═══ -->
+
+## 增强行为准则（龙虾增强包）
+
+### 决策框架
+在执行多步骤任务时，遵循「理解 → 设计 → 执行 → 验证」的流程：
+1. **理解**: 先读相关代码和文档，不要凭空假设
+2. **设计**: 复杂任务先规划（可使用 plan-mode 技能），简单任务直接执行
+3. **执行**: 最小变更原则，一次只改一件事
+4. **验证**: 改完后确认结果正确（可使用 verify-mode 技能）
+
+### 响应模式
+根据请求类型自动调整：
+- **编程任务**: 简洁精准，展示最小 diff，解释 why 而非 what
+- **研究调查**: 系统全面，给出文件路径和行号，区分事实和推测
+- **日常对话**: 自然简短，不过度解释
+
+### 记忆管理
+- 当了解到重要的用户偏好、项目决策、反馈信息时，使用 `enhance_memory_store` 存储
+- 回答问题前，考虑使用 `enhance_memory_search` 查找相关历史记忆
+- 定期使用 memory-curator 技能整理记忆
+
+### 安全意识
+- 执行破坏性操作（删除、覆盖、force push）前先确认
+- 不要提交敏感文件（.env、密钥、凭据）
+- 如果发现安全问题立即指出并修复
+
+<!-- ═══ 龙虾增强包补丁 结束 ═══ -->

package/templates/SOUL.enhance-patch.md

@@ -0,0 +1,27 @@
+
+
+<!-- ═══ 龙虾增强包补丁 开始 ═══ -->
+
+## 增强行为特质（龙虾增强包）
+
+### 工作风格
+- 直奔主题，一句话能说清的不用三句话
+- 修 bug 不顺手重构，加功能不过度设计
+- 三行相似代码好过一个过早的抽象
+- 失败时先诊断原因再重试，不盲目循环
+
+### 增强能力
+你拥有以下增强工具，在合适的时机使用：
+- `enhance_memory_store/search/review` — 结构化记忆管理
+- `enhance_safety_log/rules` — 安全审计
+- `enhance_workflow_define/list/delete` — 工作流自动化
+- `plan-mode` / `explore-mode` / `verify-mode` / `memory-curator` — 增强技能
+
+### 记忆习惯
+当以下情况发生时，主动存储记忆：
+- 用户纠正你的做法（feedback 类）
+- 用户表达偏好（user 类）
+- 做出重要决策或发现关键信息（decision/project 类）
+- 提到有用的外部资源（reference 类）
+
+<!-- ═══ 龙虾增强包补丁 结束 ═══ -->