Skip to main content
没有标注状态的功能都已在正式版可用。「实验性」已经可用,但接口形状可能调整,使用前做特性检测;「即将发布」即将随后续版本提供,接口以发布版本为准;「规划中」还没有提供。完整状态见能力与进展。

能做出什么

  • 专业工作台:把散落在多个平台的资料集中到一个页面,人和 Agent 在同一份数据上推进工作,比如官方的股市 Mini App。
  • 数据看板与监控:Token 用量、Git 提交历史、会话轨迹这类需要筛选、图表和实时刷新的页面。
  • 连接业务系统:接上 Notion、Jira 等已授权的应用,在页面里增删改,改动同步回原系统。
  • 规划与生成:把地图、搜索、图片生成等能力串成一个流程,比如自驾规划。
  • 和 Agent 一起干活:页面整理好上下文交给 Agent,或者直接发起 Agent 会话,在页面里批准和回答。
  • 小工具和小游戏:番茄钟、笔记板、占卜,任何你想放在手边的东西。

界面与窗口

完整网页界面

HTML、CSS、JavaScript,可以用任何前端框架和图表库,表格、拖拽、实时刷新都能做。

在会话侧栏打开

从面板「+」、对话里 @ 或让 Agent 打开,页面出现在当前会话的右侧面板。

打开指定页面

open 带 path,直接打开插件内的某个地址,比如某条记录的详情页。

弹出独立窗口

页面可以从文件面板弹出成独立窗口,位置会被记住;manifest 声明尺寸、置顶、透明和鼠标穿透,适合做悬浮小组件。

窗口句柄

实验性 页面读取和调整自己的弹出窗口:切换模式、改位置和尺寸、置顶、穿透。

后端与数据

Node 后端服务

导出 start(context) 就行,宿主分配端口、负责启停;可以用 SSE 或 WebSocket 做实时推送。

任意语言的后端

Node 入口可以拉起 Python、Go 等服务,再从分配的端口反向代理过去。

持久化数据

宿主为每个插件隔离一个 dataDir,服务重启和插件更新后数据都还在。

用户已授权的应用

Host Connector 用你在 MiniMax Code 里授权的账号调用 Notion 等应用,插件自己不保存凭证。

CLI、HTTP API、SDK、本地文件

Node 服务可以直接调用本机命令行工具、第三方 API 或用户授权的文件。

统一工具入口

即将发布 context.tool 用同一个写法列出和调用宿主已挂载的 MCP 工具和 Connector,按你给 Agent 设的权限规则判定。

与 Agent 协作

Agent 调用 Mini App 的工具

托管 MCP:Node 服务把业务能力暴露成工具,页面和 Agent 操作的是同一份数据。

交给输入框

页面把整理好的内容放进当前会话的输入框,你确认、修改后自己发送。

从页面发起 Agent 会话

页面让 Agent 跑一个回合,流式显示回复,在页面里渲染工具审批和问卷。

在后台运行 Agent

Node 服务用 context.agent 处理任务、写回业务数据;可以设并发上限,超出的调用排队等待。

交给聊天侧栏

open(sessionId) 把 Mini App 的 Agent 会话显示在聊天侧栏,你在那里看过程、审批和回答。

选择模型和 agent

列出你能用的模型和你配置的 agent,为会话切换模型,或以指定的 agent 新建会话。

会话

Mini App 的服务按插件共享,页面按会话分开,完整规则见 Mini App 与会话。

引用即启动

输入框里一出现 Mini App 引用,后台就开始启动;页面打开成功后才展开侧栏。

多个会话共用一个服务

每个会话有自己的页面,背后是同一个服务、同一份数据。

重复打开保留页面

同一会话里再次 @ 或打开,复用原标签,保留当前路由和状态。

会话列表标识

左侧会话列表标出当前打开了 Mini App 的会话。

只在本地会话运行

云端、SSH、Remote Control 会话不会启动或打开本机的 Mini App。

登录变化后继续可用

刷新登录凭据不影响运行中的 Mini App;退出后用同一账号登录回来,重新获取工具即可继续。

构建与分发

一句话创建

用 /miniapp-creator,Agent 验证数据、写页面和后端、发布并打开。

自动截图验收

Agent 用内置浏览器检查页面结构、文字和交互,汇报通过和未验证的部分。

安装现成的包

把 Mini App 目录或 ZIP 交给 Agent,检查后直接发布,不执行包里的说明、不装依赖。

插件市场

官方 Mini App 走插件市场的安装、更新和卸载;官方包不能在本地修改。

开源社区

通过 Pull Request 分享到 MiniMax-Code-MiniApps,团队定期甄选上架。

同包携带其他能力

同一个包里的 Skill、普通 MCP、App 照常工作,不依赖 Mini App 是否在运行。

运行与管理

按需启动

启用插件不会启动服务;同时最多运行 3 个不同的 Mini App 服务。

可回滚的发布

暂存、安装、启动分步完成,安装失败自动恢复旧版本。

状态与诊断

inspect 查看来源、运行状态和最近一次运行的诊断,不会启动服务。

停止与重启

停止只停服务,插件和同包能力保留;失败状态下工具栏直接提供重新启动。

启动失败可追溯

启动失败会写入运行日志,并在你提交反馈时一起打包,方便定位问题。

定时自动处理

规划中 按计划更新数据或执行重复工作。

权限面板

即将发布 在插件详情里逐项开关 Mini App 的权限,默认开启,关闭即时生效。

安全

端口鉴权

每次运行签发一个凭据,只有 Mini App 页面和托管 MCP 能访问服务端口,插件代码不用改。

插件和页面不接触凭证

第三方账号由宿主代为调用,宿主凭据、内部端口和工具引用都不暴露给页面。

显式授权

Connector provider、Agent 权限、置顶和鼠标穿透都要在 manifest 里声明才能用。

用户确认

交给输入框每次都要确认;Agent 审批只有「允许一次」和「拒绝」,Mini App 不能写你的全局权限规则。