AI 报错

弹「AI 插件需要升级」

最常见的一种,而且不是故障:免费版没有任何 AI 功能。问一问AI、面板里的 AI 建议、AI 生成公式、图片转表格、AI 与网络函数全部走 /api/next/ai/* 与 /api/next/beta/ai/*,免费版调用一律被后端挡下(HTTP 402),界面弹出:

AI 插件需要升级 —— Google Search、AI.Generate、Web.Crawl 等 AI 增强功能需要付费版。

处理:激活付费版,再配自己的 API Key。两个条件缺一不可。

提示需要配置 Key / 入口是灰的

没有配置 API Key。桌面版设置 → AI,粘贴 Key,保存,等引擎重启。见配置你自己的 API Key。

认证失败(401 / invalid api key)

• Key 复制不完整,前后带了空格或引号。重新粘。
• Key 属于另一家供应商,而接口地址是 OpenAI(或反过来)。Key 和地址要配套。
• Key 在供应商后台被删或过期。去供应商那里重新生成。

连不上 / 超时

• 接口地址写错:要完整 URL,通常以 /chat/completions 结尾;留空只对 OpenAI 官方有效。
• 网络到不了供应商。国内直连境外服务经常不通,用可达的兼容服务,或按你的网络环境处理。
• 供应商临时故障。过一会儿再试。

模型不存在(404 model not found)

「模型」里填的名字供应商不认。留空用默认,或到供应商文档里抄准确的模型名。

余额不足 / 限流(402 / 429)

供应商账户没钱了,或调用太密。充值,或降低频率——AI 函数按行调用,大表一次触发几千次,先在小表上试。

返回是空的或明显胡说

• 图片转表格:图片模糊、倾斜、手写。拍正、提高清晰度。
• AI 建议找不到方案:表头没有可读的列名(全是「未命名」),先改列名。
• 网络函数抓不到:目标网站禁止抓取或需要登录。

窗口角上显示 Credit: -1

0.0.9 之前的桌面版有 bug:内部用 -1 表示「不限额度」,而额度模型里没有「不限」这个概念,于是 -1 被当成一个真实的负余额,每一次 AI 请求都被判成超额,窗口角上还显示 Credit: -1。已在 0.0.9 修掉,升级到当前版本(桌面版设置 → 关于 → 检查更新)即可,当前版本没有额度概念。详见更新日志。

如果你看到的是「无可用积分」或「该功能在当前套餐不可用」,那是团队版的套餐限制,不是这个 bug。

还是不行

桌面版设置 → 隐私与诊断打开错误上报,复现一次;或把日志(位置见怎么反馈问题)发给我们。日志不含你的 Key。