docs: 生态完美化架构文档 v3.1
This commit is contained in:
xiaowei
parent
3328f00b11
commit
bcffe06e34
|
|
@ -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 |
|
||||
|
|
|
|||
Loading…
Reference in New Issue