From a316ba4f556aa2f601b407e8bf3bfba7599d0e5f Mon Sep 17 00:00:00 2001 From: "jinli.yl" Date: Sat, 20 Jun 2026 22:43:21 +0800 Subject: [PATCH] up --- README.md | 25 +++++++++++++++---------- docs/zh/auto_dream.md | 4 +++- docs/zh/auto_memory.md | 4 ++++ docs/zh/auto_resource.md | 4 ++++ docs/zh/framework.md | 4 +++- docs/zh/memory_as_file.md | 4 +++- docs/zh/memory_search.md | 4 +++- 7 files changed, 35 insertions(+), 14 deletions(-) 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/ ``` -![ReMe overview](docs/figure/reme-overview.svg) +

+ ReMe 文件化记忆系统总览 +

## 🚀 快速开始 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`。 -![Auto Dream flow](../figure/auto-dream.svg) +

+ ReMe Auto Dream 从 daily 到 digest 的长期记忆沉淀流程 +

它消费的 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` 统一索引。它负责把“聊过”变成“记住”，并把原始对话留好出处。 +

+ ReMe Auto Memory 与 Auto Resource 写入 daily 记忆卡片的流程 +

+ 关于 `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` 统一索引。 +

+ ReMe Auto Memory 与 Auto Resource 写入 daily 记忆卡片的流程 +

+ 关于 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 代码框架结构](../figure/framework-structure.svg) +

+ ReMe 代码框架结构：CLI、Service、Application、Job、Step 与 Component +

如果只想先运行和使用 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 model](../figure/memory-as-file.svg) +

+ ReMe Memory as File 文件化记忆模型 +

**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 图谱；查询时先召回最相关的片段，再沿着片段所在文件的双向链接展开上下文。 -![Memory Search 索引与检索流程](../figure/memory-search.svg) +

+ ReMe Memory Search 索引、召回、融合与链接展开流程 +

文件分层、frontmatter、wikilink 和 chunking 的通用语义见 [Memory as File](./memory_as_file.md)。这里重点说明索引维护和查询执行。