diff --git a/README.md b/README.md
index 3c205955..c320c4ae 100644
--- a/README.md
+++ b/README.md
@@ -28,18 +28,21 @@
# 🧠 ReMe
-ReMe 是一个专为 **AI 智能体** 打造的记忆管理工具，以 **Memory as File** 为核心，将对话、资料和长期知识沉淀为可读、可编辑、可检索的文件化记忆。
+ReMe 是一个面向 **AI 智能体** 的记忆管理工具，将对话、资料和长期知识沉淀为可读、可编辑、可检索的文件化记忆。
-ReMe 让智能体拥有可持续维护的记忆库：历史对话可归档，外部资料可索引，重要信息可沉淀为长期记忆，并通过关键词、语义检索和
-wikilink 图谱重新找到。
+## ✨ 核心创新
-## ✨ 适用场景
+- **Markdown as Memory**：以带 frontmatter 和 wikilink 的 Markdown 作为记忆节点，让人和 Agent 都能直接读写。
+- **自进化知识库**：记忆从原始输入进入 daily 浅加工，再沉淀为 digest 深加工长期知识。
+- **渐进式混合搜索**：先用关键词和语义召回定位片段，再沿 wikilink 图谱展开上下文。
+- **Agent 友好集成**：用文件、索引和工具接口组织记忆，方便不同 Agent 接入、维护和复用。
-- **个人助理**：为 [QwenPaw](https://github.com/agentscope-ai/QwenPaw) 等智能体提供长期记忆，记住用户偏好和历史对话。
-- **编程助手**：记录代码风格偏好、项目上下文，跨会话保持一致的开发体验。
-- **客服机器人**：记录用户问题历史、偏好设置，提供个性化服务。
-- **任务自动化**：从历史任务中学习成功/失败模式，持续优化执行策略。
-- **知识问答**：构建可检索的知识库，支持语义搜索和精确匹配。
+## 🧩 适用场景
+
+- **个人助理**：为 [QwenPaw](https://github.com/agentscope-ai/QwenPaw) 等 Agent 提供长期记忆。
+- **编程助手**：沉淀代码风格、项目背景和流程经验，跨会话保持一致。
+- **知识问答**：把资料和对话渐进加工成可检索、可追溯、可链接的 Markdown 知识库。
+- **任务自动化**：复用历史任务中的成功路径、失败教训和操作流程。
## 📁 记忆系统
@@ -80,7 +83,9 @@ ReMe 将**记忆视为文件**：原始对话和外部资料先进入输入层
└── wiki/
```
-
+
+ 
+
## 🚀 快速开始
diff --git a/docs/zh/auto_dream.md b/docs/zh/auto_dream.md
index c6f95b58..e54a0337 100644
--- a/docs/zh/auto_dream.md
+++ b/docs/zh/auto_dream.md
@@ -3,7 +3,9 @@
`auto_dream` 是 ReMe 的 daily 到 digest 的长期记忆沉淀流程。它扫描指定日期的 daily 输入，只处理相对上次 dream
发生变化的文件，把值得长期保留的内容抽取成 memory units，整合进 `digest/`，再生成当天可供主动提醒使用的 `interests.yaml`。
-
+
+ 
+
它消费的 daily 输入通常来自 [Auto Memory](./auto_memory.md) 和 [Auto Resource](./auto_resource.md)。`digest/`、`derived_from::`
和 wikilink 的文件语义见 [Memory as File](./memory_as_file.md)；Integrate 阶段的链接策略详见 [Auto Link](./auto_link.md)。
diff --git a/docs/zh/auto_memory.md b/docs/zh/auto_memory.md
index 5229f0e3..5dd96206 100644
--- a/docs/zh/auto_memory.md
+++ b/docs/zh/auto_memory.md
@@ -3,6 +3,10 @@
Auto Memory 是 ReMe 的对话记忆入口：每段对话先按 `session_id` 沉淀成一张 daily 记忆卡片，再由当天的 `YYYY-MM-DD.md`
统一索引。它负责把“聊过”变成“记住”，并把原始对话留好出处。
+
+ 
+
+
关于 `daily/`、`reme_session/`、frontmatter 和 wikilink 的通用文件语义，见 [Memory as File](./memory_as_file.md)。
```text
diff --git a/docs/zh/auto_resource.md b/docs/zh/auto_resource.md
index 02e49c80..3560fc71 100644
--- a/docs/zh/auto_resource.md
+++ b/docs/zh/auto_resource.md
@@ -3,6 +3,10 @@
Auto Resource 是 ReMe 的资源解读入口，目前处于 **Beta**。资源文件先按日期进入 `resource/`，再被解读成同名 daily
资源卡片，最后由当天的 `YYYY-MM-DD.md` 统一索引。
+
+
+
+
关于 vault 分层、`resource/` 和 `daily/` 的通用文件语义，见 [Memory as File](./memory_as_file.md)。对话进入 daily 的流程见
[Auto Memory](./auto_memory.md)。
diff --git a/docs/zh/framework.md b/docs/zh/framework.md
index 395e91e6..35aa637d 100644
--- a/docs/zh/framework.md
+++ b/docs/zh/framework.md
@@ -5,7 +5,9 @@
ReMe 的运行时可以理解为：**配置驱动的 Application 把组件和 Job 装配起来，Service 把可服务的 Job 暴露给 CLI、HTTP 或 MCP，Job
再按顺序执行 Step**。
-
+
+ 
+
如果只想先运行和使用 ReMe，见 [快速开始](./quick_start.md)。vault 文件语义见 [Memory as File](./memory_as_file.md)；检索、
自动记忆和主动读取的用户侧说明分别见 [Memory Search](./memory_search.md)、[Auto Memory](./auto_memory.md)、
diff --git a/docs/zh/memory_as_file.md b/docs/zh/memory_as_file.md
index 589b5ab8..91f2e025 100644
--- a/docs/zh/memory_as_file.md
+++ b/docs/zh/memory_as_file.md
@@ -2,7 +2,9 @@
ReMe 的核心思想是：**Memory as File, File as Memory**。
-
+
+ 
+
**Memory as File**：长期记忆不是藏在黑盒数据库里，而是落在 vault 目录中的 Markdown 文件、资源文件和索引快照里。用户和 Agent
都可以直接读、写、移动、删除这些文件。
diff --git a/docs/zh/memory_search.md b/docs/zh/memory_search.md
index 94fa972e..50b0c1b5 100644
--- a/docs/zh/memory_search.md
+++ b/docs/zh/memory_search.md
@@ -3,7 +3,9 @@
Memory Search 是 ReMe 的记忆检索入口。它先把 `daily/`、`digest/`、`resource/` 里的文件持续构建成可搜索的 chunk 索引和
wikilink 图谱；查询时先召回最相关的片段，再沿着片段所在文件的双向链接展开上下文。
-
+
+ 
+
文件分层、frontmatter、wikilink 和 chunking 的通用语义见 [Memory as File](./memory_as_file.md)。这里重点说明索引维护和查询执行。