故障排除

助手按钮未出现

您已添加代码片段，但在文本区域旁未看到助手按钮。

可能的解决方案：

• 清除浏览器缓存： 强制刷新页面（Windows/Linux 上按 Ctrl+Shift+R，Mac 上按 Cmd+Shift+R），以确保加载最新的脚本版本。
• 检查脚本是否已加载： 打开浏览器开发者工具（F12），进入控制台选项卡，查看是否有 JavaScript 错误。确保脚本加载时没有错误。
• 验证代码片段的位置： 确保脚本标签位于 <head> 部分，而不是在 <body>. 脚本应在页面内容之前加载。
• 检查文本区域： 助手仅出现在 <textarea> 和 <input type="text"> 元素旁。确保这些元素存在于您的页面上。
• 验证选择器： 仔细检查您的 CSS 选择器是否正确，并且目标是页面上的实际文本区域元素。
• 禁用广告拦截器： 某些广告拦截器或隐私扩展可能会干扰助手脚本。请在隐身/私密窗口中测试。

内容安全策略 (CSP) 错误

您的浏览器控制台显示 CSP 违规，阻止了脚本加载。

Content-Security-Policy: script-src 'self' https://ai-anywhere.ai;

如果在 HTML 中使用元标签：

<meta http-equiv="Content-Security-Policy" 
      content="script-src 'self' https://ai-anywhere.ai;">

助手按钮无响应

助手按钮出现，但点击时没有反应。

可能的解决方案：

• 检查浏览器控制台： 打开开发者工具（F12），查找可能指示身份验证或网络问题的错误消息。
• 检查网络请求： 在开发者工具的网络选项卡中，验证对 AI Anywhere 的 API 请求是否成功（状态 200）且未被阻止。
• 使用不同的浏览器测试： 通过在 Chrome、Firefox 或 Safari 中测试，排除特定浏览器的问题。
• 禁用浏览器扩展： 某些扩展可能会干扰 JavaScript 的执行。请在禁用扩展的情况下进行测试。

出现多个助手按钮

您会在同一文本区域旁看到重复的助手按钮。

解决方案：

• 检查重复的代码片段： 搜索您的 HTML/模板以确保脚本标签仅出现一次。 <head> 部分。
• React/Vue/Angular： 确保脚本仅加载一次，使用 useEffect （React）或挂载钩子，并添加保护以防止重新加载。
• 使用加载保护： 在添加脚本之前检查其是否已存在：
  if (!document.querySelector('script[src*="ai-anywhere.ai"]')) { // Add script here }

性能或加载问题

助手脚本正在减慢您的页面加载速度或导致性能问题。

解决方案：

• 使用异步加载： 添加 async 属性添加到脚本标签（尽管我们的脚本已经是异步加载的）。
• 推迟脚本加载： 如果您的页面有很多脚本，请考虑使用 defer 属性在页面解析后加载助手脚本。
• 检查网络时间： 使用浏览器开发者工具的网络选项卡查看脚本下载是否异常缓慢。
• 优化您的页面： 助手脚本很轻（约 50KB），但如果您的页面已经很慢，请先优化其他资源。

样式冲突

助手按钮与您网站的设计不匹配或与您的 CSS 冲突。

解决方案：

• 使用 CSS 覆盖： 使用更具体的选择器或 !important 以覆盖助手样式：
  .ai-helper-button { background-color: #your-color !important; border-radius: 8px !important; }
• 使用主题自定义： 在您的助手设置中配置按钮颜色和样式以匹配您的品牌。
• 检查 CSS 特异性： 确保您的自定义样式具有比助手默认样式更高的CSS特异性。

浏览器兼容性问题

助手在某些浏览器中工作，但在其他浏览器中不工作。

如果问题仍然存在：

• 更新您的浏览器： 确保您使用的是浏览器的最新版本。
• 检查 JavaScript 是否已启用： 在浏览器设置中验证 JavaScript 是否已启用。
• 在隐身模式下测试： 通过在隐身模式下测试排除扩展冲突。