常见问题
Widget 不显示
- 检查 AI 模型配置 —— 在 控制台 → 模型配置 完成配置并通过验证前，widget 不会显示（见下条）
- 确认
<script>标签是否正确添加在</body>前 - 检查浏览器控制台是否有错误
- 如果用了
data-exclude，检查当前路由是否被排除
为什么需要自备模型 API Key？
Webnav.ai 的 AI 对话运行在你自己提供的模型上（BYOK）。在 控制台 → 模型配置 可以接入：
- OpenAI 兼容端点 —— OpenAI、DeepSeek、通义千问、Moonshot、OpenRouter、自建 vLLM 等
- Anthropic Claude（原生 API）
- Google Gemini（原生 API）
你的 Key 使用 AES-256-GCM 加密存储，仅用于调用你指定的模型服务。保存时会执行连通性测试，测试通过后 widget 才会在你的网站上显示。若所选模型不支持工具调用，基础问答仍可用，但 AI Actions（下单/查物流/退款）会自动停用。
聊天窗可以在访客进站时自动打开吗？
可以——Pro 及以上套餐在 控制台 → 设置 中开启「欢迎消息」即可。访客进站 3 秒后聊天窗自动展开（每次来访一次，仅桌面端），显示你配置的欢迎文本和可选图片（如客服二维码）。详见配置文档的「欢迎消息」章节。
首次加载为什么要等一会？
首次使用时 AI 需要学习你的网站内容（通常 1-2 分钟），Widget 会显示学习进度。之后都从缓存读取，秒开。
会影响我的网站性能吗？
不会。Widget 使用 Shadow DOM 完全隔离，不会影响你的页面样式和性能。脚本异步加载，不阻塞页面渲染。
AI 回答不准确怎么办？
AI 的回答质量取决于网站内容的丰富程度。确保你的网站内容清晰、完整，AI 就能给出更好的回答。
支持哪些浏览器？
所有现代浏览器：Chrome、Firefox、Safari、Edge。不支持 IE。
对话数据安全吗？
- Widget 代码完全开源，可审计
- Shadow DOM 隔离，Widget 无法访问你的页面数据
- 对话历史只存在用户浏览器，服务器不保存
- 没有第三方追踪脚本
详见 安全机制。
如何更新 AI 学习的内容？
网站内容更新后，联系我们清除缓存即可触发 AI 重新学习。
如何联系我们？
- 邮箱：taiyisave@gmail.com
- 官网：www.webnav.ai