@xiaoqiong0v0/opencode-browser-tool 1.2.0
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 +182 -0
- package/dist/client.js +229 -0
- package/dist/config/index.js +165 -0
- package/dist/devices.js +26 -0
- package/dist/i18n/en.js +95 -0
- package/dist/i18n/index.js +24 -0
- package/dist/i18n/types.js +1 -0
- package/dist/i18n/zh.js +95 -0
- package/dist/index.js +451 -0
- package/dist/types.js +1 -0
- package/package.json +44 -0
package/dist/index.js
ADDED
|
@@ -0,0 +1,451 @@
|
|
|
1
|
+
import { readFileSync, writeFileSync, readdirSync, unlinkSync, mkdirSync, rmSync, existsSync } from "fs";
|
|
2
|
+
import { resolve } from "path";
|
|
3
|
+
import stringArgv from "string-argv";
|
|
4
|
+
import { parseArgs } from "node:util";
|
|
5
|
+
import { loadConfig, getConfig, getBrowsersDir, getProfilesDir, getProfileDir, getExportsDir, getTmpDir, getActiveProfile, setActiveProfile, } from "./config/index.js";
|
|
6
|
+
import { registerLocale, t } from "./i18n/index.js";
|
|
7
|
+
import en from "./i18n/en.js";
|
|
8
|
+
import zh from "./i18n/zh.js";
|
|
9
|
+
import { configureService, setUserDataDir, ensureService, openWindow, isRunning, stopService, service } from "./client.js";
|
|
10
|
+
import { tool } from "@opencode-ai/plugin";
|
|
11
|
+
import createLogger from "@xiaoqiong0v0/opencode-plugin-logger";
|
|
12
|
+
const log = createLogger("browser-tool");
|
|
13
|
+
const _t = (k) => t(k);
|
|
14
|
+
/** 降级说明:服务端在无可信通道、退回 untrusted DOM/JS 时返回 degraded,统一在此追加标注 */
|
|
15
|
+
function degradedNote(r) {
|
|
16
|
+
return r && r.degraded ? ` (degraded: ${r.degradedReason || "untrusted fallback"})` : "";
|
|
17
|
+
}
|
|
18
|
+
/** 就绪说明:导航/前进后退未在超时内就绪时如实标注(不假装成功) */
|
|
19
|
+
function readyNote(r) {
|
|
20
|
+
if (!r || r.ready !== false)
|
|
21
|
+
return "";
|
|
22
|
+
const rs = r.readyState ? `, readyState=${r.readyState}` : "";
|
|
23
|
+
return ` (not ready after ${r.waitedMs ?? "?"}ms${rs})`;
|
|
24
|
+
}
|
|
25
|
+
/** 滚动稳定说明:未在超时内稳定时如实标注 */
|
|
26
|
+
function stableNote(r) {
|
|
27
|
+
if (!r || r.stable !== false)
|
|
28
|
+
return "";
|
|
29
|
+
return ` (scroll position not stable after ${r.waitedMs ?? "?"}ms)`;
|
|
30
|
+
}
|
|
31
|
+
/** scroll_to_element 到达说明:未进入视口时如实标注(含原因) */
|
|
32
|
+
function reachedNote(r) {
|
|
33
|
+
if (!r || r.reached !== false)
|
|
34
|
+
return "";
|
|
35
|
+
const why = r.reason ? `: ${r.reason}` : "";
|
|
36
|
+
return ` (element reached=${r.inViewport ? "in viewport" : "not in viewport"} after ${r.waitedMs ?? "?"}ms${why})`;
|
|
37
|
+
}
|
|
38
|
+
/** 命令表:bt_cli 按 command 分发;命令描述全部走 i18n 键,帮助按 toolLang 本地化 */
|
|
39
|
+
const COMMANDS = {
|
|
40
|
+
navigate: { usage: "--url", descKey: "cli.cmd.navigate", args: [{ flag: "url" }], run: async (a) => {
|
|
41
|
+
const r = await service.navigate(a);
|
|
42
|
+
if (r.installError)
|
|
43
|
+
return `Installation failed: ${r.error}. Retry.`;
|
|
44
|
+
return r.installing ? `Installing ${r.installing} (${r.progress}). Try again.` : `Navigated to: ${r.url}` + readyNote(r);
|
|
45
|
+
} },
|
|
46
|
+
click: { usage: "--selector", descKey: "cli.cmd.click", args: [{ flag: "selector" }], run: async (a) => { const r = await service.click(a); return "Clicked" + degradedNote(r); } },
|
|
47
|
+
fill: { usage: "--selector --value", descKey: "cli.cmd.fill", args: [{ flag: "selector" }, { flag: "value" }], run: async (a) => { const r = await service.fill(a); return "Filled" + degradedNote(r); } },
|
|
48
|
+
clear: { usage: "--selector", descKey: "cli.cmd.clear", args: [{ flag: "selector" }], run: async (a) => { const r = await service.clear(a); return "Cleared" + degradedNote(r); } },
|
|
49
|
+
select: { usage: "--selector --value", descKey: "cli.cmd.select", args: [{ flag: "selector" }, { flag: "value" }], run: async (a) => { const r = await service.select(a); return "Selected" + degradedNote(r); } },
|
|
50
|
+
hover: { usage: "--selector", descKey: "cli.cmd.hover", args: [{ flag: "selector" }], run: async (a) => { const r = await service.hover(a); return "Hovered" + degradedNote(r); } },
|
|
51
|
+
drag: { usage: "--sourceSelector --targetSelector", descKey: "cli.cmd.drag", args: [{ flag: "sourceSelector" }, { flag: "targetSelector" }], run: async (a) => { await service.drag(a); return "Dragged"; } },
|
|
52
|
+
press_key: { usage: "--key [--selector]", descKey: "cli.cmd.press_key", args: [{ flag: "key" }, { flag: "selector" }], run: async (a) => { await service.pressKey(a); return `Pressed: ${a.key}`; } },
|
|
53
|
+
upload_file: { usage: "--selector --filePath", descKey: "cli.cmd.upload_file", args: [{ flag: "selector" }, { flag: "filePath" }], run: async (a) => { await service.uploadFile(a); return "Uploaded"; } },
|
|
54
|
+
screenshot: { usage: "[--selector]", descKey: "cli.cmd.screenshot", args: [{ flag: "selector" }], run: async (a) => {
|
|
55
|
+
const r = await service.screenshot(a);
|
|
56
|
+
return { output: `Screenshot taken${a.selector ? ` (element: ${a.selector})` : " (full page)"}`, attachments: [{ type: "file", mime: r.mime || "image/png", data: r.base64, url: "" }] };
|
|
57
|
+
} },
|
|
58
|
+
evaluate: { usage: "--script", descKey: "cli.cmd.evaluate", args: [{ flag: "script" }], run: async (a) => JSON.stringify(await service.evaluate(a), null, 2) },
|
|
59
|
+
get_visible_text: { usage: "[--selector]", descKey: "cli.cmd.get_visible_text", args: [{ flag: "selector" }], run: async (a) => (await service.visibleText(a))?.text || "(no visible text)" },
|
|
60
|
+
get_visible_html: { usage: "[--selector --removeScripts --removeComments --maxLength]", descKey: "cli.cmd.get_visible_html", args: [{ flag: "selector" }, { flag: "removeScripts", type: "boolean" }, { flag: "removeComments", type: "boolean" }, { flag: "maxLength" }], run: async (a) => {
|
|
61
|
+
// 宿主要求 tool 返回字符串;服务端返回对象 {html,truncated},这里取出 html 文本本体
|
|
62
|
+
const r = await service.visibleHtml(a);
|
|
63
|
+
const html = r?.html || "";
|
|
64
|
+
if (!html)
|
|
65
|
+
return "(no visible html)";
|
|
66
|
+
// 被截断时追加提示:html.length 即服务端实际生效的 maxLength(已 slice),无需再传参
|
|
67
|
+
return r?.truncated ? `${html}\n…(truncated at maxLength=${html.length})` : html;
|
|
68
|
+
} },
|
|
69
|
+
console_logs: { usage: "[--type --search --limit --clear]", descKey: "cli.cmd.console_logs", args: [{ flag: "type" }, { flag: "search" }, { flag: "limit" }, { flag: "clear", type: "boolean" }], run: async (a) => { const r = await service.consoleLogs(a); return (r.logs || []).join("\n") || "(no logs)"; } },
|
|
70
|
+
go_back: { usage: "", descKey: "cli.cmd.go_back", run: async () => { const r = await service.goBack(); return `Went back, current URL: ${r.url}` + readyNote(r); } },
|
|
71
|
+
go_forward: { usage: "", descKey: "cli.cmd.go_forward", run: async () => { const r = await service.goForward(); return `Went forward, current URL: ${r.url}` + readyNote(r); } },
|
|
72
|
+
resize: { usage: "--width --height", descKey: "cli.cmd.resize", args: [{ flag: "width" }, { flag: "height" }], run: async (a) => { await service.resize(a); return "Resized"; } },
|
|
73
|
+
set_device: { usage: "[--name]", descKey: "cli.cmd.set_device", args: [{ flag: "name" }], run: async (a) => {
|
|
74
|
+
if (!a.name) {
|
|
75
|
+
const list = await service.deviceList();
|
|
76
|
+
return ["Available device presets:", "", ...(list.devices || []).map((d) => ` ${d.name} ${d.width}x${d.height}${d.ua ? ` ${d.ua.slice(0, 60)}...` : " (default UA)"}`)].join("\n");
|
|
77
|
+
}
|
|
78
|
+
const r = await service.device({ name: a.name });
|
|
79
|
+
return `Device preset applied: ${r.device} (${r.width}x${r.height})\nUser-Agent: ${r.ua}`;
|
|
80
|
+
} },
|
|
81
|
+
devtools: { usage: "[--action]", descKey: "cli.cmd.devtools", args: [{ flag: "action" }], run: async (a) => { const r = await service.devtools({ action: a.action || "toggle" }); return r.open ? "Devtools opened" : "Devtools closed"; } },
|
|
82
|
+
reload: { usage: "", descKey: "cli.cmd.reload", run: async () => { const r = await service.reload(); return `Page reloaded: ${r.url}`; } },
|
|
83
|
+
open_window: { usage: "", descKey: "cli.cmd.open_window", run: async () => { await openWindow(); return "Browser window opened"; } },
|
|
84
|
+
close: { usage: "", descKey: "cli.cmd.close", run: async () => { if (!isRunning())
|
|
85
|
+
return "Browser already closed"; await service.close(); await stopService(); return "Browser closed"; } },
|
|
86
|
+
show_notification: { usage: "--message [--type]", descKey: "cli.cmd.show_notification", args: [{ flag: "message" }, { flag: "type" }], run: async (a) => { await service.notify(a); return "Notification shown"; } },
|
|
87
|
+
scroll: { usage: "[--direction --amount]", descKey: "cli.cmd.scroll", args: [{ flag: "direction" }, { flag: "amount" }], run: async (a) => { const r = await service.scroll(a); return `Scrolled ${a.direction || "down"} by ${a.amount || 300}px` + stableNote(r); } },
|
|
88
|
+
wait_for_selector: { usage: "--selector [--timeout]", descKey: "cli.cmd.wait_for_selector", args: [{ flag: "selector" }, { flag: "timeout" }], run: async (a) => { await service.waitForSelector(a); return "Element appeared"; } },
|
|
89
|
+
click_and_switch_tab: { usage: "--selector", descKey: "cli.cmd.click_and_switch_tab", args: [{ flag: "selector" }], run: async (a) => { const r = await service.clickSwitchTab(a); return `Clicked ${a.selector}, current URL: ${r.url || ""}` + degradedNote(r); } },
|
|
90
|
+
iframe_click: { usage: "--iframeSelector --selector", descKey: "cli.cmd.iframe_click", args: [{ flag: "iframeSelector" }, { flag: "selector" }], run: async (a) => { const r = await service.iframeClick(a); return "Clicked in iframe" + degradedNote(r); } },
|
|
91
|
+
iframe_fill: { usage: "--iframeSelector --selector --value", descKey: "cli.cmd.iframe_fill", args: [{ flag: "iframeSelector" }, { flag: "selector" }, { flag: "value" }], run: async (a) => { const r = await service.iframeFill(a); return "Filled in iframe" + degradedNote(r); } },
|
|
92
|
+
get_browser_status: { usage: "", descKey: "cli.cmd.get_browser_status", run: async () => {
|
|
93
|
+
const s = await service.status();
|
|
94
|
+
if (s.installing && Object.keys(s.installing).length > 0)
|
|
95
|
+
return `Installing ${Object.entries(s.installing).map(([b, p]) => `${b} (${p})`).join(", ")}.`;
|
|
96
|
+
if (!s.open)
|
|
97
|
+
return "Browser is not open. Use command=open_window or navigate.";
|
|
98
|
+
return `Browser is open\nTitle: ${s.title}\nURL: ${s.url}\nTabs: ${s.tabs}`;
|
|
99
|
+
} },
|
|
100
|
+
list_tabs: { usage: "", descKey: "cli.cmd.list_tabs", run: async () => { const res = await service.tabs(); const list = res?.tabs || []; if (!list.length)
|
|
101
|
+
return "(no tabs)"; return `Tabs (${list.length}):\n${list.map((p, i) => `[${i}] ${p.url || p.title}`).join("\n")}`; } },
|
|
102
|
+
switch_tab: { usage: "--index", descKey: "cli.cmd.switch_tab", args: [{ flag: "index" }], run: async (a) => { const r = await service.switchTab(a); return `Switched to tab #${a.index}: ${r.url}`; } },
|
|
103
|
+
new_tab: { usage: "--url", descKey: "cli.cmd.new_tab", args: [{ flag: "url" }], run: async (a) => { const r = await service.newTab(a); return `New tab opened: ${r.url}`; } },
|
|
104
|
+
close_tab: { usage: "[--index]", descKey: "cli.cmd.close_tab", args: [{ flag: "index" }], run: async (a) => { await service.closeTab(a); return a.index !== undefined ? `Closed tab #${a.index}` : "Closed current tab"; } },
|
|
105
|
+
get_element_state: { usage: "--selector", descKey: "cli.cmd.get_element_state", args: [{ flag: "selector" }], run: async (a) => { const r = await service.elementState(a); if (!r || !r.exists)
|
|
106
|
+
return `Element not found: ${a.selector}`; return `Element <${r.tag}>: ${a.selector}\nVisible: ${r.visible}${r.text ? `\nText: ${r.text}` : ""}\nRect: ${r.rect.x},${r.rect.y} ${r.rect.w}x${r.rect.h}`; } },
|
|
107
|
+
scroll_to_element: { usage: "--selector", descKey: "cli.cmd.scroll_to_element", args: [{ flag: "selector" }], run: async (a) => { const r = await service.scrollToElement(a); return "Scrolled to element" + reachedNote(r); } },
|
|
108
|
+
get_dropdown_options: { usage: "--selector", descKey: "cli.cmd.get_dropdown_options", args: [{ flag: "selector" }], run: async (a) => { const r = await service.dropdownOptions(a); const opts = r?.options ?? []; if (!opts.length)
|
|
109
|
+
return `Select not found or no options: ${a.selector}`; return opts.map((o) => `${o.selected ? "* " : " "}${o.value}: ${o.text}`).join("\n"); } },
|
|
110
|
+
custom_user_agent: { usage: "--userAgent", descKey: "cli.cmd.custom_user_agent", args: [{ flag: "userAgent" }], run: async (a) => { await service.userAgent(a); return "User-Agent set"; } },
|
|
111
|
+
expect_response: { usage: "--url", descKey: "cli.cmd.expect_response", args: [{ flag: "url" }], run: async (a) => { await service.expectResponse({ urlPattern: a.url }); return `Now expecting response matching: ${a.url}. Use command=assert_response to check.`; } },
|
|
112
|
+
assert_response: { usage: "--id", descKey: "cli.cmd.assert_response", args: [{ flag: "id" }], run: async (a) => { const r = await service.assertResponse({ id: a.id }); return r.matched ? `Response matched: ${r.url} (${r.status})` : r.error || "No response yet"; } },
|
|
113
|
+
get_accessibility_tree: { usage: "[--selector --maxDepth]", descKey: "cli.cmd.get_accessibility_tree", args: [{ flag: "selector" }, { flag: "maxDepth" }], run: async (a) => { const s = await service.accessibility(a); return s ? formatNode(s, 0, a.maxDepth ?? 8) : "(no accessibility info)"; } },
|
|
114
|
+
list_records: { usage: "", descKey: "cli.cmd.list_records", run: async () => { try {
|
|
115
|
+
const records = await service.annotateRecords();
|
|
116
|
+
if (!records || !records.length)
|
|
117
|
+
return "(no records)";
|
|
118
|
+
return records.map((r) => { const rect = r.rect ? ` rect=(${r.rect[0]},${r.rect[1]},${r.rect[2]},${r.rect[3]})` : ""; return `[${r.index}] ${r.selector}${rect}${r.note ? ` note="${r.note}"` : ""}`; }).join("\n");
|
|
119
|
+
}
|
|
120
|
+
catch {
|
|
121
|
+
return "(no records)";
|
|
122
|
+
} } },
|
|
123
|
+
read_record_content: { usage: "--id", descKey: "cli.cmd.read_record_content", args: [{ flag: "id" }], run: async (a) => { try {
|
|
124
|
+
const records = await service.annotateRecords();
|
|
125
|
+
const rec = (records || []).find((r) => r.index === a.id);
|
|
126
|
+
if (!rec)
|
|
127
|
+
return `(record #${a.id} not found)`;
|
|
128
|
+
return `#${rec.index} ${rec.selector}\nrect: ${JSON.stringify(rec.rect)}\nnote: ${rec.note || "(none)"}`;
|
|
129
|
+
}
|
|
130
|
+
catch {
|
|
131
|
+
return "(no records)";
|
|
132
|
+
} } },
|
|
133
|
+
fake_audio: { usage: "--kind [--data --freq --durMs --notes --digits --loop]", descKey: "cli.cmd.fake_audio", args: [{ flag: "kind" }, { flag: "data" }, { flag: "freq" }, { flag: "durMs" }, { flag: "notes" }, { flag: "digits" }, { flag: "loop", type: "boolean" }], run: async (a) => { const r = await service.mediaAudio(a); return `Fake mic audio: ${r.injected}`; } },
|
|
134
|
+
fake_video: { usage: "--kind [--data --url --loop]", descKey: "cli.cmd.fake_video", args: [{ flag: "kind" }, { flag: "data" }, { flag: "url" }, { flag: "loop", type: "boolean" }], run: async (a) => { const r = await service.mediaVideo(a); return `Fake camera video: ${r.injected}`; } },
|
|
135
|
+
profile: { usage: "[--set <name> | --delete <name>]", descKey: "cli.cmd.profile", args: [{ flag: "set" }, { flag: "delete" }], run: async (a) => {
|
|
136
|
+
mkdirSync(getProfilesDir(), { recursive: true });
|
|
137
|
+
const active = getActiveProfile();
|
|
138
|
+
if (a.delete) {
|
|
139
|
+
const name = String(a.delete);
|
|
140
|
+
if (name === "default")
|
|
141
|
+
return "Cannot delete the default profile";
|
|
142
|
+
if (name === active)
|
|
143
|
+
return "Cannot delete the active profile; switch to another first (profile --set <name>)";
|
|
144
|
+
const dir = getProfileDir(name);
|
|
145
|
+
if (!existsSync(dir))
|
|
146
|
+
return `Profile not found: ${name}`;
|
|
147
|
+
rmSync(dir, { recursive: true, force: true });
|
|
148
|
+
return `Deleted profile: ${name}`;
|
|
149
|
+
}
|
|
150
|
+
if (a.set) {
|
|
151
|
+
const name = String(a.set);
|
|
152
|
+
// 目标配置目录不存在则创建(允许 "profile --set <新名>" 直接新建并切换)
|
|
153
|
+
mkdirSync(getProfileDir(name), { recursive: true });
|
|
154
|
+
setActiveProfile(name);
|
|
155
|
+
setUserDataDir(getProfileDir(name));
|
|
156
|
+
// 切换配置:重启服务使新 user-data-dir 生效(丢当前标签可接受)
|
|
157
|
+
await stopService();
|
|
158
|
+
await ensureService();
|
|
159
|
+
return `Switched to profile: ${name} (browser restarted)`;
|
|
160
|
+
}
|
|
161
|
+
// 列出 user-data 下的配置目录
|
|
162
|
+
const dirs = readdirSync(getProfilesDir(), { withFileTypes: true })
|
|
163
|
+
.filter((d) => d.isDirectory())
|
|
164
|
+
.map((d) => d.name);
|
|
165
|
+
const list = dirs.map((d) => `${d === active ? "*" : " "} ${d}`).join("\n") || "(no profiles yet)";
|
|
166
|
+
return `Profiles:\n${list}\n\nActive: ${active}\nSwitch: profile --set <name> (restarts browser, current tabs lost)\nDelete: profile --delete <name> (not default/active)`;
|
|
167
|
+
} },
|
|
168
|
+
exports: { usage: "", descKey: "cli.cmd.exports", run: async () => {
|
|
169
|
+
const dir = getExportsDir();
|
|
170
|
+
mkdirSync(dir, { recursive: true });
|
|
171
|
+
return `Export directory: ${dir}\n\nHow to export from Edge/Chrome:\n Passwords: Settings → Profiles → Passwords → ⋯ → Export passwords (CSV)\n Bookmarks: Settings → Bookmarks → Export (HTML)\nPlace the exported files in the directory above, then the model can read them.\n\nRead passwords without leaking into context:\n lookup --csv <file.csv> --url <site>\n fill --selector <input> --value @file:<path>`;
|
|
172
|
+
} },
|
|
173
|
+
lookup: { usage: "--csv <path> --url <site>", descKey: "cli.cmd.lookup", args: [{ flag: "csv" }, { flag: "url" }], run: async (a) => {
|
|
174
|
+
const csv = a.csv;
|
|
175
|
+
const url = a.url;
|
|
176
|
+
if (!csv || !url)
|
|
177
|
+
return "Usage: lookup --csv <path> --url <site>";
|
|
178
|
+
// 解析密码 CSV(name,url,username,password[,note]),按 url 子串匹配
|
|
179
|
+
const lines = readFileSync(csv, "utf-8").split(/\r?\n/).filter((l) => l.trim());
|
|
180
|
+
for (const line of lines.slice(1)) {
|
|
181
|
+
const cols = splitCsvLine(line);
|
|
182
|
+
if (cols.length < 4)
|
|
183
|
+
continue;
|
|
184
|
+
const rowUrl = cols[1] || "";
|
|
185
|
+
if (rowUrl.toLowerCase().includes(String(url).toLowerCase())) {
|
|
186
|
+
const username = cols[2] || "";
|
|
187
|
+
const password = cols[3] || "";
|
|
188
|
+
// 密码写入临时文件,返回 @file: 引用(不进上下文);用完即删
|
|
189
|
+
const tmpDir = getTmpDir();
|
|
190
|
+
mkdirSync(tmpDir, { recursive: true });
|
|
191
|
+
const tmp = resolve(tmpDir, `secret-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.tmp`);
|
|
192
|
+
writeFileSync(tmp, password, "utf-8");
|
|
193
|
+
return `Found: ${username} @ ${rowUrl}\nUse: fill --selector <input> --value @file:${tmp}\n(password in temp file, deleted after use)`;
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
return `No entry found for: ${url}`;
|
|
197
|
+
} },
|
|
198
|
+
};
|
|
199
|
+
/** 帮助全文(command=help 或未知命令时返回;命令描述与结构按 toolLang 本地化) */
|
|
200
|
+
function buildHelp() {
|
|
201
|
+
const lines = Object.entries(COMMANDS).map(([k, v]) => ` ${k.padEnd(22)} ${v.usage.padEnd(42)} ${_t(v.descKey)}`);
|
|
202
|
+
const examples = [_t("cli.example.1"), _t("cli.example.2"), _t("cli.example.3"), _t("cli.example.4")]
|
|
203
|
+
.map((e) => ` ${e}`)
|
|
204
|
+
.join("\n");
|
|
205
|
+
return `${_t("cli.header")}\n\n${_t("cli.usage")}\n\n${_t("cli.commands")}\n${lines.join("\n")}\n\n${_t("cli.examples")}\n${examples}`;
|
|
206
|
+
}
|
|
207
|
+
/** 描述内嵌的紧凑命令索引(模型无需先调 help 即可用) */
|
|
208
|
+
const DESC_INDEX = Object.entries(COMMANDS).map(([k, v]) => `${k} ${v.usage}`).join(" | ");
|
|
209
|
+
/** 解析 --flag 风格参数(基于 node:util.parseArgs,未知 flag 报错;tokens 已由 string-argv 正确分词) */
|
|
210
|
+
function parseFlagArgs(tokens, def) {
|
|
211
|
+
if (tokens.length === 0)
|
|
212
|
+
return {};
|
|
213
|
+
const options = {};
|
|
214
|
+
for (const arg of def.args || [])
|
|
215
|
+
options[arg.flag] = { type: arg.type || "string" };
|
|
216
|
+
const { values } = parseArgs({ args: tokens, options, allowPositionals: true });
|
|
217
|
+
return values;
|
|
218
|
+
}
|
|
219
|
+
/** 简单 CSV 行解析(处理引号包裹的字段,Edge/Chrome 密码导出格式) */
|
|
220
|
+
function splitCsvLine(line) {
|
|
221
|
+
const out = [];
|
|
222
|
+
let cur = "";
|
|
223
|
+
let inQ = false;
|
|
224
|
+
for (let i = 0; i < line.length; i++) {
|
|
225
|
+
const ch = line[i];
|
|
226
|
+
if (inQ) {
|
|
227
|
+
if (ch === '"') {
|
|
228
|
+
if (line[i + 1] === '"') {
|
|
229
|
+
cur += '"';
|
|
230
|
+
i++;
|
|
231
|
+
}
|
|
232
|
+
else
|
|
233
|
+
inQ = false;
|
|
234
|
+
}
|
|
235
|
+
else
|
|
236
|
+
cur += ch;
|
|
237
|
+
}
|
|
238
|
+
else if (ch === '"')
|
|
239
|
+
inQ = true;
|
|
240
|
+
else if (ch === ",") {
|
|
241
|
+
out.push(cur);
|
|
242
|
+
cur = "";
|
|
243
|
+
}
|
|
244
|
+
else
|
|
245
|
+
cur += ch;
|
|
246
|
+
}
|
|
247
|
+
out.push(cur);
|
|
248
|
+
return out;
|
|
249
|
+
}
|
|
250
|
+
export const opencodeBrowserTool = async ({ client, worktree }) => {
|
|
251
|
+
registerLocale("en", en);
|
|
252
|
+
registerLocale("zh", zh);
|
|
253
|
+
loadConfig(worktree);
|
|
254
|
+
const config = getConfig();
|
|
255
|
+
try {
|
|
256
|
+
log.loaded();
|
|
257
|
+
// 懒启动:仅保存启动参数,不立即弹窗;open_window 或首次调工具时启动
|
|
258
|
+
configureService({
|
|
259
|
+
nodePath: config.nodePath || "",
|
|
260
|
+
browsersPath: getBrowsersDir(),
|
|
261
|
+
sessionIsolation: config.sessionIsolation,
|
|
262
|
+
browserType: config.browserType,
|
|
263
|
+
// 多用户配置:默认用当前激活配置的独立 WebView2 用户数据目录
|
|
264
|
+
userDataDir: getProfileDir(getActiveProfile()),
|
|
265
|
+
});
|
|
266
|
+
// 轮询批注发送队列(面板"发送全部" → 推送到对话)
|
|
267
|
+
void startAnnotatePoller(client, log);
|
|
268
|
+
return {
|
|
269
|
+
event: async ({ event }) => {
|
|
270
|
+
if (event.type === "session.deleted") {
|
|
271
|
+
const sid = event.data?.sessionID;
|
|
272
|
+
if (sid) {
|
|
273
|
+
try {
|
|
274
|
+
await service.closeSession({ _sessionId: sid });
|
|
275
|
+
}
|
|
276
|
+
catch { }
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
},
|
|
280
|
+
tool: filterDisabled({
|
|
281
|
+
bt_cli: tool({
|
|
282
|
+
description: _t("tool.cli.desc") + "\n" + DESC_INDEX,
|
|
283
|
+
args: {
|
|
284
|
+
// 单字符串命令行: "<command> [--flag value ...]", 如 "navigate --url https://..." / "help"
|
|
285
|
+
args: tool.schema.string().optional().describe(_t("tool.cli.arg.args")),
|
|
286
|
+
},
|
|
287
|
+
async execute(a, context) {
|
|
288
|
+
// 单字符串命令行: "<command> [--flag value ...]",如 "navigate --url https://..."
|
|
289
|
+
const raw = (typeof a?.args === "string" ? a.args : "").trim();
|
|
290
|
+
if (!raw || raw === "help" || raw === "--help" || raw === "-h")
|
|
291
|
+
return buildHelp();
|
|
292
|
+
// string-argv 正确分词(处理引号/转义),命令名取第一个 token
|
|
293
|
+
const tokens = stringArgv(raw);
|
|
294
|
+
const cmdName = tokens.shift();
|
|
295
|
+
if (!cmdName)
|
|
296
|
+
return buildHelp();
|
|
297
|
+
const def = COMMANDS[cmdName];
|
|
298
|
+
if (!def)
|
|
299
|
+
return `${_t("cli.unknown").replace("{cmd}", cmdName)}\n\n${buildHelp()}`;
|
|
300
|
+
// 剩余 token 交给 parseArgs 解析(未知 flag 会抛错,返回用法提示自愈)
|
|
301
|
+
let params = {};
|
|
302
|
+
if (tokens.length > 0) {
|
|
303
|
+
try {
|
|
304
|
+
params = parseFlagArgs(tokens, def);
|
|
305
|
+
}
|
|
306
|
+
catch (e) {
|
|
307
|
+
return `${_t("cli.invalid_args").replace("{cmd}", cmdName).replace("{msg}", e.message)}\n\nUsage: bt_cli({ args: "${cmdName} ${def.usage}" })`;
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
// @file: 引用解析:值以 @file:<path> 开头时读文件内容作为实际值
|
|
311
|
+
// (密码等敏感值不进 LLM 上下文,如 fill --value @file:C:\...\secret.tmp)
|
|
312
|
+
// 仅删除临时目录(getTmpDir)内的文件,避免误删用户文件
|
|
313
|
+
const tmpDir = resolve(getTmpDir());
|
|
314
|
+
for (const key of Object.keys(params)) {
|
|
315
|
+
const v = params[key];
|
|
316
|
+
if (typeof v === "string" && v.startsWith("@file:")) {
|
|
317
|
+
const p = v.slice(6);
|
|
318
|
+
try {
|
|
319
|
+
params[key] = readFileSync(p, "utf-8").replace(/\r?\n$/, "");
|
|
320
|
+
// 用完即删(仅限 lookup 生成的临时密码文件)
|
|
321
|
+
if (resolve(p).startsWith(tmpDir)) {
|
|
322
|
+
unlinkSync(p);
|
|
323
|
+
}
|
|
324
|
+
}
|
|
325
|
+
catch (e) {
|
|
326
|
+
return `Cannot read @file: ${p}: ${e.message}`;
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
}
|
|
330
|
+
// 透传会话 ID(会话隔离用)
|
|
331
|
+
params._sessionId = context?.sessionID || "";
|
|
332
|
+
try {
|
|
333
|
+
return await def.run(params);
|
|
334
|
+
}
|
|
335
|
+
catch (e) {
|
|
336
|
+
return `${_t("cli.failed").replace("{cmd}", cmdName).replace("{msg}", e.message || e)}`;
|
|
337
|
+
}
|
|
338
|
+
},
|
|
339
|
+
}),
|
|
340
|
+
// 切真实设备属敏感操作,单独保留工具以维持 ask 权限
|
|
341
|
+
bt_set_media_mode: tool({
|
|
342
|
+
description: _t("tool.set_media_mode.desc"),
|
|
343
|
+
args: {
|
|
344
|
+
mode: tool.schema.enum(["simulate", "real"]).optional().describe(_t("tool.set_media_mode.arg.mode")),
|
|
345
|
+
},
|
|
346
|
+
async execute(a, context) {
|
|
347
|
+
const r = await service.mediaMode({ ...a, _sessionId: context?.sessionID || "" });
|
|
348
|
+
return `Media mode: ${r.mode}`;
|
|
349
|
+
},
|
|
350
|
+
}),
|
|
351
|
+
}, config.disabledTools),
|
|
352
|
+
};
|
|
353
|
+
}
|
|
354
|
+
catch (err) {
|
|
355
|
+
log.error("Init failed", err);
|
|
356
|
+
throw err;
|
|
357
|
+
}
|
|
358
|
+
};
|
|
359
|
+
function formatNode(node, depth, maxDepth) {
|
|
360
|
+
if (depth > maxDepth)
|
|
361
|
+
return "";
|
|
362
|
+
const indent = "│ ".repeat(depth);
|
|
363
|
+
const parts = [indent + node.role];
|
|
364
|
+
if (node.name)
|
|
365
|
+
parts.push(`"${node.name}"`);
|
|
366
|
+
if (node.value !== undefined && node.value !== "")
|
|
367
|
+
parts.push(`= ${node.value}`);
|
|
368
|
+
if (node.description)
|
|
369
|
+
parts.push(`(${node.description})`);
|
|
370
|
+
const line = parts.join(" ");
|
|
371
|
+
if (node.children && node.children.length > 0) {
|
|
372
|
+
const children = node.children
|
|
373
|
+
.map((c) => formatNode(c, depth + 1, maxDepth))
|
|
374
|
+
.filter(Boolean)
|
|
375
|
+
.join("\n");
|
|
376
|
+
return children ? line + "\n" + children : line;
|
|
377
|
+
}
|
|
378
|
+
return line;
|
|
379
|
+
}
|
|
380
|
+
function filterDisabled(tools, disabled) {
|
|
381
|
+
if (!disabled || disabled.length === 0)
|
|
382
|
+
return tools;
|
|
383
|
+
const result = {};
|
|
384
|
+
for (const [name, def] of Object.entries(tools)) {
|
|
385
|
+
if (!disabled.includes(name))
|
|
386
|
+
result[name] = def;
|
|
387
|
+
}
|
|
388
|
+
return result;
|
|
389
|
+
}
|
|
390
|
+
/** 轮询批注发送队列:面板"发送全部"/截图"发送"后,拉取记录推送当前对话
|
|
391
|
+
* 注意:插件函数会随会话/切目录多次执行,轮询器必须进程级单例,
|
|
392
|
+
* 否则同一进程会累积多个 interval 空转(server 与 TUI 进程各一份,互不共享)
|
|
393
|
+
*/
|
|
394
|
+
let annotateTimer = null;
|
|
395
|
+
let annotateClient = null;
|
|
396
|
+
function startAnnotatePoller(client, log) {
|
|
397
|
+
// 更新 client 引用(插件重载后使用最新 client),但只启动一个轮询器
|
|
398
|
+
annotateClient = client;
|
|
399
|
+
if (annotateTimer)
|
|
400
|
+
return;
|
|
401
|
+
const POLL_MS = 2000;
|
|
402
|
+
const timer = setInterval(async () => {
|
|
403
|
+
// 服务未启动/已关闭:跳过本次轮询(窗口打开后再恢复推送)
|
|
404
|
+
if (!isRunning())
|
|
405
|
+
return;
|
|
406
|
+
const c = annotateClient;
|
|
407
|
+
if (!c)
|
|
408
|
+
return;
|
|
409
|
+
try {
|
|
410
|
+
const r = await service.annotateConsumeSent();
|
|
411
|
+
const records = r?.records || [];
|
|
412
|
+
if (records.length === 0)
|
|
413
|
+
return;
|
|
414
|
+
const lines = ["User annotated via panel:", ""];
|
|
415
|
+
const parts = [];
|
|
416
|
+
for (const item of records) {
|
|
417
|
+
// 截图记录:附带图片 part(裸 base64),AI 可直接看图
|
|
418
|
+
if (item.type === "screenshot" && item.image) {
|
|
419
|
+
parts.push({ type: "file", mime: "image/png", data: item.image, url: "" });
|
|
420
|
+
}
|
|
421
|
+
const label = item.type === "screenshot"
|
|
422
|
+
? `[#${item.index}] 截图${item.url ? ` @ ${item.url}` : ""}`
|
|
423
|
+
: `[#${item.index}] ${item.selector || "(no selector)"}${item.url ? ` @ ${item.url}` : ""}`;
|
|
424
|
+
lines.push(`- ${label}${item.note ? `: ${item.note}` : ""}`);
|
|
425
|
+
lines.push("");
|
|
426
|
+
}
|
|
427
|
+
const text = lines.join("\n");
|
|
428
|
+
const bodyParts = [{ type: "text", text }];
|
|
429
|
+
for (const p of parts)
|
|
430
|
+
bodyParts.push(p);
|
|
431
|
+
const sessions = await c.session.list();
|
|
432
|
+
if (sessions?.data?.length) {
|
|
433
|
+
await c.session.prompt({
|
|
434
|
+
path: { id: sessions.data[0].id },
|
|
435
|
+
body: { noReply: false, parts: bodyParts },
|
|
436
|
+
});
|
|
437
|
+
}
|
|
438
|
+
}
|
|
439
|
+
catch {
|
|
440
|
+
// 服务未就绪/已退出,停止轮询
|
|
441
|
+
clearInterval(timer);
|
|
442
|
+
annotateTimer = null;
|
|
443
|
+
}
|
|
444
|
+
}, POLL_MS);
|
|
445
|
+
// 不阻塞进程退出
|
|
446
|
+
if (typeof timer.unref === "function")
|
|
447
|
+
timer.unref();
|
|
448
|
+
annotateTimer = timer;
|
|
449
|
+
}
|
|
450
|
+
// Export default for npm loader
|
|
451
|
+
export default opencodeBrowserTool;
|
package/dist/types.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
package/package.json
ADDED
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@xiaoqiong0v0/opencode-browser-tool",
|
|
3
|
+
"version": "1.2.0",
|
|
4
|
+
"description": "opencode 浏览器工具插件:WebView2 外壳渲染 + 零注入视觉元素选取面板",
|
|
5
|
+
"main": "dist/index.js",
|
|
6
|
+
"scripts": {
|
|
7
|
+
"build": "tsc",
|
|
8
|
+
"dev": "tsc --watch",
|
|
9
|
+
"build:frontend": "cd frontend && npm install && npm run build"
|
|
10
|
+
},
|
|
11
|
+
"keywords": [
|
|
12
|
+
"opencode",
|
|
13
|
+
"browser",
|
|
14
|
+
"webview2",
|
|
15
|
+
"plugin"
|
|
16
|
+
],
|
|
17
|
+
"author": "",
|
|
18
|
+
"license": "ISC",
|
|
19
|
+
"type": "module",
|
|
20
|
+
"files": [
|
|
21
|
+
"dist"
|
|
22
|
+
],
|
|
23
|
+
"dependencies": {
|
|
24
|
+
"@xiaoqiong0v0/opencode-plugin-logger": "^1.0.5",
|
|
25
|
+
"string-argv": "^0.3.2"
|
|
26
|
+
},
|
|
27
|
+
"peerDependencies": {
|
|
28
|
+
"@opencode-ai/plugin": "^1.18.4"
|
|
29
|
+
},
|
|
30
|
+
"devDependencies": {
|
|
31
|
+
"@types/node": "^26.1.1",
|
|
32
|
+
"typescript": "^7.0.2"
|
|
33
|
+
},
|
|
34
|
+
"publishConfig": {
|
|
35
|
+
"access": "public"
|
|
36
|
+
},
|
|
37
|
+
"repository": {
|
|
38
|
+
"type": "git",
|
|
39
|
+
"url": "git+https://github.com/xiaoqiong0v0/opencode-browser-tool.git"
|
|
40
|
+
},
|
|
41
|
+
"volta": {
|
|
42
|
+
"node": "24.16.0"
|
|
43
|
+
}
|
|
44
|
+
}
|