+
+
diff --git a/docs/_static/custom.css b/docs/_static/custom.css
new file mode 100644
index 00000000..d14920e0
--- /dev/null
+++ b/docs/_static/custom.css
@@ -0,0 +1,78 @@
+/* Heading sizes — tighten furo's defaults */
+h1, .bd-article h1 {
+ font-size: 1.8rem !important;
+}
+
+h2, .bd-article h2 {
+ font-size: 1.5rem !important;
+}
+
+h3, .bd-article h3 {
+ font-size: 1.25rem !important;
+}
+
+h4, .bd-article h4 {
+ font-size: 1.1rem !important;
+}
+
+h5, .bd-article h5 {
+ font-size: 1rem !important;
+}
+
+h6, .bd-article h6 {
+ font-size: 0.9rem !important;
+}
+
+/* Centered brand in the sidebar */
+.sidebar-brand {
+ text-align: center;
+}
+
+.sidebar-brand .sidebar-logo {
+ max-width: 60%;
+ margin: 0 auto;
+}
+
+/* Language switcher (injected by switcher.js) */
+.lang-switch {
+ display: flex;
+ gap: 0.4rem;
+ justify-content: center;
+ margin: 0.4rem 0 0.9rem;
+}
+
+.lang-switch a {
+ font-size: 0.8rem;
+ line-height: 1.4;
+ padding: 0.12rem 0.7rem;
+ border-radius: 999px;
+ border: 1px solid var(--color-background-border);
+ color: var(--color-foreground-secondary);
+ text-decoration: none;
+ cursor: pointer;
+}
+
+.lang-switch a:hover {
+ border-color: var(--color-brand-primary);
+ color: var(--color-brand-primary);
+}
+
+.lang-switch a.active {
+ background: var(--color-brand-primary);
+ border-color: var(--color-brand-primary);
+ color: #fff;
+ cursor: default;
+}
+
+.lang-switch--float {
+ position: fixed;
+ top: 0.6rem;
+ right: 0.8rem;
+ z-index: 50;
+ margin: 0;
+ background: var(--color-background-primary);
+ padding: 0.3rem 0.4rem;
+ border-radius: 999px;
+ box-shadow: 0 1px 4px rgba(0, 0, 0, 0.15);
+}
+
diff --git a/docs/_static/switcher.js b/docs/_static/switcher.js
new file mode 100644
index 00000000..209e4c87
--- /dev/null
+++ b/docs/_static/switcher.js
@@ -0,0 +1,54 @@
+// Language switcher for the ReMe docs.
+//
+// Each language is a separate Jupyter Book served under /zh/ and /en/ with the
+// same page filenames. This injects a 中文 / EN toggle into the furo sidebar
+// (falling back to a floating control) that swaps the language path segment of
+// the current URL.
+(function () {
+ "use strict";
+
+ var path = window.location.pathname;
+ var current, otherHref;
+
+ if (path.indexOf("/en/") !== -1) {
+ current = "en";
+ otherHref = path.replace("/en/", "/zh/");
+ } else if (path.indexOf("/zh/") !== -1) {
+ current = "zh";
+ otherHref = path.replace("/zh/", "/en/");
+ } else {
+ return; // not inside a language book (e.g. the root landing page)
+ }
+
+ function makeLink(label, lang) {
+ var a = document.createElement("a");
+ a.textContent = label;
+ if (lang === current) {
+ a.className = "active";
+ } else {
+ a.href = otherHref;
+ }
+ return a;
+ }
+
+ var wrap = document.createElement("div");
+ wrap.className = "lang-switch";
+ wrap.appendChild(makeLink("中文", "zh"));
+ wrap.appendChild(makeLink("EN", "en"));
+
+ function inject() {
+ var brand = document.querySelector(".sidebar-brand");
+ if (brand && brand.parentNode) {
+ brand.parentNode.insertBefore(wrap, brand.nextSibling);
+ } else {
+ wrap.classList.add("lang-switch--float");
+ document.body.appendChild(wrap);
+ }
+ }
+
+ if (document.readyState !== "loading") {
+ inject();
+ } else {
+ document.addEventListener("DOMContentLoaded", inject);
+ }
+})();
diff --git a/docs/en/_config.yml b/docs/en/_config.yml
new file mode 100644
index 00000000..f17ece14
--- /dev/null
+++ b/docs/en/_config.yml
@@ -0,0 +1,68 @@
+# Jupyter Book settings — English docs (built as a standalone book, served at /en/).
+# Learn more at https://jupyterbook.org/customize/config.html
+
+project: "ReMe"
+title: "
+ AgentScope
+ ReMe
+
"
+author: Alibaba Tongyi Lab
+logo: ../figure/reme_logo.png
+copyright: "2025, Tongyi Lab, Alibaba Inc."
+only_build_toc_files: true
+
+execute:
+ execute_notebooks: off
+
+parse:
+ myst_enable_extensions:
+ - colon_fence
+ - deflist
+ - attrs_inline
+ - dollarmath
+
+sphinx:
+ extra_extensions:
+ - sphinx_design
+ - sphinxcontrib.mermaid
+ config:
+ # Render ```mermaid fences as diagrams; generate heading anchors for in-page links.
+ myst_fence_as_directive:
+ - mermaid
+ myst_heading_anchors: 4
+
+ # Theme
+ html_theme: furo
+ pygments_style: "friendly"
+ html_show_sphinx: false
+ html_last_updated_fmt: "%Y-%m-%d"
+ html_copy_source: false
+ html_show_sourcelink: false
+ # Shared assets live in docs/_static (custom.css + the language switcher).
+ html_static_path:
+ - "../_static"
+ html_css_files:
+ - custom.css
+ html_js_files:
+ - switcher.js
+ use_multitoc_numbering: false
+ html_theme_options:
+ sidebar_hide_name: false
+ source_repository: "https://github.com/agentscope-ai/ReMe"
+ source_branch: "main"
+ source_directory: "docs/en/"
+ footer_icons:
+ - name: GitHub
+ url: "https://github.com/agentscope-ai/ReMe"
+ html: |
+
+ class: ""
+ light_css_variables:
+ color-brand-primary: "#2196f3"
+ color-brand-content: "#2196f3"
+ color-admonition-background: "#f8f9fa"
+ dark_css_variables:
+ color-brand-primary: "#64b5f6"
+ color-brand-content: "#64b5f6"
diff --git a/docs/en/_toc.yml b/docs/en/_toc.yml
new file mode 100644
index 00000000..0761fa0a
--- /dev/null
+++ b/docs/en/_toc.yml
@@ -0,0 +1,24 @@
+format: jb-book
+root: index
+
+parts:
+ - caption: Getting Started
+ chapters:
+ - file: quick_start
+ - caption: Core Concepts
+ chapters:
+ - file: memory_as_file
+ - file: framework
+ - caption: Memory
+ chapters:
+ - file: auto_memory
+ - file: auto_resource
+ - file: auto_dream
+ - file: auto_link
+ - caption: Retrieval & Proactive
+ chapters:
+ - file: memory_search
+ - file: proactive
+ - caption: Community
+ chapters:
+ - file: contributing
diff --git a/docs/en/auto_dream.md b/docs/en/auto_dream.md
new file mode 100644
index 00000000..b6b5177f
--- /dev/null
+++ b/docs/en/auto_dream.md
@@ -0,0 +1,7 @@
+# Auto Dream
+
+```{note}
+📖 The English version of this page is in progress.
+
+In the meantime, please read the 中文版本.
+```
diff --git a/docs/en/auto_link.md b/docs/en/auto_link.md
new file mode 100644
index 00000000..d83ed691
--- /dev/null
+++ b/docs/en/auto_link.md
@@ -0,0 +1,7 @@
+# Auto Link
+
+```{note}
+📖 The English version of this page is in progress.
+
+In the meantime, please read the 中文版本.
+```
diff --git a/docs/en/auto_memory.md b/docs/en/auto_memory.md
new file mode 100644
index 00000000..29a36f00
--- /dev/null
+++ b/docs/en/auto_memory.md
@@ -0,0 +1,7 @@
+# Auto Memory
+
+```{note}
+📖 The English version of this page is in progress.
+
+In the meantime, please read the 中文版本.
+```
diff --git a/docs/en/auto_resource.md b/docs/en/auto_resource.md
new file mode 100644
index 00000000..2e6790ba
--- /dev/null
+++ b/docs/en/auto_resource.md
@@ -0,0 +1,7 @@
+# Auto Resource
+
+```{note}
+📖 The English version of this page is in progress.
+
+In the meantime, please read the 中文版本.
+```
diff --git a/docs/en/contributing.md b/docs/en/contributing.md
new file mode 100644
index 00000000..c8309f05
--- /dev/null
+++ b/docs/en/contributing.md
@@ -0,0 +1,7 @@
+# Contributing
+
+```{note}
+📖 The English version of this page is in progress.
+
+In the meantime, please read the 中文版本.
+```
diff --git a/docs/en/framework.md b/docs/en/framework.md
new file mode 100644
index 00000000..24313440
--- /dev/null
+++ b/docs/en/framework.md
@@ -0,0 +1,7 @@
+# Framework
+
+```{note}
+📖 The English version of this page is in progress.
+
+In the meantime, please read the 中文版本.
+```
diff --git a/docs/en/index.md b/docs/en/index.md
new file mode 100644
index 00000000..e4af1199
--- /dev/null
+++ b/docs/en/index.md
@@ -0,0 +1,106 @@
+# Overview
+
+
Remember Me, Refine Me — a memory management toolkit for AI agents
+
+
+
+
+
+ReMe turns conversations and resources into **readable, editable, and searchable
+file-based long-term memory**. Long-term memory no longer hides inside a black-box
+database — it lives as Markdown files in a workspace directory that both users and
+agents can read, write, move, and delete.
+
+```{note}
+English documentation is in progress. The pages below mirror the Chinese structure;
+some currently link back to the complete 中文文档.
+```
+
+## ✨ Core Ideas
+
+::::{grid} 1 1 2 2
+:gutter: 3
+
+:::{grid-item-card} 📄 Memory as File
+Markdown files with frontmatter and wikilinks act as memory nodes that users and
+agents can edit directly.
+:::
+
+:::{grid-item-card} 🌱 Self-evolving knowledge base
+Auto Memory / Resource / Dream progressively distill conversations and resources into
+long-term memory, weaving wikilink relationships automatically.
+:::
+
+:::{grid-item-card} 🔎 Progressive hybrid search
+wikilinks + BM25 + embeddings combine keyword matching, semantic recall, and
+relationship expansion.
+:::
+
+:::{grid-item-card} 🤝 Agent-friendly integration
+`SKILL.md` + CLI integration lets different agents read, write, maintain, and reuse memory.
+:::
+
+::::
+
+## 🔄 Memory Pipeline
+
+ReMe's capabilities follow a **capture → consolidate → recall** pipeline:
+
+- **Capture** — [Auto Memory](auto_memory.md) distills conversations into daily cards;
+ [Auto Resource](auto_resource.md) interprets resource files.
+- **Consolidate** — [Auto Dream](auto_dream.md) extracts and integrates daily notes into
+ long-term `digest/`; [Auto Link](auto_link.md) weaves source and related wikilinks.
+- **Recall** — [Memory Search](memory_search.md) does hybrid retrieval with link expansion;
+ [Proactive](proactive.md) surfaces "what's worth attention today".
+
+The underlying file model and runtime are covered in
+[Memory as File](memory_as_file.md) and [Framework](framework.md).
+
+## 📚 Start Reading
+
+::::{grid} 1 2 2 3
+:gutter: 3
+
+:::{grid-item-card} 🚀 Quick Start
+:link: quick_start
+:link-type: doc
+
+Install, launch, and run your first write, index, and retrieval.
+:::
+
+:::{grid-item-card} 📄 Memory as File
+:link: memory_as_file
+:link-type: doc
+
+The file-based memory model: layering, frontmatter, wikilinks, chunking.
+:::
+
+:::{grid-item-card} 🏗️ Framework
+:link: framework
+:link-type: doc
+
+The Application / Service / Job / Step runtime and dependency injection.
+:::
+
+:::{grid-item-card} 🧠 Auto Memory
+:link: auto_memory
+:link-type: doc
+
+How conversations become daily memory cards with preserved provenance.
+:::
+
+:::{grid-item-card} 🔎 Memory Search
+:link: memory_search
+:link-type: doc
+
+Index building, hybrid recall, and progressive link expansion.
+:::
+
+:::{grid-item-card} ✨ Proactive
+:link: proactive
+:link-type: doc
+
+Reading the day's interest topics to drive proactive reminders and insights.
+:::
+
+::::
diff --git a/docs/en/memory_as_file.md b/docs/en/memory_as_file.md
new file mode 100644
index 00000000..5f73af91
--- /dev/null
+++ b/docs/en/memory_as_file.md
@@ -0,0 +1,7 @@
+# Memory as File
+
+```{note}
+📖 The English version of this page is in progress.
+
+In the meantime, please read the 中文版本.
+```
diff --git a/docs/en/memory_search.md b/docs/en/memory_search.md
new file mode 100644
index 00000000..0a6dc3bc
--- /dev/null
+++ b/docs/en/memory_search.md
@@ -0,0 +1,7 @@
+# Memory Search
+
+```{note}
+📖 The English version of this page is in progress.
+
+In the meantime, please read the 中文版本.
+```
diff --git a/docs/en/proactive.md b/docs/en/proactive.md
new file mode 100644
index 00000000..499fba83
--- /dev/null
+++ b/docs/en/proactive.md
@@ -0,0 +1,7 @@
+# Proactive
+
+```{note}
+📖 The English version of this page is in progress.
+
+In the meantime, please read the 中文版本.
+```
diff --git a/docs/en/quick_start.md b/docs/en/quick_start.md
new file mode 100644
index 00000000..26fa3603
--- /dev/null
+++ b/docs/en/quick_start.md
@@ -0,0 +1,7 @@
+# Quick Start
+
+```{note}
+📖 The English version of this page is in progress.
+
+In the meantime, please read the 中文版本.
+```
diff --git a/docs/zh/_config.yml b/docs/zh/_config.yml
new file mode 100644
index 00000000..d5367323
--- /dev/null
+++ b/docs/zh/_config.yml
@@ -0,0 +1,68 @@
+# Jupyter Book settings — Chinese docs (built as a standalone book, served at /zh/).
+# Learn more at https://jupyterbook.org/customize/config.html
+
+project: "ReMe"
+title: "
+