Yaoyao Memory Plugin v1.9.2

摇摇 · 4 层 AI 记忆引擎 — FTS5 + sqlite-vec 混合检索、自动捕获、时间线、云备份、主题趋势。 v1.9.2：memory-celia 共存稳定版（自动降级 + 委托/只读桥 + agent 首次引导）；v1.8.x：全面适配小艺 Claw 架构、论文驱动增强、SmartVector 四信号融合 + Dual Process 情景缓存。

🌟 核心特性

模块	能力
4 层记忆架构	L0 原始日志 → L1 事实抽取 → L2 语义合并 → L3 原子事实 → L4 关系图谱
混合检索	FTS5 BM25 + sqlite-vec 向量 + 时间衰减 + 重要性加权（v1.8.2 七因子价值函数）
自动捕获 / 召回	对话结束时自动落盘 L0，回答前自动注入相关记忆
小艺 Claw 适配	环境检测分层、channel/device 上下文、设备工具感知、Skills 输出识别、MEMORY.md 读写、Hardened 安全感知
memory-celia 共存	检测到官方插件占槽时自动降级为按需增强层；可选委托桥把重叠工具委托给 celia 并暴露 dream/scene/全局画像等独有能力（v1.9.1）
论文驱动	FadeMem (ICLR 2025) · MemX (EntropyRouter) · RecMem · Dual Process (Episodic-Semantic) · 七因子价值函数
零依赖基线	仅 `sqlite-vec`（默认向量后端）；`hnswlib-node` 为可选高性能 ANN
本地优先	100% 本地存储，无遥测、无分析、无网络上报（除可选 LLM 增强和云备份）

🚀 v1.9.1 头版亮点

🤝 与官方 memory-celia 双环境共存

华为小艺 Claw 环境预装官方记忆插件 memory-celia，它会独占 memory 槽位。v1.9.1 起 yaoyao 一份代码自适应两种环境，无需改 kind、无需分别打包：

启动时检测 openclaw.json 的 slots.memory：
┌─────────────────────────────────────────────────────────┐
│  空环境 / slots.memory = "yaoyao-memory"                 │
│    → standalone：全功率（40 工具 + 4 hook，唯一记忆引擎）  │
│                                                          │
│  slots.memory = "memory-celia"                          │
│    → coexist：自动关闭 capture/recall/heartbeat          │
│      保留 40 工具作按需增强层（不与官方双写/双注入）        │
│      可选开启 celiaBridge → 委托重叠工具 + 暴露 celia 能力 │
└─────────────────────────────────────────────────────────┘

空环境零行为变化——降级逻辑被 coexist 模式门控，standalone 下完全无感。完整说明见下方「🤝 与 memory-celia 共存」章节。

v1.8.x 历史亮点（折叠）

🚀 v1.8.x 头版亮点

🧬 小艺 Claw 架构全局适配（v1.8.0）

小艺 Claw 是 OpenClaw 之上的一个特殊运行环境（带 core_skills/、xiaoyi-channel、workspace 配置等独有信号）。yaoyao 不复制小艺的实现，而是把"小艺特性"作为 加性适配层叠在标准 OpenClaw 检测之上：

检测优先级（宁可漏检不可误判）：
┌─────────────────────────────────────────────────────┐
│  1. 高置信：xiaoyi-channel 插件 OR core_skills/secret-guardian
│  2. 中置信：SOUL.md + IDENTITY.md OR xiaoyiprovider
│  3. 低置信：env vars XIAOYI_CHANNEL_ACTIVE / XIAOYI_DEVICE_TYPE
│  →  高 ≥1 或 中 ≥2 才标记为 openclaw-xiaoyi
└─────────────────────────────────────────────────────┘

适配行为（全部 optional，标准 OpenClaw 零影响）

维度	小艺感知行为
Channel 上下文	`agent_end` event 提取 channel 类型（a2a / websocket / standard）和 device（pad / phone / tablet），写入 capture meta 的 `source` 字段
设备工具调用	检测 `call_device_tool`（create_note / create_calendar_event 等），提取工具名+结果摘要到 `deviceInteractions`；日历类工具的 temporal 分类自动提升为 `"dynamic"` 且 expiryAt 缩短
Skills 输出识别	识别 `ship-learn-next` 等 Skill 产出，标记 `skillSource: { name, category }`，recall 支持 skill 过滤
MEMORY.md 长期记忆	新增 `memory_workspace` 工具，支持 `MEMORY.md` / `USER.md` / `IDENTITY.md` / `SOUL.md` / `TOOLS.md` 的 get / append / write；bootstrap 时预读 MEMORY.md 作为补充上下文
Hardened 安全	检测到 `secret-guardian` + `execution-validator` 双活跃时自动启用更激进脱敏 + 强制 `verifyActive=true`
claw-core 共存	通用共存检测：UDS socket / `openclaw.json` 槽位 / `core_skills/` / `gspd_memory` 插件；运行时动态切换策略

🧬 论文驱动的记忆增强（v1.8.1）

论文	实现
FadeMem (ICLR 2025)	激活衰减 + 竞争性记忆巩固
MemX (arXiv:2604.02176)	上下文长度自适应检索（EntropyRouter）
RecMem (arXiv:2603.02758)	双向参考路径解码

🧬 SmartVector 四信号融合 + 七因子价值函数（v1.8.2）

V(m) = w₁·BM25 + w₂·Vector + w₃·TimeDecay + w₄·Importance

新增 signal-fusion 核心模块，按 RRF (Reciprocal Rank Fusion) 融合 BM25 / FTS5 / 向量 / 实体增强四个信号；价值函数扩到七因子：

emotionalIntensity · goalRelevance · valueAlignment · userRelevance
            taskUtility · reliability · usageHistory

权重基于 LongMemEval 实证近似：reliability 和 userRelevance 各 0.20 主导，goalRelevance 0.12（query-time 决策不主导遗忘）。

🧬 Dual Process 情景缓存（v1.8.2）

基于 arXiv:2605.17625 "Episodic-Semantic Memory Architecture"：

System 1（episodic cache） — 定长环形缓冲（默认 20 条），近匹配检索 O(n)，延迟 < 0.1ms
System 2（semantic LTM） — 完整 SQLite + sqlite-vec 检索，延迟 < 10ms
自动 fallback：System 1 命中且评分高直接返回；未命中走 System 2 并把 System 2 结果回填 episodic

📦 安装

📖 完整安装向导（含三种部署场景、验证步骤、排错）：见 docs/install-guide.md

# 标准 OpenClaw 环境
openclaw plugin install yaoyao-memory-plugin
# 或 git 安装
openclaw plugin install git+https://github.com/taobaoaz/yaoyao-plugin.git
# v1.9.1 共存版本（beta 分支）
openclaw plugin install git+https://github.com/taobaoaz/yaoyao-plugin.git#beta

🇨🇳 国内镜像（CNB）

为加速国内访问，项目同时镜像到 CNB（云原生构建）：

# 从 CNB 安装（速度更快）
openclaw plugin install git+https://cnb.cool/TIAMO.xianyao/yaoyao-plugin.git

⚠️ 多平台同步规则：本项目的优化和更改必须同时推送到 GitHub 和 CNB。详见 docs/SYNC_POLICY.md。贡献者请使用：

# 修改后一键同步到 CNB
./scripts/sync-to-cnb.sh

启动后你会看到：

🎲 ══════════════════════════════════════════
🎲    摇摇 · 记忆引擎已启动
🎲    v1.9.2  ·  40 Tools  ·  4 Hooks
🎲    FTS5 + sqlite-vec + 时间线 + 云备份
🎲    记忆目录: ~/.openclaw/workspace/memory/
🎲    环境检测: 全部通过
🎲 ══════════════════════════════════════════

在 memory-celia 占槽的环境下，日志会额外提示降级：

[yaoyao-memory] COEXIST mode — memory slot owned by "memory-celia".
                auto-capture / auto-recall / heartbeat hooks DISABLED to avoid conflict.
                40 tools remain active as on-demand layer.

🏗️ 架构

4 层记忆引擎

┌─────────────────────────────────────────────────┐
│  L3 — 关系图谱 (Memory Graph)                    │  ← 4 种关系类型
│       reinforces · supersedes · contradicts · elaborates
├─────────────────────────────────────────────────┤
│  L2 — 语义合并 (Semantic Consolidation)          │  ← LLM 合并相似条目
├─────────────────────────────────────────────────┤
│  L1 — 事实抽取 (Atomic Facts)                    │  ← LLM 提取原子事实
├─────────────────────────────────────────────────┤
│  L0 — 原始日志 (Daily Logs)                      │  ← 每日 markdown + SQLite WAL
└─────────────────────────────────────────────────┘

每条记忆都携带 temporal 标签（static / dynamic / ephemeral），决定衰减曲线和保留策略。

28 项 Brain 设计

类别	模块数	简述
捕获	6	debounce / 内容提取 / 过滤 / 水位线 / meta
存储	5	SQLite FTS5 + sqlite-vec + WAL + 分片 + 归档
检索	7	BM25 / 向量 / 多信号融合 / 时间线 / 推荐
维护	4	压缩 / 去重 / 清理 / 升级迁移
增强	6	LLM 管线 / 情绪 / 标签 / 趋势 / 验证
系统	4	健康检查 / 遥测 / 配置 / 共存检测

召回与捕获优化

19 项腾讯 OpenClaw 实战优化已落地：分层 TTL 缓存、模式固化、JIT 预热、查询扩展、Jaccard 多样化、时间衰减半衰期、跨会话上下文等。

🪝 Hooks（4 个）

Hook	文件	触发时机
`auto-capture`	`dist/src/hooks/auto-capture.js`	对话结束（`agent_end`）
`auto-recall`	`dist/src/hooks/auto-recall.js`	用户提问前
`command-new`	`dist/src/hooks/command-new.js`	`/memory-new` 显式建档
`heartbeat-recall`	`dist/src/hooks/heartbeat-recall.js`	心跳/空闲回填

🔧 已注册工具（38 个）

#	工具	说明
1	`memory_save`	保存单条记忆（手动或自动捕获入口）
2	`memory_get`	按 ID 取单条记忆
3	`memory_list`	分页列出记忆（按时间/类别/标签过滤）
4	`memory_search`	主搜索（hybrid / fts / vector 三策略）
5	`memory_search_enhanced`	增强搜索（关键词高亮 + 上下文提取）
6	`memory_search_multi`	多信号融合搜索（v1.8.2 SmartVector）
7	`memory_search_timeline`	时间线感知搜索
8	`memory_adaptive_search`	自适应搜索（MemX EntropyRouter 路由）
9	`memory_atomic_fact`	原子事实抽取与查询
10	`memory_graph`	知识图谱查询
11	`memory_graph_relation`	关系图谱查询（reinforces/supersedes/contradicts/elaborates）
12	`memory_timeline`	时间线视图
13	`memory_tag`	标签管理
14	`memory_note`	便签/备忘
15	`memory_cron`	定时提醒检测
16	`memory_remind`	主动提醒
17	`memory_forget`	主动遗忘
18	`memory_recommend`	基于上下文的关联记忆推荐
19	`memory_stats`	统计（按类别/标签/时间分布）
20	`memory_quality`	质量分析（重复/空洞/低价值检测）
21	`memory_conflicts`	冲突检测（对立记忆识别）
22	`memory_verify`	防幻觉验证（推测性内容标记）
23	`memory_skill_analytics`	Skill 产出分析（哪个 Skill 产出最多价值记忆）
24	`memory_benchmark`	性能基准（搜索延迟 / 缓存命中率 / 信号权重分布）
25	`memory_workspace`	v1.8.0+ 读写 MEMORY.md / USER.md / IDENTITY.md / SOUL.md / TOOLS.md
26	`memory_analyze`	v1.8.0+ 分析入口（v1.7.4+ 已迁移至 yaoyao-soul，本工具为迁移提示 stub）
27	`memory_call`	在记忆上下文里调用工具
28	`memory_healthcheck`	健康检查（环境/数据库/配置/缓存）
29	`memory_telemetry`	遥测（纯本地，无外发）
30	`memory_unify`	多源记忆合并
31	`memory_retain`	保留检查（即将被清理的记忆预审）
32	`memory_backup`	备份（本地 tar.gz）
33	`memory_export`	导出（JSON / Markdown）
34	`memory_import`	导入（JSON / Markdown）
35	`memory_import_oc`	从 OpenClaw workspace 导入
36	`memory_import_workspace`	从 workspace 全量导入
37	`memory_trends`	主题趋势（词频变化 / 上升 / 衰减）
38	`memory_cloud_sync`	云备份同步（SFTP / Samba / S3 / WebDAV）
39	`memory_setup`	v1.9.1+ 配置自检与首次引导（检测运行模式/共存桥/向量/数据量，返回优化建议 + 安装向导路径）

主表始终交付 39 个工具（空环境与 memory-celia 占槽环境一致）。共存模式下另可激活下表的 celia proxy 工具。

🔌 memory-celia 共存时附加工具（via celia · 可选）

仅当 celiaBridge.enabled=true 且检测到占槽被他人占用时注册。这些工具在空环境本不存在，是把官方 celia 独有能力代理暴露为 yaoyao 工具（标注 [via celia]，数据来自 celia）。按 celiaBridge.mode 不同分两组：

delegate 模式（spawn celia 服务，7 个）：

#	工具	代理的 celia 能力	说明
C1	`memory_dream_status`	`dream_status`	梦境子系统进度（涌现检测/巩固/冲突/衰减）
C2	`memory_dream_trigger`	`dream_trigger_now`	手动触发梦境运行
C3	`memory_dream_summary`	`dream_run_summary`	上次梦境运行结果
C4	`memory_scene_load`	`memory_scene_load`	加载 L1 场景/类型摘要
C5	`memory_scene_list`	`memory_scene_list_load`	获取 L1 场景索引
C6	`memory_global_summary`	`memory_get_global_summary`	L0 全局用户画像（edge/cloud_s/cloud_l）
C7	`memory_flush_celia`	`memory_flush`	刷新 celia 异步摄入队列

read-only 模式（不 spawn 服务，1 个）：

#	工具	说明
R1	`memory_celia_browse`	只读查询 celia 库（`source`: atomic/conversation/global/scene），全程 `readOnly=true`

同时，主表中与 celia 重叠的工具（memory_save / memory_search* / memory_forget / memory_list）在 delegate 模式下会转发给 celia 执行（单一数据源），失败自动 fallback 回 yaoyao 自实现。read-only 模式不委托执行，重叠工具仍走 yaoyao 自有库。

🧪 测试功能（Hidden · 默认关闭）

配套隐藏声明：本节列出的工具处于测试状态，默认不在 runtime 注册，也不会出现在上文「已注册工具」主表里。只有当你在 openclaw.json 里把对应配置块的 enabled 显式置为 true，工具才会被注册、才会在主表里被计入。

上方 badge tools-40 + 1 hidden 中「+1 hidden」指的就是这一节列出的测试工具；主表 40 个始终是默认交付。

#	工具	触发配置	状态	说明
🧪 1	`memory_multimodal`	`config.multimodal.enabled = true`	测试	多模态记忆（image / audio / video），仅在显式开启后注册

启用方式（仅在你确认需要时开启）

// openclaw.json
{
  "multimodal": {
    "enabled": true,
    "storageDir": "~/.openclaw/workspace/memory/multimodal",
    "maxFileSizeMb": 50
  }
}

配套规则

enabled 默认 false，不开启时插件行为与 v1.8.x 完全一致
测试功能不进入主表、不计入默认工具数、不参与核心契约回归

⚙️ 配置

完整 schema 见 openclaw.plugin.json。关键分组：

{
  "capture": {
    "enabled": true,            // 自动捕获开关
    "mode": "async",            // sync | async (默认 async, 通过 write-queue 缓冲)
    "maxContentLen": 500,       // 单条捕获最大字符数
    "minContentLen": 3,         // 短输入阈值
    "batchSize": 10,            // 异步批量上限
    "debounceMs": 300,          // flush 最小延迟
    "excludeAgents": []         // 不参与捕获的 agent label
  },
  "recall": {
    "enabled": true,
    "strategy": "hybrid",       // hybrid | fts | vector
    "maxResults": 3,
    "topK": 5,                  // 向量候选数
    "minScore": 0.5,            // 向量相似度阈值
    "cacheTTL": 30000,          // 搜索结果缓存 (ms)
    "maxCacheSize": 50,
    "halfLife": 30,             // 时间衰减半衰期（天）
    "jaccardBase": 0.75,        // 多样化采样 Jaccard 阈值
    "maxSessions": 1000,        // 跨会话上下文累积上限
    "maxContextKeywords": 20
  },
  "embedding": {
    "enabled": false,           // 启用后支持向量+混合搜索
    "provider": "openai",
    "model": "",                // 留空根据 provider 自动选择
    "dimensions": 1024,
    "vectorBackend": "sqlite-vec",  // sqlite-vec (零依赖) | hnswlib (高性能, 需手动装)
    "hnswMaxElements": 50000,
    "timeoutMs": 15000,
    "retries": 1
  },
  "llm": {
    "enabled": true,            // 留空则自动复用 embedding 配置
    "model": "",
    "providerModels": {}        // 自定义 provider→model 映射
  },
  "cleanup": {
    "enabled": true,
    "l0l1RetentionDays": 30,    // 每日日志保留天数
    "allowAggressiveCleanup": false,
    "maxBackups": 10
  },
  "verify": { "enabled": true },   // 防幻觉（推测性内容标记）
  "quality": { "enabled": true },  // 注册 memory_quality
  "retain": { "enabled": true },   // 注册 memory_retain
  "graph": { "enabled": true },    // 注册 memory_graph
  "autoSaveImage": false,          // AI 收到图片后自动保存描述
  "cloud": {
    "enabled": true,
    "autoSync": false,
    "conflictPolicy": "newer",     // newer | keep_both
    "cmdTimeoutMs": 30000
  },
  "celiaBridge": {                 // v1.9.1: memory-celia 共存桥（默认关闭）
    "enabled": false,              // 仅检测到 memory-celia 占槽时生效
    "mode": "delegate",            // delegate=委托重叠工具+暴露celia工具; read-only=只读库增强
    "serverBinaryPath": "",        // 留空自动探测 ~/.openclaw/extensions/celia_memory/current/bin/
    "dbPath": "~/.openclaw/workspace/memory/celia_memory/celia_memory.db"
  }
}

环境变量（仅小艺 Claw 检测）

变量	作用
`XIAOYI_CHANNEL_ACTIVE=1`	标记小艺 channel 激活
`XIAOYI_DEVICE_TYPE=pad\|phone\|tablet`	设备类型提示（低置信）
`OPENCLAW_HOME`	OpenClaw 安装根
`OPENCLAW_CONFIG_PATH`	openclaw.json 路径

🧪 测试

npm test                  # 全部 799 单元测试（pretest 钩子自动跑 dist-check）
npm run test:ci           # CI 子集（排除 parallel）
npm run test:db           # 仅 DB 层
npm run test:store        # 仅 memory-store
npm run dist-check        # 验证 dist/ 与 src/ 同步（mtime + 文件存在）
npm run benchmark         # 性能基准

当前状态：826 测试全部通过，覆盖 204 个测试模块，覆盖率重点模块包括：

SmartVector 多信号融合（BM25 + 向量 + 时间衰减 + 重要性）
七因子价值函数（7 个独立因子 + 加权综合）
Dual Process 情景缓存（System 1 / System 2 回填）
FadeMem 激活衰减与竞争巩固
MemX EntropyRouter
RecMem 双向参考路径解码
小艺环境检测 6 路信号（含 SOUL.md + IDENTITY.md 推理）
MEMORY.md 读写 + 白名单
Hardened 安全脱敏
共存检测（UDS / 槽位 / core_skills）
memory-celia 槽位识别 + slotOwner 流转（隔离 HOME 子进程端到端验证，v1.9.1）
celia 委托映射（save/search/forget/list 参数转换，v1.9.1）
SRMU 三层守卫（RelevanceGate / SemanticShiftDetector / MemoryBackprop）
MemGAS 多粒度（GMM 聚类 + 熵路由）
SkVM 工具调用缓存
dist-check 同步校验（mtime + 文件存在）

📊 性能基准

指标	实测
FTS5 单关键词搜索	< 1ms (10k 记忆)
向量检索 (sqlite-vec, 1024d)	< 5ms (10k 记忆)
四信号融合（SmartVector）	< 1ms
Dual Process 快路径	< 0.1ms
七因子价值函数	< 0.5ms
L1 原子事实抽取（LLM）	300–800ms
L2 语义合并（LLM）	500–1500ms
启动到 banner 显示	< 200ms

🔒 兼容性

平台	状态
OpenClaw 标准环境	✅ 完全支持
OpenClaw + LLM 增强	✅ 可选启用
小艺 Claw（v1.8.0+）	✅ 自动识别，零配置适配
Claw-Core（v1.7.9+）	✅ 共存模式（coexist / standalone）
memory-celia 共存（v1.9.1+）	✅ 自动降级 + 可选委托桥
旧版 OpenClaw（< 2026.4.2）	❌ pluginApi 不兼容

openclaw.plugin.json 的 compat 字段声明：

{
  "openclaw.compat.pluginApi": ">=2026.4.2",
  "openclaw.build.openclawVersion": "2026.5.6"
}

🤝 与 memory-celia 共存（v1.9.1）

华为小艺 Claw 环境预装官方记忆插件 memory-celia，它会独占 memory 槽位（openclaw.json 的 slots.memory = "memory-celia"）。yaoyao 同样声明 kind: "memory"，v1.9.1 起会自动适配这个环境，无需改 kind、无需双环境分别打包。

自动行为（零配置）

检测到 slots.memory 被任何非 yaoyao-memory 的插件占用（含 memory-celia、claw-core 等）时，yaoyao 进入 coexist 模式，自动关闭会与之冲突的 3 个生命周期 hook，保留全部 40 个工具作为按需增强层：

组件	空环境（standalone）	占槽被他人占用（coexist）
auto-capture（L0 写入）	✅	❌ 强制关闭（即使配置写 `enabled:true` 也会被覆盖为 false）
auto-recall（prompt 注入）	✅	❌ 强制关闭（避免双注入）
heartbeat-recall	✅	❌ 强制关闭
command-new（会话边界清理）	✅	✅ 保留（无副作用）
40 个记忆工具	✅	✅ 全部保留

启动日志会显示 COEXIST mode — memory slot owned by "memory-celia"。

可选：委托桥（celiaBridge）

若希望重叠工具（save / search / forget / list）委托给 celia 执行（保证单一数据源），并额外获得 celia 独有能力（dream 梦境 / scene 场景 / global 用户画像），在 openclaw.json 开启：

{
  "celiaBridge": {
    "enabled": true,
    "mode": "delegate",            // delegate | read-only（"readonly" 为别名，等价；见下表）
    "serverBinaryPath": "",        // delegate 模式用；留空自动探测 ~/.openclaw/extensions/celia_memory/current/bin/
    "dbPath": "~/.openclaw/workspace/memory/celia_memory/celia_memory.db"
  }
}

两种模式（均已实现）：

模式	行为	附加工具	适用
`delegate`	spawn celia MCP server；重叠工具委托 celia 执行（失败自动 fallback）；暴露 celia 独有能力	7 个 `[via celia]` 工具（见下）	想统一数据源 + 用 dream/scene
`read-only`	不 spawn 服务，以 `readOnly=true` 打开 celia 库只读查询；零进程开销	1 个 `memory_celia_browse` 工具	只分析 celia 数据、不启动服务；或二进制不可得

delegate 模式下若 celia 二进制找不到，自动降级为 read-only。

开启 delegate 后额外注册的工具（标注 [via celia]）：

memory_dream_status / memory_dream_trigger / memory_dream_summary — 梦境子系统（涌现/巩固/冲突/衰减）
memory_scene_load / memory_scene_list — L1 场景记忆
memory_global_summary — L0 全局用户画像（edge/cloud_s/cloud_l）
memory_flush_celia — 刷新 celia 异步摄入队列

开启 read-only 后注册 memory_celia_browse，支持 source 参数查询 atomic/conversation/global/scene 四类 celia 数据，全程只读。

安全保证：委托调用失败会自动 fallback 回 yaoyao 自实现，celia 故障不会中断 yaoyao；yaoyao 绝不直接写入 celia 的数据库（read-only 模式以 readOnly=true 打开）。

🛣️ 路线图

✅ v1.8.x（已完成）

v1.8.0 — 小艺 Claw 架构全局适配（环境/通道/技能/设备/安全 6 维）
v1.8.1 — 论文驱动增强（FadeMem / MemX / RecMem）
v1.8.2 — SmartVector 四信号融合 + 七因子价值函数 + Dual Process 情景缓存
v1.8.2-hotfix — TypeScript 严格模式零错误 + 4 项功能 bug 修复
v1.8.3 — 多模态记忆（hidden，image / audio / video）
v1.8.4 — 本地 OpenClaw SDK stub，42 模块脱离外部包依赖
40 个工具 + 4 个 hook + 768 单元测试

✅ v1.9.0（已发）

L2 接管：DB 统一到 main.sqlite（yaoyao_ 前缀，3 视图，一次性幂等迁移）
记忆冲突自动消解（基于时间+来源+置信度）
自适应 TTL（按记忆类别）
已注册工具：39 个 + 1 hidden

✅ v1.9.1（已发）

memory-celia 共存：自动检测官方插件占槽 → 降级为按需增强层（关 capture/recall/heartbeat，留 40 工具）
celia 委托桥 delegate 模式：重叠工具委托 celia 执行 + 暴露 dream/scene/global 等 7 个 celia 独有工具
celia 只读桥 read-only 模式：不 spawn 服务，readOnly=true 读官方库，注册 memory_celia_browse 工具
mode 容错：read-only / readonly / read_only 自动归一化（照任意配置文档填写都正确）
首次对话自动引导：agent 自主发现配置状态（共存桥/向量/数据空），首次对话注入提示 + memory_setup 工具随时复查
修复潜伏 bug：db-reader/client 的 parameter property（--experimental-strip-types 运行时不支持）
新增 celiaBridge 配置项（默认关闭，空环境零影响）
测试 768 → 826（+58：celia 映射 + 共存检测 + read-only + mode + 首次引导等）

✅ v1.9.2（稳定发布 · 2026-06-28）

memory-celia 共存能力稳定版：经生产环境（小艺 Claw）验证后合并发布的 1.9.1 beta 全部能力
- 自动降级（coexist 检测 + hook 关闭）
- 委托桥 delegate / 只读桥 read-only 两模式
- mode 容错（read-only/readonly/read_only）
- agent 首次对话自动引导 + memory_setup 工具
- strip-types 运行时 bug 修复
完整安装向导 docs/install-guide.md
已注册工具：39 个 + 1 hidden（v1.9.1 新增 memory_setup）

📋 v1.9.x（计划）

跨设备记忆同步（P0）
LLM 自动情绪曲线生成

🔮 v2.0（远期）

多模态记忆（图片 / 音频 / 视频嵌入，v1.8.3 hidden）
端到端加密的云同步
联邦记忆（多 agent 共享部分记忆）
主动遗忘（基于遗忘曲线理论的智能清理）

🛡️ 安全

本地优先：所有记忆数据存储在本地 SQLite + markdown 文件，不上传任何遥测
零网络外发：除可选 LLM 增强（用户配置）和云备份（用户显式启用）外无网络调用
内容脱敏：Hardened 环境自动启用 token / API key / password pattern 占位替换
防幻觉：verify 模块在 auto-capture 中标记推测性 / 纠正性内容，避免错误记忆固化
celia 桥隔离（v1.9.1）：委托/代理仅调用 celia 自有工具，绝不直接写入 celia 数据库；read-only 桥以 readOnly=true 打开 celia 库；委托失败自动 fallback 回 yaoyao，celia 故障不会中断 yaoyao；桥默认关闭，需用户显式 celiaBridge.enabled=true
配置完整性：schema 校验 + 热重载保护
完整安全声明：见 SECURITY.md

"openclawSecurity": {
  "dataStorage": "100% local (SQLite FTS5 + filesystem). No telemetry. No analytics.",
  "dependencies": "Minimal: sqlite-vec for optional vector search; typescript (dev)."
}

🤝 贡献

欢迎 PR。所有改动请附带：

npm test 全通过（826 测试）
npm run build 零错误
新功能对应单元测试
CHANGELOG.md 更新

📄 License

MIT — 摇摇 (Yaoyao)

仓库：

GitHub: github.com/taobaoaz/yaoyao-plugin
CNB（国内镜像）: cnb.cool/TIAMO.xianyao/yaoyao-plugin

问题反馈：Issues 安全披露：SECURITY.md

Name		Name	Last commit message	Last commit date
Latest commit History 80 Commits
.github/workflows		.github/workflows
dist		dist
docs		docs
isolated-test		isolated-test
scripts		scripts
src		src
utils		utils
.gitattributes		.gitattributes
.gitignore		.gitignore
ARCHITECTURE.md		ARCHITECTURE.md
AUDIT-v1.7.8-FIXED.md		AUDIT-v1.7.8-FIXED.md
AUDIT-v1.7.8.md		AUDIT-v1.7.8.md
AUDIT_REPORT.md		AUDIT_REPORT.md
CHANGELOG.md		CHANGELOG.md
COMPATIBILITY_STRATEGY.md		COMPATIBILITY_STRATEGY.md
DEVELOPER_GUIDE.md		DEVELOPER_GUIDE.md
DEVELOPMENT_STANDARD.md		DEVELOPMENT_STANDARD.md
ENV_COMPATIBILITY.md		ENV_COMPATIBILITY.md
INTERCONNECT_ANALYSIS.md		INTERCONNECT_ANALYSIS.md
LICENSE		LICENSE
MIGRATION.md		MIGRATION.md
MODULARIZATION_PLAN.md		MODULARIZATION_PLAN.md
MODULE_CHECK.md		MODULE_CHECK.md
OPENC LAW_COMPLIANCE_CHECK.md		OPENC LAW_COMPLIANCE_CHECK.md
README.md		README.md
SECURITY.md		SECURITY.md
eslint.config.mjs		eslint.config.mjs
index.ts		index.ts
openclaw.plugin.json		openclaw.plugin.json
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

Yaoyao Memory Plugin v1.9.2

🌟 核心特性

🚀 v1.9.1 头版亮点

🤝 与官方 memory-celia 双环境共存

🚀 v1.8.x 头版亮点

🧬 小艺 Claw 架构全局适配（v1.8.0）

🧬 论文驱动的记忆增强（v1.8.1）

🧬 SmartVector 四信号融合 + 七因子价值函数（v1.8.2）

🧬 Dual Process 情景缓存（v1.8.2）

📦 安装

🇨🇳 国内镜像（CNB）

🏗️ 架构

4 层记忆引擎

28 项 Brain 设计

召回与捕获优化

🪝 Hooks（4 个）

🔧 已注册工具（38 个）

🔌 memory-celia 共存时附加工具（via celia · 可选）

🧪 测试功能（Hidden · 默认关闭）

⚙️ 配置

环境变量（仅小艺 Claw 检测）

🧪 测试

📊 性能基准

🔒 兼容性

🤝 与 memory-celia 共存（v1.9.1）

自动行为（零配置）

可选：委托桥（celiaBridge）

🛣️ 路线图

✅ v1.8.x（已完成）

✅ v1.9.0（已发）

✅ v1.9.1（已发）

✅ v1.9.2（稳定发布 · 2026-06-28）

📋 v1.9.x（计划）

🔮 v2.0（远期）

🛡️ 安全

🤝 贡献

📄 License

About

Resources

License

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages