@flrande/browserctl 0.1.0-dev.7.1

package/apps/browserd/src/main.ts

@@ -0,0 +1,7 @@
+import { bootstrapBrowserd } from "./bootstrap";
+
+export function main() {
+  return bootstrapBrowserd();
+}
+
+void main();

package/bin/browserctl.cjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+const { spawn } = require("node:child_process");
+const { resolve } = require("node:path");
+
+const repoRoot = resolve(__dirname, "..");
+const entry = resolve(repoRoot, "apps/browserctl/src/main.ts");
+
+const child = spawn(process.execPath, ["--import", "tsx", entry, ...process.argv.slice(2)], {
+  cwd: repoRoot,
+  env: process.env,
+  stdio: "inherit"
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+
+  process.exit(code ?? 1);
+});

package/bin/browserd.cjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+const { spawn } = require("node:child_process");
+const { resolve } = require("node:path");
+
+const repoRoot = resolve(__dirname, "..");
+const entry = resolve(repoRoot, "apps/browserd/src/main.ts");
+
+const child = spawn(process.execPath, ["--import", "tsx", entry, ...process.argv.slice(2)], {
+  cwd: repoRoot,
+  env: process.env,
+  stdio: "inherit"
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+
+  process.exit(code ?? 1);
+});

package/extensions/chrome-relay/README-CN.md

@@ -0,0 +1,38 @@
+# BrowserCtl Relay 扩展
+
+[English](README.md) | 简体中文
+
+此扩展用于将 Chromium 系浏览器标签页层连接到本地 BrowserCtl 扩展桥接服务。
+
+## 加载已解压扩展
+
+1. 打开 `chrome://extensions`（Edge 使用 `edge://extensions`）。
+2. 开启**开发者模式**。
+3. 点击**加载已解压的扩展程序**。
+4. 选择目录：`extensions/chrome-relay`。
+
+该扩展使用 `debugger` 权限采集控制台/网络遥测，以供 agent 侧诊断与分析。
+
+## 配置
+
+1. 打开扩展弹窗。
+2. 将 `Bridge URL` 设置为桥接地址。
+3. 将 token 设置为与 `BROWSERD_CHROME_RELAY_EXTENSION_TOKEN` 一致（必填）。
+4. 点击 **Save**，然后点击 **Reconnect**。
+
+默认 Bridge URL：
+
+- `ws://127.0.0.1:9223/bridge`
+
+## 弹窗故障排查
+
+弹窗内置了专门的排查区域：
+
+- **Run Diagnostics**：对比扩展侧连接状态与 relay 侧 `/browserctl/relay/status`。
+- **Copy Report**：复制包含状态快照与建议动作的 JSON 诊断报告。
+- **Guidance list**：给出常见问题的定向建议（URL 不匹配、token 不匹配、relay 不可达、连接陈旧等）。
+
+## 语言切换
+
+使用弹窗语言选择器可切换 **English** 与 **中文**。
+所选语言会保存到扩展本地存储，并在下次打开弹窗时自动应用。

package/extensions/chrome-relay/README.md

@@ -0,0 +1,38 @@
+# BrowserCtl Relay Extension
+
+English | [简体中文](README-CN.md)
+
+This extension connects a Chromium-based browser tab layer to the local BrowserCtl extension bridge.
+
+## Load Unpacked
+
+1. Open `chrome://extensions` (or `edge://extensions` in Edge).
+2. Enable **Developer mode**.
+3. Click **Load unpacked**.
+4. Select this folder: `extensions/chrome-relay`.
+
+This extension uses the `debugger` permission to collect console/network telemetry for agent-side inspection.
+
+## Configure
+
+1. Open the extension popup.
+2. Set `Bridge URL` to your bridge endpoint.
+3. Set token to match `BROWSERD_CHROME_RELAY_EXTENSION_TOKEN` (required).
+4. Click **Save** and then **Reconnect**.
+
+Default bridge URL:
+
+- `ws://127.0.0.1:9223/bridge`
+
+## Troubleshooting In Popup
+
+The popup now includes a dedicated troubleshooting section:
+
+- **Run Diagnostics**: compares extension-side connection state with relay-side `/browserctl/relay/status`.
+- **Copy Report**: copies a JSON diagnostics report with status snapshots and recommended actions.
+- **Guidance list**: shows targeted fixes for common issues (URL mismatch, token mismatch, relay unreachable, stale connection).
+
+## Language Switch
+
+Use the popup language selector to switch between **English** and **Chinese (中文)**.
+The selected language is persisted in extension local storage and applied on the next popup open.