@xiaoqiong0v0/opencode-browser-tool 1.2.0 → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +60 -8
- package/dist/binary.js +569 -0
- package/dist/client.js +21 -5
- package/dist/index.js +3 -0
- package/package.json +1 -1
- package/dist/devices.js +0 -26
package/README.md
CHANGED
|
@@ -13,6 +13,32 @@ opencode 插件:Tauri 多 Webview 浏览器外壳 + 零注入视觉元素选
|
|
|
13
13
|
}
|
|
14
14
|
```
|
|
15
15
|
|
|
16
|
+
## 二进制获取(bt-shell)
|
|
17
|
+
|
|
18
|
+
插件依赖 Rust 外壳 `bt-shell`。默认**首次使用时后台自动下载**对应平台的 Release 资产到
|
|
19
|
+
`~/.opencode/plugins-data/opencode-browser-tool/<平台三元组>/bt-shell[.exe]`(Windows 即
|
|
20
|
+
`%USERPROFILE%\.opencode\plugins-data\opencode-browser-tool\<triple>\bt-shell.exe`),并**就地覆盖**同一路径
|
|
21
|
+
(不按插件版本建目录);同目录另有 `bt-shell.version.json` 记录该可执行文件的来源
|
|
22
|
+
(`tag` / `asset` / `sha256` / `size` / `downloadedAt` / `sourceUrl`)。下载用 Release 的 `SHA256SUMS` 做
|
|
23
|
+
sha256 校验(**幂等**:sha 与当前 release 期望值一致即跳过;**原子**替换;跨进程 `.lock`;Linux 下载后 `chmod 755`)。下载后台进行、**不阻塞 opencode 启动**;未就绪时工具调用会给出
|
|
24
|
+
明确提示(下载进度 / 失败原因),不会假装成功。
|
|
25
|
+
|
|
26
|
+
平台支持与系统依赖:
|
|
27
|
+
|
|
28
|
+
- Windows x64 → `x86_64-pc-windows-msvc`(WebView2,系统自带)
|
|
29
|
+
- Linux x64 → `x86_64-unknown-linux-gnu`,需系统库 `libwebkit2gtk-4.1` / `libgtk-3`(及 appindicator / rsvg 等,见 [docs/linux-support.md](./docs/linux-support.md) §5)
|
|
30
|
+
- 其它平台:暂不提供预编译,请用 `BT_SHELL_PATH` 指定自行构建的二进制
|
|
31
|
+
|
|
32
|
+
> 代理:下载优先调用系统 `curl`(自动遵循 `HTTPS_PROXY`/`HTTP_PROXY`/`NO_PROXY`);无 curl 时回退 Node `fetch`。
|
|
33
|
+
|
|
34
|
+
## 版本与产物策略
|
|
35
|
+
|
|
36
|
+
- **中间位(minor)**:只要**动了 Rust / 要发新 exe**,就升 `x.Y.0`(如 `1.2.x → 1.3.0`),并为该 `x.Y.0` 新建/更新 Release 挂上二进制。
|
|
37
|
+
- **末位(patch)**:**只改插件**(TS/配置/文档,不改 Rust)时只升末位(如 `1.2.0 → 1.2.1`),**不新发二进制**。
|
|
38
|
+
- **二进制产物永远只挂在 `x.Y.0` 的 Release 上**:插件的 patch 版本**自动推导**出对应的二进制 tag(把 patch 归 0):插件 `1.2.1` → 二进制 tag `v1.2.0`;`1.3.0` → `v1.3.0`;`1.3.0-beta.1` → `v1.3.0`。
|
|
39
|
+
- 因此纯插件改动升级时**复用同一份二进制**,不会重下;只有当推导出的 `x.Y.0` 与缓存中二进制的 sha 不一致(发新 exe)时才重新下载。
|
|
40
|
+
- 如需指向别的二进制发布(如临时验证),用 `BT_SHELL_VERSION` 显式覆盖——它表示**二进制发布版本**(形如 `1.2.0`),**原样使用、不做归 0 推导**。
|
|
41
|
+
|
|
16
42
|
## 配置
|
|
17
43
|
|
|
18
44
|
配置文件:`~/.config/opencode/browser-tool.jsonc`(首次运行自动生成)
|
|
@@ -32,7 +58,10 @@ opencode 插件:Tauri 多 Webview 浏览器外壳 + 零注入视觉元素选
|
|
|
32
58
|
- `BT_BROWSERS_PATH` — 浏览器缓存目录
|
|
33
59
|
- `BT_SHELL_URL` — **附着模式**:连接到已运行的 shell(完整基地址,如 `http://127.0.0.1:18280`),优先级最高
|
|
34
60
|
- `BT_SHELL_PORT` — **附着模式**:仅指定端口,等价于 `http://127.0.0.1:<port>`
|
|
35
|
-
- `BT_SHELL_PATH` — **启动模式**:指定要 spawn 的 Rust shell
|
|
61
|
+
- `BT_SHELL_PATH` — **启动模式**:指定要 spawn 的 Rust shell 二进制路径(开发用;优先级最高,覆盖自动下载与本地构建)
|
|
62
|
+
- `BT_SHELL_NO_DOWNLOAD` — 设为 `1` 时不自动下载(状态 `disabled`;需自行放置二进制或配合 `BT_SHELL_PATH`)
|
|
63
|
+
- `BT_SHELL_DOWNLOAD_BASE` — 覆盖下载根(默认 GitHub Release `https://github.com/xiaoqiong0v0/opencode-browser-tool/releases/download`),可指向镜像/自建
|
|
64
|
+
- `BT_SHELL_VERSION` — 显式指定**二进制发布版本**(形如 `1.2.0`,即 `x.Y.0` 的 Release;**原样使用、不做归 0 推导**;不设时由插件版本自动推导)
|
|
36
65
|
|
|
37
66
|
> **附着模式 vs 启动模式**:设置了 `BT_SHELL_URL`(优先)或 `BT_SHELL_PORT` 时进入附着模式——插件**不 spawn** 任何进程,直接连接该地址的外部 shell;两者都未设置时按启动模式 spawn 本地二进制(`BT_SHELL_PATH` 可覆盖查找路径)。附着模式下 `bt_close` 只关闭浏览器窗口并断开连接,**不会**结束外部 shell 进程(进程不归插件管理)。
|
|
38
67
|
|
|
@@ -76,12 +105,13 @@ opencode(Bun)
|
|
|
76
105
|
|
|
77
106
|
| 类别 | 工具 |
|
|
78
107
|
|------|------|
|
|
79
|
-
| **导航** | `bt_navigate`, `bt_go_back`, `bt_go_forward`, `bt_reload`, `bt_close` |
|
|
108
|
+
| **导航** | `bt_navigate`, `bt_go_back`, `bt_go_forward`, `bt_reload`, `bt_open_window`, `bt_close` |
|
|
80
109
|
| **交互** | `bt_click`, `bt_fill`, `bt_clear`, `bt_select`, `bt_hover`, `bt_drag`, `bt_press_key`, `bt_upload_file`, `bt_iframe_click`, `bt_iframe_fill` |
|
|
81
110
|
| **标签页** | `bt_list_tabs`, `bt_switch_tab`, `bt_new_tab`, `bt_close_tab`, `bt_click_and_switch_tab` |
|
|
82
111
|
| **信息** | `bt_screenshot`, `bt_evaluate`, `bt_get_visible_text`, `bt_get_visible_html`, `bt_console_logs`, `bt_get_browser_status`, `bt_get_element_state`, `bt_get_dropdown_options`, `bt_list_records`, `bt_expect_response`, `bt_assert_response`, `bt_get_accessibility_tree` |
|
|
83
112
|
| **滚动/等待** | `bt_scroll`, `bt_scroll_to_element`, `bt_wait_for_selector`, `bt_resize`, `bt_set_device` |
|
|
84
113
|
| **设备/工具** | `bt_custom_user_agent`, `bt_devtools`(开发者工具开关) |
|
|
114
|
+
| **媒体/本地** | `bt_fake_audio`, `bt_fake_video`, `bt_profile`, `bt_exports`, `bt_lookup` |
|
|
85
115
|
| **其他** | `bt_show_notification`, `bt_read_record_content` |
|
|
86
116
|
|
|
87
117
|
### 工具参数
|
|
@@ -97,7 +127,7 @@ opencode(Bun)
|
|
|
97
127
|
| `bt_drag` | `sourceSelector`, `targetSelector`(string) 必填 | 从源元素拖到目标元素 |
|
|
98
128
|
| `bt_press_key` | `key`(string) 必填, `selector`(string) 可选 | 按键(如 Enter/Escape);可指定聚焦元素 |
|
|
99
129
|
| `bt_upload_file` | `selector`, `filePath`(string) 必填 | 向文件输入框上传文件 |
|
|
100
|
-
| `bt_screenshot` | `selector`(string)
|
|
130
|
+
| `bt_screenshot` | `selector`(string) 可选 | 截取视口;指定 `selector` 时截该元素区域(PNG 图片附件) |
|
|
101
131
|
| `bt_evaluate` | `script`(string) 必填 | 在页面执行 JS 并返回 JSON 结果 |
|
|
102
132
|
| `bt_get_visible_text` | `selector`(string) 可选 | 返回页面/元素可见文本 |
|
|
103
133
|
| `bt_get_visible_html` | `selector`, `removeScripts`(boolean), `removeComments`(boolean), `maxLength`(number) | 返回页面/元素 HTML |
|
|
@@ -123,7 +153,13 @@ opencode(Bun)
|
|
|
123
153
|
| `bt_get_element_state` | `selector`(string) 必填 | 返回元素可见性/文本/位置 |
|
|
124
154
|
| `bt_scroll_to_element` | `selector`(string) 必填 | 滚动到元素 |
|
|
125
155
|
| `bt_get_dropdown_options` | `selector`(string) 必填 | 列出下拉框选项 |
|
|
126
|
-
| `bt_custom_user_agent` | `userAgent`(string) 必填 | 设置自定义 User-Agent
|
|
156
|
+
| `bt_custom_user_agent` | `userAgent`(string) 必填 | 设置自定义 User-Agent(Windows/Linux 支持;macOS 未实现) |
|
|
157
|
+
| `bt_open_window` | 无 | 打开浏览器窗口(未启动则启动;已启动幂等) |
|
|
158
|
+
| `bt_fake_audio` | `kind`(string) 必填,`data`/`freq`/`durMs`/`notes`/`digits`(string),`loop`(boolean) | 向页面注入模拟麦克风音频 |
|
|
159
|
+
| `bt_fake_video` | `kind`(string) 必填,`data`/`url`(string),`loop`(boolean) | 向页面注入模拟摄像头画面 |
|
|
160
|
+
| `bt_profile` | `set` / `delete`(string) 可选 | user-data 配置管理:空参列出;`--set` 切换并重启服务;`--delete` 删除(默认/激活项除外) |
|
|
161
|
+
| `bt_exports` | 无 | 显示导出目录与 Edge/Chrome 导出指引 |
|
|
162
|
+
| `bt_lookup` | `csv`, `url`(string) 必填 | 从密码 CSV 按站点匹配并返回凭据(写入临时文件,不进上下文) |
|
|
127
163
|
| `bt_expect_response` | `url`(string) 必填 | 记录期望匹配的响应模式,清空响应历史后重新捕获 |
|
|
128
164
|
| `bt_assert_response` | `id`(string) 必填 | 断言是否存在匹配的响应(返回 `url` + `status` 码) |
|
|
129
165
|
| `bt_get_accessibility_tree` | `selector`, `maxDepth`(number) | 返回页面可访问性树(role/name/value 嵌套结构) |
|
|
@@ -141,7 +177,7 @@ opencode(Bun)
|
|
|
141
177
|
| iPhone | `iphone-15-pro`, `iphone-14`, `iphone-13`, `iphone-12`, `iphone-se` |
|
|
142
178
|
| Android | `pixel-7`, `pixel-6`, `galaxy-s23` |
|
|
143
179
|
|
|
144
|
-
切换时自动调整窗口尺寸并运行时修改 UA(UA
|
|
180
|
+
切换时自动调整窗口尺寸并运行时修改 UA(UA 修改 Windows/Linux 支持;macOS 未实现)。
|
|
145
181
|
|
|
146
182
|
## 批注 / 截图
|
|
147
183
|
|
|
@@ -161,12 +197,25 @@ opencode(Bun)
|
|
|
161
197
|
|
|
162
198
|
## 发布
|
|
163
199
|
|
|
200
|
+
版本规则见上文「版本与产物策略」:**动了 Rust / 发新 exe 才升中间位(minor)**,纯插件改动只升末位(patch);**二进制资产只挂在 `x.Y.0` 的 Release 上**(插件 patch 版本由自身版本推导二进制 tag)。
|
|
201
|
+
|
|
164
202
|
```bash
|
|
165
|
-
|
|
203
|
+
# 1) 定版本(动 Rust 用 minor;纯插件用 patch)
|
|
204
|
+
npm version <x.y.z> --no-git-tag-version
|
|
205
|
+
# 2) 构建插件产物(清空 dist 再建,避免孤儿 .js)
|
|
206
|
+
npm run build
|
|
207
|
+
# 3) 提交 + 打 tag + 建 Release(tag = v<x.y.z>)
|
|
208
|
+
# 只有动 Rust 时才需要为 x.Y.0 上传各平台二进制 + SHA256SUMS:
|
|
209
|
+
gh release create v<x.y.z> --title v<x.y.z> --notes "..."
|
|
210
|
+
gh release upload v<x.y.z> <各平台二进制> SHA256SUMS --clobber
|
|
211
|
+
# 4) 发布 npm 包(只含 dist;不含二进制)
|
|
166
212
|
npm publish
|
|
167
213
|
```
|
|
168
214
|
|
|
169
|
-
|
|
215
|
+
- `SHA256SUMS` 每行 `<sha256> <文件名>`(两空格),文件名不带路径。
|
|
216
|
+
- npm 包只带 `dist/`(`files: ["dist"]`);原生二进制由运行时从 Release 下载(见「二进制获取」)。
|
|
217
|
+
- **先本地自测**:可用 `.tmp/publish-local.ps1` 覆盖到 opencode 插件缓存后重启验证(做法与脚本模板见技能 `xqv-plugin-release`)。
|
|
218
|
+
- **部署顺序(exe 文件锁)**:若已有 opencode 实例在跑,`cargo build --release` 会在最后一步报 `failed to remove file ... (os error 5)`(产物不可信)→ 先**退出 opencode**(确认 shell 也退出)→ 构建 → 重新启动。TS 改动需 `npm run build` 重建 `dist/`。
|
|
170
219
|
|
|
171
220
|
## 开发
|
|
172
221
|
|
|
@@ -179,4 +228,7 @@ npm run build
|
|
|
179
228
|
## 文档
|
|
180
229
|
|
|
181
230
|
- [docs/v5-tauri-architecture.md](./docs/v5-tauri-architecture.md) — V5 当前架构
|
|
182
|
-
- [docs/implementation.md](./docs/implementation.md) —
|
|
231
|
+
- [docs/implementation.md](./docs/implementation.md) — 实施状态与关键经验
|
|
232
|
+
- [docs/linux-support.md](./docs/linux-support.md) — Linux 适配、硬性约定,及 §7「平台能力与降级策略」(可信通道/降级矩阵)
|
|
233
|
+
- [docs/linux-verification.md](./docs/linux-verification.md) — Kali/Linux 可信输入复验清单(含 `tests/manual/verify-linux.sh` 一键 15 项)
|
|
234
|
+
- [docs/README.md](./docs/README.md) — docs 索引
|
package/dist/binary.js
ADDED
|
@@ -0,0 +1,569 @@
|
|
|
1
|
+
//! 二进制分发:从 GitHub Release 下载 bt-shell 到插件数据目录并校验
|
|
2
|
+
//!
|
|
3
|
+
//! 目录布局(固定路径,就地覆盖;不按插件版本建目录,避免累积与无效重下):
|
|
4
|
+
//! `<pluginDataDir>/<triple>/bt-shell[.exe]` 可执行文件
|
|
5
|
+
//! `<pluginDataDir>/<triple>/bt-shell.version.json` 来源旁文件(tag/asset/sha256/size/…)
|
|
6
|
+
//!
|
|
7
|
+
//! 设计要点:
|
|
8
|
+
//! - 幂等:目标存在 **且** sha256 与"当前插件版本对应 release 的 SHA256SUMS"一致 → 跳过;
|
|
9
|
+
//! **每次都拉 SHA256SUMS 校验**(取不到即失败,不跳过校验),但不会因插件版本变化无条件重下
|
|
10
|
+
//! - 原子:下载到 `<target>.part`,校验通过后 `rename` 替换到最终路径
|
|
11
|
+
//! - 并发:同进程共享 Promise;跨进程用 `<target>.lock`(未过期则等待复用,避免重复下载)
|
|
12
|
+
//! - 有界:`ensureBinary(timeoutMs)` 等待至就绪/超时,不无限等待
|
|
13
|
+
//! - 迁移:启动清理旧布局的版本目录(`<pluginDataDir>/<x.y.z>/`),可移动一份合法资产省一次下载
|
|
14
|
+
//! - 代理:优先用系统 `curl`(自动遵循 HTTPS_PROXY/HTTP_PROXY),不可用时回退 `fetch`
|
|
15
|
+
//!
|
|
16
|
+
//! 环境变量:BT_SHELL_PATH / BT_SHELL_NO_DOWNLOAD / BT_SHELL_DOWNLOAD_BASE / BT_SHELL_VERSION
|
|
17
|
+
import { spawn, spawnSync } from "child_process";
|
|
18
|
+
import { createHash } from "crypto";
|
|
19
|
+
import { chmodSync, closeSync, createWriteStream, existsSync, mkdirSync, openSync, readdirSync, readFileSync, readSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, } from "fs";
|
|
20
|
+
import { dirname, resolve } from "path";
|
|
21
|
+
import { fileURLToPath, pathToFileURL } from "url";
|
|
22
|
+
import { getPluginDataDir } from "./config/index.js";
|
|
23
|
+
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
24
|
+
/** 默认下载根(不含 `/v<version>/<asset>`),可用 BT_SHELL_DOWNLOAD_BASE 覆盖 */
|
|
25
|
+
const DEFAULT_DOWNLOAD_BASE = "https://github.com/xiaoqiong0v0/opencode-browser-tool/releases/download";
|
|
26
|
+
/** 跨进程锁过期时间(ms):超过则视为陈旧锁可接管 */
|
|
27
|
+
const LOCK_STALE_MS = 10 * 60 * 1000;
|
|
28
|
+
/** 等待其它进程下载完成的上限(ms) */
|
|
29
|
+
const WAIT_OTHER_PROCESS_MS = 60 * 1000;
|
|
30
|
+
/** 版本旁文件名 */
|
|
31
|
+
const SIDECAR_NAME = "bt-shell.version.json";
|
|
32
|
+
/** 旧布局版本目录名(如 `1.2.0`;仅删符合该形态的目录) */
|
|
33
|
+
const LEGACY_VERSION_DIR_RE = /^\d+\.\d+\.\d+([-+][0-9A-Za-z.-]+)?$/;
|
|
34
|
+
/** 当前平台 → Release 资产信息;不支持的平台返回 null */
|
|
35
|
+
export function platformInfo() {
|
|
36
|
+
const { platform, arch } = process;
|
|
37
|
+
if (platform === "win32" && arch === "x64") {
|
|
38
|
+
return { triple: "x86_64-pc-windows-msvc", assetName: "bt-shell-x86_64-pc-windows-msvc.exe" };
|
|
39
|
+
}
|
|
40
|
+
if (platform === "linux" && arch === "x64") {
|
|
41
|
+
return { triple: "x86_64-unknown-linux-gnu", assetName: "bt-shell-x86_64-unknown-linux-gnu" };
|
|
42
|
+
}
|
|
43
|
+
return null;
|
|
44
|
+
}
|
|
45
|
+
/** 插件自身版本(读包元数据;不受 BT_SHELL_VERSION 影响) */
|
|
46
|
+
export function pluginVersion() {
|
|
47
|
+
try {
|
|
48
|
+
const pkg = JSON.parse(readFileSync(resolve(__dirname, "..", "package.json"), "utf-8"));
|
|
49
|
+
if (pkg?.version)
|
|
50
|
+
return String(pkg.version);
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
// 忽略:回退占位版本
|
|
54
|
+
}
|
|
55
|
+
return "0.0.0";
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* 二进制发布版本:取插件版本的 `<major>.<minor>.0`(忽略预发布/构建元数据)。
|
|
59
|
+
*
|
|
60
|
+
* 版本策略:二进制产物**只挂在 `x.Y.0` 的 Release 上** —— 动了 Rust 升中间位(minor)并发新 exe;
|
|
61
|
+
* 只改插件升末位(patch),沿用同一二进制 tag。故插件需由自身版本推导二进制 tag:
|
|
62
|
+
* `1.2.1 → 1.2.0`、`1.3.0 → 1.3.0`、`1.3.0-beta.1 → 1.3.0`、`2.0.5 → 2.0.0`。
|
|
63
|
+
*/
|
|
64
|
+
export function binaryReleaseVersion(version) {
|
|
65
|
+
const m = String(version).trim().match(/^v?(\d+)\.(\d+)(?:\.\d+)?/);
|
|
66
|
+
if (!m)
|
|
67
|
+
return "0.0.0";
|
|
68
|
+
return `${m[1]}.${m[2]}.0`;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* 实际要拉取的二进制发布版本:
|
|
72
|
+
* - `BT_SHELL_VERSION` 显式指定时**原样使用**(不做归 0 推导;形如 `1.2.0`,不带 `v`)
|
|
73
|
+
* - 否则由插件版本推导(`binaryReleaseVersion`)
|
|
74
|
+
*/
|
|
75
|
+
export function binaryVersion() {
|
|
76
|
+
const env = process.env.BT_SHELL_VERSION?.trim();
|
|
77
|
+
if (env)
|
|
78
|
+
return env;
|
|
79
|
+
return binaryReleaseVersion(pluginVersion());
|
|
80
|
+
}
|
|
81
|
+
/** 二进制发布 tag:`v<binaryVersion>` */
|
|
82
|
+
export function binaryTag() {
|
|
83
|
+
return `v${binaryVersion()}`;
|
|
84
|
+
}
|
|
85
|
+
/** Release 下载根(含推导后的二进制版本):`<base>/v<major>.<minor>.0` */
|
|
86
|
+
function releaseBase() {
|
|
87
|
+
const base = (process.env.BT_SHELL_DOWNLOAD_BASE?.trim() || DEFAULT_DOWNLOAD_BASE).replace(/\/+$/, "");
|
|
88
|
+
return `${base}/v${binaryVersion()}`;
|
|
89
|
+
}
|
|
90
|
+
/** 本地可执行文件名(固定,不带 triple/版本) */
|
|
91
|
+
function localBinaryName() {
|
|
92
|
+
return process.platform === "win32" ? "bt-shell.exe" : "bt-shell";
|
|
93
|
+
}
|
|
94
|
+
/** 本地 triple 目录名(不支持平台时用 `${platform}-${arch}` 占位) */
|
|
95
|
+
function localTriple() {
|
|
96
|
+
return platformInfo()?.triple ?? `${process.platform}-${process.arch}`;
|
|
97
|
+
}
|
|
98
|
+
/** 固定缓存路径:`<pluginDataDir>/<triple>/bt-shell[.exe]` */
|
|
99
|
+
export function cachedBinaryPath() {
|
|
100
|
+
return resolve(getPluginDataDir(), localTriple(), localBinaryName());
|
|
101
|
+
}
|
|
102
|
+
/** 版本旁文件路径(与可执行文件同目录) */
|
|
103
|
+
export function cachedSidecarPath() {
|
|
104
|
+
return resolve(dirname(cachedBinaryPath()), SIDECAR_NAME);
|
|
105
|
+
}
|
|
106
|
+
/** 供外部(工具提示)使用:二进制的三元组/文件名/下载 URL/缓存路径 */
|
|
107
|
+
export function getBinaryInfo() {
|
|
108
|
+
const info = platformInfo();
|
|
109
|
+
if (!info)
|
|
110
|
+
return null;
|
|
111
|
+
const path = cachedBinaryPath();
|
|
112
|
+
return {
|
|
113
|
+
pluginVersion: pluginVersion(),
|
|
114
|
+
version: binaryVersion(),
|
|
115
|
+
tag: binaryTag(),
|
|
116
|
+
triple: info.triple,
|
|
117
|
+
assetName: info.assetName,
|
|
118
|
+
url: `${releaseBase()}/${info.assetName}`,
|
|
119
|
+
sumsUrl: `${releaseBase()}/SHA256SUMS`,
|
|
120
|
+
path,
|
|
121
|
+
sidecarPath: cachedSidecarPath(),
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
// ---- 状态机 ----
|
|
125
|
+
let current = { state: "idle", path: undefined };
|
|
126
|
+
/** 同进程内共享的下载 Promise(并发只下载一次) */
|
|
127
|
+
let inflight = null;
|
|
128
|
+
export function getBinaryStatus() {
|
|
129
|
+
return { ...current };
|
|
130
|
+
}
|
|
131
|
+
function setStatus(next) {
|
|
132
|
+
current = next;
|
|
133
|
+
}
|
|
134
|
+
/** 触发后台下载(幂等;fire-and-forget,失败不抛出) */
|
|
135
|
+
export function startDownload() {
|
|
136
|
+
if (inflight)
|
|
137
|
+
return;
|
|
138
|
+
if (current.state === "ready" || current.state === "disabled" || current.state === "unsupported")
|
|
139
|
+
return;
|
|
140
|
+
inflight = doDownload()
|
|
141
|
+
.catch(() => {
|
|
142
|
+
// 失败原因已写入状态;这里吞掉,避免影响调用方(opencode 启动)
|
|
143
|
+
})
|
|
144
|
+
.finally(() => {
|
|
145
|
+
inflight = null;
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
/** 等待二进制就绪或超时(不无限等待);超时返回当前状态 */
|
|
149
|
+
export async function ensureBinary(timeoutMs = 20000) {
|
|
150
|
+
startDownload();
|
|
151
|
+
const deadline = Date.now() + timeoutMs;
|
|
152
|
+
while (Date.now() < deadline) {
|
|
153
|
+
const s = getBinaryStatus();
|
|
154
|
+
if (s.state !== "idle" && s.state !== "downloading")
|
|
155
|
+
return s;
|
|
156
|
+
await sleep(200);
|
|
157
|
+
}
|
|
158
|
+
return getBinaryStatus();
|
|
159
|
+
}
|
|
160
|
+
/** 就绪状态的可读提示文案(供工具在未就绪时返回) */
|
|
161
|
+
export function describeBinaryStatus(s) {
|
|
162
|
+
switch (s.state) {
|
|
163
|
+
case "ready":
|
|
164
|
+
return s.path ?? "ready";
|
|
165
|
+
case "downloading":
|
|
166
|
+
return `bt-shell 正在下载(${s.progress ?? 0}%)… 稍后重试`;
|
|
167
|
+
case "failed":
|
|
168
|
+
return `bt-shell 下载失败:${s.reason ?? "未知原因"};可用 BT_SHELL_DOWNLOAD_BASE 换源、或 BT_SHELL_PATH 手动指定二进制`;
|
|
169
|
+
case "disabled":
|
|
170
|
+
return `bt-shell 自动下载已禁用(BT_SHELL_NO_DOWNLOAD=1);请用 BT_SHELL_PATH 指定二进制,或把它放到 ${s.path ?? cachedBinaryPath()}`;
|
|
171
|
+
case "unsupported":
|
|
172
|
+
return `bt-shell 暂不支持当前平台:${s.reason ?? `${process.platform}/${process.arch}`}`;
|
|
173
|
+
default:
|
|
174
|
+
return "bt-shell 尚未就绪,请稍后重试";
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
// ---- 下载主流程 ----
|
|
178
|
+
async function doDownload() {
|
|
179
|
+
const path = cachedBinaryPath();
|
|
180
|
+
if (process.env.BT_SHELL_NO_DOWNLOAD === "1") {
|
|
181
|
+
setStatus({ state: "disabled", reason: "BT_SHELL_NO_DOWNLOAD=1", path });
|
|
182
|
+
return;
|
|
183
|
+
}
|
|
184
|
+
const info = platformInfo();
|
|
185
|
+
if (!info) {
|
|
186
|
+
setStatus({ state: "unsupported", reason: `${process.platform}/${process.arch}`, path });
|
|
187
|
+
return;
|
|
188
|
+
}
|
|
189
|
+
const finalPath = path;
|
|
190
|
+
const partPath = `${finalPath}.part`;
|
|
191
|
+
const lockPath = `${finalPath}.lock`;
|
|
192
|
+
const tag = binaryTag();
|
|
193
|
+
const sourceUrl = `${releaseBase()}/${info.assetName}`;
|
|
194
|
+
mkdirSync(dirname(finalPath), { recursive: true });
|
|
195
|
+
setStatus({ state: "downloading", progress: 0, path: finalPath });
|
|
196
|
+
// 1) 每次都拉 SHA256SUMS 做校验(取不到即失败,不跳过校验)
|
|
197
|
+
let sumsText;
|
|
198
|
+
try {
|
|
199
|
+
sumsText = await fetchText(`${releaseBase()}/SHA256SUMS`);
|
|
200
|
+
}
|
|
201
|
+
catch (e) {
|
|
202
|
+
const hint = notFoundHint(tag, e);
|
|
203
|
+
setStatus({
|
|
204
|
+
state: "failed",
|
|
205
|
+
reason: `无法获取 SHA256SUMS(不跳过校验):${errMsg(e)}${hint ? `;${hint}` : ""}`,
|
|
206
|
+
path: finalPath,
|
|
207
|
+
});
|
|
208
|
+
return;
|
|
209
|
+
}
|
|
210
|
+
const expected = parseSums(sumsText, info.assetName);
|
|
211
|
+
if (!expected) {
|
|
212
|
+
setStatus({ state: "failed", reason: `SHA256SUMS 中未找到 ${info.assetName}`, path: finalPath });
|
|
213
|
+
return;
|
|
214
|
+
}
|
|
215
|
+
// 2) 迁移:清理旧布局版本目录,必要时从旧目录移动合法资产(同盘 rename)
|
|
216
|
+
migrateLegacyDirs(info, finalPath, expected, sourceUrl);
|
|
217
|
+
// 3) 幂等:目标存在且 sha 与当前 release 期望一致 → 跳过(不重下)
|
|
218
|
+
if (existsSync(finalPath) && sha256File(finalPath) === expected) {
|
|
219
|
+
ensureSidecar(finalPath, info, expected, sourceUrl);
|
|
220
|
+
setStatus({ state: "ready", path: finalPath });
|
|
221
|
+
return;
|
|
222
|
+
}
|
|
223
|
+
// 4) 跨进程锁:抢不到则等其它进程下载完成
|
|
224
|
+
if (!acquireLock(lockPath)) {
|
|
225
|
+
const ok = await waitForValidFile(finalPath, expected, WAIT_OTHER_PROCESS_MS);
|
|
226
|
+
if (ok) {
|
|
227
|
+
ensureSidecar(finalPath, info, expected, sourceUrl);
|
|
228
|
+
setStatus({ state: "ready", path: finalPath });
|
|
229
|
+
}
|
|
230
|
+
else {
|
|
231
|
+
setStatus({ state: "failed", reason: "等待其它进程下载超时(可删除 .lock 后重试)", path: finalPath });
|
|
232
|
+
}
|
|
233
|
+
return;
|
|
234
|
+
}
|
|
235
|
+
try {
|
|
236
|
+
try {
|
|
237
|
+
if (existsSync(partPath))
|
|
238
|
+
unlinkSync(partPath);
|
|
239
|
+
}
|
|
240
|
+
catch { }
|
|
241
|
+
await downloadTo(sourceUrl, partPath, (p) => setStatus({ state: "downloading", progress: p, path: finalPath }));
|
|
242
|
+
const got = sha256File(partPath);
|
|
243
|
+
if (got !== expected) {
|
|
244
|
+
safeUnlink(partPath);
|
|
245
|
+
setStatus({
|
|
246
|
+
state: "failed",
|
|
247
|
+
reason: `sha256 校验失败:期望 ${expected.slice(0, 12)}… 实际 ${got.slice(0, 12)}…`,
|
|
248
|
+
path: finalPath,
|
|
249
|
+
});
|
|
250
|
+
return;
|
|
251
|
+
}
|
|
252
|
+
renameSync(partPath, finalPath); // 原子替换
|
|
253
|
+
if (process.platform !== "win32") {
|
|
254
|
+
try {
|
|
255
|
+
chmodSync(finalPath, 0o755);
|
|
256
|
+
}
|
|
257
|
+
catch { }
|
|
258
|
+
}
|
|
259
|
+
ensureSidecar(finalPath, info, expected, sourceUrl);
|
|
260
|
+
setStatus({ state: "ready", path: finalPath });
|
|
261
|
+
}
|
|
262
|
+
catch (e) {
|
|
263
|
+
safeUnlink(partPath);
|
|
264
|
+
const hint = notFoundHint(tag, e);
|
|
265
|
+
setStatus({ state: "failed", reason: `${errMsg(e)}${hint ? `;${hint}` : ""}`, path: finalPath });
|
|
266
|
+
}
|
|
267
|
+
finally {
|
|
268
|
+
releaseLock(lockPath);
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
// ---- 迁移:旧布局 `<pluginDataDir>/<x.y.z>/<triple>/<asset>` → 新固定路径 ----
|
|
272
|
+
/**
|
|
273
|
+
* 清理旧布局版本目录(仅匹配 `<x.y.z>` 形态,其它一律不碰)。
|
|
274
|
+
* - dry-run:先把清单打印到日志
|
|
275
|
+
* - 若新路径无合法文件,优先从旧目录"移动"一份 sha 匹配的资产(同盘 rename,省一次下载)
|
|
276
|
+
* - 随后删除全部旧版本目录
|
|
277
|
+
*/
|
|
278
|
+
function migrateLegacyDirs(info, finalPath, expected, sourceUrl) {
|
|
279
|
+
const dataDir = getPluginDataDir();
|
|
280
|
+
let entries;
|
|
281
|
+
try {
|
|
282
|
+
entries = readdirSync(dataDir, { withFileTypes: true });
|
|
283
|
+
}
|
|
284
|
+
catch {
|
|
285
|
+
return;
|
|
286
|
+
}
|
|
287
|
+
const legacyDirs = entries
|
|
288
|
+
.filter((e) => e.isDirectory() && LEGACY_VERSION_DIR_RE.test(e.name))
|
|
289
|
+
.map((e) => resolve(dataDir, e.name));
|
|
290
|
+
if (legacyDirs.length === 0)
|
|
291
|
+
return;
|
|
292
|
+
console.log(`[bt-shell][migrate] dry-run 旧版本目录清单: ${legacyDirs.join(", ")}`);
|
|
293
|
+
const newValid = existsSync(finalPath) && sha256File(finalPath) === expected;
|
|
294
|
+
if (!newValid) {
|
|
295
|
+
for (const dir of legacyDirs) {
|
|
296
|
+
const cand = resolve(dir, info.triple, info.assetName);
|
|
297
|
+
try {
|
|
298
|
+
if (existsSync(cand) && sha256File(cand) === expected) {
|
|
299
|
+
mkdirSync(dirname(finalPath), { recursive: true });
|
|
300
|
+
renameSync(cand, finalPath); // 同盘 rename
|
|
301
|
+
console.log(`[bt-shell][migrate] moved ${cand} -> ${finalPath}`);
|
|
302
|
+
break;
|
|
303
|
+
}
|
|
304
|
+
}
|
|
305
|
+
catch {
|
|
306
|
+
// 候选不可用则继续尝试下一个
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
else {
|
|
311
|
+
console.log(`[bt-shell][migrate] 新路径已有合法文件,保留 ${finalPath}`);
|
|
312
|
+
}
|
|
313
|
+
for (const dir of legacyDirs) {
|
|
314
|
+
try {
|
|
315
|
+
rmSync(dir, { recursive: true, force: true });
|
|
316
|
+
console.log(`[bt-shell][migrate] removed ${dir}`);
|
|
317
|
+
}
|
|
318
|
+
catch (e) {
|
|
319
|
+
console.log(`[bt-shell][migrate] remove failed ${dir}: ${errMsg(e)}`);
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
if (existsSync(finalPath) && sha256File(finalPath) === expected) {
|
|
323
|
+
ensureSidecar(finalPath, info, expected, sourceUrl, "migrated");
|
|
324
|
+
}
|
|
325
|
+
}
|
|
326
|
+
/** 写版本旁文件;已存在且 sha 一致则不动(避免无谓改写 mtime) */
|
|
327
|
+
function ensureSidecar(finalPath, info, sha256, sourceUrl, extra) {
|
|
328
|
+
const sidecarPath = resolve(dirname(finalPath), SIDECAR_NAME);
|
|
329
|
+
try {
|
|
330
|
+
if (existsSync(sidecarPath)) {
|
|
331
|
+
const prev = JSON.parse(readFileSync(sidecarPath, "utf-8"));
|
|
332
|
+
if (prev?.sha256 === sha256 &&
|
|
333
|
+
prev?.asset === info.assetName &&
|
|
334
|
+
prev?.tag === binaryTag()) {
|
|
335
|
+
return;
|
|
336
|
+
}
|
|
337
|
+
}
|
|
338
|
+
const version = {
|
|
339
|
+
tag: binaryTag(),
|
|
340
|
+
pluginVersion: pluginVersion(),
|
|
341
|
+
asset: info.assetName,
|
|
342
|
+
sha256,
|
|
343
|
+
size: statSync(finalPath).size,
|
|
344
|
+
downloadedAt: new Date().toISOString(),
|
|
345
|
+
sourceUrl,
|
|
346
|
+
};
|
|
347
|
+
writeFileSync(sidecarPath, JSON.stringify(version, null, 2), "utf-8");
|
|
348
|
+
console.log(`[bt-shell] 写入版本旁文件 ${sidecarPath}${extra ? ` (${extra})` : ""}`);
|
|
349
|
+
}
|
|
350
|
+
catch (e) {
|
|
351
|
+
console.log(`[bt-shell] 写入版本旁文件失败: ${errMsg(e)}`);
|
|
352
|
+
}
|
|
353
|
+
}
|
|
354
|
+
// ---- 下载实现:curl 优先(自动遵循系统代理),回退 fetch ----
|
|
355
|
+
let curlChecked = false;
|
|
356
|
+
let curlOk = false;
|
|
357
|
+
function curlAvailable() {
|
|
358
|
+
if (!curlChecked) {
|
|
359
|
+
curlChecked = true;
|
|
360
|
+
try {
|
|
361
|
+
curlOk = spawnSync("curl", ["--version"], { stdio: "ignore" }).status === 0;
|
|
362
|
+
}
|
|
363
|
+
catch {
|
|
364
|
+
curlOk = false;
|
|
365
|
+
}
|
|
366
|
+
}
|
|
367
|
+
return curlOk;
|
|
368
|
+
}
|
|
369
|
+
async function downloadTo(url, dest, onProgress) {
|
|
370
|
+
if (curlAvailable())
|
|
371
|
+
return downloadWithCurl(url, dest, onProgress);
|
|
372
|
+
return downloadWithFetch(url, dest, onProgress);
|
|
373
|
+
}
|
|
374
|
+
/** 用系统 curl 下载(curl 自动读取 HTTPS_PROXY/HTTP_PROXY/NO_PROXY 并跟随重定向) */
|
|
375
|
+
async function downloadWithCurl(url, dest, onProgress) {
|
|
376
|
+
const total = curlContentLength(url);
|
|
377
|
+
await new Promise((resolvePromise, reject) => {
|
|
378
|
+
const child = spawn("curl", ["-L", "--fail", "--silent", "--show-error", "-o", dest, url], {
|
|
379
|
+
stdio: ["ignore", "ignore", "pipe"],
|
|
380
|
+
});
|
|
381
|
+
let stderr = "";
|
|
382
|
+
child.stderr?.on("data", (d) => {
|
|
383
|
+
stderr += d.toString();
|
|
384
|
+
});
|
|
385
|
+
const timer = setInterval(() => {
|
|
386
|
+
try {
|
|
387
|
+
const size = statSync(dest).size;
|
|
388
|
+
onProgress(total ? Math.min(100, Math.floor((size * 100) / total)) : undefined);
|
|
389
|
+
}
|
|
390
|
+
catch {
|
|
391
|
+
// .part 尚未创建
|
|
392
|
+
}
|
|
393
|
+
}, 200);
|
|
394
|
+
child.on("error", (e) => {
|
|
395
|
+
clearInterval(timer);
|
|
396
|
+
reject(e);
|
|
397
|
+
});
|
|
398
|
+
child.on("close", (code) => {
|
|
399
|
+
clearInterval(timer);
|
|
400
|
+
if (code === 0)
|
|
401
|
+
resolvePromise();
|
|
402
|
+
else
|
|
403
|
+
reject(new Error(`curl exit ${code}: ${stderr.trim() || "下载失败"}`));
|
|
404
|
+
});
|
|
405
|
+
});
|
|
406
|
+
}
|
|
407
|
+
/** HEAD 取 Content-Length(取不到返回 undefined;进度仍可降级为未知) */
|
|
408
|
+
function curlContentLength(url) {
|
|
409
|
+
try {
|
|
410
|
+
const r = spawnSync("curl", ["-sIL", url], { encoding: "utf-8", maxBuffer: 8 * 1024 * 1024 });
|
|
411
|
+
if (r.status !== 0 || !r.stdout)
|
|
412
|
+
return undefined;
|
|
413
|
+
let total;
|
|
414
|
+
for (const line of r.stdout.split(/\r?\n/)) {
|
|
415
|
+
const m = line.match(/^content-length:\s*(\d+)/i);
|
|
416
|
+
if (m) {
|
|
417
|
+
const n = Number(m[1]);
|
|
418
|
+
if (n > 0)
|
|
419
|
+
total = n;
|
|
420
|
+
}
|
|
421
|
+
}
|
|
422
|
+
return total;
|
|
423
|
+
}
|
|
424
|
+
catch {
|
|
425
|
+
return undefined;
|
|
426
|
+
}
|
|
427
|
+
}
|
|
428
|
+
async function downloadWithFetch(url, dest, onProgress) {
|
|
429
|
+
const res = await fetch(url, { redirect: "follow" });
|
|
430
|
+
if (!res.ok || !res.body)
|
|
431
|
+
throw new Error(`HTTP ${res.status} ${res.statusText}`);
|
|
432
|
+
const total = Number(res.headers.get("content-length") || 0) || undefined;
|
|
433
|
+
const out = createWriteStream(dest);
|
|
434
|
+
const reader = res.body.getReader();
|
|
435
|
+
let received = 0;
|
|
436
|
+
try {
|
|
437
|
+
for (;;) {
|
|
438
|
+
const { done, value } = await reader.read();
|
|
439
|
+
if (done)
|
|
440
|
+
break;
|
|
441
|
+
if (value) {
|
|
442
|
+
received += value.length;
|
|
443
|
+
out.write(Buffer.from(value));
|
|
444
|
+
onProgress(total ? Math.min(100, Math.floor((received * 100) / total)) : undefined);
|
|
445
|
+
}
|
|
446
|
+
}
|
|
447
|
+
}
|
|
448
|
+
finally {
|
|
449
|
+
await new Promise((r) => out.end(() => r()));
|
|
450
|
+
}
|
|
451
|
+
}
|
|
452
|
+
/** 取文本:fetch 优先(无代理时直连);失败回退 curl(代理环境) */
|
|
453
|
+
async function fetchText(url) {
|
|
454
|
+
try {
|
|
455
|
+
const res = await fetch(url, { redirect: "follow" });
|
|
456
|
+
if (!res.ok)
|
|
457
|
+
throw new Error(`HTTP ${res.status} ${res.statusText}`);
|
|
458
|
+
return await res.text();
|
|
459
|
+
}
|
|
460
|
+
catch (e) {
|
|
461
|
+
if (curlAvailable())
|
|
462
|
+
return curlText(url);
|
|
463
|
+
throw e;
|
|
464
|
+
}
|
|
465
|
+
}
|
|
466
|
+
function curlText(url) {
|
|
467
|
+
const r = spawnSync("curl", ["-sL", "--fail", url], { encoding: "utf-8", maxBuffer: 8 * 1024 * 1024 });
|
|
468
|
+
if (r.status !== 0)
|
|
469
|
+
throw new Error(`curl exit ${r.status}: ${(r.stderr || "").trim() || "获取失败"}`);
|
|
470
|
+
return r.stdout || "";
|
|
471
|
+
}
|
|
472
|
+
// ---- 校验/锁/工具 ----
|
|
473
|
+
/** 计算文件 sha256(hex,流式读取,避免大文件占内存) */
|
|
474
|
+
function sha256File(path) {
|
|
475
|
+
const hash = createHash("sha256");
|
|
476
|
+
const fd = openSync(path, "r");
|
|
477
|
+
const buf = Buffer.alloc(1024 * 256);
|
|
478
|
+
try {
|
|
479
|
+
for (;;) {
|
|
480
|
+
const n = readSync(fd, buf, 0, buf.length, null);
|
|
481
|
+
if (n <= 0)
|
|
482
|
+
break;
|
|
483
|
+
hash.update(buf.subarray(0, n));
|
|
484
|
+
}
|
|
485
|
+
}
|
|
486
|
+
finally {
|
|
487
|
+
closeSync(fd);
|
|
488
|
+
}
|
|
489
|
+
return hash.digest("hex");
|
|
490
|
+
}
|
|
491
|
+
/** 从 SHA256SUMS 解析目标资产的 sha256;找不到返回 null */
|
|
492
|
+
function parseSums(text, assetName) {
|
|
493
|
+
for (const line of text.split(/\r?\n/)) {
|
|
494
|
+
const m = line.trim().match(/^([0-9a-fA-F]{64})\s+\*?(.+)$/);
|
|
495
|
+
if (m && m[2].trim() === assetName)
|
|
496
|
+
return m[1].toLowerCase();
|
|
497
|
+
}
|
|
498
|
+
return null;
|
|
499
|
+
}
|
|
500
|
+
/** 抢占跨进程锁(原子创建);陈旧锁可接管;失败返回 false(表示其它进程在下载) */
|
|
501
|
+
function acquireLock(lockPath) {
|
|
502
|
+
try {
|
|
503
|
+
writeFileSync(lockPath, `${process.pid} ${Date.now()}`, { flag: "wx" });
|
|
504
|
+
return true;
|
|
505
|
+
}
|
|
506
|
+
catch (e) {
|
|
507
|
+
if (e?.code !== "EEXIST")
|
|
508
|
+
return true; // 其它错误不阻塞下载
|
|
509
|
+
try {
|
|
510
|
+
const age = Date.now() - statSync(lockPath).mtimeMs;
|
|
511
|
+
if (age > LOCK_STALE_MS) {
|
|
512
|
+
unlinkSync(lockPath);
|
|
513
|
+
return acquireLock(lockPath);
|
|
514
|
+
}
|
|
515
|
+
}
|
|
516
|
+
catch {
|
|
517
|
+
// 锁文件刚被删除等:重试一次
|
|
518
|
+
return acquireLock(lockPath);
|
|
519
|
+
}
|
|
520
|
+
return false;
|
|
521
|
+
}
|
|
522
|
+
}
|
|
523
|
+
function releaseLock(lockPath) {
|
|
524
|
+
safeUnlink(lockPath);
|
|
525
|
+
}
|
|
526
|
+
async function waitForValidFile(path, expected, timeoutMs) {
|
|
527
|
+
const deadline = Date.now() + timeoutMs;
|
|
528
|
+
while (Date.now() < deadline) {
|
|
529
|
+
try {
|
|
530
|
+
if (existsSync(path) && sha256File(path) === expected)
|
|
531
|
+
return true;
|
|
532
|
+
}
|
|
533
|
+
catch { }
|
|
534
|
+
await sleep(300);
|
|
535
|
+
}
|
|
536
|
+
return false;
|
|
537
|
+
}
|
|
538
|
+
function safeUnlink(path) {
|
|
539
|
+
try {
|
|
540
|
+
if (existsSync(path))
|
|
541
|
+
unlinkSync(path);
|
|
542
|
+
}
|
|
543
|
+
catch { }
|
|
544
|
+
}
|
|
545
|
+
function errMsg(e) {
|
|
546
|
+
return e instanceof Error ? e.message : String(e);
|
|
547
|
+
}
|
|
548
|
+
/** Release/资产不存在(HTTP 404 / curl exit 22)时的针对性提示 */
|
|
549
|
+
function notFoundHint(tag, e) {
|
|
550
|
+
const m = errMsg(e).toLowerCase();
|
|
551
|
+
const notFound = m.includes("404") || m.includes("curl exit 22") || m.includes("not found");
|
|
552
|
+
if (!notFound)
|
|
553
|
+
return "";
|
|
554
|
+
return `未找到该版本对应的 Release 资产(tag=${tag});若这是纯插件改动请确认二进制产物仍在 x.Y.0 的 Release 中,若动了 Rust 需先升中间版本号并新开/更新对应 Release`;
|
|
555
|
+
}
|
|
556
|
+
function sleep(ms) {
|
|
557
|
+
return new Promise((r) => setTimeout(r, ms));
|
|
558
|
+
}
|
|
559
|
+
// ---- 独立运行:`node dist/binary.js [--timeout=ms]`〔便于测试〕----
|
|
560
|
+
const isMain = process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href;
|
|
561
|
+
if (isMain) {
|
|
562
|
+
const arg = process.argv.find((a) => a.startsWith("--timeout="));
|
|
563
|
+
const timeout = arg ? Number(arg.split("=")[1]) : 20000;
|
|
564
|
+
startDownload();
|
|
565
|
+
ensureBinary(Number.isFinite(timeout) ? timeout : 20000).then((s) => {
|
|
566
|
+
console.log(JSON.stringify(s, null, 2));
|
|
567
|
+
process.exit(s.state === "ready" || s.state === "disabled" || s.state === "unsupported" ? 0 : 1);
|
|
568
|
+
});
|
|
569
|
+
}
|
package/dist/client.js
CHANGED
|
@@ -3,18 +3,23 @@ import { resolve, dirname } from "path";
|
|
|
3
3
|
import { existsSync } from "fs";
|
|
4
4
|
import { fileURLToPath } from "url";
|
|
5
5
|
import createLogger from "@xiaoqiong0v0/opencode-plugin-logger";
|
|
6
|
+
import { cachedBinaryPath, describeBinaryStatus, ensureBinary } from "./binary.js";
|
|
6
7
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
7
8
|
/** 就绪轮询超时(ms) */
|
|
8
9
|
const READY_TIMEOUT_MS = 20000;
|
|
9
10
|
/** 就绪轮询间隔(ms) */
|
|
10
11
|
const READY_POLL_INTERVAL_MS = 300;
|
|
11
|
-
// Rust
|
|
12
|
+
// Rust 二进制查找:优先级 BT_SHELL_PATH → 本地开发构建 → 下载缓存(binary.ts)
|
|
12
13
|
function resolveShellBinary() {
|
|
13
14
|
const platform = process.platform === "win32" ? "win-x64" : "linux-x64";
|
|
14
15
|
const bin = process.platform === "win32" ? "bt-shell.exe" : "bt-shell";
|
|
16
|
+
// 1) 显式指定:最优先(即使文件暂不存在也返回,由 startService 给出明确错误)
|
|
17
|
+
const envPath = process.env.BT_SHELL_PATH;
|
|
18
|
+
if (envPath)
|
|
19
|
+
return envPath;
|
|
20
|
+
// 2) 本地开发构建(保持开发者流程不变)
|
|
15
21
|
const cargoTargetDir = process.env.CARGO_TARGET_DIR;
|
|
16
22
|
const candidates = [
|
|
17
|
-
process.env.BT_SHELL_PATH,
|
|
18
23
|
resolve(__dirname, "bin", `bt-shell-${platform}.exe`),
|
|
19
24
|
resolve(__dirname, "bin", `bt-shell-${platform}`),
|
|
20
25
|
resolve(__dirname, "..", "rust", "target", "release", bin),
|
|
@@ -27,8 +32,8 @@ function resolveShellBinary() {
|
|
|
27
32
|
if (c && existsSync(c))
|
|
28
33
|
return c;
|
|
29
34
|
}
|
|
30
|
-
//
|
|
31
|
-
return
|
|
35
|
+
// 3) 下载缓存(未下载时由 startService 先 ensureBinary)
|
|
36
|
+
return cachedBinaryPath();
|
|
32
37
|
}
|
|
33
38
|
/** 解析附着模式目标地址:BT_SHELL_URL 优先,其次 BT_SHELL_PORT;均未设置返回 null */
|
|
34
39
|
function resolveAttachBaseUrl() {
|
|
@@ -129,7 +134,18 @@ async function attachToService(baseUrl) {
|
|
|
129
134
|
export async function startService(nodePath, browsersPath, sessionIsolation, browserType, userDataDir) {
|
|
130
135
|
const log = createLogger("opencode-browser-tool");
|
|
131
136
|
attachMode = false;
|
|
132
|
-
|
|
137
|
+
let shell = resolveShellBinary();
|
|
138
|
+
// 未就绪:先(有界)等待下载完成;失败/超时给出明确提示
|
|
139
|
+
if (!existsSync(shell)) {
|
|
140
|
+
if (process.env.BT_SHELL_PATH) {
|
|
141
|
+
throw new Error(`BT_SHELL_PATH 指向的二进制不存在:${shell}`);
|
|
142
|
+
}
|
|
143
|
+
const st = await ensureBinary(20000);
|
|
144
|
+
if (st.state !== "ready" || !st.path) {
|
|
145
|
+
throw new Error(describeBinaryStatus(st));
|
|
146
|
+
}
|
|
147
|
+
shell = st.path;
|
|
148
|
+
}
|
|
133
149
|
// 显式指定端口(release 模式 GUI 程序无控制台,无法解析 stdout)
|
|
134
150
|
const port = 18000 + Math.floor(Math.random() * 1000);
|
|
135
151
|
const args = ["--browsers-path", browsersPath || "", "--port", String(port)];
|
package/dist/index.js
CHANGED
|
@@ -7,6 +7,7 @@ import { registerLocale, t } from "./i18n/index.js";
|
|
|
7
7
|
import en from "./i18n/en.js";
|
|
8
8
|
import zh from "./i18n/zh.js";
|
|
9
9
|
import { configureService, setUserDataDir, ensureService, openWindow, isRunning, stopService, service } from "./client.js";
|
|
10
|
+
import { startDownload } from "./binary.js";
|
|
10
11
|
import { tool } from "@opencode-ai/plugin";
|
|
11
12
|
import createLogger from "@xiaoqiong0v0/opencode-plugin-logger";
|
|
12
13
|
const log = createLogger("browser-tool");
|
|
@@ -263,6 +264,8 @@ export const opencodeBrowserTool = async ({ client, worktree }) => {
|
|
|
263
264
|
// 多用户配置:默认用当前激活配置的独立 WebView2 用户数据目录
|
|
264
265
|
userDataDir: getProfileDir(getActiveProfile()),
|
|
265
266
|
});
|
|
267
|
+
// 启动即后台下载 bt-shell(fire-and-forget:不阻塞启动,失败不抛出;状态见 getBinaryStatus)
|
|
268
|
+
startDownload();
|
|
266
269
|
// 轮询批注发送队列(面板"发送全部" → 推送到对话)
|
|
267
270
|
void startAnnotatePoller(client, log);
|
|
268
271
|
return {
|
package/package.json
CHANGED
package/dist/devices.js
DELETED
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 内置设备预设表(名称 → User-Agent)
|
|
3
|
-
* 空字符串表示使用浏览器默认 UA(桌面类)
|
|
4
|
-
* 数据为静态硬编码,不依赖 Playwright 运行时
|
|
5
|
-
*/
|
|
6
|
-
export const DEVICES = {
|
|
7
|
-
// 桌面(默认 UA)
|
|
8
|
-
"Desktop Chrome": "",
|
|
9
|
-
"Desktop Edge": "",
|
|
10
|
-
"Desktop Firefox": "",
|
|
11
|
-
"Desktop Safari": "",
|
|
12
|
-
// iPhone
|
|
13
|
-
"iPhone 15 Pro": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1",
|
|
14
|
-
"iPhone 14": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.4 Mobile/15E148 Safari/604.1",
|
|
15
|
-
"iPhone 13": "Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.5 Mobile/15E148 Safari/604.1",
|
|
16
|
-
"iPhone 12": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1 Mobile/15E148 Safari/604.1",
|
|
17
|
-
"iPhone SE (3rd gen)": "Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.5 Mobile/15E148 Safari/604.1",
|
|
18
|
-
// iPad
|
|
19
|
-
"iPad Pro 11": "Mozilla/5.0 (iPad; CPU OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1",
|
|
20
|
-
"iPad (10th gen)": "Mozilla/5.0 (iPad; CPU OS 16_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.4 Mobile/15E148 Safari/604.1",
|
|
21
|
-
"iPad Mini (6th gen)": "Mozilla/5.0 (iPad; CPU OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.5 Mobile/15E148 Safari/604.1",
|
|
22
|
-
// Android
|
|
23
|
-
"Pixel 7": "Mozilla/5.0 (Linux; Android 13; Pixel 7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Mobile Safari/537.36",
|
|
24
|
-
"Pixel 6": "Mozilla/5.0 (Linux; Android 13; Pixel 6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Mobile Safari/537.36",
|
|
25
|
-
"Samsung Galaxy S23": "Mozilla/5.0 (Linux; Android 13; SM-S911B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/111.0.0.0 Mobile Safari/537.36",
|
|
26
|
-
};
|