From bcffe06e34b8207d0373c8e725302d76aa7afef4 Mon Sep 17 00:00:00 2001 From: xiaowei Date: Thu, 30 Jul 2026 12:34:13 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E7=94=9F=E6=80=81=E5=AE=8C=E7=BE=8E?= =?UTF-8?q?=E5=8C=96=E6=9E=B6=E6=9E=84=E6=96=87=E6=A1=A3=20v3.1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/记忆系统架构与流水线.md | 149 ++++++++++++++++------------------- 1 file changed, 66 insertions(+), 83 deletions(-) diff --git a/docs/记忆系统架构与流水线.md b/docs/记忆系统架构与流水线.md index 144b42d0..c9852f45 100644 --- a/docs/记忆系统架构与流水线.md +++ b/docs/记忆系统架构与流水线.md @@ -1,105 +1,88 @@ # 记忆系统架构与流水线 -> 版本: v3.0 | 2026-07-30 全面盘点修复 +> 版本: v3.1 | 2026-07-30 生态完美化 > 作者: 小唯 A06 +## 完整身份生态（7 实体） + +``` +┌─────────────────────────────────────────────────────┐ +│ 织忆 (共同大脑) │ +│ LanceDB 4,425mem + 图谱 8,705节点 │ +└──────┬──────────────┬──────────────┬────────────────┘ + │ │ │ + ┌───┴───┐ ┌────┴────┐ ┌───┴──────────────────┐ + │Hermes │ │prof-b │ │OpenClaw │ + │小唯A06│ │(分身) │ │A01小雪/A02铁锋 │ + │V4Flash│ │免费模型 │ │A03墨文/A04卫安/A05蓝图│ + └───────┘ └─────────┘ └──────────────────────┘ + │ │ + └──────────桥接──────────────┘ + openclaw-bridge.py + 织忆通道 +``` + ## 六层记忆架构 ``` -L0 运行时记忆 → llm_context.json (15KB, v2格式) +L0 运行时记忆 → llm_context.json (daemon统一写入) L1 对话记忆 → Hermes Sessions (SQLite FTS5) L2 语义记忆 → 织忆 (LanceDB + BGE-M3) -L3 代码记忆 → CBM (codebase-memory-mcp v0.9.0) -L4 情感记忆 → Soulful (JSONL 画像/心迹/牵挂) +L3 代码记忆 → CBM (codebase-memory-mcp v0.9.0, 5项目188K节点) +L4 情感记忆 → Soulful (JSONL 画像/心迹/牵挂/情绪感知) L5 结构化知识 → 仓颉书库 (7主题/15+skills) -L6 外部存储 → TencentDB (SQLite + sqlite-vec) +L6 外部存储 → TencentDB (SQLite + sqlite-vec, 3610任务) ``` -## 核心原则 - -1. **织忆是核心枢纽** — 所有层的数据最终汇聚/可查询到织忆 -2. **Daemon 是统一写入器** — deep_think 循环聚合各层状态 -3. **变更检测防冗余** — hash 对比，只有实质变化才 commit -4. **异常隔离** — 写入失败不影响主流程 - -## 数据流图 +## 数据流 ``` -┌──────────────┐ P0(每6h) ┌──────────┐ -│ CBM (L3) │ ──────────────▶ │ │ -│ 188K节点 │ │ │ -│ 753K边 │ P2(每12h) │ 织忆 │ -├──────────────┤ ──────────────▶ │ (L2) │ -│ 仓颉 (L5) │ │ 63ep │ -│ 7主题/15skill│ │ 4397mem │ -├──────────────┤ P1(每日) │ 8705节点 │ -│ Soulful (L4) │ ──────────────▶ │ │ -│ 画像/心迹/牵挂│ └──────────┘ -├──────────────┤ │ -│ Daemon (L0) │ ──deep_think(120s)──▶│ -│ llm_context │ │ -├──────────────┤ daemon每tick ┌──────────┐ -│ TencentDB(L6)│ ◀────────────────── │ Daemon │ -│ 3610任务 │ │ (L0) │ -└──────────────┘ │ 统一写入 │ - └──────────┘ +daemon deep_think (每120s tick) +├── P0: cbm-to-zhiyi.py (每4次tick) → CBM状态→织忆 +├── P2: cangjie-to-zhiyi.sh (每4次tick) → 仓颉调用→织忆 +├── F5: profile-sync.py (每4次tick) → 主状态→织忆(分身感知) +├── F3: openclaw-bridge.py status (每8次tick) → OpenClaw状态 +├── 情绪感知 _detect_emotion() → heart-traces→织忆 +├── TencentDB L1 capture +└── llm_context.json v2 统一写入 + +cron (27个任务) +├── 记忆系统自检 (每小时) → 5层健康检查 +├── 记忆系统自我升级 (每天4am) +├── CBM全索引刷新 (每天3am, 5项目) +├── CBM→织忆同步 (每6h, P0) +├── 仓颉→织忆同步 (每12h, P2, 全7skill) +├── 主状态→织忆同步 (每4h, F5, 分身感知) +├── OpenClaw状态同步 (每8h) +├── 每日复盘 (每天10pm) → 画像更新 +├── 牵挂提醒 (每天9am/9pm) +├── 股票信号 (交易日) +└── 双备份同步 (每6h) → 服务器 + Gitea ``` -## P0-P4 集成流水线 - -| 阶段 | 脚本 | 数据流 | 触发方式 | 状态 | -|------|------|--------|---------|------| -| P0 | `cbm-to-zhiyi.py` | CBM 项目状态 → 织忆 | cron 每6h | ✅ | -| P1 | `update_profile.py` | Soulful 画像更新 → 织忆 | daemon deep_think | ✅ | -| P2 | `cangjie-to-zhiyi.sh` | 仓颉技能调用 → 织忆 | cron 每12h | ✅ | -| P3 | `cbm-query-wrapper.py` | CBM CLI 查询 → 织忆 | 手动调用 | ✅ | -| P4 | `memory-system-check.sh` | 5层自检报告 | cron 每小时 | ✅ | - -## 自检命令 +## 桥接能力 ```bash -# 全系统 5 层自检 -bash ~/.hermes/scripts/memory-system-check.sh +# 向 OpenClaw agent 发消息 +python3 ~/.hermes/scripts/openclaw-bridge.py send a02 "检查磁盘" -# 指定层快速检查 -curl -s -H "X-API-Key: zhiyi-dev-key-2026" http://127.0.0.1:7821/api/v1/health -curl -s http://127.0.0.1:8420/health -codebase-memory-mcp cli list_projects 2>/dev/null | python3 -m json.tool +# 查看所有agent健康 +python3 ~/.hermes/scripts/openclaw-bridge.py status + +# 看通信历史 +python3 ~/.hermes/scripts/openclaw-bridge.py history + +# 主状态同步(分身感知) +python3 ~/.hermes/scripts/profile-sync.py ``` -## 2026-07-30 盘点修复记录 +## 跨系统插件接入 -### 发现的问题 - -| 问题 | 严重度 | 状态 | -|------|--------|------| -| 织忆 recall 偶尔超时(首次bge加载慢) | P0 | ✅ 已修(memory_recall.py 加15s超时+重试) | -| Soulful 情感记忆停滞(14天无增长) | P1 | ✅ 已修(daemon.py journals路径修复+cares自愈) | -| P0-P3 未接入自动化流水线 | P2 | ✅ 已修(daemon deep_think + cron) | -| 遗留 DB 占 25MB(graph.db/memoryweave.db) | P3 | ✅ 已归档 | -| agent_id 三套不一致 | P4 | ✅ 统一为 a06 | -| CBM 只索引2个项目 | P5 | ✅ 扩展至5项目 | -| memory_recall.py 超时&无重试 | P6 | ✅ 已修(15s+3次重试) | -| 架构文档丢失 | P7 | ✅ 本笔记 | - -### cron 任务清单 (2026-07-30) - -| cron | 调度 | 模式 | 用途 | -|------|------|------|------| -| 记忆系统自检 | 每小时 | no_agent | 5层健康检查 | -| 记忆系统自我升级 | 每天4am | no_agent | 自动缺陷修复 | -| CBM全索引刷新 | 每天3am | no_agent | 5项目索引 | -| CBM→织忆同步 | 每6小时 | no_agent | P0集成 | -| 仓颉→织忆同步 | 每12小时 | no_agent | P2集成 | -| 自我优化报告 | 每周日10am | no_agent | 优化建议 | -| 技能健康扫描 | 每周一10am | no_agent | 技能质量 | -| 每日复盘 | 每天10pm | no_agent | 画像更新 | -| 牵挂每日提醒 | 每天9am | no_agent | 情感关怀 | - -## 统一查询入口 - -```python -# 跨层统一查询 -python3 ~/.hermes/scripts/memory_recall.py "牧尘偏好" --top-k 3 -# 输出: 织忆 + TencentDB L1 + TencentDB L0 + Soulful 合并结果 -``` +| 实体 | 织忆 | CBM | 飞书 | 技能 | +|------|------|-----|------|------| +| 小唯 A06 (Hermes) | ✅ plugin v1.1 | ✅ MCP 8工具 | ✅ 当前聊天 | ✅ 仓颉7+skills | +| prof-b (分身) | ✅ 共享记忆 | ❌ | ❌ | ✅ 共享 | +| A01 小雪 (OpenClaw) | ✅ plugin v0.5.1 | ❌ | ✅ 飞书 | ✅ 3 skills | +| A02 铁锋 (OpenClaw) | ✅ plugin v0.5.1 | ❌ | ✅ 飞书 | ✅ 3 skills | +| A03 墨文 (OpenClaw) | ✅ plugin v0.5.1 | ❌ | ✅ 飞书 | ✅ 3 skills | +| A04 卫安 (OpenClaw) | ✅ plugin v0.5.1 | ❌ | ✅ 飞书 | ✅ 3 skills | +| A05 蓝图 (OpenClaw) | ✅ plugin v0.5.1 | ❌ | ✅ 飞书 | ✅ 3 skills |