632 lines
25 KiB
Markdown
632 lines
25 KiB
Markdown
# 织忆 (MemoryWeave) — 独立记忆基础设施
|
||
|
||
> **Go + Rust 双二进制架构** | port 7821 | 版本 v0.1.0-dev
|
||
> Gitea: http://192.168.123.11:3000/xiaoxue_admin/memoryweave/
|
||
|
||
织忆是多 Agent 系统的共享记忆层。它提供**语义记忆检索**、**知识图谱导航**、**自动蒸馏整合**三大核心能力，为 Hermes Agent、OpenClaw、Obsidian 等多客户端提供统一的记忆读写接口。
|
||
|
||
**织忆不是小唯系统的子模块——它是独立的基础设施服务。** 小唯系统（xiaowei-system）是上层应用，织忆是底层存储引擎，两者代码独立、仓库独立、进程独立，通过 HTTP API 交互。
|
||
|
||
---
|
||
|
||
## 相关项目关系图
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ 基础设施层（独立仓库，独立进程） │
|
||
│ │
|
||
│ 织忆 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）
|
||
```
|
||
|
||
| 项目 | 仓库 | 定位 | 依赖关系 |
|
||
|------|------|------|---------|
|
||
| **织忆 memoryweave** | `xiaoxue_admin/memoryweave` | 底层存储引擎（zhiyid + LanceDB + bge-embed）| 被依赖方 |
|
||
| **小唯 xiaowei-system** | `xiaoxue_admin/xiaowei-system` | 上层应用（daemon + cron + 记忆蒸馏）| 依赖方 |
|
||
|
||
**安装顺序：先织忆，再小唯系统。** 小唯系统通过 `localhost:7821` 调用织忆 API。
|
||
|
||
```bash
|
||
# 小唯系统调用织忆示例
|
||
curl -s -H "X-API-Key: zhiyi-dev-key-2026" \
|
||
-d '{"query":"牧尘偏好","top_k":3}' \
|
||
http://127.0.0.1:7821/api/v1/recall
|
||
```
|
||
|
||
---
|
||
|
||
## 架构总览
|
||
|
||
```
|
||
┌──────────────────────────────────────────────────────────────┐
|
||
│ Hermes Agent (Plugin) │
|
||
│ plugins/memory/zhiyi/ — 7 tools + 自动注入 + 社交关闭 │
|
||
└──────────────────────────┬───────────────────────────────────┘
|
||
│ HTTP (localhost:7821)
|
||
▼
|
||
┌──────────────────────────────────────────────────────────────┐
|
||
│ zhiyid (Go daemon, port 7821) │
|
||
│ │
|
||
│ ┌─────────────┐ ┌──────────────┐ ┌──────────────────────┐ │
|
||
│ │ REST API │ │ 蒸馏引擎 │ │ 冲突治理 / 缺口检测 │ │
|
||
│ │ ~84 端点 │ │ distill/ │ │ conflict + gap │ │
|
||
│ └──────┬──────┘ └──────┬───────┘ └──────────────────────┘ │
|
||
│ │ │ │
|
||
│ │ ┌──────────▼───────────┐ │
|
||
│ │ │ SQLiteGraphStore │ │
|
||
│ │ │ (7014 节点/61058 边)│ │
|
||
│ │ └──────────────────────┘ │
|
||
│ │ │
|
||
│ │ Unix Socket (/tmp/zhiyi-ipc.sock) │
|
||
└─────────┼─────────────────────────────────────────────────────┘
|
||
▼
|
||
┌──────────────────────────────────────────────────────────────┐
|
||
│ zhiyi-consolidate (Rust sidecar) │
|
||
│ │
|
||
│ ┌──────────────┐ ┌──────────────┐ ┌────────────────────┐ │
|
||
│ │ LanceDB 原生 │ │ DBSCAN 聚类 │ │ Embedding + │ │
|
||
│ │ 读写 │ │ 衰减回归 │ │ Rerank 管线 │ │
|
||
│ └──────┬───────┘ └──────────────┘ └────────────────────┘ │
|
||
│ ▼ │
|
||
│ ┌─────────────────────────────────────┐ │
|
||
│ │ /var/lib/memoryweave/ (LanceDB) │ │
|
||
│ │ memories: 3510 条 / episodes: 73 │ │
|
||
│ └─────────────────────────────────────┘ │
|
||
└──────────────────────────────────────────────────────────────┘
|
||
|
||
┌──────────────────────────┐
|
||
│ bge-embed (port 8000) │ ← Python ONNX 推理
|
||
│ BGE-M3 embedding 服务 │
|
||
└──────────────────────────┘
|
||
```
|
||
|
||
### 语言分工
|
||
|
||
| 组件 | 语言 | 原因 |
|
||
|------|------|------|
|
||
| HTTP API + 业务逻辑 | Go | goroutine 高并发，单二进制 |
|
||
| LanceDB + 向量管线 | Rust | 原生 `lancedb` crate，零 FFI |
|
||
| Embedding 推理 | Python (ONNX) | BGE-M3 模型，最佳推理生态 |
|
||
| Hermes 插件 | Python | Hermes MemoryProvider 接口 |
|
||
|
||
---
|
||
|
||
## 功能特性
|
||
|
||
### 语义记忆（commit / recall）
|
||
|
||
```
|
||
POST /api/v1/commit — 提交记忆（需 agent_id + content）
|
||
POST /api/v1/recall — 语义检索（支持 hybrid / keyword / semantic 三模式）
|
||
```
|
||
|
||
- 1024 维向量嵌入（BGE-M3）
|
||
- MMR diversity 默认 0.3，结果去重
|
||
- freshness 生命周期：`fresh` → `verified`
|
||
- 支持 namespace 隔离
|
||
|
||
### 知识图谱（Navigate / Stats）
|
||
|
||
```
|
||
POST /api/v1/graph/navigate — BFS 节点关系遍历
|
||
GET /api/v1/graph/stats — 图谱统计
|
||
POST /api/v1/graph/query — 精确边查询
|
||
GET /api/v1/graph/pagerank — PageRank 排序
|
||
```
|
||
|
||
- SQLite 存储，7014 节点 / 61058 边
|
||
- 自动实体归一化（`n_` 前缀）
|
||
- 按关系类型分组 + 推荐探索建议
|
||
- 自然语言查询（`nl_query`）
|
||
|
||
### P0 — Recall 降级策略
|
||
|
||
当 bge-embed (8000) 或 Rust IPC sidecar 不可用时，recall 自动降级到 graph.db 关键词搜索（FallbackTextSearch），返回 `X-Fallback: graph` 响应头。保证单点故障不导致全挂。
|
||
|
||
### P1 — 自动注入钩子 + 社交关闭
|
||
|
||
- `queue_prefetch` 后台线程自动查织忆 + 缓存（TTL 30s）
|
||
- 社交关闭检测：短消息、纯社交用语（"好的" / "ok" / "👍"）跳过注入
|
||
- 输出标记：`[织忆 Memory]` / `[织忆 Graph]`
|
||
- 无缝融入 Hermes 对话流
|
||
|
||
### P2 — 信任评分
|
||
|
||
`graph_edges` 表新增三列：
|
||
|
||
| 列名 | 类型 | 默认值 | 说明 |
|
||
|------|------|--------|------|
|
||
| `trust_score` | REAL | 0.5 | 信任评分（贝叶斯先验） |
|
||
| `retrieval_count` | INTEGER | 0 | 被检索次数 |
|
||
| `helpful_count` | INTEGER | 0 | 被标记有用次数 |
|
||
|
||
评分公式：`trust_score = helpful_count / retrieval_count`（retrieval_count > 0 时）
|
||
|
||
### P3 — CREATIVE.md 隔离
|
||
|
||
`~/.hermes/CREATIVE.md` 存储织忆工作记忆，插件 `system_prompt_block()` 自动加载标注为 `[织忆 工作记忆]`（Ground Truth level 2），解决 memory 工具与织忆 plugin 的双写入冲突。
|
||
|
||
### P4 — Ground Truth Prompt
|
||
|
||
SOUL.md 定义 4 级权威层级：
|
||
|
||
1. **Terminal 实时输出** — curl / 工具调用真实结果
|
||
2. **注入记忆** — `[织忆 Memory]` / `[织忆 Graph]`（插件注入）
|
||
3. **项目官方文档** — `docs/` / README / INSTALL
|
||
4. **训练知识** — 模型权重中存储的通用知识
|
||
|
||
低层级不可推翻高层级。另有记忆反馈规则确保信任评分闭环。
|
||
|
||
### P5 — Wiki 策展管线
|
||
|
||
`scripts/wiki_curator.py` 自动知识库管线：
|
||
|
||
- 扫描 `~/mc/` 下 `.md` 文件，SHA-256 diff 跟踪
|
||
- 启发式提取：headings → 概念，bold / key phrases → 实体
|
||
- 写入织忆：概念 `/commit`（category=wiki），关系 `/graph/edge`
|
||
- 支持 `--dry-run`（预览）、`--force`（全量）、`--llm`（LLM 增强）
|
||
- 跳过 <500 字符文件和 `_` 前缀文件
|
||
|
||
### H1-H6 精度优化
|
||
|
||
| 编号 | 优化 | 状态 |
|
||
|------|------|------|
|
||
| H1 | BM25 关键词评分（0.7 向量 + 0.3 关键词融合） | ✅ |
|
||
| H2 | LLM Wiki 策展（--llm 模式，回退启发式） | ✅ |
|
||
| H3 | 自动信任评分（recall 后异步 UpdateEdgeTrustScores） | ✅ |
|
||
| H4 | 默认 MMR diversity = 0.3 | ✅ |
|
||
| H5 | 三模式搜索：hybrid / keyword / semantic | ✅ |
|
||
| H6 | 多级存储：LanceDB → SQLite → 内存三级降级 | ✅ |
|
||
|
||
### cli-anything 命令行伴侣
|
||
|
||
织忆原生集成 cli-anything 框架，将 Go 和 Rust API 封装为 CLI 子命令。支持：
|
||
|
||
- `zhiyi commit` / `zhiyi recall` — 记忆操作
|
||
- `zhiyi navigate` / `zhiyi stats` — 图谱查询
|
||
- `zhiyi health` — 健康检查
|
||
- 详见 `cli-anything/` 目录
|
||
|
||
### rag-skill 渐进式检索（新增）
|
||
|
||
三段式检索架构：
|
||
|
||
```
|
||
用户查询 → keyword 粗筛 → semantic 精排 → rerank 重排序
|
||
```
|
||
|
||
- 粗筛层：BM25 关键词倒排索引，快速缩减候选集
|
||
- 精排层：BGE-M3 语义嵌入，向量相似度排序
|
||
- 重排序层：cross-encoder rerank，微调 top-K 结果
|
||
- 默认返回 top-K 结果，支持 `top_k` 参数调优
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
### 前置依赖
|
||
|
||
- Go 1.21+
|
||
- Rust 1.75+（仅需构建 zhiyi-consolidate）
|
||
- Redis 7.0+（可选，默认降级为内存模式）
|
||
- Python 3.10+（bge-embedding 服务）
|
||
|
||
### 构建
|
||
|
||
```bash
|
||
# 克隆
|
||
git clone http://192.168.123.11:3000/xiaoxue_admin/memoryweave.git
|
||
cd memoryweave
|
||
|
||
# 构建 Go daemon（zhiyid）
|
||
make build
|
||
|
||
# 构建 Rust sidecar（可选）
|
||
make build-rust
|
||
|
||
# 构建 CLI 工具
|
||
make build-cli
|
||
```
|
||
|
||
### 运行
|
||
|
||
```bash
|
||
# 方式一：直接运行
|
||
~/.local/bin/zhiyid
|
||
|
||
# 方式二：systemd（用户级，推荐）
|
||
systemctl --user enable --now zhiyid
|
||
systemctl --user enable --now bge-embed
|
||
systemctl --user enable --now zhiyi-consolidate
|
||
curl http://localhost:7821/health
|
||
|
||
# 方式三：Docker
|
||
docker compose up -d
|
||
curl http://localhost:7821/health
|
||
```
|
||
|
||
### 验证完整链路
|
||
|
||
```bash
|
||
# 1) 健康检查
|
||
curl -s -H "X-API-Key: zhiyi-dev-key-2026" http://localhost:7821/api/v1/health
|
||
|
||
# 2) 提条记忆试试
|
||
curl -s -X POST -H "X-API-Key: zhiyi-dev-key-2026" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"agent_id":"a06","content":"Hello 织忆","metadata":{"source":"test"}}' \
|
||
http://localhost:7821/api/v1/commit
|
||
|
||
# 3) 搜一下
|
||
curl -s -X POST -H "X-API-Key: zhiyi-dev-key-2026" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"query":"织忆","top_k":3}' \
|
||
http://localhost:7821/api/v1/recall
|
||
|
||
# 4) 图谱统计
|
||
curl -s -H "X-API-Key: zhiyi-dev-key-2026" http://localhost:7821/api/v1/graph/stats
|
||
```
|
||
|
||
### Hermes 插件安装
|
||
|
||
```bash
|
||
cp -r plugins/hermes-zhiyi ~/.hermes/hermes-agent/plugins/memory/zhiyi
|
||
uv pip install websocket-client
|
||
cd ~/.hermes/hermes-agent
|
||
python3 -c "from plugins.memory.zhiyi import HermesZhiYiMemoryProvider; \
|
||
p = HermesZhiYiMemoryProvider(); \
|
||
print(f'可用: {p.is_available()}, 工具数: {len(p.get_tool_schemas())}')"
|
||
```
|
||
|
||
---
|
||
|
||
## 配置参考
|
||
|
||
### 环境变量
|
||
|
||
| 变量 | 默认值 | 说明 |
|
||
|------|--------|------|
|
||
| `PORT` | `7821` | API 监听端口 |
|
||
| `STORAGE_BACKEND` | `lancedb` | 存储后端：`lancedb` / `sqlite` / `memory` |
|
||
| `SQLITE_PATH` | `/var/lib/memoryweave/memoryweave.db` | SQLite 数据库路径 |
|
||
| `LANCEDB_SOCKET` | `/tmp/zhiyi-ipc.sock` | Rust IPC socket 路径 |
|
||
| `GRAPH_PATH` | `/var/lib/memoryweave/graph.db` | 图谱数据库路径 |
|
||
| `API_KEY` | — | API 认证密钥 |
|
||
| `VLLM_ENDPOINT` | — | Embedding 模型端点 |
|
||
| `BGE_MODEL_DIR` | — | BGE-M3 ONNX 模型目录 |
|
||
| `RERANK_ENDPOINT` | — | Rerank 模型端点 |
|
||
| `LLM_ENDPOINT` | — | LLM 端点（蒸馏/自动修复用） |
|
||
| `LLM_MODEL` | — | LLM 模型名称 |
|
||
| `LLM_API_KEY` | — | LLM API Key |
|
||
| `STATIC_DIR` | 内置静态文件 | Web UI 静态文件目录 |
|
||
| `ZHIYI_WEB_UI_ROOT` | 内置 HTML | Web UI 入口路径 |
|
||
|
||
---
|
||
|
||
## API 速查表
|
||
|
||
> 所有 `/api/v1/*` 接口需要 Header: `X-API-Key: ***`
|
||
|
||
### 健康检查
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| GET | `/health` | 健康检查（无认证） |
|
||
| GET | `/api/v1/health` | 健康检查（需认证） |
|
||
|
||
### 核心记忆
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| POST | `/api/v1/commit` | 提交记忆 |
|
||
| POST | `/api/v1/recall` | 语义检索（支持 mode=hybrid\|keyword\|semantic） |
|
||
| POST | `/api/v1/batch-commit` | 批量提交 |
|
||
| GET | `/api/v1/memories` | 列出记忆（分页） |
|
||
| POST | `/api/v1/feedback` | 反馈（useful / not-useful / deprecate） |
|
||
|
||
### 统计
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| GET | `/api/v1/stats` | 系统统计（total_memories, episodes 等） |
|
||
|
||
### 知识图谱
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| GET | `/api/v1/graph/stats` | 图谱统计（节点数 / 边数 / 密度） |
|
||
| POST | `/api/v1/graph/navigate` | BFS 节点遍历（entity + max_hops） |
|
||
| POST | `/api/v1/graph/query` | 精确边查询 |
|
||
| POST | `/api/v1/graph/nl_query` | 自然语言图谱查询 |
|
||
| POST | `/api/v1/graph/edge` | 添加关系边 |
|
||
| POST | `/api/v1/graph/edge/feedback` | 边信任评分反馈 |
|
||
| GET | `/api/v1/graph/pagerank` | PageRank 节点排名 |
|
||
| POST | `/api/v1/graph/export` | 导出图谱 |
|
||
| POST | `/api/v1/graph/cleanup` | 脏数据清理（支持 dry_run） |
|
||
| GET | `/api/v1/cache/stats` | 图谱缓存命中率 |
|
||
|
||
### WebSocket
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| WS | `/api/v1/ws/{agent_id}` | 实时记忆流订阅 |
|
||
|
||
### 管理接口
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| POST | `/api/v1/admin/consolidate` | 手动触发记忆整合 |
|
||
| POST | `/api/v1/admin/forget` | 删除记忆 |
|
||
| POST | `/api/v1/admin/backup` | 创建备份 |
|
||
| GET | `/api/v1/admin/backups` | 列出备份 |
|
||
| POST | `/api/v1/admin/restore` | 恢复备份 |
|
||
| POST | `/api/v1/admin/distill/force` | 强制蒸馏 |
|
||
| GET | `/api/v1/admin/audit` | 审计日志 |
|
||
|
||
### 冲突治理
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| GET | `/api/v1/conflicts` | 列出记忆冲突 |
|
||
| POST | `/api/v1/conflicts/resolve` | 解决冲突 |
|
||
|
||
### 缺口检测
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| GET | `/api/v1/gaps` | 列出记忆缺口 |
|
||
| POST | `/api/v1/gaps/detect` | 检测缺口 |
|
||
| POST | `/api/v1/gaps/repair` | 修复缺口 |
|
||
| POST | `/api/v1/gaps/close/{id}` | 关闭缺口 |
|
||
|
||
### 蒸馏管理
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| GET | `/api/v1/distill/status` | 蒸馏状态 |
|
||
| GET | `/api/v1/distill/queue` | 蒸馏队列 |
|
||
| GET | `/api/v1/distill/quota` | 蒸馏配额 |
|
||
|
||
### L3 世界模型
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| GET | `/api/v1/l3/worldmodel` | 获取世界模型 |
|
||
| POST | `/api/v1/l3/worldmodel` | 更新世界模型 |
|
||
|
||
---
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
memoryweave/
|
||
├── go/ # Go daemon（zhiyid）
|
||
│ ├── cmd/zhiyid/ # 主入口
|
||
│ ├── internal/
|
||
│ │ ├── api/ # HTTP 路由 + 端点（~84 端点）
|
||
│ │ │ └── routes/ # 路由实现（core, graph, ws, l3, ...）
|
||
│ │ ├── governance/ # 冲突治理、图谱存储、自动扩展
|
||
│ │ ├── storage/ # 存储引擎（lancedb, sqlite, redis, recall, ...）
|
||
│ │ ├── models/ # 数据模型
|
||
│ │ ├── distill/ # 蒸馏引擎
|
||
│ │ ├── consolidate/ # 记忆整合客户端
|
||
│ │ ├── selfoptimize/ # 自优化管线
|
||
│ │ ├── distributed/ # 分布式支持
|
||
│ │ └── metrics/ # 监控指标
|
||
│ └── zhiyid-new # 编译产物
|
||
├── rust/ # Rust sidecar（zhiyi-consolidate）
|
||
│ └── src/
|
||
│ ├── main.rs # IPC 监听 + 调度
|
||
│ ├── lancedb_ops.rs # LanceDB 原生读写
|
||
│ ├── embed.rs # Embedding 推理
|
||
│ ├── rerank.rs # Rerank 管道
|
||
│ ├── cluster.rs # DBSCAN 聚类
|
||
│ ├── decay_calibrate.rs # 衰减校准
|
||
│ ├── graph_prune.rs # 图谱剪枝
|
||
│ ├── quality_backtrace.rs # 质量回溯
|
||
│ └── report.rs # 报告生成
|
||
├── plugins/
|
||
│ ├── hermes-zhiyi/ # Hermes MemoryProvider 插件（7 工具）
|
||
│ │ └── __init__.py # v1.1.0: 自动注入 + 社交关闭
|
||
│ └── obsidian/ # Obsidian 侧边栏插件
|
||
├── scripts/ # 运维脚本
|
||
│ ├── wiki_curator.py # P5 Wiki 策展管线
|
||
│ ├── three-way-check.sh # 三方交叉健康检查
|
||
│ ├── verify-p0p1p2.sh # P0/P1/P2 一键验证
|
||
│ └── daily-check.sh # 每日巡检
|
||
├── deploy/ # 部署配置
|
||
│ └── systemd/ # systemd service 文件
|
||
│ ├── zhiyid.service
|
||
│ ├── bge-embed.service
|
||
│ └── zhiyi-consolidate.service
|
||
├── cli-anything/ # CLI 命令行伴侣集成
|
||
├── carriers/ # 载体（Obsidian / 飞书等）
|
||
├── proto/ # Protocol Buffers 定义
|
||
├── web-ui/ # Web 管理界面
|
||
├── docs/ # 设计文档 / 方案文档
|
||
├── tests/ # 集成测试
|
||
├── backups/ # 备份目录
|
||
├── skills/ # Hermes skills 定义
|
||
├── docker-compose.yml # Docker 编排
|
||
├── Makefile # 构建入口
|
||
├── DESIGN.md # 完整架构设计（v3.8）
|
||
├── INSTALL.md # systemd 详细安装步骤
|
||
├── BENCHMARK.md # 性能基准测试
|
||
└── VERSION # 版本文件
|
||
```
|
||
|
||
---
|
||
|
||
## 运维
|
||
|
||
### 进程管理
|
||
|
||
```bash
|
||
# 查看所有相关进程
|
||
ps aux | grep -E 'zhiyi|bge' | grep -v grep
|
||
|
||
# 查看端口
|
||
ss -tlnp | grep -E '7821|8000'
|
||
```
|
||
|
||
### systemd 操作
|
||
|
||
```bash
|
||
# 状态检查
|
||
systemctl --user status zhiyid
|
||
systemctl --user status bge-embed
|
||
systemctl --user status zhiyi-consolidate
|
||
|
||
# 日志
|
||
journalctl --user -u zhiyid -f
|
||
journalctl --user -u bge-embed -f
|
||
journalctl --user -u zhiyi-consolidate -f
|
||
|
||
# 重启
|
||
systemctl --user restart zhiyid
|
||
```
|
||
|
||
### 健康检查
|
||
|
||
```bash
|
||
# 一键三方交叉验证（进程 + 端口 + 端点）
|
||
bash scripts/three-way-check.sh
|
||
|
||
# 或手动
|
||
curl -s -H "X-API-Key: zhiyi-dev-key-2026" http://localhost:7821/api/v1/health
|
||
curl -s http://localhost:8000/health # bge-embed
|
||
```
|
||
|
||
### 日志位置
|
||
|
||
| 进程 | 日志 |
|
||
|------|------|
|
||
| zhiyid | `/tmp/zhiyid.log` / `journalctl --user -u zhiyid` |
|
||
| Rust sidecar | `/tmp/zhiyi-sidecar.log` / `journalctl --user -u zhiyi-consolidate` |
|
||
| bge-embed | `journalctl --user -u bge-embed` |
|
||
|
||
---
|
||
|
||
## 相关项目
|
||
|
||
- **Hermes Agent** — 织忆的主要消费者。通过 `memory.provider: zhiyi` 配置自动集成 7 个记忆工具。
|
||
- **OpenClaw** — 第二消费者。通过 `openclaw-zhiyi-plugin/` 集成织忆记忆。
|
||
- **Obsidian** — 知识管理前端。通过 `plugins/obsidian/` 侧边栏插件交互。
|
||
- **cli-anything** — 命令行伴侣。将织忆 API 封装为 CLI 子命令。
|
||
- **Memory-OS** — 竞品对比参考（7 层记忆架构）。详见 `docs/memory-os-7-layer-comparison.md`。
|
||
|
||
---
|
||
|
||
## 文档
|
||
|
||
- [DESIGN.md](DESIGN.md) — 完整架构设计 v3.8
|
||
- [INSTALL.md](INSTALL.md) — systemd 详细安装步骤
|
||
- [Makefile](Makefile) — 构建入口（`make build` / `make build-rust` / `make build-cli`）
|
||
- [docker-compose.yml](docker-compose.yml) — Docker 编排
|
||
- [BENCHMARK.md](BENCHMARK.md) — 性能基准
|
||
- [docs/](docs/) — 方案文档与竞品分析
|