> ## 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 协作、会话、构建分发、运行管理和安全。

没有标注状态的功能都已在正式版可用。「实验性」已经可用，但接口形状可能调整，使用前做特性检测；「即将发布」即将随后续版本提供，接口以发布版本为准；「规划中」还没有提供。完整状态见[能力与进展](/docs/miniapp/progress)。

## 能做出什么

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

## 界面与窗口

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

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

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

> **[弹出独立窗口](/docs/miniapp/authors/client-api#window)**
>
> 页面可以从文件面板弹出成独立窗口，位置会被记住；manifest 声明尺寸、置顶、透明和鼠标穿透，适合做悬浮小组件。

> **[窗口句柄](/docs/miniapp/authors/client-api#window)**
>
> 实验性 页面读取和调整自己的弹出窗口：切换模式、改位置和尺寸、置顶、穿透。

## 后端与数据

> **[Node 后端服务](/docs/miniapp/authors/node-runtime#contract)**
>
> 导出 `start(context)` 就行，宿主分配端口、负责启停；可以用 SSE 或 WebSocket 做实时推送。

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

> **[持久化数据](/docs/miniapp/authors/data#state)**
>
> 宿主为每个插件隔离一个 `dataDir`，服务重启和插件更新后数据都还在。

> **[用户已授权的应用](/docs/miniapp/authors/data#host-connector)**
>
> Host Connector 用你在 MiniMax Code 里授权的账号调用 Notion 等应用，插件自己不保存凭证。

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

> **[统一工具入口](/docs/miniapp/progress#backend)**
>
> 即将发布 `context.tool` 用同一个写法列出和调用宿主已挂载的 MCP 工具和 Connector，按你给 Agent 设的权限规则判定。

## 与 Agent 协作

> **[Agent 调用 Mini App 的工具](/docs/miniapp/authors/agent#mcp)**
>
> 托管 MCP：Node 服务把业务能力暴露成工具，页面和 Agent 操作的是同一份数据。

> **[交给输入框](/docs/miniapp/authors/client-api#append)**
>
> 页面把整理好的内容放进当前会话的输入框，你确认、修改后自己发送。

> **[从页面发起 Agent 会话](/docs/miniapp/authors/agent#agent-page)**
>
> 页面让 Agent 跑一个回合，流式显示回复，在页面里渲染工具审批和问卷。

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

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

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

## 会话

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

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

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

> **[重复打开保留页面](/docs/miniapp/sessions#open)**
>
> 同一会话里再次 @ 或打开，复用原标签，保留当前路由和状态。

> **[会话列表标识](/docs/miniapp/sessions#open)**
>
> 左侧会话列表标出当前打开了 Mini App 的会话。

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

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

## 构建与分发

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

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

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

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

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

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

## 运行与管理

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

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

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

> **[停止与重启](/docs/miniapp/authors/quickstart#tool)**
>
> 停止只停服务，插件和同包能力保留；失败状态下工具栏直接提供重新启动。

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

> **[定时自动处理](/docs/miniapp/progress#build)**
>
> 规划中 按计划更新数据或执行重复工作。

> **[权限面板](/docs/miniapp/progress#security)**
>
> 即将发布 在插件详情里逐项开关 Mini App 的权限，默认开启，关闭即时生效。

## 安全

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

> **[插件和页面不接触凭证](/docs/miniapp/host/security#boundaries)**
>
> 第三方账号由宿主代为调用，宿主凭据、内部端口和工具引用都不暴露给页面。

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

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