From 4e17b8cb983ba75db491d0929aa926ae7966448a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=B0=8F=E5=94=AF?= <xiaowei@xiaoxue.ai>
Date: Mon, 20 Jul 2026 15:50:07 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AF=B4=E6=98=8E=E4=B8=8E=20xiaowei-s?=
 =?UTF-8?q?ystem=20=E7=9A=84=E5=85=B3=E7=B3=BB=E5=92=8C=E5=AE=89=E8=A3=85?=
 =?UTF-8?q?=E9=A1=BA=E5=BA=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 明确织忆是底层基础设施，xiaowei-system 是上层应用
- 安装顺序：先织忆，再小唯系统
- 加 API 调用示例
---
 README.md | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 25e398e..968275d 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,25 @@
 
 织忆是多 Agent 系统的共享记忆层。它提供**语义记忆检索**、**知识图谱导航**、**自动蒸馏整合**三大核心能力，为 Hermes Agent、OpenClaw、Obsidian 等多客户端提供统一的记忆读写接口。
 
-织忆不是 Hermes 的子模块——它是独立的系统级服务，由 4 个平级组件组成，任何组件的独立故障不影响全局。
+**织忆不是小唯系统的子模块——它是独立的基础设施服务。** 小唯系统（xiaowei-system）是上层应用，织忆是底层存储引擎，两者代码独立、仓库独立、进程独立，通过 HTTP API 交互。
+
+---
+
+## 与 xiaowei-system 的关系
+
+| 项目 | 仓库 | 定位 | 依赖关系 |
+|------|------|------|---------|
+| **织忆 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
+```
 
 ---