diff --git a/.env.example b/.env.example
index 49e5b12..a8a448b 100644
--- a/.env.example
+++ b/.env.example
@@ -16,6 +16,13 @@ LLM_API_KEY=sk-xxxxx
 LLM_MODEL=gpt-4o
 LLM_FALLBACK_MODEL=gpt-4o-mini
 
+# ========== 记忆嵌入 (Embedding) — 可选 ==========
+# 嵌入 API 独立于对话 LLM，因为 DeepSeek 等厂商不提供 /embeddings 端点。
+# 不配置时自动使用本地 n-gram 文本相似度（中文效果可用，无需外部依赖）。
+# 如需更强检索质量，可指向 Ollama 等本地嵌入服务：
+# EMBEDDING_API_URL=http://localhost:11434/v1
+# EMBEDDING_MODEL=bge-m3
+
 # ========== LLM 模型路由配置 (可选，优先于 LLM_* 环境变量) ==========
 # MODELS_CONFIG_PATH=./models.json