故障排查：常见提示及处理办法

扫描与提示追踪

• 「检测超时，请稍后重试」：引擎繁忙。一分钟后打开证据点「立即扫描」。
• 「上次检测中断 · 已完成 n / m 个」：检测中途关了页面。点「继续检测」从中断处续跑。
• 「每日扫描已达上限」：每日频率的提示词太多。把其他的改成每周或每月。
• 行一直「检测中…」：队列在依次处理，结果会自动出现，不用刷新。
• 提示词语言与市场不符：用横幅里的「一键迁移到匹配市场」，让它按正确语言扫描。
• 中国市场的提示词显示「需 Business」：中国市场只在豆包、DeepSeek、Qwen、Kimi 上扫描，专业版不含这些引擎。升级到商业版前这些提示词不会扫描，国际市场不受影响。
• 引擎带锁：不在你的套餐里。
• 覆盖率突然下降：先看工作台有没有「AI 平台整体变化」，或证据里覆盖率走势图上的标记。如果同一天该引擎所有项目都有变化，通常是平台原因，不是你的品牌。

积分与上限

• 「积分不足」：在弹出的窗口里直接充值，或到「API 密钥与额度」→「平台额度」充值、打开自动充值。免费版需要先升级。
• 「积分不足，无法添加提示词」：余额不够新提示词的第一次检测。在窗口里直接充值后再添加，或少加几条。
• 「已达项目上限」：删除不用的项目或升级；企业版和代理在页面上增购项目。
• 「最多 n 个问题可以开启多次采样」：先关掉其他问题的多次采样。

新功能

• 「这个功能还在准备中」（品牌词、覆盖、智能体、增量实验）：这个功能正在为你的账户开通，稍后刷新再试；一天后仍然这样，请联系客服。
• 增量实验显示「数据不足」：实验组或对照组在开始前或开始后不到 10 笔（订单、线索或访问，取决于你选的指标）。等数据积累，或把对比天数调长、把更多页面放进组里。
• 模拟智能体任务失败，显示「第 n 步：…」：智能体卡在那一步，后面写的是挡住它的元素。智能体不执行 JavaScript、不登录、不提交表单，所以只靠脚本渲染的价格、要登录才能看的信息、藏在弹窗里的链接都会让它卡住。把关键信息放进页面的 HTML 里，再点「运行」或等下周一的自动运行。
• 智能体标签显示「付费套餐可用」：持续监测和模拟任务需要付费套餐；一次性检查用免费的 /agent-readiness。
• 品牌词没有错误电话或网址的检查结果：先在品牌词 → 官方信息 填官方域名、客服电话和价格，检查需要拿它们对比。

生成

• 「还没有填写业务信息」：去生产规则填写，否则流水线不会启动。
• 「该项目已有一篇在生成中」：每个项目同时一篇深研；等它完成，或在弹窗里取消。
• 「AI 代理生成需要 3–15 个提示词」：多选（或少选）提示词。
• 「触发限流」「AI 服务当前过载」「已超时」：等一分钟重试；超时的话把话题改短。

发布与集成

• 「未连接 · 直接发布会失败」：去集成页连接该平台；完成后链接会带你回文章。
• 一直「处理中」：扩展平台请在打开的标签页里按发布；自有渠道刷新看错误。
• 某平台「每日上限已到」：该平台今天的额度用完；明天发或换渠道。
• 扩展未检测到 / 版本过旧：安装或更新 Citadex Publisher（Chrome 或 Edge）；日本平台需要 1.2.6，Ameblo 需要 1.3.0。
• GitHub「redirect_uri mismatch」：GitHub OAuth 应用里登记的回调地址和站点地址不一致（常见是 www 与非 www）。改 OAuth 应用，不是改 Citadex。
• 托管博客「域名出错」：DNS 记录缺失或错误；对照抽屉里显示的记录，然后点「检查状态」。
• 「测试失败：…」：检查凭据、权限和站点地址（不带末尾斜杠）。

数据接入与收入归因

• AI 流量一直是空的：还没接入数据。到 AI 流量 → 数据接入 选一种方式；Cloudflare 直接连接每小时同步一次。
• 「只有工作区所有者可以连接」：Google Analytics 只能由所有者授权。
• 收入到账了，却没有归到 AI：先装网站脚本并打开「表单邮箱自动捕获」，收入来源靠邮箱和访客对上。见 收入归因。

登录

• 点 Google 登录没反应：你在应用内浏览器里（LINE、Instagram、TikTok）。用 Chrome 或 Safari 打开链接。
• 每次都被带到新建项目：账号需要先有一个项目，其他页面才会打开。

还是没解决

打开右下角的「AI 助手」描述问题，或点抽屉顶部的「联系客服」；也可以用顶栏的「联系我们」（附截图），写明项目名和你期望发生的事。