🎀 MIBU 常见问题答疑

这个报错信息是 API 服务商（也就是你购买 API 的地方）直接返回的，MIBU 只是把它原样展示给你看。

遇到这种情况怎么办：

1. 登录你购买 API 的中转站后台
2. 检查账户余额是否充足
3. 检查 API Key 是否过期，必要时重新生成
4. 将新的 Key 更新到 MIBU 的 API 设置中

这些都是 服务器端错误，意味着 API 上游服务出了问题。

可能的原因：

• 你的中转站服务器暂时宕机或维护中
• 上游 AI 服务商（如 OpenAI、Claude 等）正在抽风
• 中转站到上游之间的网络链路出了问题

建议：

1. 稍等几分钟后重试
2. 去你的中转站群里问问是不是在维护
3. 如果持续很久，考虑联系中转站客服

生图功能（如 NovelAI）需要 专门的生图 API 额度，和聊天 API 是分开计费的。

常见的生图报错原因：

• 余额不足 → 你的生图额度用完了
• 凭证过期 → 生图 API 的密钥需要更新
• 401/403 → 你的 API 套餐可能不包含生图权限

解决方法：联系你的 API 中转站，确认你的套餐是否包含生图服务，以及生图额度是否充足。

这是一个非常常见的疑问，我们完全理解你的困惑 💕 请耐心看完下面的解释：

每个"小手机"（AI 聊天工具）本身 都不生产 AI 能力，它们都是调用外部 API 来工作的。关键区别在于：

• 你在不同平台填的 API 可能不一样 —— 不同的 Key、不同的中转站、不同的余额
• 有些平台可能自带 API —— 它们用的是平台自己的 API 账户，不是你的
• 同一个 Key 在不同时间状态也不同 —— 也许你用别的平台时还有余额，现在用完了

排查建议：

1. 确认你在 MIBU 里填的 API Key 和在其他平台用的是不是同一个
2. 如果是同一个 Key，检查是否在其他平台把额度用完了
3. 如果是不同的 Key，分别检查各自的余额和有效期
4. 确认 API 地址（URL）填写是否正确

这里涉及到一个 AI 技术限制 的问题，我们来科普一下：

目前所有的 AI 模型都有一个叫 上下文窗口（Context Window） 的限制，简单说就是 AI 一次能"看到"的文字量是有上限的。

• GPT-4o：最大约 128K tokens（大约 8~10 万字）
• Claude：最大约 200K tokens
• 普通模型：通常只有 4K~32K tokens

几千条聊天记录的文字量，很可能已经 远远超过 了 AI 模型的处理上限。

MIBU 的做法：

我们选择把总结的控制权交给你，让你清楚地知道每一次 API 调用。建议不要积攒太多消息再总结，定期总结（比如每 50~100 条）效果会更好，也更省额度。

MIBU 的数据存储在浏览器本地，不是存在云端服务器上的。数据丢失最常见的原因有以下几种：

① 没有"添加到主屏幕"

如果你只是在浏览器里打开网址使用，浏览器会把 MIBU 的数据当作"普通网页缓存"，随时可能被清理掉。

👉 强烈建议：请务必将 MIBU 添加到主屏幕后再使用！

② 手机自动清理 / 管家类软件

很多手机自带"手机管家"、"存储清理"功能，或者安装了第三方清理软件（如猎豹清理、360清理等），它们会自动清除浏览器数据。

1. 关闭手机自带的"自动清理"功能
2. 在清理软件中将浏览器设为"白名单"
3. 手动清理时注意不要勾选浏览器数据

③ 手机存储空间不足

当手机存储快满的时候，系统会自动回收浏览器的存储空间。这是操作系统层面的行为，任何网页应用都无法阻止。

这个问题问得很好，涉及到 MIBU 的双存储架构：

MIBU 使用了两种不同的浏览器存储方式：

预防措施：

1. 一定要"添加到主屏幕"，这样浏览器会申请持久化存储保护
2. 保持手机有充足的可用存储空间
3. 定期导出重要的聊天记录作为备份

这些浏览器虽然轻便好用，但在网页应用数据保护方面和主流浏览器有差异：

• VIA 浏览器：极简设计，对 PWA（网页应用）的持久化存储支持有限
• X 浏览器：同样是轻量级浏览器，部分存储 API 支持不完整
• 夸克浏览器：有自己的缓存清理策略，可能会主动清理网页数据

这些浏览器为了追求"轻量"和"省空间"，对底层的 Web 标准做了裁剪或修改，导致：

• 持久化存储请求（Persistent Storage）可能不被支持或被忽略
• IndexedDB 数据可能被更积极地清理
• "添加到主屏幕"可能不会触发 PWA 安装模式

这两个功能对 AI 的要求不一样，报错原因也不同，分开说：

📮 书信功能报错

书信不需要 AI 返回特殊格式，只要能输出文字就行。书信报错通常是以下原因：

• API 本身有问题（余额、密钥、上游故障），对照上面的错误码排查
• 角色设定 + 历史信件 + 聊天记忆叠加在一起，发送的内容超过了模型的上下文长度限制
• 模型能力较弱，无法理解复杂的角色扮演指令

🏋️ 私教功能报错

私教需要 AI 返回结构化的 JSON 数据来生成你的训练蓝图（阶段目标、训练节点等）。MIBU 已经内置了4种兜底解析策略，模型不需要返回"纯 JSON"，哪怕夹在一堆废话里也能提取。

但如果模型完全没有输出任何 JSON 结构，就真的没办法解析了。这通常发生在：

• 模型能力太弱，不理解"按格式输出"的指令
• 中转站对请求内容做了截断或过滤
• 模型被限制了输出长度，导致 JSON 输出到一半就断了

解决方法：

1. 先多试几次，偶尔模型"发挥失常"，重试就好了
2. 切换到能力更强的模型，如 GPT-4o、Claude 3.5、Gemini 1.5 Pro 等
3. 联系你的中转站，确认套餐内的模型是否支持较长的输出

如果其他用户都正常，只有你点不动，通常是以下原因：

① 浏览器兼容性问题

VIA、X浏览器等第三方浏览器对部分 JavaScript 特性的支持不完整，可能导致某些交互功能失效。这些浏览器为了轻量化，裁剪了一些 Web 标准的实现。

② 手机内存不足导致页面卡死

当手机运行内存（RAM）紧张时，浏览器会限制网页的 JavaScript 执行，导致按钮点击没有反应。

1. 关闭后台不需要的应用，释放运行内存
2. 完全关闭浏览器后重新打开 MIBU
3. 如果经常出现，建议换用 Chrome 或系统自带浏览器

③ 页面加载不完整

网络不稳定时，页面的脚本可能没有完全加载，导致部分功能不可用。

这个报错的意思是：AI 服务商返回了一段 MIBU 无法理解的数据。

正常情况下，API 应该返回标准格式的数据，但有时候会返回乱码或不完整的内容。

常见原因：

• 中转站不稳定 → 数据在传输过程中被截断或损坏
• 上游服务抽风 → AI 服务商返回了非标准的响应
• 手机存储空间不足 → 浏览器没有足够空间缓存响应数据，导致数据不完整
• 网络不稳定 → 数据传输中断，只收到了一半

解决方法：

1. 点击"重试"按钮，大部分情况下重试就好了
2. 检查手机存储空间，确保有足够的可用空间
3. 如果频繁出现，说明你的 API 中转站服务质量不太稳定
4. 尝试切换到其他 AI 模型

不管遇到什么报错，都可以按这个流程走一遍：

1. 看报错信息 —— MIBU 会把 API 返回的原始错误展示出来，仔细阅读报错内容
2. 对照错误码表 —— 翻到本页顶部的速查表，确认是哪一类问题
3. 登录中转站后台 —— 检查余额、Key 状态、套餐权限
4. 检查 MIBU 设置 —— 确认 API 地址、Key、模型名称填写正确
5. 换个模型试试 —— 有时候某个模型暂时不可用，换一个可能就好了
6. 等一等再试 —— 5xx 错误通常是临时的，过几分钟可能就恢复了