设置
osano.js 的文件,并填入以下内容。Mintlify 会自动在每个页面上包含内容目录中的任何 .js 文件。
OSANO_SCRIPT_URL 替换为你的 Osano 脚本 URL。你的脚本 URL 是 Osano 生成的代码片段中 src 的值。你的脚本 URL 始终以 https://cmp.osano.com/ 开头,并以 /osano.js 结尾。
Mintlify 会自动在你站点的每个页面上包含内容目录中的任何 .js 文件。你无需在 docs.json 中注册 osano.js。详情请参见自定义 JavaScript。
部署后,在隐私或无痕窗口中打开你的站点,确认 Osano 同意横幅是否出现。如果没有出现,请检查浏览器控制台是否有加载 osano.js 的错误,并确认脚本 URL 与 Osano 控制台中的一致。
故障排查
在 Strict 合规模式下页面无法加载
在 Strict 合规模式下页面无法加载
如果在使用 Osano 的 Strict 合规模式时文档页面无法正常加载,你需要将 Mintlify 的 domain 加入允许列表,以允许图片和其他资源加载。
1
前往 Managed Rules
在 Osano 控制台中,进入 Scripts → Managed Rules。
2
添加 Mintlify domain
将 
.mintlify.site/ 添加为一条 managed rule。
这可确保所有由 Mintlify 提供的资产 (包括图片、样式表和其他文档资源) 被视为必要内容,即使 Osano 阻止未分类的第三方内容时也会加载。