Skip to main content

​
发布流程

Mini App 不会直接在安装目录里运行。发布时，宿主依次完成：
1

暂存

把包复制到宿主管理的暂存区。依赖目录不随包发布。复制后重新读取清单和文件摘要，和复制前不一致就发布失败。
2

安装

旧版本先移入隔离区，暂存副本原子替换进安装目录，再核对一次摘要。
3

启动

从安装目录再复制一份运行副本，验证身份后启动独立进程。旧进程先停止，新进程就绪后才接管。
安装阶段任何一步失败，旧版本从隔离区移回，安装目录恢复原样。如果旧进程已经停了、新进程又没起来，宿主不会自动拉起旧进程，需要再 open、publish 或 restart 一次；同包的 Skill 和普通 MCP 不受影响。详见更新运行中的 Mini App。

​
查看运行状态

inspect 是只读操作，不会启动或重启服务。主要返回：
  • source：official 或 local，由宿主根据安装记录给出。
  • diagnostics.run：当前或最近一次运行，包括准备、就绪时间和确认过的退出信息。
  • diagnostics.failure：宿主当前报告的失败。
  • diagnostics.logs：宿主记录的启动、就绪、失败和退出记录，有数量上限。
诊断只保存在宿主内存里，宿主重启后清空。缺失的时间、退出码和失败原因按”未知”处理，不要猜。

​
调试页面

先 open 打开页面，再用内置浏览器的 inspect、query 和点击、输入等操作，检查页面结构、文字、控件和状态。生命周期操作（发布、重启、停止）始终通过 miniapp 工具，不要用浏览器操作代替。

​
常见问题

完整列表见错误码速查。