故障排查
客服氣泡不出現，幾乎都是下面五個原因之一。按順序逐項檢查，每項只需 30 秒。
1. 未配置 AI 模型（最常見）
在你的帳號通過模型連通性測試之前，挂件會刻意保持隱藏。
檢查： Dashboard → AI Model —— 是否有已保存且驗證通過（綠色狀態）的模型配置？
解決： 選擇一個 Provider（OpenAI 兼容 / Anthropic Claude / Google Gemini），填入你自己的 API Key 並保存。測試通過後約 1 分鐘內氣泡就會出現。詳見 嵌入代碼。
2. CSP（內容安全政策）攔截了腳本
如果你的網站返回 Content-Security-Policy 響應頭，瀏覽器可能會靜默拒絕加載挂件。
檢查： 打開 DevTools → Console，CSP 攔截的報錯形如：
Refused to load the script 'https://widget.webnav.ai/widget/chat-widget.js'
because it violates the following Content Security Policy directive: "script-src ..."解決： 在 script-src 和 connect-src 兩個指令裡放行挂件域名（只需這兩條，詳見 CSP 說明）：
script-src 'self' https://widget.webnav.ai;
connect-src 'self' https://widget.webnav.ai;3. 廣告攔截 / 隱私插件
部分攔截器會按 chat-widget 這類 URL 特徵攔截。
檢查： 用無痕窗口 + 禁用全部擴展 打開你的網站。氣泡出現了？就是某個擴展攔的。
對訪客側： 無需處理——攔截與否是訪客自己的選擇，挂件會靜默失敗，絕不影響宿主頁面。
4. 腳本標籤根本沒上頁面
檢查： DevTools → Network → 過濾 chat-widget，應能看到 chat-widget.js 返回 200。
- 完全沒有請求 →
<script>標籤不在最終輸出的 HTML 裡（檢查模板/部署），或被標籤管理器移除了。 - 返回 4xx/5xx → 記下響應內容；403 通常是域名未加入你帳號的白名單。
5. 域名未加白名單
挂件只為你帳號下已登記的域名提供服務。
檢查： Dashboard → Domains —— 頁面所在的完整域名（含子域名）是否在列表裡？
解決： 添加該域名，或把 data-base-url 指向已登記的域名。詳見 挂件屬性。
仍未解決？
收集以下信息，通過 webnav.ai 上的挂件或後台聯繫我們：
- 氣泡本應出現的頁面 URL
- DevTools Console 報錯截圖
- Network 面板中
chat-widget.js請求的截圖
補充說明
data-exclude只控制爬取範圍（AI 學什麼），不會在對應路由上隱藏氣泡。SPA 想在特定頁面隱藏氣泡，請在路由邏輯裡按條件加載腳本。- 挂件渲染在 Shadow DOM 內，樣式互不滲透；若出現視覺異常，通常是宿主頁全局 CSS 在通配選擇器上用了
!important。