OpenCode 使用指南

本教程介绍如何通过 OpenCode 控制 ego (lite)：开启自动批准权限，在桌面端或 TUI 中加载 ego-browser，并完成一次浏览器任务。

OpenCode 可以通过桌面端或终端界面控制 ego (lite)。本指南以 Anthropic 的 X 主页为例，由 OpenCode 在 ego (lite) 的 Agent Space 中打开页面，读取前五条帖子，并将结果返回到对话中。

上方是桌面端的完整操作过程。TUI 使用相同的 ego-browser Skill 和任务指令。

开始前：安装 ego (lite)

打开 OpenCode 前，请先安装 ego (lite) 并完成初始设置。

下载并打开 DMG 安装包
按照指示，双击 ego (lite) 的 icon 进行安装
启动 ego (lite)，完成初始设置
在 OpenCode 桌面端打开项目，或在终端中进入项目目录后启动 OpenCode

初始设置会将 ego-browser 写入 ~/.agents/skills/，OpenCode 会从该目录读取可用的 Skill。如果 OpenCode 已经打开，请完全退出并重新启动，再继续下面的操作。

选择 OpenCode 桌面端或 TUI

使用桌面端时，先打开项目并新建会话。使用 TUI 时，在终端中进入项目目录，然后运行：

opencode --auto

--auto 会在启动 OpenCode 时开启自动批准权限。桌面端和 TUI 都可以使用相同的 ego-browser 命令与任务指令。

第 1 步：开启自动批准权限

桌面端

在 OpenCode 桌面端打开 Settings > General，开启 Auto-accept permissions。这就是本指南中所说的免审批模式。开启后，Agent 可以直接启动 ego (lite) 并发送本机浏览器指令，执行过程中无需反复等待确认。

TUI

使用 TUI 时，通过 opencode --auto 启动 OpenCode。也可以打开命令面板，选择 Enable auto-approve permissions。

第 2 步：加载 ego-browser Skill

桌面端

新建会话，输入 /ego-browser，从列表中选择 ego-browser，然后将它作为一条单独的消息提交。Skill 加载完成后，再发送浏览器任务。

加载后，OpenCode 可以启动 ego (lite)、创建 Agent Space，并操作该 Space 中的网页。如果列表中没有 ego-browser，请确认 ego (lite) 已完成初始设置，然后重新启动 OpenCode。

TUI

上方素材展示的是 TUI 操作流程。OpenCode 会先在终端会话中加载 ego-browser Skill，再接收浏览器任务。后续执行方式与桌面端一致：启动 ego (lite)、创建 Agent Space，并操作该 Space 中的网页。

第 3 步：让 OpenCode 执行浏览器任务

将任务交给 OpenCode。Agent 会通过 ego-browser 在 ego (lite) 中打开 Anthropic 的 X 主页，读取指定的帖子，并将结果整理到 OpenCode 对话中。

桌面端与 TUI 的执行方式相同。提交任务后，Agent 会通过 ego (lite) 完成后续的浏览器操作。

第 4 步：完成任务

任务完成后，OpenCode 会返回五条帖子的可见信息、对应链接和简要内容概括。Anthropic 的 X 主页会继续保留在 ego (lite) 中，本次浏览器任务至此完成。

常见问题

找不到 `ego-browser`

请确认 ego (lite) 已完成初始设置，然后完全退出并重新启动 OpenCode。安装后的 Skill 应位于 ~/.agents/skills/。

已加载 Skill，但 ego (lite) 没有启动

桌面端请检查 Settings > General > Auto-accept permissions。TUI 请关闭当前会话，再通过 opencode --auto 重新启动。

TUI 打开了错误的项目

退出 OpenCode，在终端中进入正确的项目目录，然后重新运行 opencode --auto。OpenCode 会将当前目录作为项目上下文。

X 要求登录或验证账号

请在 ego (lite) 的 Agent Space 中完成登录或验证，然后让 OpenCode 继续执行任务。