OpenCode¶

在运行你环境的机器上安装并认证 OpenCode，然后在设置 > 提供方中启用它。参见提供方设置。T3 Code 要求 OpenCode 1.14.19 或更高版本，包括在连接现有 OpenCode 服务器时也是如此。

OpenCode 2¶

T3 Code 支持 OpenCode 2.0.18 及更高版本。它会自行检测版本，因此相同的提供方设置适用于 OpenCode 1.x 和 2.x。OpenCode 1.x 在其提供方设置中显示有限支持。

OpenCode 2 是一个独立的包，@opencode/cli。要从 1.x 迁移，请自行安装它，例如 npm install -g @opencode/cli。然后刷新提供方状态。T3 Code 的更新按钮会更新你已安装的任意包。它绝不会将 1.x 安装切换到 2.x。

OpenCode 2 在首次运行时会将共享的 OpenCode 数据库转换为其自身格式。不要在同一台机器上同时运行 OpenCode 1.x 和 2.x。你在 1.x 上启动的线程会在 2.x 上继续。

压缩¶

OpenCode 会自行压缩长对话，T3 Code 没有相应设置。在 OpenCode 2 中，可在 OpenCode 配置文件（如 opencode.json）的 compaction 下更改：auto 开启或关闭自动压缩，buffer 设置 token 余量，keep.tokens 设置保留多少近期上下文。OpenCode 1.x 以不同方式配置压缩。发送 /compact 可自行压缩线程。

本地或外部服务器¶

将服务器 URL 留空，让 T3 Code 在本地启动 OpenCode。提供方设置中的密码同时适用于该服务器和 T3 Code 的连接。若未设置密码，本地服务器会使用其环境中的 OPENCODE_SERVER_PASSWORD。

要使用现有 OpenCode 服务器，请在提供方设置中设置服务器 URL 及其密码。T3 Code 对外部服务器仅使用已配置的密码；它不会转发本地的 OPENCODE_SERVER_PASSWORD。如果连接或版本检查失败，请检查 URL、凭据和 OpenCode 版本，然后刷新提供方状态。

连接丢失后，发送另一条 prompt 以重新连接到同一个 OpenCode 会话。

审批¶

OpenCode 遵循共享的权限模式。自动与受监督规则相同，因为 OpenCode 没有 AI 审批审查器。环境文件（如 .env 和 .env.local）在受限模式下需要审批，即使普通文件读取不需要；.env.example 是允许的。

允许用于工作区适用于使用同一工作区的其他 OpenCode 会话中的匹配请求。它比当前线程更宽泛，尤其是在共享外部服务器上。对于单个请求，请使用允许一次。拒绝某个操作不会停止整个回合。

刷新模型、命令和技能¶

更改 OpenCode 登录或配置后，请在该环境的设置 > 提供方中使用刷新提供方状态。在移动设备上，请在线程设置中使用刷新模型。重新连接也会刷新目录；定期提供方健康检查则不会。

凭据更改会在刷新时读取。本地助手运行时，原生 OpenCode 配置可能仍处于缓存状态。请让其保持空闲 30 秒，期间不要进行模型刷新或文本生成操作，然后再次刷新以重新加载文件。重复刷新会保持助手活动。外部服务器可能需要自行重新加载或重启，T3 Code 才能看到配置更改。

现有线程会保留其选定的模型和选项，即使该模型从目录中消失。如果 OpenCode 拒绝该模型，请选择一个可用模型并重试。