> ## Documentation Index
> Fetch the complete documentation index at: https://octop.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Octop 中的浏览器自动化与终端 AI 访问

> Octop 的工作台把远程浏览器和 AI 辅助终端合在一个页面，另有独立的远程桌面用于完整操控主机。

Octop 的**工作台**把远程浏览器和 AI 辅助终端合并在一个页面，让您实时查看并随时接管专家的执行过程。远程桌面与远程手机使用独立页面。

## 浏览器

浏览器标签页驱动的是一个真实的 Chromium 实例（通过 CDP 接入，支持持久化配置），专家可以在其中浏览网页、填写表单、截图，您也可以随时接管操作。

### 启用浏览器

浏览器需要 `browser` 扩展，按您的安装方式选择：

```bash 一键安装脚本（macOS / Linux） theme={null}
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash -s -- --extras browser
```

```bash PyPI theme={null}
pip install "octop[browser]"
```

安装后重启 `octop run`，然后打开：

```text theme={null}
工作台 → 浏览器
```

点击**检查**确认环境就绪，再点击**启动浏览器**建立会话。在地址栏输入网址即可访问，同时可使用收藏夹与 AI 助手。

每个 Octop 用户使用隔离的 Chrome profile。需要结束本地 Chrome 时点击**关闭浏览器**。空闲 30 分钟后也会回收（`OCTOP_BROWSER_IDLE_TIMEOUT_MINUTES`）。登录态仍保留在磁盘 profile，下次启动不用重新登录。

Docker 镜像不带 Playwright Chromium。要用此标签页，请安装 `browser` extra。

![工作台浏览器](https://mintcdn.com/octop/P_aBdthWeK4YndCE/images/ui-workbench.png?fit=max\&auto=format\&n=P_aBdthWeK4YndCE\&q=85\&s=bab813b3a3259dd184279e85c5184111)

启用后，在对话中直接用自然语言让专家浏览网页即可，例如「帮我看看某某网站今天的头条」或「给 [https://example.com](https://example.com) 截个图」。

专家正在操控浏览器时，你可以接管同一会话。你的点击和输入会先于专家生效，直到你交还控制权。

## 终端

工作台中的**终端**标签页内嵌了完整的交互式 shell。您可以开多个会话标签、直接执行命令，也可以让专家推荐命令、解释输出或排查报错。

工作台**终端**与聊天 Dock 中的终端共用同一会话，无论从哪一侧操作，命令与输出都保持一致。

```text theme={null}
工作台 → 终端
```

![工作台终端](https://mintcdn.com/octop/P_aBdthWeK4YndCE/images/ui-terminal.png?fit=max\&auto=format\&n=P_aBdthWeK4YndCE\&q=85\&s=2fa3ded84d70c9599ec89aad7bafb291)

## 相关控制页面

* **服务器桌面** — [远程桌面](https://octop.mintlify.site/zh/guides/remote-desktop.md)
* **手机** — [远程手机](https://octop.mintlify.site/zh/guides/remote-phone.md)

## 安全防护

浏览器和终端让专家能够真实触达您的机器，因此相关的安全控制统一收敛在：

```text theme={null}
管理 → 安全防护
```

![安全防护](https://mintcdn.com/octop/P_aBdthWeK4YndCE/images/ui-security.png?fit=max\&auto=format\&n=P_aBdthWeK4YndCE\&q=85\&s=34f720b6250b23d63ac54576951dc03d)

页面分为六个标签页：

| 标签页 | 作用 |
| - | - |
| **工具审批** | 命中列表的工具在执行前暂停，等待您在对话中批准或拒绝 |
| **文件访问** | 控制专家可读写的路径 |
| **敏感信息** | 对密钥和个人信息做脱敏处理 |
| **命令防护** | 对 shell 命令生效的放行与拦截规则 |
| **技能扫描** | 技能安装前的安全检查 |
| **审计日志** | 记录被防护拦截或放行的操作 |

工具审批默认已把风险最高的 `bash`、`execute`、`write_file`、`edit_file` 列入名单，但总开关**启用工具人工审批**默认关闭。打开后，名单中的工具执行前都会等待您确认。

保存时会一并保存所有标签页的设置，运行中的专家会自动重载。

> [!WARNING]
>
> 在生产环境开放 shell 访问前，请先检查命令防护和文件访问规则。过于宽松的规则可能让专家执行破坏性命令。建议从严格的白名单开始，按需逐步放开。

> [!TIP]
>
> 启用技能的 CLI 命令见[专家命令](https://octop.mintlify.site/zh/cli/agent-commands.md#octop-skills)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.