diff --git a/frontend-web/docs/AI_WRITING_BACKEND_DEV_ZH.md b/frontend-web/docs/AI_WRITING_BACKEND_DEV_ZH.md
index e3177f4b..296507f8 100644
--- a/frontend-web/docs/AI_WRITING_BACKEND_DEV_ZH.md
+++ b/frontend-web/docs/AI_WRITING_BACKEND_DEV_ZH.md
@@ -543,6 +543,11 @@ config.yaml
 - `max_materials` 是「合并去重后的总量上限」，不是每个关键词的检索条数；每个词的检索数会按 `ceil(max_materials / keyword_count)` 均分。`keyword_count` 由前端启动写作时传入（1~10，默认 6）。
 - `intranet` 模式不带 fallback；如果内网 ES 全挂，researcher 拿到空结果会直接进入「未检索到素材，可重新搜索或在无素材的情况下继续写作」分支。如果想让内网失败时退回互联网检索，需要在 `get_search_provider` 里手动用 `_FallbackSearchProvider(IntranetSearchProvider(...), DuckDuckGoSearchProvider(...))` 包一层。
 
+ai_writing:
+  keyword_model: deepseek-chat       # 检索词生成专用模型，留空回退写作主模型
+  rank_model: deepseek-chat          # 素材排序专用模型，留空回退写作主模型
+  max_materials: 50                  # 合并去重后的素材总量上限，范围 [1, 100]，默认 20
+
 ---
 
 ## 十一、SSE 事件协议（后端 → 前端契约）
diff --git a/offline-backend-20260512/backend/config.yaml b/offline-backend-20260512/backend/config.yaml
index ea59ee68..bcd59712 100644
--- a/offline-backend-20260512/backend/config.yaml
+++ b/offline-backend-20260512/backend/config.yaml
@@ -186,6 +186,10 @@ memory:
     # streaming_scrubber:预留字段,代码尚未实现 —— 待版本支持后取消注释。
     # streaming_scrubber: true       # SSE 流前清洗 <memory-context>
 
-keyword_model: deepseek-chat
-rank_model: deepseek-chat
-max_materials: 20
+# AI 写作子系统 —— 素材收集专家专用配置。
+# 注意：这三项必须嵌套在 ai_writing: 段下；写到顶层会被 _ai_writing_config()
+# (app/gateway/routers/ai_writing.py:_ai_writing_config) 直接忽略。
+ai_writing:
+  keyword_model: deepseek-chat       # 检索词生成专用模型，留空回退写作主模型
+  rank_model: deepseek-chat          # 素材排序专用模型，留空回退写作主模型
+  max_materials: 50                  # 合并去重后的素材总量上限，范围 [1, 100]，默认 20