> ## 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.

# WebUI

> 在本机启动 MiniMax Code Web，用浏览器下指令、看进度、批权限。

MiniMax Code Web 是 MiniMax Code 的浏览器客户端。你在浏览器里打开本机地址下指令，Agent 在本机进程里执行：读文件、跑命令、改代码、开浏览器、审批权限，都发生在你自己的机器上。

WebUI 和桌面端、终端客户端是同级的，不是某个客户端的网页外壳。三者实现同一套会话协议，账号、会话历史、技能、插件、记忆和定时任务在哪边打开都一样。

> [!NOTE]
>
> WebUI 仍在迭代，界面文案以你机器上的实际版本为准。

## 适合做什么

| 场景 | 说明 |
| - | - |
| 远程开发 | 笔记本上跑 WebUI，在浏览器里下指令、看进度、批权限 |
| 长任务盯梢 | 让 Agent 跑长流程，随时在浏览器里看变更、终端输出和子任务 |
| 审阅变更 | 在工作区面板直接看 diff，逐文件审阅、撤销或回退某一轮改动 |
| 定时自动化 | 在「定时任务」里排计划，到点自动执行，结果写回会话 |
| 手机协同 | 配对手机端后，用手机补指令、批权限、查进度 |
| 多入口同源 | 桌面端、终端、浏览器共享账号、技能、插件、记忆与定时任务 |

## 安装与启动

WebUI 是一个只监听 `127.0.0.1` 的本机服务。

```bash theme={null}
npm install -g @minimax-webui/minimax-code --allow-scripts=better-sqlite3,node-pty,bufferutil,utf-8-validate
mcode-webui
```

`mcode-webui` 默认使用 `2233` 端口，需要换端口时设置环境变量 `WEBUI_SERVER_PORT`。服务只接受回环地址绑定，不能直接对外网开放。

## 打开页面

在浏览器访问 `http://127.0.0.1:2233/`。页面会带上这次启动生成的访问凭据，用它连接本机的 WebSocket 服务。凭据只存在于这份页面配置里，不会写入磁盘。

![WebUI 首页工作台](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/01-home.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=93c0e7bdef709ffe2d027393484ef903)

## 创建第一个任务

1. 点首页的「选择文件夹」，选中要改的项目目录。没选目录的会话会归到「未选项目」下。
2. 在输入框写下目标，例如「把这个仓库跑起来并修掉失败的测试」。
3. 点发送。Agent 会在这个目录里读文件、跑命令；遇到需要授权的操作会弹出确认，在输入框上方点批准即可。

## 核心工作流

### 工作模式

在「设置 → 通用 → 模式」中切换：

| 模式 | 特点 | 适合 |
| - | - | - |
| 适用于编程开发 | 保留技术细节与开发工具 | 写代码、改项目、跑测试、调页面 |
| 适用于日常工作 | 能力相同，少一些技术细节 | 文档、研究、表格、日常办公自动化 |

![设置（通用）](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/08-settings.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=cf228e80b195719ba412e595b4fdd4fc)

### 项目与会话

会话按项目目录分组。选定目录后，Agent 才能读到其中的文件、命令和变更。

左侧导航栏有新建、导入会话、工作区入口（插件、定时任务、应用、远程）、置顶和项目分组，底部是账号与设置。

| 操作 | 说明 |
| - | - |
| 导入会话 | 从会话文件导入历史记录 |
| 置顶 | 把重要会话固定在导航栏上方 |
| 归档 | 收起不常用的会话，可在「已归档任务」里找回 |
| 搜索 | 按关键词找历史会话或执行命令 |
| 快速导航 | 在长对话里跳回某一轮 |

### 权限确认

输入区左下角是权限开关：

| 模式 | 行为 |
| - | - |
| 请求批准（默认） | 写文件、跑命令、对外操作前逐条询问 |
| 完全访问权限 | 不再逐条询问，适合已经信任的环境 |

Agent 需要澄清时会发问卷，需要授权时会弹确认卡片，两者都在对话里直接回答。

### 代码审查

有三种方式：

* 输入 `/` 调出 `code-review` 指令，审查整个仓库。
* 在回复里的改动卡片上点「Review」，查看这一轮的 diff。
* 在工作区面板的「变更」标签里按文件审阅全部改动，可以撤销或回退某一轮。

![对话区与改动卡片](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/06-transcript.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=fbe61dc769a576b3ed238c413aba5509)

桌面端的划词评论和回复反馈在 WebUI 里暂不可用，反馈可以直接写在对话里。

## 工作区面板

工作区面板在对话右侧，是一排标签。每个标签是固定的位置，内容可以原地替换：在新标签页里打开网页，再跳到别的网页，仍然是同一个标签。

| 标签 | 作用 |
| - | - |
| 查看文件 | 浏览工作区文件树、预览文件内容 |
| 变更 | 当前改动集，逐文件 diff、审阅与回退 |
| 终端 | 在项目目录里开终端 |
| 画布 | 无限画布，图片、视频、文本节点可以自由排布和连线 |
| 网页 | 内置浏览器打开的页面，可前进后退 |
| 应用 | 已安装 Mini App 的页面 |

新标签页上有五个入口：变更、终端、画布、应用、查看文件，另有一个地址栏可以直接输入网址。

![工作区面板](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/07-workspace-panel.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=c2a847b381bb2d90d68b7073a384b7cf)

### 内置浏览器

可选三种浏览器：隔离浏览器（默认，进程内独立环境）、Microsoft Edge、Google Chrome。Edge 和 Chrome 需要先在设置里授权，授权后 Agent 可以直接操作真实浏览器页面。

### 外观与快捷键

「设置 → 通用 → 外观」可切换浅色、深色或跟随系统；个性化页提供主题设置；快捷键页可以查看并重新绑定输入区快捷键。

## Agent 能力

* **目标（Goal）**：用 `/目标` 给 Agent 设一个可验证的终局目标，它会持续推进，直到达标或遇到阻塞。
* **Agent Team 与自定义 Agent**：团队模式让多个 Agent 分工执行、互相校验。在插件管理里可以为某个插件指定执行 Agent。
* **Mini App**：「应用」列出本机可用的 Mini App，点击后在右侧标签里打开。
* **插件与技能**：「插件」入口有插件和技能两个页签，插件按分类浏览，卡片上显示安装状态，也支持从 GitHub 仓库导入插件。
* **MCP 服务**：在插件管理里接入外部工具和数据源，支持本地 stdio 和远程 HTTP 两种传输，HTTP 可以配置请求头、参数等。
* **记忆**：在设置里维护记忆和全局指令。记忆保存长期偏好和项目约定，全局指令对所有会话生效。

![插件与技能目录](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/02-plugins.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=76d416165ab464f6d9f0982b37f04b49)

![Mini App 应用列表](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/04-mini-apps.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=ec34061342bb4ff5b04867c6deb25152)

## 自动化与远程

### 定时任务

任务到点自动执行，结果写回对应会话。内置四个模板：

| 模板 | 说明 |
| - | - |
| 每日工作总结 | 一天结束时回顾项目进展与待办 |
| 每周计划整理 | 每周开始时梳理本周重点 |
| 定时检查项目 | 周期检查代码变化并汇总要关注的内容 |
| 一次性提醒 | 为某件事创建一个定时任务 |

编辑时可以填写名称、请求内容和执行 Agent，列表里能看到待执行的任务和历史运行记录。

![定时任务](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/03-schedule.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=b587533d6e6906ddebcb4bb976688079)

### 远程控制与 IM

「远程」页有两个页签：

* **远程控制**：与手机端配对。配对码只用一次，不落盘，也不回传浏览器。服务重启后会自动重连，手机端不用重新配对。
* **接入 IM**：把飞书、微信等 IM 通道绑定到本机 Agent，之后可以在聊天里下任务、看结果、批权限。通道状态和消息过滤规则也在这里管理。

![远程控制与 IM 接入](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/05-remote.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=0a7ba447d8bd6a75e1623dc69e152c09)

## 模型与账户

* **用量**：「设置 → 用量与模型」展示 5 小时限额、周限额、视频限额等配额，以及上下文窗口的使用情况。账户菜单里有每日签到，连续签到可以累积积分。
* **模型**：可以用 MiniMax 托管模型，也可以通过 Base URL、API Key 和模型名接入自己的模型源，支持发现候选模型和测试连通性。

## 与桌面端的差异

| 能力 | WebUI | 说明 |
| - | - | - |
| 端云任务接力 | 不支持 | 云端会话与交接是桌面端能力 |
| 划词评论 / 回复反馈 | 不支持 | 桌面端能力 |
| 变更图谱 | 不支持 | 桌面端工作区面板提供提交历史与分支关系 |
| 快捷小窗 | 不适用 | 桌面端提供 |
| 应用自更新 | 不适用 | 通过 npm 包升级 |
| 电脑操控 | 以插件提供 | 插件市场里的「电脑操控」 |
| 语音输入 | 暂不可用 | 语音设置页目前禁用 |
| 数据目录迁移 | 不支持 | 只展示位置 |
| 网页标签命名 | 仅隔离浏览器 | Edge / Chrome 页面不能命名 |

### 已知限制

* 部分服务只在桌面端可用，WebUI 里会隐藏对应入口。
* 进度面板在窗口宽度小于 1080px 时不可用。
* 侧栏折叠后不显示导航项。

## 常见问题

**页面一直显示「正在加载项目和会话」？**

多半是服务没就绪或连接被拒。看一下左下角状态条的连接标识；刷新页面会重新获取一份凭据。

**Agent 说没有可用模型？**

在「设置 → 用量与模型」里确认模型源和凭据。

**找不到某个功能？**

部分能力需要开关。在「设置 → 浏览器」或插件、MCP 页面确认授权和启用状态。

**能从别的机器访问吗？**

服务只监听回环地址。跨机器访问需要你自己配置安全的端口转发或隧道，不要把它直接暴露到公网。

**和终端客户端能共用账号吗？**

能。数据目录 `~/.minimax`（可用 `MINIMAX_DATA_DIR` 指定）与 CLI 共享同一份登录状态、技能和插件。

## 速查

| 项目 | 值 |
| - | - |
| 启动命令 | `mcode-webui` |
| 默认地址 | `http://127.0.0.1:2233/` |
| 端口覆盖 | `WEBUI_SERVER_PORT` |
| 数据目录 | `~/.minimax`（可用 `MINIMAX_DATA_DIR` 指定） |