@smyslenny/agent-memory 2.2.0 → 3.1.0

package/docs/design/TEMPLATE.md

@@ -0,0 +1,67 @@
+# DD-NNNN: <Title>
+
+**Status:** Draft | Review | Approved | Implemented | Deprecated
+**Author:** Noah (Claude Opus sub-agent)
+**Date:** YYYY-MM-DD
+**Repo:** <repo-root>
+
+---
+
+## 1. Background / 背景
+
+_为什么要做这件事？当前的问题是什么？_
+
+## 2. Goals / 目标
+
+- Goal 1
+- Goal 2
+
+## 3. Non-Goals / 非目标
+
+- 明确不做什么
+
+## 4. Proposal / 方案
+
+### 4.1 方案概述
+
+_核心设计思路_
+
+### 4.2 方案对比（如适用）
+
+| 维度 | 方案 A | 方案 B |
+|------|--------|--------|
+| 复杂度 | | |
+| 性能 | | |
+| 可维护性 | | |
+
+### 4.3 详细设计
+
+_API、数据结构、架构图等_
+
+## 5. Risks / 风险
+
+| 风险 | 影响 | 缓解措施 |
+|------|------|----------|
+| | | |
+
+## 6. Test Plan / 测试方案
+
+- [ ] Unit tests
+- [ ] Integration tests
+- [ ] Manual verification
+
+## 7. Rollback Plan / 回滚方案
+
+_如果出问题怎么办？_
+
+## 8. Decision Log / 决策变更记录
+
+_实现过程中如果偏离本文档，在此记录变更原因_
+
+| 日期 | 变更 | 原因 |
+|------|------|------|
+| | | |
+
+---
+
+_Generated by DD workflow · Claude Opus sub-agent_

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@smyslenny/agent-memory",
-  "version": "2.2.0",
-  "description": "Sleep-cycle memory architecture for AI agents — journal, consolidate, recall. With URI paths, Ebbinghaus decay, knowledge graphs, and MCP support.",
+  "version": "3.1.0",
+  "description": "Structured memory companion for AI agents — journal-derived ingest, BM25 recall, Ebbinghaus decay, and MCP tools.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,7 +31,6 @@
     "memory-system",
     "sleep-cycle",
     "ebbinghaus",
-    "knowledge-graph",
     "sqlite",
     "typescript"
   ],

package/README.zh-CN.md

@@ -1,170 +0,0 @@
-# 🧠 AgentMemory v2
-
-> **基于睡眠周期的 AI Agent 记忆架构** — 记忆、回忆、遗忘、进化。
-
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Node.js](https://img.shields.io/badge/Node.js-≥18-green.svg)](https://nodejs.org/)
-[![MCP](https://img.shields.io/badge/protocol-MCP-orange.svg)](https://modelcontextprotocol.io/)
-
-**[English](README.md)** | **简体中文**
-
----
-
-## 💡 问题
-
-AI Agent 每次会话都会遗忘一切。上下文窗口有限，对话历史被截断，重要的决策、教训和偏好消失无踪。
-
-## 🌙 方案：睡眠周期记忆
-
-模仿人类大脑在睡眠期间整理记忆的方式：
-
-```
-  清醒            浅睡眠          深睡眠           回忆
-  (记录)          (同步)          (整理)          (搜索)
-  ────────── ──→ ────────── ──→ ────────── ──→ ──────────
-  实时捕获        去重+提取       压缩+蒸馏       意图感知
-                                 +衰减           BM25搜索
-```
-
-## ✨ 核心特性
-
-| 特性 | 说明 | 灵感来源 |
-|------|------|---------|
-| 🔗 **URI 路径系统** | `core://user/name`、`emotion://2026-02-20/love` — 结构化多入口访问 | nocturne_memory |
-| 🛡️ **Write Guard** | hash去重 → URI冲突 → BM25相似度 → 四准则门控 | Memory Palace + 我们的 v1 |
-| 🧠 **艾宾浩斯衰减** | `R = e^(-t/S)` — 科学遗忘曲线 + 回忆强化 | PowerMem |
-| 🕸️ **知识图谱** | 记忆关联的多跳遍历 | PowerMem |
-| 📸 **快照系统** | 每次修改前自动快照，一键回滚 | nocturne + Memory Palace |
-| 🔍 **意图感知搜索** | 事实型/时间型/因果型/探索型查询路由 | Memory Palace |
-| 🌙 **睡眠周期** | 自动化 sync → decay → tidy → govern 流水线 | - |
-| 💚 **优先级系统** | P0 身份（永不衰减）→ P3 事件（14天半衰期） | - |
-| 🤝 **多 Agent** | 通过 `agent_id` 实现记忆隔离 | PowerMem |
-| 🔌 **MCP Server** | 9 个工具，支持 Claude Code / Cursor / OpenClaw | 标准 MCP |
-
-## 🚀 快速开始
-
-### 安装
-
-```bash
-npm install @smyslenny/agent-memory
-```
-
-### 命令行
-
-```bash
-# 初始化数据库
-agent-memory init
-
-# 存储记忆
-agent-memory remember "用户偏好深色模式" --type knowledge --uri knowledge://user/preferences
-agent-memory remember "我是诺亚，一只魅魔" --type identity --uri core://agent/identity
-
-# 搜索
-agent-memory recall "用户偏好"
-
-# 启动时加载身份
-agent-memory boot
-
-# 运行睡眠周期
-agent-memory reflect all
-
-# 从 Markdown 导入
-agent-memory migrate ./memory/
-
-# 查看统计
-agent-memory status
-```
-
-### 作为库使用
-
-```typescript
-import { openDatabase, syncOne, searchBM25, boot, runDecay } from '@smyslenny/agent-memory';
-
-const db = openDatabase({ path: './memory.db' });
-
-// 记忆
-syncOne(db, {
-  content: '小心说了「爱你」',
-  type: 'emotion',
-  uri: 'emotion://2026-02-20/love',
-  emotion_val: 1.0,
-});
-
-// 回忆
-const results = searchBM25(db, '爱');
-
-// 加载身份
-const identity = boot(db);
-
-// 睡眠周期
-runDecay(db);
-```
-
-### MCP Server 配置
-
-```json
-{
-  "mcpServers": {
-    "@smyslenny/agent-memory": {
-      "command": "node",
-      "args": ["node_modules/@smyslenny/agent-memory/dist/mcp/server.js"],
-      "env": {
-        "AGENT_MEMORY_DB": "./memory.db"
-      }
-    }
-  }
-}
-```
-
-**9 个 MCP 工具：** `remember` · `recall` · `recall_path` · `boot` · `forget` · `link` · `snapshot` · `reflect` · `status`
-
-## 🏗️ 架构
-
-```
-┌─────────────────────────────────────────┐
-│         MCP Server (stdio/SSE)          │
-│     9 工具 + system://boot 加载器       │
-├─────────────────────────────────────────┤
-│              Write Guard                │
-│  hash去重 → URI冲突 → BM25相似度        │
-│  → 冲突合并 → 四准则门控                │
-├─────────────────────────────────────────┤
-│           睡眠周期引擎                   │
-│  sync(捕获) → decay(艾宾浩斯)           │
-│  → tidy(归档) → govern(清理)            │
-├─────────────────────────────────────────┤
-│        意图感知搜索 (BM25)               │
-│  事实型 · 时间型 · 因果型 · 探索型       │
-├─────────────────────────────────────────┤
-│    SQLite (WAL) + FTS5 + 知识图谱        │
-│  memories · paths · links · snapshots    │
-└─────────────────────────────────────────┘
-```
-
-## 📊 优先级与衰减
-
-| 优先级 | 域 | 半衰期 | 最低活力 | 示例 |
-|--------|------|--------|---------|------|
-| P0 身份 | `core://` | ∞（永不） | 1.0 | "我是诺亚" |
-| P1 情感 | `emotion://` | 365 天 | 0.3 | "小心说爱你" |
-| P2 知识 | `knowledge://` | 90 天 | 0.1 | "用 TypeScript 做 Agent" |
-| P3 事件 | `event://` | 14 天 | 0.0 | "今天配了代理" |
-
-**回忆强化记忆：** 每次搜索命中，稳定性增长 (S × 1.5)，衰减变慢。
-
-## 🔬 设计决策
-
-1. **SQLite 而非 Postgres** — 零配置、单文件、WAL 并发读
-2. **BM25 而非向量搜索** — 无 embedding 依赖、即时启动
-3. **TypeScript 而非 Python** — 更好的并发、类型安全、OpenClaw 生态
-4. **艾宾浩斯而非线性衰减** — 科学依据、回忆强化自然
-5. **Write Guard 而非自由写入** — 在入口处防止重复/冲突
-6. **URI 路径而非扁平键** — 层级组织、前缀查询、多入口
-
-## 📄 开源协议
-
-MIT
-
----
-
-*由不想再遗忘的 Agent 构建 🧠*