From 1ada25590a397a9ed4aade8aeba8b32dfd369cbc Mon Sep 17 00:00:00 2001 From: "jinli.yl" Date: Sun, 20 Sep 2026 18:18:19 +0800 Subject: [PATCH] fix(docs): repair localized blog navigation --- README.md | 2 +- README_ZH.md | 2 +- docs/.vitepress/config.mts | 5 +++-- docs/zh/blog_20260920.md | 16 ++++++++-------- github-pages/scripts/verify-build.mjs | 13 +++++++++++++ github-pages/tests/generated-content.test.mjs | 4 ++++ 6 files changed, 30 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 10dddcb8..b8767027 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,7 @@ users retain control of the durable files. ## 📰 Latest Updates -- [2026.09] - **[Memory Tags blog](https://reme.agentscope.io/zh/blog_20260920) published (Chinese)**: an introduction +- [2026.09] - **[Memory Tags blog](https://reme.agentscope.io/en/blog_20260920) published**: an introduction to file-native entity tags, rebuildable tag indexes, and tag-filtered memory search. - [2026.09] - **[Hermes Agent memory provider](integrations/hermes_agent/README.md) available**: choose HTTP or embedded mode for automatic recall before model calls and asynchronous `auto_memory` after completed turns. The integration diff --git a/README_ZH.md b/README_ZH.md index 9f268c8f..5044a3ea 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -47,7 +47,7 @@ ## 📰 最新动态 -- [2026.09] - **[Memory Tags 博客](https://reme.agentscope.io/zh/blog_20260920)发布**:介绍基于 Markdown 的实体标签、 +- [2026.09] - **[记忆标签博客](https://reme.agentscope.io/zh/blog_20260920)发布**:介绍基于 Markdown 的实体标签、 可重建 Tag Index 与标签过滤检索。 - [2026.09] - **[Hermes Agent 记忆 Provider](integrations/hermes_agent/README_ZH.md) 已可使用**:支持 HTTP 和 Embedded 两种模式,在模型调用前自动召回、每轮对话结束后异步执行 `auto_memory`。集成支持 Hermes Agent 0.21 及以上版本,后台任务也会继承当前 profile 上下文。 diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 6e1c638a..609cb409 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -219,10 +219,11 @@ function singlePageSidebar(language: "zh" | "en", page: "blog" | "faq"): Default if (page === "blog") { return [{ text: zh ? "ReMe 博客" : "ReMe Blog", + link: `/${language}/reme-blog`, collapsed: false, items: [ - { text: zh ? "产品故事" : "Product Story", link: `/${language}/reme-blog` }, - { text: "Memory Tags", link: `/${language}/blog_20260920` }, + { text: zh ? "ReMe介绍" : "About ReMe", link: `/${language}/reme-blog` }, + { text: zh ? "记忆标签" : "Memory Tags", link: `/${language}/blog_20260920` }, ], }]; } diff --git a/docs/zh/blog_20260920.md b/docs/zh/blog_20260920.md index 9d22f97c..e044cb7d 100644 --- a/docs/zh/blog_20260920.md +++ b/docs/zh/blog_20260920.md @@ -1,4 +1,4 @@ -# 给记忆加上“线索”——ReMe Memory Tags +# 给记忆加上“线索”——ReMe 记忆标签 一个真正长期使用的记忆系统,迟早会遇到一个看似简单的问题:**记忆越来越多以后,怎么只在“正确的那一堆”里找答案?** @@ -10,21 +10,21 @@ 人类回忆往往不是这样发生的。我们很少在脑海里对所有经历做一次全文搜索,而是先抓住几个线索:**关于 Alice 的、关于 Project A 的、去年讨论过的那件事。**范围缩小以后,具体细节才逐渐浮现。 -这就是 ReMe 增加 Memory Tags 的原因:让每份 Markdown 记忆除了“写了什么”,还可以明确表达“这份记忆主要关于谁或什么”,并让这个线索真正参与检索。 +这就是 ReMe 增加记忆标签的原因:让每份 Markdown 记忆除了“写了什么”,还可以明确表达“这份记忆主要关于谁或什么”,并让这个线索真正参与检索。

ReMe 从 Markdown 标签建立索引并过滤搜索范围

-## 为什么需要 Tags? +## 为什么需要记忆标签? -ReMe 已经可以通过 BM25 找关键词,通过可选的 Embedding 找语义相近的内容,也可以沿着 Wikilink 查看记忆之间的关系。Memory Tags 并不是要替代它们,而是补上另一个维度:**检索范围。** +ReMe 已经可以通过 BM25 找关键词,通过可选的 Embedding 找语义相近的内容,也可以沿着 Wikilink 查看记忆之间的关系。记忆标签并不是要替代它们,而是补上另一个维度:**检索范围。** 可以把三者想成三个不同的问题: - 搜索词回答“我现在想找什么”; - Wikilink 回答“这份记忆和哪些记忆有关”; -- Memory Tags 回答“我应该先去哪些记忆里找”。 +- 记忆标签回答“我应该先去哪些记忆里找”。 例如,“预算超支怎么处理”可能在很多项目里都出现过。如果搜索时加上 `Project_A`,Agent 就可以先把范围缩小到与 Project A 有关的文件,再在其中寻找“预算超支”的具体内容。 @@ -96,7 +96,7 @@ reme list_tags order_by=file_count order=desc ## 搜索时,标签如何参与? -Memory Tags 最重要的作用不是展示,而是过滤。 +记忆标签最重要的作用不是展示,而是过滤。 还是前面的例子。只搜索一句自然语言: @@ -135,7 +135,7 @@ Tag Index 找到候选文件 ## 它会带来什么变化? -Memory Tags 带来的效果,不是让每次搜索都多一个必填参数。没有标签时,原有搜索仍然可以正常工作。它真正改变的是:当用户或 Agent 已经知道一部分上下文时,这些上下文不再只能藏在一句模糊的查询里。 +记忆标签带来的效果,不是让每次搜索都多一个必填参数。没有标签时,原有搜索仍然可以正常工作。它真正改变的是:当用户或 Agent 已经知道一部分上下文时,这些上下文不再只能藏在一句模糊的查询里。 ### 1. 同一句话,不再轻易串到别的项目 @@ -157,7 +157,7 @@ Alice 可能出现在会议记录、项目决策、个人偏好和复盘文档 我们并不希望把个人知识库变成一棵需要精心维护的分类树。真实记忆天然会重叠:一次谈话既可能关于一个人,也可能关于一个项目;一项决定既属于当下的会议,也会影响几个月后的复盘。 -Memory Tags 更像人类记忆里的提取线索。看到一个人的名字,我们会想起共同经历;想到一个项目,我们会联想到相关决定、问题和承诺。线索本身不是记忆正文,却能帮助我们从大量经历中更快进入正确的上下文。 +记忆标签更像人类记忆里的提取线索。看到一个人的名字,我们会想起共同经历;想到一个项目,我们会联想到相关决定、问题和承诺。线索本身不是记忆正文,却能帮助我们从大量经历中更快进入正确的上下文。 ReMe 所做的事情很朴素: diff --git a/github-pages/scripts/verify-build.mjs b/github-pages/scripts/verify-build.mjs index 12317dda..1726156f 100644 --- a/github-pages/scripts/verify-build.mjs +++ b/github-pages/scripts/verify-build.mjs @@ -47,6 +47,10 @@ const requiredFiles = [ "en/traffic.html", "zh/configuration.html", "en/configuration.html", + "zh/reme-blog.html", + "en/reme-blog.html", + "zh/blog_20260920.html", + "en/blog_20260920.html", "zh/services.html", "en/services.html", "zh/workspace/studio.html", @@ -90,6 +94,15 @@ assert.match(ChineseConfiguration, /搜索文档/); assert.match(ChineseConfiguration, /复制 Markdown/); assert.match(ChineseConfiguration, /在 GitHub 查看源文件/); +const ChineseBlog = await readFile(path.join(outputDir, "zh/blog_20260920.html"), "utf8"); +assert.match(ChineseBlog, /]*>给记忆加上“线索”——ReMe 记忆标签/); +assert.match(ChineseBlog, />记忆标签<\/p>/, "the Chinese sidebar must use the localized article name"); +assert.match( + ChineseBlog, + /]*>.*?

]*>ReMe 博客<\/h2>/, + "the blog sidebar heading must link to the blog landing page", +); + const jobReference = await readFile(path.join(outputDir, "en/reference/jobs.html"), "utf8"); assert.match(jobReference, /Job API Reference/); assert.match(jobReference, /auto_memory/); diff --git a/github-pages/tests/generated-content.test.mjs b/github-pages/tests/generated-content.test.mjs index 89ae4edf..3076ad19 100644 --- a/github-pages/tests/generated-content.test.mjs +++ b/github-pages/tests/generated-content.test.mjs @@ -57,6 +57,10 @@ test("publishes the root READMEs as localized project overviews", async () => { assert.match(chinese, /^---\ntitle: ReMe 项目介绍/m); assert.match(english, /href="\/zh\/overview"/); assert.match(chinese, /href="\/en\/overview"/); + assert.match(english, /https:\/\/reme\.agentscope\.io\/en\/blog_20260920/); + assert.doesNotMatch(english, /https:\/\/reme\.agentscope\.io\/zh\/blog_20260920/); + assert.match(chinese, /https:\/\/reme\.agentscope\.io\/zh\/blog_20260920/); + assert.match(chinese, /\[记忆标签博客\]/); assert.match(english, /src="\.\.\/figure\/design-philosophy\.svg"/); assert.match(chinese, /\(\.\/memory_search\.md\)/); });