diff --git a/docs/design/11-context-layers-redesign.md b/docs/design/11-context-layers-redesign.md
index 0382f48..c84ca0f 100644
--- a/docs/design/11-context-layers-redesign.md
+++ b/docs/design/11-context-layers-redesign.md
@@ -554,6 +554,10 @@ Base：`http://localhost:8083/api/mail`
 - **收件箱**：`GET /mail`
 - **发信**：`POST /mail`（必填：from, to, title, text；可选：type[inform/request], in_reply_to）
 - **Agent 列表**：`GET /mail/agents/list`
+
+## 注意事项
+- **开发/安装目录严格区分**：源码改在开发目录（`~/.openclaw/sanguo_projects/`），运行时在安装目录（`~/.sanguo_projects/`），设计文档只在开发目录维护
+- **Git 代理**：`git config --global http.proxy http://127.0.0.1:7890`（Git 不走系统代理）
 ```
 
 ### 8.4 IDENTITY.md