> ## 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 各项能力的状态：已发布、实验性、即将发布、规划中。

状态截至 2026 年 11 月 3 日。「已发布」表示正式版已提供，最低版本要求见对应说明；「即将发布」为功能预告，具体功能和上线时间以正式发布版本为准。

* 已发布 正式版可用
* 实验性 接口定义可能调整，使用前做特性检测
* 即将发布 将随后续版本发布，接口以发布版本为准
* 规划中 尚未开放

## 与 Agent 协作

| 能力 | 状态 | 说明 |
| - | - | - |
| [Agent 调用 Mini App 的工具](https://agent.minimaxi.com/docs/miniapp/authors/agent.md#mcp) | 已发布 | 托管 MCP：Node 服务把业务功能作为工具提供给 Agent，页面和 Agent 操作同一份数据 |
| [交给输入框](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#append) | 已发布 | `message.append` 把整理好的内容放进当前会话的输入框，用户确认后再发送 |
| [发起 Agent 会话](https://agent.minimaxi.com/docs/miniapp/authors/agent.md#agent-api) | 已发布 | 页面和 Node 服务都能发起会话，并选择模型和 agent。回复流式显示，审批和问卷在页面中处理；也可用 `open(sessionId)` 将会话显示到聊天侧栏。Node 侧可设并发上限，超出的调用排队等待 |
| [会话忙时跟进](https://agent.minimaxi.com/docs/miniapp/authors/agent.md#agent-busy) | 已发布 | `run` 带 `whenBusy`：目标会话正忙时，排队等待空闲，或把消息插入正在进行的回合 |

## 会话

| 能力 | 状态 | 说明 |
| - | - | - |
| [在会话里打开](https://agent.minimaxi.com/docs/miniapp/sessions.md#open) | 已发布 | 输入框里出现引用就启动后台并打开页面；`open` 带 `path` 直接打开插件内的某个地址；服务未重启、页面未重载且未指定 `path` 时，同一会话再次打开保留路由和状态 |
| [多个会话共用一个服务](https://agent.minimaxi.com/docs/miniapp/sessions.md#shared) | 已发布 | 服务按插件共享，页面按会话分开 |
| [登录变化后继续可用](https://agent.minimaxi.com/docs/miniapp/sessions.md#accounts) | 已发布 | 刷新登录凭据不影响运行中的 Mini App；同一账号再次登录后，重新获取工具即可继续，不用重新发布 |
| [读取和观察用户会话](https://agent.minimaxi.com/docs/miniapp/authors/agent.md#agent-read) | 已发布 | `agent.sessions` 列出用户的会话，`agent.session` 查看详情，`agent.observe` 订阅会话进度；需在 manifest 声明 `session.read`，用户可以在权限面板随时关闭 |

## 界面与窗口

| 能力 | 状态 | 说明 |
| - | - | - |
| [独立窗口](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#window) | 已发布 | 页面可从文件面板弹出成独立窗口，`surface.window` 声明尺寸、置顶、透明和鼠标穿透，位置会被记住，显隐不跟随主窗口；切窗可能重建页面，见[重建与确认](https://agent.minimaxi.com/docs/miniapp/reference/client-api.md#window-reload) |
| [页面侧窗口句柄](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#window) | 实验性 | `window.mcode.miniapp.window` 读取和调整弹出窗口 |

## Host 感知与导航

| 能力 | 状态 | 说明 |
| - | - | - |
| 主题与界面语言 | 即将发布 | 支持页面适配宿主的明暗主题和界面语言 |
| 导航状态感知 | 即将发布 | 感知宿主的公开界面状态及导航变化 |
| 打开宿主入口 | 即将发布 | 用户操作后，从 Mini App 打开宿主常用入口 |

## 设备

| 能力 | 状态 | 说明 |
| - | - | - |
| [麦克风与语音转写](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#speech) | 已发布 | manifest 声明 `deviceAccess` 后页面可以使用麦克风，`speech.transcribe` 把录音交给宿主转成文字 |
| [摄像头](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#camera) | 已发布 | v3.1.9 起支持在 Mini App 页面中使用摄像头，用户可控制访问权限 |
| [系统通知](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md#notifications) | 已发布 | v3.1.9 起支持从 Mini App 发送系统通知，提醒用户查看处理结果 |

## 后端与数据

| 能力 | 状态 | 说明 |
| - | - | - |
| [后端服务](https://agent.minimaxi.com/docs/miniapp/authors/node-runtime.md#contract) | 已发布 | 导出 `start(context)`，宿主分配端口、负责启停；Node 入口也能拉起 Python、Go 等服务，再从分配的端口反向代理过去 |
| [持久化数据](https://agent.minimaxi.com/docs/miniapp/authors/data.md#state) | 已发布 | 每个插件有独立的 `dataDir`，服务重启和插件更新后数据仍会保留 |
| [数据接入](https://agent.minimaxi.com/docs/miniapp/authors/data.md#methods) | 已发布 | Host Connector 使用用户在 MiniMax Code 里授权的账号调用 Notion 等应用，插件自己不保存凭证；也可以直接用 CLI、HTTP API、SDK 和本地文件 |
| [统一工具入口](https://agent.minimaxi.com/docs/miniapp/authors/data.md#tools) | 已发布 | manifest 声明 `toolAccess` 后，`context.tool` 通过同一套接口列出和调用宿主已挂载的 MCP 工具和 Connector；每次调用都遵守用户为 Agent 设置的权限规则，需要确认时由宿主弹框 |

## 权限与安全

| 能力 | 状态 | 说明 |
| - | - | - |
| [端口鉴权](https://agent.minimaxi.com/docs/miniapp/authors/node-runtime.md#auth) | 已发布 | 每次运行签发一个凭据，只有 Mini App 页面和托管 MCP 能访问服务端口，插件代码不用改 |
| [插件和页面不接触凭证](https://agent.minimaxi.com/docs/miniapp/host/security.md#boundaries) | 已发布 | 宿主使用用户授权的第三方账号代为调用，宿主凭据、内部端口和工具引用都不暴露给页面 |
| [授权与确认](https://agent.minimaxi.com/docs/miniapp/host/security.md) | 已发布 | Connector provider、Agent 权限、置顶和鼠标穿透都要在 manifest 里声明；交给输入框每次都要确认；Agent 审批只有「允许一次」和「拒绝」，Mini App 不能改用户的全局权限规则 |
| [权限面板](https://agent.minimaxi.com/docs/miniapp/host/security.md#permissions) | 已发布 | 插件详情里逐项开关这个 Mini App 的 Connector、Agent 会话、读取会话、工具调用、麦克风、摄像头和通知权限；默认开启，关闭后新调用立即受限，不用重启 |
| 页面系统权限默认拒绝 | 已发布 | 麦克风、摄像头和通知需在 manifest 声明并开启对应权限；定位等未开放的系统权限默认拒绝 |

## 构建、发布与运行

| 能力 | 状态 | 说明 |
| - | - | - |
| [创建与安装](https://agent.minimaxi.com/docs/miniapp/authors/quickstart.md) | 已发布 | `/miniapp-creator` 一句话创建，用内置浏览器截图验收；也可以把现成的目录或 ZIP 交给 Agent 发布；官方 Mini App 走插件市场的安装、更新和卸载 |
| 从 GitHub 导入 | 即将发布 | 导入 GitHub 仓库中的 Mini App |
| [运行管理](https://agent.minimaxi.com/docs/miniapp/authors/publish.md) | 已发布 | 发布分步完成，安装失败自动恢复旧版本；`inspect` 查看来源、运行状态和诊断；用 `stop`、`restart` 停止或重启服务，失败时也可从工具栏重新启动 |
| [受控市场更新](https://agent.minimaxi.com/docs/miniapp/host/lifecycle.md#marketplace-updates) | 已发布 | 新版 Mini App 定义仍兼容且更新需要重启时，运行中的实例保留当前整包，直到用户确认更新或服务停止；定义被删除或因最低版本要求被屏蔽时，宿主会退役旧服务，无需等待确认 |
| 按内存管理运行容量 | 即将发布 | 取消固定 3 个服务的限制，根据设备内存确定可同时运行的服务数量 |
| 后台休眠与恢复 | 即将发布 | 根据内存压力释放后台资源，降低闲置 Mini App 的内存占用 |
| 定时自动处理 | 规划中 | 按计划更新数据或执行重复工作 |

## 版本与兼容

| 能力 | 状态 | 说明 |
| - | - | - |
| [最低版本与能力探测](https://agent.minimaxi.com/docs/miniapp/reference/manifest.md#compat) | 已发布 | `miniapp.json` 的 `engines.mcode` 声明最低 MiniMax Code 版本；识别该声明的宿主版本不足时，不加载 Mini App，同包 Skill 和普通 MCP 保留。`capabilities.has(name)` 检查宿主接口支持，不代表插件授权 |

需要 Mini App 还没有的运行时能力，可以到开源社区置顶的[能力许愿单](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/issues/9)留言。