仓库 →

WebUI 界面

除了终端 TUI，AtomCode 还内置一个浏览器界面：在 TUI 里输入 /webui 即可一键启动，在浏览器里聊天、翻看历史会话、增删改模型配置、上传图片，并通过 /sync 让终端与浏览器实时同步同一个会话。它复用本机的登录态、模型与会话历史，不需要另外配置。

启动与关闭

在 AtomCode 的 TUI 输入框里运行：

# 启动 webui 并自动打开浏览器（默认绑定 127.0.0.1:13457，仅本机可访问）
/webui

# 关闭 webui 服务
/webui stop

启动后 AtomCode 会在本机起一个 HTTP 服务，并自动打开浏览器到形如 http://127.0.0.1:13457/?token=<一次性令牌> 的地址。URL 里带的 token 用于鉴权，等同于密码，请勿外传。同时，当前 TUI 会话会自动接入实时同步（见下文 多端实时同步）。

默认只监听本机

webui 默认绑定 127.0.0.1，只有本机能访问。要让手机等设备访问，不要直接用 --host 0.0.0.0 暴露到公网，请走蒲公英虚拟局域网方案 —— 见 远程访问指南。

界面功能

浏览器界面把终端里的能力搬到了图形界面上，主要包括：

区域能做什么
侧边栏按项目分组的历史会话列表、搜索会话、新建对话、重命名 / 删除会话；可收起为图标栏，移动端为抽屉。
模型选择器输入框下方直接切换 provider / 模型；同名模型会附带 provider 标识消歧。
模型配置设置里管理供应商账号和账号下的多个模型，并配置协议、Base URL、API Key、上下文窗口及默认模型。
设置主题（浅色 / 深色）、语言（中 / 英）、模型配置、远程访问入口。
图片附件粘贴或选择图片随消息发送（单张上限 2MB），非视觉模型走 VL 兜底；历史里显示缩略图。
工具执行实时展示工具调用的参数与输出，可逐行展开查看，历史回看同样可见。
附件菜单（+）上传图片、选择文件作为上下文、插入技能（Skills）。
工作目录切换工作目录、浏览目录、新建文件夹、设为默认工作目录。

多端实时同步

webui 背后是一个 LiveSession：同一个会话可以同时被终端和多个浏览器标签页打开，任意一端的输入、AI 的增量回复、工具调用结果都会实时广播到所有连接的视图，晚加入的一端还会先收到快照回放。

这让「终端里发起、手机 / 平板上盯进度」或「多人围观同一个 agent 会话」成为可能。

审批模式

底栏有一个 pill 用来设置 agent 操作的门控方式 —— 相当于终端审批模式在浏览器里的镜像。默认是 Build。

模式行为
Build(默认)交互式 —— 每次改文件、跑命令前都请求审批。
Accept Edits文件改动自动批准;命令仍需审批。
Plan只读探索 —— 写入和执行类工具被拦下,让 agent 先给方案。
Bypass(免审批)⚠ 自动批准一切,含改文件与跑命令。请谨慎使用。

该模式是进程级的,并通过实时通道广播,所以在一个标签页里切换会同步到所有已连接的视图。它不写入配置 —— 重启后回到 Build。

当 agent 在任务中途需要你拍板时,会弹出一张交互提问卡片(单选、多选或自由文本),回合会暂停到你作答为止。完整行为见 交互提问。

远程访问

想从手机等设备打开 webui，又不暴露公网？借助蒲公英（Oray PGY）组建的虚拟局域网，用 /webui --host <虚拟 IP> 把服务绑定到虚拟 IP，再在「远程访问」面板扫码即可。完整流程见 远程访问指南。

下一步