ai-memory-claw 1.0.0

package/.gitattributes

@@ -0,0 +1,28 @@
+# 文本文件统一使用 LF 换行符（跨平台一致）
+* text=auto eol=lf
+
+# 明确指定某些文件类型
+*.ts text
+*.json text
+*.md text
+*.yml text
+*.yaml text
+
+# 排除二进制/不适用文本处理的目录
+/node_modules/* -text
+/dist/* -text
+coverage/* -text
+data/* -text
+*.map -text
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.woff binary
+*.woff2 binary
+
+# 确保大量文本文件（如果未来有）被正确识别
+*.txt text
+*.gitignore text
+*.gitattributes text

package/LICENSE

@@ -0,0 +1,194 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (which shall be included in the Source form).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work, that is intentionally submitted to the Licensor for
+      inclusion in the Work by the copyright owner or by an individual or
+      Legal Entity authorized to submit on behalf of the copyright owner.
+      For the purposes of this definition, "submitted" means any form of
+      electronic, verbal, or written communication sent to the Licensor or
+      its representatives, including but not limited to communication on
+      electronic mailing lists, source code control systems, and issue
+      tracking systems that are managed by, or on behalf of, the Licensor
+      for the purpose of discussing and improving the Work, but excluding
+      communication that is conspicuously marked or otherwise designated
+      in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean the Licensor and any individual or Legal
+      Entity on behalf of whom a Contribution has been received by the
+      Licensor and subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to use, reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work or
+      a Contribution incorporated within the Work constitutes direct or
+      contributory patent infringement, then any patent licenses granted
+      to You under this License for that Work shall terminate as of the date
+      such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, trademark, patent, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work,
+          provided that such additional attribution notices cannot be
+          construed as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      provide for additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing shall supersede or modify the
+      terms of any separate license agreement you may have executed
+      with the Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+      NONINFRINGEMENT. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event shall any Contributor be
+      liable to You for damages, including any direct, indirect,
+      special, incidental, or consequential damages of any character
+      arising as a result of this License or out of the use or inability
+      use the Work (including but dot limited to procurement of substitute
+      goods or services; loss of use, data, or profits; or business
+      interruption) however caused and on any theory of liability,
+      whether in contract, strict liability, or tort (including
+      negligence or otherwise) arising in any way out of the use of
+      the Work, even if advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works, You may choose to offer and charge a
+      fee for, warranty, support, indemnity or other liability obligations
+      and/or rights consistent with this License. However, in accepting such
+      obligations, You may act only on Your own behalf and on Your sole
+      responsibility, not on behalf of any other Contributor, and only if
+      You agree to indemnify, defend, and hold each Contributor harmless
+      for any liability incurred by, that Contributor as a result of your
+      accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed" page as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright (c) [year] [fullname]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by exc

package/README.md

@@ -0,0 +1,199 @@
+# AI Memory Claw
+
+OpenClaw 插件 - AI 渐进式记忆系统（无感运行版）
+
+## 功能特性
+
+- **自动召回**：对话前自动搜索并注入相关记忆
+- **自动捕获**：对话后自动生成记忆（100%强制存储）
+- **遗忘机制**：自动删除低价值记忆
+- **整合机制**：自动合并相似记忆
+- **向量搜索**：基于语义相似度的记忆检索
+- **分类分析**：自动识别记忆类别
+
+## 安装
+
+### 方式一：直接复制（推荐用于本地）
+
+1. 克隆或下载本项目
+2. 进入项目目录并安装依赖
+   ```bash
+   npm install
+   ```
+3. 复制整个项目到 OpenClaw 扩展目录
+   ```bash
+   # 根据你的系统调整路径
+   cp -r . ~/.openclaw/extensions/ai-memory-claw
+   cd ~/.openclaw/extensions/ai-memory-claw
+   npm install  # 再次安装确保本地依赖完整
+   ```
+4. 配置 OpenClaw：编辑 `~/.openclaw/openclaw.json`
+   ```json
+   {
+     "plugins": {
+       "allow": ["ai-memory-claw"],
+       "entries": {
+         "ai-memory-claw": {
+           "enabled": true,
+           "config": {
+             "autoRecall": true,
+             "autoCapture": true
+           }
+         }
+       }
+     }
+   }
+   ```
+5. 启动 OpenClaw Gateway
+
+### 方式二：发布到 npm（供开发者使用）
+
+本插件已发布为 npm 包 `ai-memory-claw`。你可以：
+```bash
+npm install ai-memory-claw
+```
+然后在 OpenClaw 配置中指定：
+```json
+{
+  "plugins": {
+    "entries": {
+      "ai-memory-claw": {
+        "package": "ai-memory-claw",
+        "enabled": true
+      }
+    }
+  }
+}
+```
+
+## 配置说明
+
+在 OpenClaw 配置中通过 `plugins.entries.ai-memory-claw.config` 设置。所有配置项：
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| `dataDir` | `string` | `~/.ai-memory-claw/data` | 记忆数据存储目录 |
+| `autoRecall` | `boolean` | `true` | 对话前自动搜索并注入相关记忆 |
+| `autoCapture` | `boolean` | `true` | 对话后自动生成记忆 |
+| `captureStrategy` | `"always" \| "selective"` | `"always"` | 捕获策略：always=全部存储，selective=仅关键词匹配 |
+| `autoRecallInNewSession` | `boolean` | `true` | 新会话首次对话时自动注入记忆 |
+| `newSessionMemoryLimit` | `number` (1-5) | `1` | 新会话时注入的记忆数量 |
+| `manualTriggerEnabled` | `boolean` | `true` | 用户消息包含关键词时触发手动召回 |
+| `manualTriggerKeywords` | `string[]` | 见下方 | 手动召回触发关键词列表 |
+| `manualRecallLimit` | `number` (1-10) | `3` | 手动触发时注入的记忆数量上限 |
+| `recallThreshold` | `number` (0-1) | `0.6` | 相似度阈值，越高越严格 |
+| `recallLimit` | `number` (1-10) | `2` | 每次召回的记忆数量上限 |
+| `captureMaxChars` | `number` (100-2000) | `500` | 自动捕获的最大字符数 |
+| `enableSummary` | `boolean` | `true` | 启用记忆摘要功能 |
+| `enableForget` | `boolean` | `true` | 启用遗忘机制（定期清理低价值记忆） |
+| `enableIntegration` | `boolean` | `true` | 启用整合机制（合并相似记忆） |
+| `forgetIntervalDays` | `number` (1-30) | `7` | 遗忘检查间隔（天） |
+| `integrationThreshold` | `number` (0.5-1) | `0.8` | 记忆整合相似度阈值 |
+
+### 默认触发关键词
+
+```json
+[
+  "记得", "之前", "上次", "以前", "查一下", "看看之前的记忆",
+  "用一下之前的", "参考之前的", "以前是怎么做的", "你还记得吗",
+  "记忆里", "历史上", "之前那次"
+]
+```
+
+## 记忆目录结构
+
+```
+~/.ai-memory-claw/data/
+├── 日常事务/
+│   └── 通用/
+│       └── 日常-通用-20260328-2315-xxxxx.json
+├── 系统运维/
+│   └── 通用/
+│       └── 系统-通用-20260328-xxxxxx.json
+└── ...
+```
+
+## 数据格式
+
+每条记忆为 JSON 文件：
+
+```json
+{
+  "id": "日常-通用-20260328-2315-xxxxx",
+  "category": "日常事务",
+  "subCategory": "通用",
+  "content": {
+    "task": "用户询问的问题",
+    "process": "处理过程",
+    "result": "处理结果"
+  },
+  "embedding": [0.1, 0.2, ...],
+  "importance": "critical",
+  "usageCount": 10
+}
+```
+
+## 开发
+
+### 构建
+
+TypeScript 源码需编译为 JavaScript：
+
+```bash
+npm run build
+# 或监听模式
+npm run dev
+```
+
+输出位于 `dist/` 目录。
+
+### 测试
+
+本插件使用 Vitest 进行测试：
+
+```bash
+npm test
+```
+
+### 项目结构
+
+```
+ai-memory-claw/
+├── src/
+│   ├── auto-capture.ts      # 自动捕获逻辑
+│   ├── auto-recall.ts       # 自动召回逻辑
+│   ├── category.ts          # 记忆分类分析
+│   ├── config.ts            # 配置管理
+│   ├── embedding.ts         # 向量化处理
+│   ├── forgetter.ts         # 遗忘机制
+│   ├── integrator.ts        # 整合机制
+│   ├── memory-system.ts     # 核心记忆系统
+│   ├── triggers.ts          # 触发器匹配
+│   ├── types.ts             # 类型定义
+│   └── test.ts              # 测试文件
+├── index.ts                 # 插件入口
+├── openclaw.plugin.json     # OpenClaw 插件元数据
+├── tsconfig.json            # TypeScript 配置
+├── package.json             # 项目依赖
+└── README.md                # 本文档
+```
+
+## 技术说明
+
+- 记忆数据按 `category/subCategory/` 分类存储 JSON 文件
+- 使用简化的本地向量搜索（基于 `chroma-js` 的色彩空间算法，实验性质）
+- 分类基于关键词匹配 + LLM 分析（可选）
+- 支持自动摘要、合并重复记忆、定期遗忘
+
+## 许可证
+
+Apache License 2.0 - 详见 [LICENSE](LICENSE) 文件。
+
+---
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request。请确保：
+- 代码通过 `npm run build` 编译
+- 测试通过 `npm test`
+- 遵循项目的代码风格

package/index.ts

@@ -0,0 +1,167 @@
+/**
+ * AI Memory Claw - OpenClaw 插件入口
+ * 
+ * AI渐进式记忆系统 - 无感运行版
+ * 每次对话自动召回、自动捕获记忆
+ */
+
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { MemorySystem } from "./src/memory-system";
+import { AutoRecall } from "./src/auto-recall";
+import { AutoCapture } from "./src/auto-capture";
+
+// 默认触发关键词
+const DEFAULT_TRIGGER_KEYWORDS = [
+  "记得", "之前", "上次", "以前", "查一下", "看看之前的记忆",
+  "用一下之前的", "参考之前的", "以前是怎么做的", "你还记得吗",
+  "记忆里", "历史上", "之前那次"
+];
+
+// 配置类型
+interface MemoryConfig {
+  dataDir: string;
+  autoRecall: boolean;
+  autoCapture: boolean;
+  captureStrategy: "always" | "selective";
+  autoRecallInNewSession: boolean;
+  newSessionMemoryLimit: number;
+  manualTriggerEnabled: boolean;
+  manualTriggerKeywords: string[];
+  manualRecallLimit: number;
+  recallThreshold: number;
+  recallLimit: number;
+  captureMaxChars: number;
+  enableSummary: boolean;
+  enableForget: boolean;
+  enableIntegration: boolean;
+  forgetIntervalDays: number;
+  integrationThreshold: number;
+}
+
+// 默认配置
+const defaultConfig: MemoryConfig = {
+  dataDir: "~/.ai-memory-claw/data",
+  autoRecall: true,
+  autoCapture: true,
+  captureStrategy: "always",
+  autoRecallInNewSession: true,
+  newSessionMemoryLimit: 1,
+  manualTriggerEnabled: true,
+  manualTriggerKeywords: DEFAULT_TRIGGER_KEYWORDS,
+  manualRecallLimit: 3,
+  recallThreshold: 0.6,
+  recallLimit: 2,
+  captureMaxChars: 500,
+  enableSummary: true,
+  enableForget: true,
+  enableIntegration: true,
+  forgetIntervalDays: 7,
+  integrationThreshold: 0.8
+};
+
+// 插件配置 schema
+const configSchema = {
+  type: "object" as const,
+  additionalProperties: false,
+  properties: {
+    dataDir: { type: "string" as const, default: "~/.ai-memory-claw/data" },
+    autoRecall: { type: "boolean" as const, default: true },
+    autoCapture: { type: "boolean" as const, default: true },
+    captureStrategy: { type: "string" as const, enum: ["always", "selective"], default: "always" },
+    autoRecallInNewSession: { type: "boolean" as const, default: true },
+    newSessionMemoryLimit: { type: "number" as const, minimum: 1, maximum: 5, default: 1 },
+    manualTriggerEnabled: { type: "boolean" as const, default: true },
+    manualTriggerKeywords: { type: "array" as const, items: { type: "string" as const }, default: DEFAULT_TRIGGER_KEYWORDS },
+    manualRecallLimit: { type: "number" as const, minimum: 1, maximum: 10, default: 3 },
+    recallThreshold: { type: "number" as const, minimum: 0, maximum: 1, default: 0.6 },
+    recallLimit: { type: "number" as const, minimum: 1, maximum: 10, default: 2 },
+    captureMaxChars: { type: "number" as const, minimum: 100, maximum: 2000, default: 500 },
+    enableSummary: { type: "boolean" as const, default: true },
+    enableForget: { type: "boolean" as const, default: true },
+    enableIntegration: { type: "boolean" as const, default: true },
+    forgetIntervalDays: { type: "number" as const, minimum: 1, maximum: 30, default: 7 },
+    integrationThreshold: { type: "number" as const, minimum: 0.5, maximum: 1, default: 0.8 }
+  }
+};
+
+// 全局实例
+let memorySystem: MemorySystem | null = null;
+let autoRecallInstance: AutoRecall | null = null;
+let config: MemoryConfig = defaultConfig;
+
+const plugin = {
+  id: "ai-memory-claw",
+  name: "AI Memory Claw",
+  description: "AI渐进式记忆系统 - 无感运行版",
+  configSchema,
+  
+  register(api: OpenClawPluginApi) {
+    // 合并配置
+    const pluginConfig = api.pluginConfig as Partial<MemoryConfig> || {};
+    config = { ...defaultConfig, ...pluginConfig } as MemoryConfig;
+    
+    const dataDir = api.resolvePath(config.dataDir);
+    
+    // 初始化日志欢迎 (方案A)
+    api.logger.info("=".repeat(40));
+    api.logger.info("✅ AI Memory Claw 插件已加载");
+    api.logger.info(`📂 数据目录: ${dataDir}`);
+    
+    // 初始化记忆系统
+    memorySystem = new MemorySystem(dataDir, config);
+    
+    // 初始化并显示状态
+    memorySystem.initialize().then(() => {
+      const stats = memorySystem!.getStats();
+      api.logger.info(`📚 当前记忆: ${stats.total} 条`);
+      api.logger.info(`🎯 自动召回: ${config.autoRecall ? '已开启' : '已关闭'}`);
+      api.logger.info(`📝 自动捕获: ${config.autoCapture ? '已开启' : '已关闭'}`);
+      api.logger.info(`🗂️  存储策略: ${config.captureStrategy}`);
+      api.logger.info(`🔄 新会话召回: ${config.autoRecallInNewSession ? '已开启' : '已关闭'}`);
+      api.logger.info(`🔍 手动触发: ${config.manualTriggerEnabled ? '已开启' : '已关闭'}`);
+      api.logger.info("=".repeat(40));
+    }).catch((err) => {
+      api.logger.error(`❌ 初始化失败: ${err}`);
+    });
+    
+    // 初始化自动召回
+    autoRecallInstance = new AutoRecall(memorySystem, config);
+    
+    // 初始化自动捕获
+    const autoCapture = new AutoCapture(memorySystem, config);
+    
+    // 注册 before_agent_start 钩子 (自动召回)
+    if (config.autoRecall) {
+      api.on("before_agent_start", async (event) => {
+        try {
+          return await autoRecallInstance!.execute(event);
+        } catch (err) {
+          api.logger.error(`自动召回失败: ${err}`);
+        }
+      });
+    }
+    
+    // 注册 agent_end 钩子 (自动捕获)
+    if (config.autoCapture) {
+      api.on("agent_end", async (event) => {
+        try {
+          await autoCapture.execute(event);
+        } catch (err) {
+          api.logger.error(`自动捕获失败: ${err}`);
+        }
+      });
+    }
+    
+    // 注册 session_start 钩子（重置召回状态）
+    api.on("session_start", () => {
+      if (autoRecallInstance) {
+        autoRecallInstance.resetSession();
+      }
+      api.logger.info("[Memory] 新会话开始");
+    });
+    
+    api.logger.info("AI Memory Claw 插件初始化完成");
+  }
+};
+
+export default plugin;