Widget 属性
通过 <script> 标签的 data-* 属性配置 Widget 行为。
属性列表
| 属性 | 必填 | 说明 | 默认值 | 示例 |
|---|---|---|---|---|
data-server | 否 | 后端服务地址 | 同域 | https://widget.webnav.ai |
data-base-url | 否 | 网站 URL，支持逗号分隔多个（第一个为主域名） | window.location.origin | https://a.com,https://b.com |
data-theme | 否 | 初始主题 | light | dark |
data-lang | 否 | 强制语言 | 自动检测 | zh / en / ja / ko |
data-logo | 否 | 自定义 Logo URL | 网站 favicon | https://yoursite.com/logo.png |
data-mode | 否 | 全屏模式（移动端 WebView） | 正常 | fullscreen |
data-exclude | 否 | 不显示客服的路由 | 无 | /admin/*,/login |
主题优先级
data-theme 属性 > localStorage 用户选择 > 默认 light语言检测优先级
data-lang 属性 > <html lang> > navigator.language > 默认 en多域名抓取
data-base-url 支持逗号分隔多个 URL，AI 会同时学习所有配置域名的内容：
html
<script
src="https://widget.webnav.ai/widget/chat-widget.js"
data-base-url="https://yoursite.com,https://blog.yoursite.com,https://help.another.com"
></script>- 第一个 URL 的域名作为主域名（用于缓存目录名和白名单校验）
- 每个域名会自动推导并抓取其
docs.子域名 - 所有内容合并到同一个缓存中，AI 可以跨域名回答
自动 docs 子域名发现
配置 https://example.com 时，系统会自动抓取：
https://example.com— 主站https://docs.example.com— 文档站（自动推导）
无需手动配置，开箱即用。
路由排除规则
- 精确匹配：
/login匹配/login和/login/ - 通配符：
/admin/*匹配/admin/下所有路径 - 多个用逗号分隔：
/admin/*,/login,/checkout/*