疑难排查

每条都对应产品里真实会出现的提示。找不到你遇到的情况，说明它可能是个 bug，欢迎反馈。

上传报表

某个文件被跳过了

先看页面上给出的原因，几种常见情况：

• 同名文件已导入过。 默认跳过重复文件。确实要重新导入（比如你重新导出了修正版），用强制导入。
• 文件里找不到数据日期。 日期只从报表内容的「筛选条件 → 时间范围」或行级日期取，不拿文件下载时间当数据日期——那两个经常差好几天。请重新导出时保留完整的表头和元数据行。
• 多日聚合的报表。 数据层按天存储，窗口由系统自己算。多日聚合的产品 ASIN 视图会进校正层；其他多日聚合暂不入库，会显式提示，不会静默丢掉。

库存或成本报表带了一条日期警告

这类是快照报表，内容里通常没有时间范围。系统会回退到文件名里的导出日期，并附一条明确的警告。这是有意为之：宁可让你看见这个回退，也不静默假装它有准确日期。

一批文件里有几个失败了

失败的文件不影响其他文件，页面会逐项列出失败原因。修好那几个重新传即可，已成功的不用重来。

传完发现数据不对，重新导出了正确版本

直接重传。一个文件对它覆盖的日期是完全权威的：导入会先清掉那些日期的旧数据行，所以修正版里不再出现的实体会跟着被移除，不会留下上一版的残影。

运行诊断

提示未配置 API Key

诊断走你自己的 AI 服务账号。在设置页填入 OpenRouter API Key。账号在你手上，费用直接付给服务商。

OpenRouter 余额不足（402）

到 openrouter.ai/credits 充值，或在设置页换一个更便宜的模型——设置页的模型列表里有几个量大便宜的选项。

OpenRouter 认证失败（401 / 403）

API Key 无效或没有对应权限，到设置页检查 Key 是否填错、是否已过期。

提示输出被截断

模型的输出上限不够。全账户诊断需要输出完整的分层判断，字数很多——换一个支持长输出的模型。这个错误不会自动重试，因为重试只会再截断一次。设置页列出的模型都满足输出上限要求；自己填的模型请确认它的输出上限。

诊断跑了一半停了 / 某几个 ASIN 没结果

限流、服务端错误和网络中断会自动退避重试。重试仍失败的单个 ASIN 只记一条警告，不影响其他 ASIN——重新点一次开始分析即可补上，已完成的部分不会重跑。

诊断很慢

全账户诊断默认并发执行，一个账户通常需要几分钟到十几分钟，取决于 ASIN 数量和模型速度。这一步在调用外部 AI 服务，慢的主要是等待响应。

想回看上次的诊断结果

历史记录里点查看即可重新打开那次结果，不重新调用 AI，也就不花钱。

安装与启动

macOS 提示无法打开应用

Beta 阶段的安装包是 ad-hoc 签名，首次打开会被 Gatekeeper 拦截。在应用图标上右键 → 打开，确认一次即可。正式签名与公证在路线图里。

打开后看不到任何数据

先确认已经导入过报表。数据全部存在本机，换电脑或清空数据目录后需要重新导入。

复盘

复盘显示「操作后暂无新报表数据」

记录的操作日期之后还没有新报表进来。追加日报表后前后对比会自动出现。

复盘不判断「攒够了没有」——它把操作后已有几天数据摆出来，够不够下判断由你决定。所以你不会看到「观察期不足」这类提示，也不会看到「这次调整有效/无效」的结论：那是你的判断，不是它的。

暂停了某个投放，复盘显示后段是 0

多半是暂停生效了——对象在暂停后从报表里消失，按 0 计入正是它该有的样子。

但要注意：后段是 0 还有另一个原因，两者在界面上长得一模一样——如果在平台上改了名字，前后就对不上，后段同样会是 0。分辨方法是去平台确认这个对象还在不在、名字有没有变过。

复盘找不到某个对象

跨期比对靠实体标识对齐同一个对象。如果在平台上改了广告活动名、广告组名或匹配方式，前后就对不上了。改名会打断跨期追踪，这是平台数据的固有限制。