diff --git a/config.example.yaml b/config.example.yaml
index a4e1610..a6e433f 100644
--- a/config.example.yaml
+++ b/config.example.yaml
@@ -110,7 +110,13 @@ notify:
     url: ""
     secret: ""
     timeout: 10s
+    # 默认空白名单 ⇒ 所有 webhook 投递被丢弃。生产部署需要显式列出要外发的 topics：
     topics: []
+    # 可选 topics：
+    # - workspace.sync_failed
+    # - worktree.prune_pending
+    # - webhook.dead_letter
+    # - acp.session_crashed
 
 # ACP module: agent subprocess pool + WebSocket fanout + event retention
 acp: