常见问题排查

有什么不按预期工作？在下面找到你的问题。每一条都说明了发生了什么，以及该怎么做。如果这里的内容都帮不上忙，请报告问题：MonstarX 会帮你截取页面，团队就能看到你看到的情况。

我的构建很慢，或者看起来卡住了

一个小改动需要一两分钟；一个全新的应用通常需要几分钟。MonstarX 工作时，聊天中会为每一段工作显示一行实时状态和计时；在有页面可看之前，预览中会显示一张状态卡片，写着 它现在在做什么，例如“正在编写代码… · 7 个文件”。如果这些内容一直在变化，就说明构建正在进行。见跟进构建进度。

你可以：

• 想关掉标签页就关掉。 构建在 MonstarX 上运行，而不是在你的浏览器里。开启通知，完成时就会告诉你。
• 看看队列。 请求是轮流处理的。另一个构建正在进行时发送的构建请求，会在输入框上方的 接下来 下等待，并自动开始。如果显示 队列已停止（例如你点击了 停止 之后），点击 恢复。见队列。
• 模型没有响应时会自动处理。 如果某个模型停止响应，MonstarX 会把工作转给另一个模型，聊天中会显示“… 停止响应，正在使用 … 继续。”
• 等了很久还是没动静？ 点击 停止，然后重新发送请求，或者在模型选择器中换一个模型。

“MonstarX 已执行 … 步，达到单次请求的步骤上限”

一个请求能执行的步骤是有限的。非常大的请求可能在完成之前就达到上限。到目前为止的一切都已保存。点击 继续（如果还有规划好的功能没构建，则点击 继续构建），它就会从停下的地方接着做。见功能计划。

“MonstarX 在处理过程中重启了”

在你的请求处理期间，MonstarX 进行了更新。它会自己从上一步继续，你什么都不用做。如果你看到的是“MonstarX 无法开始此请求”，请重新发送请求。

我的预览空白、休眠或显示错误

1. “预览已休眠”：预览 20 分钟没有使用就会停止，并显示页面的已保存副本。把鼠标移到工作区上，点击副本上的任意位置，或者点击 立即唤醒。几秒钟后就会重新启动。

2. “正在启动预览…”：第一次启动时，会为你的项目准备一台安全的云端计算机，并安装应用需要的东西。可能需要一分钟。

3. “页面未能显示” 或 “正在恢复页面…”：页面此刻是空的或有错误，通常是因为构建正写到一半。代码一恢复正常，MonstarX 就会自动重新加载页面。

4. 还是空白或内容过时？ 点击预览工具栏中的 重新加载预览。如果没用，点击 重启开发服务器（在手机上：••• 菜单 → 重启开发服务器）。

5. “重新加载仍未解决问题”：应用本身有 bug。页面的错误显示在下方。在聊天中提出，例如：“首页是空白的，请修复。”聊天中的修复完成后会自动生效。

如果项目是别人分享给你查看的，你可以 重新加载 预览；如果一直失败，请让所有者重启它。更多内容见预览。

我看到了“页面出现问题”

这个页面表示 MonstarX 无法打开你要求的内容。

1. 点击 重试。

2. 如果还是不行，刷新页面，或者点击 首页 从你的项目重新开始。

3. 仍然失败？检查你的网络连接，然后报告问题。

相关提示及处理方法：

提示	怎么做
“MonstarX 刚刚完成更新。请刷新页面继续。”	点击 刷新。你的标签页打开期间，MonstarX 发布了新版本。
“你工作期间 MonstarX 已更新。请检查请求是否已完成，如未完成，请重试。”	看看聊天。如果你的请求没有完成，请重新发送。
“无法连接 MonstarX。请检查网络连接后重试。”	你的网络断开了。重新连接后再试。
“你的消息超出上限 … 个字符（上限为 100,000 个字符）。请缩短后发送。”	缩短消息。快到上限时，输入框会显示字数。
“你的套餐无法使用此模型。”	在模型选择器中选择 自动 或其他模型。高级模型需要 Plus 或更高套餐。见选择模型。

我用完了用量上限

你会看到“你已用完 … 套餐的 5 小时额度，将于 … 重置。”（或者每周额度）。什么都不会丢失。你可以：

• 等待：点击输入框旁的用量圆环，查看每项上限何时重置。
• 使用 Boost，立即重置所有上限（仅限 Plus 和 Pro）。
• 升级，立即获得更高的上限。
• 高级模型额度用完了？ 从 低成本 或 标准 中选一个模型，继续构建。

有了剩余额度后，让 MonstarX 继续就行。见用量和上限。

我总是被退出登录，或被送回登录页面

从 Stripe、Google 或邮件中的链接回来时，MonstarX 会快速重新检查你的登录状态，页面可能会闪一下。如果你一次又一次地回到登录页面，或者看到“你已退出登录。请重新登录以继续查看此项目。”：

1. 刷新页面。

2. 确认浏览器允许 monstarx.com 使用 Cookie，登录需要它们。严格的隐私设置或广告拦截扩展可能会拦截 Cookie。

3. 从名字下方的菜单退出登录，然后重新登录。

4. 试试无痕窗口或另一个浏览器。如果这样可以，问题就出在某个扩展或浏览器设置上。

忘记密码了？在登录页面点击 忘记密码？。见个人资料和登录。

我的域名还不能用

域名就是你的应用专属的网址，例如 brewandbean.com。它的状态显示在项目 发布 菜单的 域名 下，也显示在设置 → 域名中。

状态	含义	怎么做
注册中	你购买的域名正在注册和设置	等待。通常几分钟内就会生效，有时需要几个小时。
设置中 / 等待 DNS	你自己的域名还没有指向你的应用	在管理你域名 DNS 的服务商那里（域名解析设置），添加 发布 → 域名 中显示的 CNAME 记录。更改生效可能需要一段时间。
正在签发证书	地址已经指向你的应用，正在设置 HTTPS 安全锁	什么都不用做，它会自动生效。
需要处理 / 设置需要处理	有些步骤没有完成	打开应用 → 发布 → 域名，点击 完成设置，或者按显示的步骤操作。

另外请确认应用已经 发布，域名需要有内容可以显示。你自己拥有的根域名（例如 example.com，而不是 www.example.com）必须把 DNS 放在 Cloudflare 上；如果想继续使用现在的 DNS 服务商，请改为连接 www。见连接你已有的域名和购买域名。

我的应用发出的邮件收不到

你的应用会从它在 monstarx.app 上的专属地址发送邮件（注册确认、密码重置、订单收据）。

1. 打开项目的 后端›邮件。这里列出了应用发送的每一封邮件，以及它的 状态。

2. 列表里没有？ 说明应用没有发送这封邮件。在聊天中提出，例如：“有人下单时发送确认邮件。”

3. 未送达 · 测试地址？ 像 someone@example.com 这样的地址永远收不到邮件，所以会被特意跳过。请用你自己真实的邮箱测试。

4. 失败？ 旁边会显示原因。如果应用达到了每小时或每天的邮件上限（显示在列表顶部），请等一等再试。

5. 显示 已发送 但没收到？请对方检查 垃圾邮件 或 推广邮件 文件夹。

见应用中的邮件。

QA 一直失败

自动 QA 会在真实的浏览器中测试你的应用。测试失败时，QA 会在聊天中解释出了什么问题。

• 默认情况下，QA 只报告。 选择 修复此问题（或 修复这 … 个问题），让 MonstarX 修改应用并重新测试；或者选择 稍后，暂时不管。
• 自动修复（在 QA 设置中）会自己修复并重新测试，但会消耗更多额度。
• “请自行检查此项”：QA 无法测试某个步骤。打开预览，按显示的步骤操作，然后在聊天中说说你看到了什么。
• “… 未连接，因此未测试该步骤”：应用需要某个还没连接的服务，例如 Stripe。点击 QA 卡片上的 连接 …，添加它的密钥，然后再次运行 QA（见连接器）。
• “QA 因重启而中断”：打开顶部栏中的 QA，点击 立即运行 QA。
• “无法启动 QA”：QA 也会消耗你套餐的用量。如果你已经用完了上限，请看我用完了用量上限。

见 QA 测试。

某次修改弄坏了我的应用，怎么撤销？

每次构建修改应用代码时，MonstarX 都会保存一个 版本，所以你随时可以回退。

1. 在你的项目中，点击顶部栏中的 版本。

2. 找到修改之前的那个版本：每个版本都会显示保存时间和文件数量。

3. 点击 恢复 并确认。

恢复会把应用的 代码 替换成那个版本。应用的 数据（用户、订单、帖子）不会改变，而且这次恢复本身也会保存为一个新版本，所以你也可以撤销它。你也可以在聊天中说明出了什么问题：“撤销上一次对菜单页面的修改。”见版本。

收不到通知

在 设置›通知 中为每台设备开启通知，然后点击 发送测试通知。在 iPhone 和 iPad 上，请先把 MonstarX 添加到主屏幕（共享 → 添加到主屏幕），再从那里打开。见通知。

常见问题

为什么我的 MonstarX 构建要这么久？

一个全新的应用通常需要几分钟。聊天和状态卡片会显示它现在在做什么；只要内容一直在变化，就说明它在工作。你可以关掉标签页（它会继续构建），并开启通知，完成时就会告诉你。

为什么我的预览是空白的？

通常是预览休眠了（把鼠标移上去或点击 立即唤醒），或者构建正写到一半（它会自动重新加载）。否则，先点击 重新加载预览，再点击 重启开发服务器，或者在聊天中让它修复页面。

如何撤销修改？

点击项目顶部栏中的 版本，找到修改之前的版本，点击 恢复。应用的数据不受影响。

失败的构建会消耗我的额度吗？

会，按停止前完成的 AI 工作计算。这些工作已经保存，所以继续时不会重做。

这里的内容都帮不上忙，该联系谁？

在“问问 Luna”中报告问题（附上截图报告问题），或者从名字下方的菜单进入 支持 创建工单。见报告问题。

相关内容

报告问题发送附截图的问题报告，或创建工单。

用量和上限用完上限后会怎样。

版本回到应用之前的任意版本。

预览实时预览如何运行、休眠和重启。