docs: 更新 README — 4个项目关系图 + TencentDB + Soulful

README.md

@@ -9,7 +9,119 @@
 
 ---
 
-## 与 xiaowei-system 的关系
+## 相关项目关系图
+
+```
+┌─────────────────────────────────────────────────────────┐
+│               基础设施层（独立仓库，独立进程）              │
+│                                                         │
+│  织忆 memoryweave         TencentDB                    │
+│  /tmp/memoryweave/        ~/.memory-tencentdb/         │
+│  port 7821                 port 8420                    │
+│  zhiyid + LanceDB          tdai-gateway                │
+│  + bge-embed              Node.js                      │
+└────────────────────┬────────────────────────────────────┘
+                     │ HTTP API（localhost）
+                     ▼
+┌─────────────────────────────────────────────────────────┐
+│               上层应用层（小唯系统）                       │
+│                                                         │
+│  ~/.hermes/  ← xiaowei-system 仓库（Git 版本控制）      │
+│                                                         │
+│  ┌─────────┐  ┌──────────┐  ┌─────────┐  ┌──────────┐  │
+│  │ Soulful │  │  daemon  │  │  cron   │  │  skills  │  │
+│  │ 牵挂    │  │  持久意识 │  │  定时任务│  │  仓颉技能 │  │
+│  │ 心迹    │  │  L1→L6   │  │  自检    │  │  股票投研 │  │
+│  │ 画像    │  │  蒸馏    │  │  升级    │  │          │  │
+│  └─────────┘  └──────────┘  └─────────┘  └──────────┘  │
+│                                                         │
+│  daemon.py → 统一写入 → llm_context.json（L7统一层）    │
+└─────────────────────────────────────────────────────────┘
+                     ▲
+                     │ daemon.py 读取
+                     │
+┌────────────────────┴────────────────────────────────────┐
+│               参考架构项目（GitHub/Gitea）                │
+│                                                         │
+│  agent-memory-skill  ← tier分层/线性衰减 参考            │
+│  memory-os           ← 7层记忆架构 参考                  │
+└─────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 各项目详情
+
+### 织忆 memoryweave（底层存储引擎）
+
+| 属性 | 值 |
+|------|-----|
+| 源码位置 | `/tmp/memoryweave/` |
+| Gitea | http://192.168.123.11:3000/xiaoxue_admin/memoryweave |
+| 进程 | zhiyid（port 7821）+ zhiyi-consolidate + bge-embed（port 8000）|
+| 数据 | LanceDB（memories）+ graph.db（8397 节点图谱）|
+| API | `http://127.0.0.1:7821/api/v1/` |
+
+### 小唯系统 xiaowei-system（上层应用）
+
+| 属性 | 值 |
+|------|-----|
+| 源码位置 | `~/.hermes/` |
+| Gitea | http://192.168.123.11:3000/xiaoxue_admin/xiaowei-system |
+| 进程 | daemon.py（持久意识） |
+| 数据 | llm_context.json（L7 统一层）+ soulful/（Soulful 数据）|
+
+**Soulful（牵挂/心迹/画像）** 是 xiaowei-system 的子模块，数据文件在 `~/.hermes/soulful/`：
+- `cares-queue.json` — 牵挂队列
+- `heart-traces.jsonl` — 心迹（重要时刻记录）
+- `user-profile.json` — 用户画像（含 distilled_rules）
+
+### TencentDB memory-tdai（对话记忆）
+
+| 属性 | 值 |
+|------|-----|
+| 源码位置 | `~/.memory-tencentdb/memory-tdai/` |
+| Gitea | 无（未版本控制）|
+| 进程 | tdai-gateway（port 8420，Node.js）|
+| 数据 | `memory.db`（对话）+ `vectors.db`（向量）|
+| API | `http://127.0.0.1:8420/` |
+| 小唯调用 | daemon.py 通过 `/capture` 和 `/recall` 写入/读取 |
+
+### 参考项目
+
+| 仓库 | 用途 |
+|------|------|
+| `xiaoxue_admin/agent-memory-skill` | tier 分层、线性衰减架构参考 |
+| `xiaoxue_admin/memory-os` | 7层记忆操作系统架构参考 |
+
+---
+
+## 安装顺序
+
+```
+第一步：织忆（底层）
+  ↓
+第二步：TencentDB（对话存储）
+  ↓
+第三步：小唯系统（上层应用，包含 Soulful）
+```
+
+**安装顺序：织忆 → TencentDB → 小唯系统。** 三者通过 HTTP API 互联，代码完全解耦。
+
+---
+
+## 架构依赖
+
+```
+小唯系统(daemon.py)
+├── /capture (TencentDB)    ← L3/L4 scenes 存储
+│   └── session_key + user_content + assistant_content
+├── http://127.0.0.1:7821  ← 织忆 L1/L2 recall
+│   └── X-API-Key: zhiyi-dev-key-2026
+├── ~/.hermes/soulful/     ← Soulful L5/L6 读写
+│   └── cares + heart-traces + user-profile
+└── → 统一写入 ~/.hermes/llm_context.json（L7）
+```
 
 | 项目 | 仓库 | 定位 | 依赖关系 |
 |------|------|------|---------|