### 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 ```shell Mini App publication preparation failed (host runtime 的 PluginSystemError,code = MINIAPP_PREPARATION_FAILED;reasonCode 未被透出) ``` ### Screenshots _No response_ ### Before submitting - [x] I have searched existing issues. - [x] I have included my version and removed sensitive information.
Activity
Fectivnfy112357 commentedon Nov 20, 2026
补充验证 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,等待该诊断缺口及双客户端场景验证。
Fectivnfy112357 commentedon Nov 20, 2026
诊断链路已在 PR #53 单独提交。修前 dispatcher 回归用例因缺失 reasonCode 失败,修后 wire envelope、客户端 transport 和 Mini App 状态三组共 74 项通过。服务端记录经校验的准备原因,客户端保留该原因,并将包装后的 OWNED_ELSEWHERE 交给已有跨客户端占用提示。PR #47 仍负责错误态和重试。原 macOS Desktop + WebUI 同时打开 MiniMax Bot,以及群聊 @ 接力的实机结果仍待验证,因此本 issue 保持开放。
Fectivnfy112357 commentedon Nov 20, 2026
PR #53 增加了真实宿主的所有权回归。隔离测试用真实所有权锁模拟 Desktop 持有本地 Mini App,WebUI 通过真实 loopback 请求打开。修前返回 MINIAPP_PREPARATION_FAILED 但缺少 reasonCode;修后返回同一主错误码及 OWNED_ELSEWHERE。释放锁后再次打开成功,真实子进程启动并通过 WebUI 代理返回页面。相关 81 项测试通过。Desktop 在本次测试中是持锁夹具,原 macOS Desktop + MiniMax Bot 和群聊 @ 接力仍需实机确认。
Fectivnfy112357 commentedon Nov 20, 2026
已在独立工作树同时应用 PR #47 与 PR #53 的改动,两者涉及同一所有权用例的断言,验证时保留了包装错误识别及持久失败态两个要求。合并后的工作树通过 67 项单元和真实宿主集成测试。构建出的客户端在 Chromium 中通过 6 项独立 Mini App 页面用例,其中直接注入 MINIAPP_PREPARATION_FAILED + reasonCode: OWNED_ELSEWHERE,验证跨端关闭提示、关闭 toast 后仍保留错误态、以及明确重试恢复 iframe。浏览器错误使用夹具注入,未在 macOS Desktop + MiniMax Bot 账号环境中验证。