miniapp.json 字段 - MiniMax Agent 文档

顶层字段

字段	类型	说明
`schemaVersion`	`1`	固定为 1
`artifacts.client`	`string[]`	必填。页面载荷根目录，非空、不重复，位于 `miniapp/` 下
`artifacts.node`	`string[]`	必填。Node 载荷根目录，可以和 `client` 重叠
`runtime.kind`	`"process"`	固定为 `process`
`runtime.entry`	`string`	Node 入口，`.js` / `.mjs` / `.cjs`，必须在 Node 载荷内
`runtime.lifecycle`	`"on-demand"`	可省略。只支持按需启动；旧的 `background` 按 `on-demand` 处理
`surface.path`	`string`	页面入口路由，以 `/` 开头，不带 origin、query、fragment 和反斜杠
`surface.window`	`object`	可选。弹出成独立窗口时的属性，见下表
`mcpEndpoints`	`{ server, path }[]`	托管 MCP。`server` 必须是 `plugin.json` 已声明的 MCP 服务器；没有就写空数组
`hostConnectorAccess.providers`	`string[]`	允许使用的 Connector provider，小写字母、数字、`_`、`-`，不重复
`agentAccess`	`["session.run"]`	可选。允许运行 Agent 回合；缺失或为空即禁止
`agentConcurrency`	`integer`	可选，1–32，默认 4。同时运行的 Agent 回合数；没有 `agentAccess` 时不生效

surface.window

弹出窗口时应用的属性，是 Electron 窗口参数的白名单子集。每个字段都可选。

字段	默认值	说明
`width` / `height`	弹出前在文件面板里的尺寸	整数，200–10000
`minWidth` / `minHeight`	480 / 360	同时给出时，不能大于对应的 `width` / `height`
`resizable`	`true`	为 `false` 时，运行时也不能改尺寸
`frame`	`true`	为 `false` 时要自己提供拖动区域
`transparent`	`false`	为 `true` 时必须同时声明 `frame: false`
`alwaysOnTop`	`false`	运行时开启置顶的上限
`skipTaskbar`	`false`	不在任务栏显示
`clickThrough`	`false`	鼠标事件穿透到下层窗口，页面仍能收到移动事件；也是运行时开启的上限

不能声明的：和主窗口的关系（总是独立的顶层窗口，显隐不跟随主窗口：主窗口隐藏、最小化或关到托盘都不影响它）、标题（总是 displayName）、屏幕位置，以及打开和关闭行为（窗口只通过文件面板的弹出操作出现，关闭后回到文件面板）。