diff --git a/README.md b/README.md index 968275d..3f1dcb1 100644 --- a/README.md +++ b/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) +``` | 项目 | 仓库 | 定位 | 依赖关系 | |------|------|------|---------|