> ## 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 年 10 月 20 日，「已发布」指 MiniMax Code v3.1.4 已经提供；具体功能和上线时间以实际版本为准。

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

## 与 Agent 协作

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

## 会话

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

## 界面与窗口

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

## 设备

| 能力 | 状态 | 说明 |
| - | - | - |
| 麦克风与语音转写 | 即将发布 | manifest 声明 `deviceAccess` 后页面可以使用麦克风，`speech.transcribe` 把录音交给宿主转成文字 |

## 后端与数据

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

## 权限与安全

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

## 构建、发布与运行

| 能力 | 状态 | 说明 |
| - | - | - |
| [创建与安装](/docs/miniapp/authors/quickstart) | 已发布 | `/miniapp-creator` 一句话创建，用内置浏览器截图验收；也可以把现成的目录或 ZIP 交给 Agent 发布；官方 Mini App 走插件市场的安装、更新和卸载 |
| [运行管理](/docs/miniapp/authors/publish) | 已发布 | 发布分步进行，安装失败自动恢复旧版本；`inspect` 查看来源、运行状态和诊断；`stop`、`restart`，失败状态下工具栏直接提供重新启动 |
| 市场更新不打断运行中的 Mini App | 即将发布 | 插件市场有新版本时，运行中的实例继续用旧版；工具栏和插件页提供「更新」入口，由你决定何时切换 |
| 定时自动处理 | 规划中 | 按计划更新数据或执行重复工作 |

## 版本与兼容

| 能力 | 状态 | 说明 |
| - | - | - |
| 最低版本与能力探测 | 即将发布 | manifest 里声明需要的最低 MiniMax Code 版本，低于该版本的宿主不加载这个 Mini App，同包的 Skill 和普通 MCP 照常工作；`capabilities.has(name)` 检查当前宿主支持哪些接口，老版本上可以降级 |

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