研究对象：OpenCode 独立应用生态及其 VSCode 扩展体系

第一章：OpenCode 独立应用形态及其关系

　　在进入编辑器插件研究之前，必须先理解 OpenCode 作为一个独立 AI Agent 生态的三种核心存在形态：CLI、TUI 与 Desktop。

1.1 三种独立形态定义

　　**CLI (Command Line Interface)**：

　　**本质**：OpenCode 的核心引擎（大脑），基于 Go 语言开发。

　　**功能**：负责处理所有底层的逻辑——连接 LLM 供应商（如 Gemini, Claude）、管理文件上下文、执行 Shell 指令。

　　**特点**：非交互式，适合脚本调用和自动化流水线（如 `opencode "帮我重构这段代码"`）。

　　**TUI (Terminal User Interface)**：

　　**本质**：内置在 CLI 里的交互式终端界面。

　　**功能**：当直接运行 `opencode` 指令而不带具体命令时启动。

　　**特点**：在终端里模拟图形操作（使用键盘快捷键、显示进度条），是极客和终端爱好者的主力工具。

　　**Desktop App (桌面应用)**：

　　**本质**：基于 Electron 开发的独立图形化程序。

　　**功能**：提供完全脱离编辑器的专业 AI 聊天和代码协作界面。

　　**特点**：视觉体验最佳，支持拖拽文件、管理复杂的对话历史。

1.2 三者之间的内在联系

　　**引擎共用**：TUI 和 Desktop 都是 CLI 引擎的“图形化外壳”。

　　**独立运行**：这三者都是**独立应用**，意味着不需要安装 VSCode 或 Antigravity 也可以在系统中完美运行。

　　**底座逻辑**：CLI 是唯一的“底座”，Desktop 和 TUI 实际上是连接到本地 CLI 服务上的客户端（Client）。

　　─────────────────────────────

第二章：OpenCode 编辑器扩展 (Extension)

　　为了让独立应用的 AI 能力进入开发者的日常编码环境，OpenCode 提供了针对不同编辑器的“连接器”。

2.1 扩展的本质

　　编辑器的扩展程序本身不具备 AI 运算能力。它们的主要任务是在编辑器的界面（如侧边栏、终端栏）开一个窗口，并将编辑器里的代码上下文发送给系统里安装的 OpenCode CLI。

2.2 VSCode 扩展生态

　　在 VSCode Marketplace 中，你会搜索到多种后缀的 OpenCode 产品，它们都是这个扩展体系的一部分：

　　`OpenCode` (基础版)

　　`OpenCode Beta` (目前的主流原生界面)

　　`OpenCode UX+ / GUI` (前瞻功能测试版)

　　─────────────────────────────

第三章：插件与 OpenCode CLI 的连接关系

　　理解插件与 CLI 的连接是解决“为什么装了插件不能用”的关键。

3.1 “大脑”与“面孔”的插座模式

　　**CLI 是插座 (Socket)**：它是后端服务。

　　**Plugin 是电器 (Appliance)**：它是前端展示。

　　**ACP 协议**：两者之间通过 **Agent Client Protocol (ACP)** 进行实时通信。

3.2 运行依赖

　　**必须安装模式**：在使用任何编辑器插件之前，系统里必须已经存在一个处于“监听”状态或可执行的 `opencode` CLI 程序。

　　**连接逻辑**：插件启动 -> 寻找本地 CLI 路径 -> 握手建立连接 -> 开始收发代码上下文。

　　─────────────────────────────

第四章：各插件版本之间的差异与冲突

　　虽然都连着 CLI，但不同名称的插件在功能上有所重叠。

4.1 核心差异对比矩阵

　　交互偏好

　　物理形态

　　冲突情况

　　OpenCode (Standard)

　　终端控

　　开启底部垂直分屏终端

　　占用终端资源，界面极简。

　　OpenCode Beta

　　原生控

　　侧边栏原生 GUI 聊天框

　　推荐。最符合 Copilot/Cursor 用户习惯。

　　OpenCode UX+

　　极客控

　　独立 Webview 或增强侧边栏

　　包含实验性功能，可能不稳定。

　　Sidebar TUI

　　混合控

　　侧边栏里开终端

　　字符界面与侧边栏的折衷。

4.2 插件间的互斥建议

　　**不要全装**：由于它们都会监听相同的快捷键（如 `Ctrl + Esc`）并尝试连接同一个 CLI 引擎，安装多个会导致 UI 弹窗重叠和连接不稳定。

　　─────────────────────────────

第五章：Antigravity 环境下的选型与使用建议

　　在作为 AI 助手的 Antigravity 环境中，如何科学选择插件来构建你的“最强编程阵列”？

5.1 如何推演选型路线？

　　**第一步：安装底座**。无论你选哪个插件，先找 Antigravity 帮你确保 `OpenCode CLI` 安装成功。

　　**第二步：明确你的操作主场**。

　　**如果你经常要在不同编辑器切换**：建议多使用 **Desktop App**，它保持了跨编辑器的对话一致性。

　　**如果你全程在 VSCode 中**：

　　首选 **OpenCode Beta**。它的侧边栏模式能与编辑器代码高亮完美配合。

　　避开 **OpenCode (Standard)** 产生的 Windows 快捷键冲突（`Ctrl + Esc` 会弹出开始菜单）。

5.2 协同作战建议 (Antigravity + OpenCode)

　　**让 Antigravity 管理环境**：我对文件系统和终端有最高控制权，我可以监控 OpenCode CLI 的健康度。

　　**让 OpenCode 执行编码**：利用 OpenCode 的 **Build Mode** 进行自动代码写入。

　　**Antigravity 负责“总结与提炼”**：如果 OpenCode 的对话太长太乱，你可以让我阅读它的对话日志，我来为你整理成技术文档。