diff --git a/AGENTS.md b/AGENTS.md
index e9a7986..f429ea9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -180,6 +180,13 @@ curl -s -X POST -H "Authorization: Bearer $TOK" "$A/gateway/apply"
 # 导航分组 / 条目
 curl -s -X POST -H "Authorization: Bearer $TOK" -H 'Content-Type: application/json' \
   -d '{"name":"常用服务"}' "$A/section"
+> ⚠️ **两个分组是系统管理的，不要往里手工加条目**：
+> - `常用服务`：按**访问频次**自动取前 5（Gitea 固定置顶），服务端重建
+> - `历史访问`：按浏览器同步的浏览记录重建（安装入口由它自己放在首位）
+>
+> 因此 `navEnabled` 的 `navSection` 必须指向**用户分组**（如 `AI & 工具`、`系统管理`）。
+> 实测教训：把新服务直接塞进 `常用服务` 会污染频次榜，且该条目会被下一次重建挤掉。
+
 # 导航条目是**嵌套形状**（实测：扁平 {"name","url"} 会返回 "title and url required"）：
 #   先查分组下标，再提交 {"sectionIndex":N,"item":{...}}
 IDX=$(curl -s -H "Authorization: Bearer $TOK" "$A/sections" | \
diff --git a/README.md b/README.md
index b44d06c..3f54db9 100644
--- a/README.md
+++ b/README.md
@@ -642,6 +642,10 @@ curl -s http://127.0.0.1:18080/api/schema | jq        # 人读：items + resourc
    echo "$code"
    ```
 
+> **注意 `常用服务` 与 `历史访问` 是系统管理的分组**：前者按访问频次自动取前 5（Gitea 置顶），
+> 后者按浏览记录重建。新增服务要放进用户分组（如 `AI & 工具`）；`navEnabled` 的 `navSection`
+> 若指向 `常用服务`，条目会在下次重建时被挤掉。
+
 **示例：让 agent 一次性把站点改成你要的样子**
 
 ```bash