Skip to content

[Bug]: WebUI 无法打开“正在其他客户端运行”的 Mini App:Mini App publication preparation failed(连带 MiniMax Bot 群聊 @ 点名接力不可用) #42

Open

Description

@leonLIu111

Product or interface

Desktop app

Version

WebUI 0.1.8(npm 包 @minimax-webui/minimax-code,启动命令 mcode-webui,默认 http://127.0.0.1:2233/)/ MiniMax Code 桌面端同时在运行,与 WebUI 共用同一 ~/.minimax 数据目录

Platform

macOS

OS version and architecture

macOS 26.5.1 (25.80) arm64 / Node v25.9.0 / npm 11.12.1

Issue area

Startup / install / update

Desktop log upload ID (optional)

No response

Steps to reproduce

  1. 保持桌面端运行,并且桌面端的「应用」里已经打开过 MiniMax Bot(该 Mini App 处于运行中)。
  2. 终端执行 mcode-webui,浏览器打开 http://127.0.0.1:2233/。
  3. 左侧「应用」→ 找到 MiniMax Bot → 点「打开」。

对照实验(同一环境、同一 WebUI 实例):

Mini App 应用面板状态 结果
磁盘透视 / 自驾规划 / 文本编辑器 已停止 ✅ 正常启动,页面显示「运行中」
MiniMax Bot 其他客户端运行中 ❌ Mini App publication preparation failed

复现稳定:2/2 成功触发。

Expected and actual behavior

期望:Mini App 界面渲染出来,可以正常在群里聊天。

实际:

  • 立刻弹出错误 toast:Mini App publication preparation failed
  • 新标签页停在 /miniapp?token=<token>&plugin=minimax-bot,只显示「正在启动 MiniMax Bot…」,随后正文为空 —— 白屏,Mini App 永远不渲染
  • 控制台只有一条 [WEBUI-STALL-DIAG] boot 的 info,之后再无任何活动;没有失败的网络请求,也没有任何重试入口
  • 只有「已经在别的客户端里跑着」的 Mini App 会挂;没在别处运行过的 Mini App 在 WebUI 里都能正常打开

宿主观:Mini App 本身没坏
同一个 minimax-bot 在桌面端打开完全正常(http://127.0.0.1:58925/bot),界面、群聊、@ 点名接力都工作。所以问题出在 WebUI 侧的「发布准备」(publication preparation)这一步,不是 Mini App 自身的问题。

定位到的信息

  • 报错文案来自 host runtime 抛出的 PluginSystemError:code = MINIAPP_PREPARATION_FAILED,message = "Mini App publication preparation failed"
  • 产生位置在 server/runtime.js:
    • normalizeMiniAppPreparationError() / normalizeSupervisedPreparationError():把内部错误包装成 MINIAPP_PREPARATION_FAILED
    • publicationError(code):抛 DISPOSED 等发布边界错误
    • isPublicationBoundaryError():SCOPE_CHANGED / DISPOSED / PUBLICATION_SUPERSEDED 不会被包装成这条通用文案
  • 这两个包装函数都会附带 reasonCode(ownerClassifiedReasonCode / supervisedPreparationReasonCode),但 WebUI 只把 message 透出,reasonCode 既没进前端 toast,也没进服务端日志 —— 用户和维护者都看不到真正原因
  • WebUI 启动日志里也没有对应的错误行,只有 [mcode-webui] Mini App port: 49152 — forward it, or a Mini App loads blank
  • 不是端口冲突:49152 由 WebUI 进程自己占用,桌面端的 Mini App 用的是 58925

影响

  1. Mini App 在 WebUI 里完全打不开:白屏 + 一句没有信息量的报错 + 没有重试入口
  2. MiniMax Bot 的 @ 点名接力随之不可用:该功能在 Mini App 的群聊界面里(界面原文:"群聊已创建。管理员 Chief 默认接话;用 @名字 可以直接点名某个 Bot")。Mini App 打不开,@ 接力自然也用不了

补充:WebUI 输入框自带的 @ 提及是正常的
为排除混淆,在同一个 WebUI 实例里测了输入框的 @:

  • 首页输入框和会话内输入框输入 @ 都会弹出 .webui-composer-mention-menu(分节:插件 / 本地资源,51 行)
  • 方向键可以移动高亮项,Enter 能真正插入(输入框值变为 @browser-use )

所以"@ 出不来"指的是 Mini App 内部的 @ 点名接力,而不是 WebUI 输入框的 @ 提及。

期望的处理

  1. 报错可诊断:把 reasonCode 透传到前端 toast 和服务端日志,至少能区分「已被其他客户端占用」和「真的准备失败」两种情况
  2. 跨端占用时给出可执行提示:例如"该 Mini App 正在桌面端运行,请先在桌面端关闭",或提供「在本端接管 / 强制打开」的操作入口
  3. 失败时不要白屏:准备失败应保留可读的错误态 + 重试按钮,而不是停在「正在启动…」然后正文变空
  4. (可选) 应用面板既然已经知道状态是「其他客户端运行中」,可以据此对该入口做禁用或前置提示

Redacted error summary

Mini App publication preparation failed
(host runtime 的 PluginSystemError,code = MINIAPP_PREPARATION_FAILED;reasonCode 未被透出)

Screenshots

No response

Before submitting

  • I have searched existing issues.
  • I have included my version and removed sensitive information.

Activity

  1. Fectivnfy112357 commented on Nov 20, 2026

    @Fectivnfy112357
    Contributor

    补充验证 PR #47 的覆盖范围。该 PR 的浏览器步骤在三个平台均成功,已逐条确认 Linux 和 macOS 日志中的 MINIAPP_PREPARATION_FAILED、OWNED_ELSEWHERE 两条独立标签页用例通过,覆盖保留失败提示和显式重试。PR 总状态中的单元测试失败涉及依赖路径清单、Markdown 文件图标和设计 token 数量等断言。

    在当前代码上,用真实的 runtime 错误归一化函数和 WebUI dispatcher 做了定向复现。注入 OWNED_ELSEWHERE 后,runtime 生成 code: MINIAPP_PREPARATION_FAILED、reasonCode: OWNED_ELSEWHERE;浏览器收到的错误帧保留了通用 code/message,未携带 reasonCode。另跑了 runtime ownership、supervisor diagnostics、WebUI 状态和界面四组定向测试,70 项通过。

    这确认了 WebUI 的诊断信息丢失点。它还不能确定原报告里 macOS Desktop 和 WebUI 同时启动 MiniMax Bot 时的真实 reasonCode,也没有验证群聊 @ 点名接力。保留本 issue,等待该诊断缺口及双客户端场景验证。

  2. Fectivnfy112357 commented on Nov 20, 2026

    @Fectivnfy112357
    Contributor

    诊断链路已在 PR #53 单独提交。修前 dispatcher 回归用例因缺失 reasonCode 失败,修后 wire envelope、客户端 transport 和 Mini App 状态三组共 74 项通过。服务端记录经校验的准备原因,客户端保留该原因,并将包装后的 OWNED_ELSEWHERE 交给已有跨客户端占用提示。PR #47 仍负责错误态和重试。原 macOS Desktop + WebUI 同时打开 MiniMax Bot,以及群聊 @ 接力的实机结果仍待验证,因此本 issue 保持开放。

  3. Fectivnfy112357 commented on Nov 20, 2026

    @Fectivnfy112357
    Contributor

    PR #53 增加了真实宿主的所有权回归。隔离测试用真实所有权锁模拟 Desktop 持有本地 Mini App,WebUI 通过真实 loopback 请求打开。修前返回 MINIAPP_PREPARATION_FAILED 但缺少 reasonCode;修后返回同一主错误码及 OWNED_ELSEWHERE。释放锁后再次打开成功,真实子进程启动并通过 WebUI 代理返回页面。相关 81 项测试通过。Desktop 在本次测试中是持锁夹具,原 macOS Desktop + MiniMax Bot 和群聊 @ 接力仍需实机确认。

  4. Fectivnfy112357 commented on Nov 20, 2026

    @Fectivnfy112357
    Contributor

    已在独立工作树同时应用 PR #47 与 PR #53 的改动,两者涉及同一所有权用例的断言,验证时保留了包装错误识别及持久失败态两个要求。合并后的工作树通过 67 项单元和真实宿主集成测试。构建出的客户端在 Chromium 中通过 6 项独立 Mini App 页面用例,其中直接注入 MINIAPP_PREPARATION_FAILED + reasonCode: OWNED_ELSEWHERE,验证跨端关闭提示、关闭 toast 后仍保留错误态、以及明确重试恢复 iframe。浏览器错误使用夹具注入,未在 macOS Desktop + MiniMax Bot 账号环境中验证。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions