> ## Documentation Index
> Fetch the complete documentation index at: https://agent.minimaxi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 功能一览

> Mini App 能做什么：界面与窗口、设备、后端与数据、与 Agent 协作、会话、构建分发、运行管理和安全。

本页介绍 Mini App 的功能和使用场景，各项能力的版本支持与发布计划统一见[能力与进展](https://agent.minimaxi.com/docs/miniapp/progress.md)。

## 能做出什么

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

## 界面与窗口

> [card] [完整网页界面](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#page-rules)
>
> HTML、CSS、JavaScript，可以用任何前端框架和图表库，表格、拖拽、实时刷新都能做。

> [card] [在会话侧栏打开](https://agent.minimaxi.com/docs/miniapp/sessions.md#open)
>
> 从面板「+」、对话里 @ 或让 Agent 打开，页面出现在当前会话的右侧面板。

> [card] [打开指定页面](https://agent.minimaxi.com/docs/miniapp/authors/quickstart.md#tool)
>
> `open` 带 `path`，直接打开插件内的某个地址，比如某条记录的详情页。

> [card] [弹出独立窗口](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#window)
>
> 页面可以从文件面板弹出成独立窗口，位置会被记住；manifest 声明尺寸、置顶、透明和鼠标穿透，适合做悬浮小组件。切换窗口模式可能重建页面，需提前保存状态，见[页面重建提示](https://agent.minimaxi.com/docs/miniapp/reference/client-api.md#window-reload)。

> [card] [窗口句柄](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#window)
>
> 页面读取和调整自己的弹出窗口：切换模式、改位置和尺寸、置顶、穿透。接口仍可能调整，使用前做特性检测。

## 设备

摄像头和系统通知需 MiniMax Code v3.1.9 或更新版本。

> [card] [麦克风与语音转写](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#speech)
>
> 页面录音后，用 `speech.transcribe` 交给宿主转成文字；需要声明并开启麦克风权限。

> [card] [摄像头](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#camera)
>
> 声明 `deviceAccess: ["camera"]`，页面通过标准浏览器 API 获取摄像头画面；用户可在权限面板关闭访问。

> [card] [系统通知](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#notifications)
>
> 声明 `deviceAccess: ["notifications"]`，从页面发送系统通知，提醒用户查看处理结果。

## 后端与数据

> [card] [Node 后端服务](https://agent.minimaxi.com/docs/miniapp/authors/node-runtime.md#contract)
>
> Node 入口导出 `start(context)`，宿主分配端口并负责启停；可以用 SSE 或 WebSocket 做实时推送。

> [card] [任意语言的后端](https://agent.minimaxi.com/docs/miniapp/authors/node-runtime.md#child)
>
> Node 入口可以拉起 Python、Go 等服务，再从分配的端口反向代理过去。

> [card] [持久化数据](https://agent.minimaxi.com/docs/miniapp/authors/data.md#state)
>
> 宿主为每个插件分配独立的 `dataDir`，服务重启和插件更新后数据仍会保留。

> [card] [用户已授权的应用](https://agent.minimaxi.com/docs/miniapp/authors/data.md#host-connector)
>
> Host Connector 使用用户在 MiniMax Code 里授权的账号调用 Notion 等应用，插件自己不保存凭证。

> [card] [CLI、HTTP API、SDK、本地文件](https://agent.minimaxi.com/docs/miniapp/authors/data.md#methods)
>
> Node 服务可以直接调用本机命令行工具、第三方 API 或用户授权的文件。

> [card] [统一工具入口](https://agent.minimaxi.com/docs/miniapp/progress.md#backend)
>
> `context.tool` 通过同一套接口列出和调用宿主已挂载的 MCP 工具和 Connector，并遵守用户为 Agent 设置的权限规则。

## 与 Agent 协作

> [card] [Agent 调用 Mini App 的工具](https://agent.minimaxi.com/docs/miniapp/authors/agent.md#mcp)
>
> 托管 MCP：Node 服务把业务功能作为工具提供给 Agent，页面和 Agent 操作同一份数据。

> [card] [交给输入框](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#append)
>
> 页面把整理好的内容放进当前会话的输入框，用户确认、修改后自行发送。

> [card] [从页面发起 Agent 会话](https://agent.minimaxi.com/docs/miniapp/authors/agent.md#agent-page)
>
> 页面发起 Agent 回合，流式显示回复，并渲染工具审批和问卷。

> [card] [在后台运行 Agent](https://agent.minimaxi.com/docs/miniapp/authors/agent.md#agent-node)
>
> Node 服务用 `context.agent` 处理任务、写回业务数据；可以设并发上限，超出的调用排队等待。

> [card] [交给聊天侧栏](https://agent.minimaxi.com/docs/miniapp/sessions.md#open-in-chat)
>
> `open(sessionId)` 把 Mini App 的 Agent 会话显示在聊天侧栏，你在那里看过程、审批和回答。

> [card] [选择模型和 agent](https://agent.minimaxi.com/docs/miniapp/authors/agent.md#agent-session)
>
> 列出你能用的模型和你配置的 agent，为会话切换模型，或以指定的 agent 新建会话。

## 会话

Mini App 的服务按插件共享，页面按会话分开，完整规则见 [Mini App 与会话](https://agent.minimaxi.com/docs/miniapp/sessions.md)。

> [card] [引用即启动](https://agent.minimaxi.com/docs/miniapp/sessions.md#open)
>
> 输入框里一出现 Mini App 引用，后台就开始启动；页面打开成功后才展开侧栏。

> [card] [多个会话共用一个服务](https://agent.minimaxi.com/docs/miniapp/sessions.md#shared)
>
> 每个会话有自己的页面，背后是同一个服务、同一份数据。

> [card] [重复打开保留页面](https://agent.minimaxi.com/docs/miniapp/sessions.md#open)
>
> 服务未重启、页面未重载且未指定 `path` 时，同一会话里再次 @ 或打开会复用原标签，保留当前路由和状态。

> [card] [会话列表标识](https://agent.minimaxi.com/docs/miniapp/sessions.md#open)
>
> 左侧会话列表标出当前打开了 Mini App 的会话。

> [card] [只在本地会话运行](https://agent.minimaxi.com/docs/miniapp/sessions.md#open)
>
> 云端、SSH、Remote Control 会话不会启动或打开本机的 Mini App。

> [card] [登录变化后继续可用](https://agent.minimaxi.com/docs/miniapp/sessions.md#accounts)
>
> 刷新登录凭据不影响运行中的 Mini App；退出后用同一账号登录回来，重新获取工具即可继续。

## 构建与分发

> [card] [一句话创建](https://agent.minimaxi.com/docs/miniapp/authors/quickstart.md)
>
> 用 /miniapp-creator，Agent 验证数据、写页面和后端、发布并打开。

> [card] [自动截图验收](https://agent.minimaxi.com/docs/miniapp/authors/quickstart.md#flow)
>
> Agent 用内置浏览器检查页面结构、文字和交互，汇报通过和未验证的部分。

> [card] [安装现成的包](https://agent.minimaxi.com/docs/miniapp/authors/quickstart.md#finished)
>
> 把 Mini App 目录或 ZIP 交给 Agent，检查后直接发布，不执行包里的说明、不装依赖。

> [card] [插件市场](https://agent.minimaxi.com/docs/miniapp/authors/share.md#enterprise)
>
> 官方 Mini App 走插件市场的安装、更新和卸载；官方包不能在本地修改。

> [card] [开源社区](https://agent.minimaxi.com/docs/miniapp/authors/share.md#community)
>
> 通过 Pull Request 分享到 MiniMax-Code-MiniApps，团队定期甄选上架。

> [card] [同包携带其他能力](https://agent.minimaxi.com/docs/miniapp/authors/package.md#plugin-json)
>
> 同一个包里的 Skill、普通 MCP、App 照常工作，不依赖 Mini App 是否在运行。

## 运行与管理

> [card] [按需启动](https://agent.minimaxi.com/docs/miniapp/authors/node-runtime.md#lifecycle)
>
> 启用插件不会启动服务；同时最多运行 3 个不同的 Mini App 服务。

> [card] [可回滚的发布](https://agent.minimaxi.com/docs/miniapp/authors/publish.md#pipeline)
>
> 暂存、安装、启动分步完成，安装失败自动恢复旧版本。

> [card] [状态与诊断](https://agent.minimaxi.com/docs/miniapp/authors/publish.md#inspect)
>
> `inspect` 查看来源、运行状态和最近一次运行的诊断，不会启动服务。

> [card] [停止与重启](https://agent.minimaxi.com/docs/miniapp/authors/quickstart.md#tool)
>
> 停止操作只停止服务，保留插件和同包能力；失败时也可从工具栏重新启动。

> [card] [启动失败可追溯](https://agent.minimaxi.com/docs/miniapp/authors/publish.md#inspect)
>
> 启动失败会写入运行日志，并在你提交反馈时一起打包，方便定位问题。

> [card] [权限面板](https://agent.minimaxi.com/docs/miniapp/progress.md#security)
>
> 在插件详情里逐项开关 Mini App 的权限，默认开启，关闭后新调用立即受限，不用重启。

## 安全

> [card] [端口鉴权](https://agent.minimaxi.com/docs/miniapp/authors/node-runtime.md#auth)
>
> 每次运行签发一个凭据，只有 Mini App 页面和托管 MCP 能访问服务端口，插件代码不用改。

> [card] [插件和页面不接触凭证](https://agent.minimaxi.com/docs/miniapp/host/security.md#boundaries)
>
> 宿主使用用户授权的第三方账号代为调用，宿主凭据、内部端口和工具引用都不暴露给页面。

> [card] [显式授权](https://agent.minimaxi.com/docs/miniapp/reference/manifest.md)
>
> Connector provider、Agent 权限、置顶和鼠标穿透都要在 manifest 里声明才能用。

> [card] [用户确认](https://agent.minimaxi.com/docs/miniapp/host/security.md#human)
>
> 交给输入框每次都要确认；Agent 审批只有「允许一次」和「拒绝」，Mini App 不能写用户的全局权限规则。