# utools-opencode

uTools 插件：在任意目录快速打开 OpenCode TUI / Web。

## 使用方式

### 快速打开

在 uTools 搜索框中输入：

- **opencode** — 打开 OpenCode 终端模式
- **opencode web** — 打开 OpenCode Web 模式

### 智能目录识别

- **中键选中目录**：在资源管理器中鼠标中键点击文件夹，超级面板自动出现「opencode（当前目录）」，在选中目录打开
- **资源管理器窗口**：当前活动窗口是资源管理器时呼出 uTools，自动识别当前浏览的目录
- 以上两种方式均支持 TUI 和 Web 两种模式

### 全局打开

如果不在资源管理器中，opencode 将在全局配置目录（默认 `~/.config/opencode`）中打开。

## 设置

输入 **opencode设置** 进入设置页面。

### 功能开关

| 开关 | 说明 |
|------|------|
| 目录匹配 | 中键选目录 / 资源管理器窗口识别目录 |
| opencode TUI | 终端模式指令 |
| opencode web | Web 模式指令 |

关闭开关后，对应指令会立即从搜索框和超级面板中消失。

### 自定义配置

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| OpenCode 路径 | 可执行文件路径 | 使用 PATH 中的 opencode |
| 全局目录 | 无目录匹配时的工作目录 | ~/.config/opencode |
| 终端 | 打开的终端类型 | PowerShell |
| 附加参数 | 传递给 opencode 的额外参数 | 无 |

终端类型可选 PowerShell、CMD、Windows Terminal。

### 安装检测

设置页面会自动检测 OpenCode 是否已安装。未安装时：

- 显示 Go 和 npm 两种安装命令，支持一键复制
- 提供「在终端中安装」按钮，自动打开 PowerShell 执行安装
- 提供 GitHub Releases 下载链接