本页介绍 Mini App 的功能和使用场景，各项能力的版本支持与发布计划统一见能力与进展。
能做出什么
- 专业工作台：把散落在多个平台的资料集中到一个页面，人和 Agent 在同一份数据上推进工作，比如官方的股市 Mini App。
- 数据看板与监控：Token 用量、Git 提交历史、会话轨迹这类需要筛选、图表和实时刷新的页面。
- 连接业务系统：连接 Notion、Jira 等已授权的应用，在页面中增删改，改动同步回原系统。
- 规划与生成：把地图、搜索、图片生成等能力串成一个流程，比如自驾规划。
- 和 Agent 一起干活：页面整理好上下文交给 Agent，或者直接发起 Agent 会话，在页面中处理审批和问卷。
- 小工具和小游戏：番茄钟、笔记板、占卜，或其他你想随手打开的小工具和小游戏。
界面与窗口
完整网页界面
HTML、CSS、JavaScript，可以用任何前端框架和图表库，表格、拖拽、实时刷新都能做。
在会话侧栏打开
从面板「+」、对话里 @ 或让 Agent 打开，页面出现在当前会话的右侧面板。
打开指定页面
open 带 path，直接打开插件内的某个地址，比如某条记录的详情页。弹出独立窗口
页面可以从文件面板弹出成独立窗口，位置会被记住；manifest 声明尺寸、置顶、透明和鼠标穿透，适合做悬浮小组件。切换窗口模式可能重建页面，需提前保存状态，见页面重建提示。
窗口句柄
页面读取和调整自己的弹出窗口：切换模式、改位置和尺寸、置顶、穿透。接口仍可能调整，使用前做特性检测。
设备
摄像头和系统通知需 MiniMax Code v3.1.9 或更新版本。麦克风与语音转写
页面录音后，用
speech.transcribe 交给宿主转成文字；需要声明并开启麦克风权限。摄像头
声明
deviceAccess: ["camera"]，页面通过标准浏览器 API 获取摄像头画面；用户可在权限面板关闭访问。系统通知
声明
deviceAccess: ["notifications"]，从页面发送系统通知，提醒用户查看处理结果。后端与数据
Node 后端服务
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 回合，流式显示回复，并渲染工具审批和问卷。
在后台运行 Agent
Node 服务用
context.agent 处理任务、写回业务数据；可以设并发上限，超出的调用排队等待。交给聊天侧栏
open(sessionId) 把 Mini App 的 Agent 会话显示在聊天侧栏，你在那里看过程、审批和回答。选择模型和 agent
列出你能用的模型和你配置的 agent，为会话切换模型，或以指定的 agent 新建会话。
会话
Mini App 的服务按插件共享，页面按会话分开，完整规则见 Mini App 与会话。引用即启动
输入框里一出现 Mini App 引用，后台就开始启动；页面打开成功后才展开侧栏。
多个会话共用一个服务
每个会话有自己的页面，背后是同一个服务、同一份数据。
重复打开保留页面
服务未重启、页面未重载且未指定
path 时，同一会话里再次 @ 或打开会复用原标签，保留当前路由和状态。会话列表标识
左侧会话列表标出当前打开了 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 不能写用户的全局权限规则。