From e2fb026dee611efa8f7b0cbbb818da83d6bd55e0 Mon Sep 17 00:00:00 2001
From: ZiyaZhang <199893125+ZiyaZhang@users.noreply.github.com>
Date: Fri, 31 Jul 2026 02:08:35 -0700
Subject: [PATCH] docs(examples): clarify reference memory limits

---
 examples/mcp-memory/README.i18n.yaml | 4 ++--
 examples/mcp-memory/README.md        | 2 ++
 examples/mcp-memory/README.zh.md     | 2 ++
 3 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/examples/mcp-memory/README.i18n.yaml b/examples/mcp-memory/README.i18n.yaml
index 1793918477..f2b9153850 100644
--- a/examples/mcp-memory/README.i18n.yaml
+++ b/examples/mcp-memory/README.i18n.yaml
@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write examples/mcp-memory/README.md
-README.md: 7d1565f240738249b1e08eef135031bf81cc6146
-README.zh.md: 037670ed0110ad46d6f7e1b7160a1c4ae830ed4b
+README.md: e0ca7ee4f18d0d8612f8e2ad5b3ba28ac15b2479
+README.zh.md: e5af09a98c8386697acde43b5f3db5438d90d69d
diff --git a/examples/mcp-memory/README.md b/examples/mcp-memory/README.md
index 7d1565f240..e0ca7ee4f1 100644
--- a/examples/mcp-memory/README.md
+++ b/examples/mcp-memory/README.md
@@ -55,6 +55,8 @@ dsh --config "$PWD/examples/mcp-memory/mcp-reference-memory.cordis.yml"
 
 This reference server stores a local knowledge graph and exposes entity, relation, observation, read, search, and open tools. It needs no model or embedding service. The example maps `DSH_MEMORY_USER_ID` to an isolated `MEMORY_FILE_PATH`.
 
+Search is case-insensitive substring matching over entity names, types, and observations, not semantic retrieval. The server does not add embeddings, automatic summarization, conflict resolution, or a forgetting policy.
+
 ### Engram
 
 ```sh
diff --git a/examples/mcp-memory/README.zh.md b/examples/mcp-memory/README.zh.md
index 037670ed01..e5af09a98c 100644
--- a/examples/mcp-memory/README.zh.md
+++ b/examples/mcp-memory/README.zh.md
@@ -55,6 +55,8 @@ dsh --config "$PWD/examples/mcp-memory/mcp-reference-memory.cordis.yml"
 
 该参考服务器存储本地知识图谱，并公开实体、关系、观察、读取、搜索和打开工具。它不需要模型或 embedding 服务。该示例将 `DSH_MEMORY_USER_ID` 映射到隔离的 `MEMORY_FILE_PATH`。
 
+搜索只对实体名称、类型和 observation 进行不区分大小写的子字符串匹配，不是语义检索。该服务器不提供 embedding、自动摘要、冲突消解或遗忘策略。
+
 ### Engram
 
 ```sh