@sleepinsummer/agent-browser-cli 0.2.7 → 0.2.9

package/README.md

@@ -10,8 +10,9 @@
   <a href="https://github.com/sleepinginsummer/agent-browser-cli"><img src="https://img.shields.io/badge/CLI-agentbrowsercli-2ea44f" alt="CLI agentbrowsercli"></a>
   <a href="https://github.com/sleepinginsummer/agent-browser-cli/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green" alt="License MIT"></a>
   <a href="https://github.com/sleepinginsummer/agent-browser-cli"><img src="https://img.shields.io/badge/sys-win%2Fmac%2Flinux-0078D6?labelColor=0078D6&color=C0C0C0" alt="sys win/mac/linux"></a>
-  <a href="https://github.com/sleepinginsummer/agent-browser-cli/releases"><img src="https://img.shields.io/badge/release-v0.2.7-blue" alt="release v0.2.7"></a>
+  <a href="https://github.com/sleepinginsummer/agent-browser-cli/releases"><img src="https://img.shields.io/badge/release-v0.2.9-blue" alt="release v0.2.9"></a>
   <a href="https://github.com/sleepinginsummer/agent-browser-cli/pulls"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs welcome"></a>
+  <a href="https://github.com/sleepinginsummer/agent-browser-cli/stargazers"><img src="https://img.shields.io/github/stars/sleepinginsummer/agent-browser-cli?label=stars&color=yellow" alt="GitHub stars"></a>
 </p>
 
 [AI 一句话安装](#ai-一句话安装) · [手动安装](#手动安装) · [Chrome 扩展](#chrome-扩展) · [更新](#更新) · [卸载](#卸载) · [友情链接](#友情链接)
@@ -26,7 +27,7 @@
 
 ## 项目信息
 
-- 当前版本：`0.2.7`
+- 当前版本：`0.2.9`
 - 支持平台：Windows（包括 WSL）/ Mac / Linux
 - 浏览器：Chrome，需加载拓展 `assets/tmwd_cdp_bridge`
 - Linux 支持前提：本机 Chrome / Chromium 需要支持安装扩展
@@ -112,17 +113,51 @@ cargo build --release
 
 ## Chrome 扩展
 
-推荐从 [最新 Release](https://github.com/sleepinginsummer/agent-browser-cli/releases/latest) 下载 `chrome-extensions.zip`，下载后解压，Chrome 打开 `chrome://extensions`，开启“开发者模式”，点击“加载已解压的扩展程序”，选择解压后的 `tmwd_cdp_bridge` 目录。
+1. 推荐从 [最新 Release](https://github.com/sleepinginsummer/agent-browser-cli/releases/latest) 下载 `chrome-extensions.zip`，下载后解压，Chrome 打开 `chrome://extensions`，开启“开发者模式”，点击“加载已解压的扩展程序”，选择解压后的 `tmwd_cdp_bridge` 目录。
 
-本地源码构建时，也可以直接加载扩展目录：
+2. 本地源码构建时，也可以直接加载扩展目录：
 
 ```text
 assets/tmwd_cdp_bridge
 ```
 
-Chrome 需要至少打开一个正常网页标签页，不要只停留在 `about:blank` 或 `chrome://` 页面。
+3. Chrome 需要至少打开一个正常网页标签页，不要只停留在 `about:blank` 或 `chrome://` 页面。
+4. 扩展连接后会在页面右侧显示 Chrome 插件提示角标。角标支持拖动位置，鼠标悬浮时展开；10 秒无命令后自动隐藏，也可以点击 `本次隐藏` 手动隐藏，本次服务连接周期内不再显示，约 300 秒服务断开并下次重连后恢复。
+
+###  自定义Chrome插件的ws监听端口
+
+- `18765`：默认插件 WebSocket 端口，Chrome 扩展连接使用，可通过 `agent-browser-cli set-extension-port <port>` 修改。
+- `18767`：CLI HTTP API 端口，供 CLI 复用会话，不能作为插件端口使用。
+
+CLI 修改插件端口：
+
+```bash
+agent-browser-cli set-extension-port 18766
+```
+
+该命令会写入配置文件；如果 daemon 正在运行，会自动重启 daemon，让新端口立即生效。
+
+也可以手动修改配置文件。配置文件位于 `~/.agent-browser-cli/config.json`，不存在时会自动生成：
+
+```json
+{
+  "extension_port": 18765
+}
+```
+
+手动修改示例：
+
+```json
+{
+  "extension_port": 18766
+}
+```
+
+手动改配置后需要执行 `agent-browser-cli restart`，daemon 才会按新端口重新监听。
+
+Chrome 插件 popup 中也可以修改插件端口并立即重连。插件端口必须和 CLI 配置中的 `extension_port` 一致。
+
 
-扩展连接后会在页面右侧显示 Chrome 插件提示角标。角标支持拖动位置，鼠标悬浮时展开；10 秒无命令后自动隐藏，也可以点击 `本次隐藏` 手动隐藏，本次服务连接周期内不再显示，约 300 秒服务断开并下次重连后恢复。
 
 ## 快速自检
 
@@ -155,26 +190,13 @@ agent-browser-cli tabs
 
 ## 更新
 
-```bash
-git pull
-cargo build --release
-./target/release/agent-browser-cli restart
-```
-
-如果 Chrome 扩展有更新，在 `chrome://extensions` 中重新加载 `assets/tmwd_cdp_bridge` 扩展。
-
-当前扩展配置标识为：
-
-```js
-const TID = '__agent_browser_cli_bridge_26c9f1';
+ai一句话更新
+```text
+请阅读 https://github.com/sleepinginsummer/agent-browser-cli/blob/main/AI_INSTALL.md，按说明更新 CLI、重新下载插件zip让用户指定位置，用户手动加载 Chrome 扩展，并更新相关 SKILL.md`。
 ```
 
-如果你把 skill 安装到了 Codex/Agent 的全局目录，更新后同步复制：
+如果 Chrome 扩展有更新，在 `chrome://extensions` 中重新下载zpi覆盖，然后重新加载 `assets/tmwd_cdp_bridge` 扩展。
 
-```bash
-mkdir -p ~/.agents/skills/agent-browser-cli
-cp skills/agent-browser-cli/SKILL.md ~/.agents/skills/agent-browser-cli/SKILL.md
-```
 
 ## 卸载
 
@@ -193,10 +215,7 @@ rm -rf ~/.agents/skills/agent-browser-cli
 
 最后在 Chrome 扩展管理页中移除 `TMWD CDP Bridge` 扩展，或删除已加载的 `assets/tmwd_cdp_bridge` 扩展配置。
 
-## 端口
 
-- `18765`：底层 `TMWebDriver` WebSocket，Chrome 扩展连接使用。
-- `18767`：外层 `agent-browser-cli` HTTP 服务，供 CLI 复用会话。
 
 ## 友情链接
 

package/README_EN.md

@@ -10,8 +10,9 @@ Browser perception · Page control · Chrome session reuse · CDP · Conditional
   <a href="https://github.com/sleepinginsummer/agent-browser-cli"><img src="https://img.shields.io/badge/CLI-agentbrowsercli-2ea44f" alt="CLI agentbrowsercli"></a>
   <a href="https://github.com/sleepinginsummer/agent-browser-cli/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green" alt="License MIT"></a>
   <a href="https://github.com/sleepinginsummer/agent-browser-cli"><img src="https://img.shields.io/badge/sys-win%2Fmac%2Flinux-0078D6?labelColor=0078D6&color=C0C0C0" alt="sys win/mac/linux"></a>
-  <a href="https://github.com/sleepinginsummer/agent-browser-cli/releases"><img src="https://img.shields.io/badge/release-v0.2.7-blue" alt="release v0.2.7"></a>
+  <a href="https://github.com/sleepinginsummer/agent-browser-cli/releases"><img src="https://img.shields.io/badge/release-v0.2.9-blue" alt="release v0.2.9"></a>
   <a href="https://github.com/sleepinginsummer/agent-browser-cli/pulls"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs welcome"></a>
+  <a href="https://github.com/sleepinginsummer/agent-browser-cli/stargazers"><img src="https://img.shields.io/github/stars/sleepinginsummer/agent-browser-cli?label=stars&color=yellow" alt="GitHub stars"></a>
 </p>
 
 [AI One-Line Install](#ai-one-line-install) · [Manual Installation](#manual-installation) · [Chrome Extension](#chrome-extension) · [Update](#update) · [Uninstall](#uninstall) · [Friendly Links](#friendly-links)
@@ -26,7 +27,7 @@ This project is not Selenium or Playwright. It is better suited for helping agen
 
 ## Project Info
 
-- Current version: `0.2.7`
+- Current version: `0.2.9`
 - Supported platforms: Windows (including WSL) / Mac / Linux
 - Browser: Chrome, with the `assets/tmwd_cdp_bridge` extension loaded
 - Linux prerequisite: the local Chrome / Chromium build must support loading extensions
@@ -112,17 +113,49 @@ cargo build --release
 
 ## Chrome Extension
 
-Recommended: download `chrome-extensions.zip` from the [latest Release](https://github.com/sleepinginsummer/agent-browser-cli/releases/latest), extract it, open `chrome://extensions` in Chrome, enable `Developer mode`, click `Load unpacked`, and select the extracted `tmwd_cdp_bridge` directory.
+1. Recommended: download `chrome-extensions.zip` from the [latest Release](https://github.com/sleepinginsummer/agent-browser-cli/releases/latest), extract it, open `chrome://extensions` in Chrome, enable `Developer mode`, click `Load unpacked`, and select the extracted `tmwd_cdp_bridge` directory.
 
-When building from local source, you can also load this extension directory directly:
+2. When building from local source, you can also load this extension directory directly:
 
 ```text
 assets/tmwd_cdp_bridge
 ```
 
-Chrome needs at least one normal web page tab open. Do not leave it only on `about:blank` or `chrome://` pages.
+3. Chrome needs at least one normal web page tab open. Do not leave it only on `about:blank` or `chrome://` pages.
+4. After the extension is connected, a Chrome extension tip badge appears on the right side of the page. The badge position is draggable and expands on hover. It auto-hides after 10 seconds without commands, and you can also click `Hide for this session` to hide it manually. Manual hiding lasts for the current service connection cycle and resets after the service disconnects after about 300 seconds and reconnects.
 
-After the extension is connected, a Chrome extension tip badge appears on the right side of the page. The badge position is draggable and expands on hover. It auto-hides after 10 seconds without commands, and you can also click `Hide for this session` to hide it manually. Manual hiding lasts for the current service connection cycle and resets after the service disconnects after about 300 seconds and reconnects.
+### Custom Chrome Extension WebSocket Port
+
+- `18765`: default extension WebSocket port, used by the Chrome extension. It can be changed with `agent-browser-cli set-extension-port <port>`.
+- `18767`: CLI HTTP API port, used by the CLI to reuse the session. It cannot be used as the extension port.
+
+Change the extension port from CLI:
+
+```bash
+agent-browser-cli set-extension-port 18766
+```
+
+This command writes the config file. If the daemon is running, it restarts the daemon so the new port takes effect immediately.
+
+You can also edit the config file manually. The config file is `~/.agent-browser-cli/config.json`. It is created automatically when missing:
+
+```json
+{
+  "extension_port": 18765
+}
+```
+
+Manual edit example:
+
+```json
+{
+  "extension_port": 18766
+}
+```
+
+After manually editing the config file, run `agent-browser-cli restart` so the daemon listens on the new port.
+
+The Chrome extension popup can also update the extension port and reconnect immediately. The popup port must match the CLI `extension_port` config.
 
 ## Quick Check
 
@@ -155,26 +188,13 @@ agent-browser-cli tabs
 
 ## Update
 
-```bash
-git pull
-cargo build --release
-./target/release/agent-browser-cli restart
-```
-
-If the Chrome extension has updates, reload the `assets/tmwd_cdp_bridge` extension in `chrome://extensions`.
+AI one-line update:
 
-Current extension bridge identifier:
-
-```js
-const TID = '__agent_browser_cli_bridge_26c9f1';
+```text
+Please read https://github.com/sleepinginsummer/agent-browser-cli/blob/main/AI_INSTALL.md, follow the instructions to update the CLI, download the extension zip again to the user-specified location, ask the user to manually load the Chrome extension, and update the related SKILL.md.
 ```
 
-If you installed the skill into a global Codex/Agent directory, copy it again after updating:
-
-```bash
-mkdir -p ~/.agents/skills/agent-browser-cli
-cp skills/agent-browser-cli/SKILL.md ~/.agents/skills/agent-browser-cli/SKILL.md
-```
+If the Chrome extension has updates, download the zip again, overwrite the existing files, and reload the `assets/tmwd_cdp_bridge` extension in `chrome://extensions`.
 
 ## Uninstall
 
@@ -193,11 +213,6 @@ rm -rf ~/.agents/skills/agent-browser-cli
 
 Finally, remove the `TMWD CDP Bridge` extension from Chrome's extension management page, or remove the loaded `assets/tmwd_cdp_bridge` extension configuration.
 
-## Ports
-
-- `18765`: underlying `TMWebDriver` WebSocket, used by the Chrome extension.
-- `18767`: outer `agent-browser-cli` HTTP service, used by the CLI to reuse the session.
-
 ## Friendly Links
 
 - [LINUX DO - A New Ideal Community](https://linux.do/)

package/assets/tmwd_cdp_bridge/background.js

@@ -16,9 +16,13 @@ chrome.runtime.onInstalled.addListener(() => {
 });
 
 let lastCommandAt = 0;
+const DEFAULT_WS_PORT = 18765;
+const CLI_API_PORT = 18767;
+let wsPort = DEFAULT_WS_PORT;
 
 async function handleExtMessage(msg, sender) {
   if (msg.cmd === 'status') return handleStatus();
+  if (msg.cmd === 'setPort') return await handleSetPort(msg);
   lastCommandAt = Date.now();
   if (msg.cmd === 'cookies') return await handleCookies(msg, sender);
   if (msg.cmd === 'cdp') return await handleCDP(msg, sender);
@@ -78,12 +82,27 @@ function handleStatus() {
     ok: true,
     data: {
       wsConnected: !!ws && ws.readyState === WebSocket.OPEN,
-      wsUrl: WS_URL,
+      wsUrl: getWsUrl(),
+      wsPort,
       lastCommandAt
     }
   };
 }
 
+async function handleSetPort(msg) {
+  const port = normalizePort(msg.port);
+  await saveWsPort(port);
+  reconnectWS();
+  return {
+    ok: true,
+    data: {
+      wsPort,
+      wsUrl: getWsUrl(),
+      wsConnected: !!ws && ws.readyState === WebSocket.OPEN
+    }
+  };
+}
+
 chrome.runtime.onMessage.addListener((msg, sender, sendResponse) => {
   handleExtMessage(msg, sender).then(sendResponse);
   return true;
@@ -250,11 +269,36 @@ function buildCdpScript(code) {
 
 // --- WebSocket Client for TMWebDriver ---
 let ws = null;
-const WS_URL = 'ws://127.0.0.1:18765';
+
+function normalizePort(port) {
+  const value = Number(port);
+  if (!Number.isInteger(value) || value < 1 || value > 65535) {
+    throw new Error('端口必须是 1-65535');
+  }
+  if (value === CLI_API_PORT) {
+    throw new Error('18767 是 agent-browser-cli API 端口，请换一个插件端口');
+  }
+  return value;
+}
+
+async function loadWsPort() {
+  const data = await chrome.storage.local.get({ wsPort: DEFAULT_WS_PORT });
+  wsPort = normalizePort(data.wsPort);
+  return wsPort;
+}
+
+async function saveWsPort(port) {
+  wsPort = normalizePort(port);
+  await chrome.storage.local.set({ wsPort });
+}
+
+function getWsUrl() {
+  return `ws://127.0.0.1:${wsPort}`;
+}
 
 function scheduleProbe() {
   // Use chrome.alarms to survive MV3 service worker suspension
-  chrome.alarms.create('tmwd-ws-probe', { delayInMinutes: 0.083 }); // ~5s
+  chrome.alarms.create('tmwd-ws-probe', { delayInMinutes: 0.017 }); // ~1s
 }
 
 function scheduleKeepalive() {
@@ -266,7 +310,7 @@ async function isServerAlive() {
   try {
     const ctrl = new AbortController();
     setTimeout(() => ctrl.abort(), 2000);
-    await fetch('http://127.0.0.1:18765', { signal: ctrl.signal });
+    await fetch(`http://127.0.0.1:${wsPort}`, { signal: ctrl.signal });
     return true; // Got HTTP response → port is listening
   } catch (e) {
     return false; // Network error (connection refused) or timeout → server not alive
@@ -372,12 +416,20 @@ async function handleWsExec(data) {
   }
 }
 
-function connectWS() {
+async function connectWS() {
+  await loadWsPort();
   if (ws && ws.readyState <= 1) return; // CONNECTING or OPEN
+  if (!(await isServerAlive())) {
+    console.warn('[TMWD-WS] Server not ready, retrying later:', getWsUrl());
+    ws = null;
+    scheduleProbe();
+    return;
+  }
   ws = null;
-  console.log('[TMWD-WS] Connecting to', WS_URL);
+  const wsUrl = getWsUrl();
+  console.log('[TMWD-WS] Connecting to', wsUrl);
   try {
-    ws = new WebSocket(WS_URL);
+    ws = new WebSocket(wsUrl);
   } catch (e) {
     console.error('[TMWD-WS] Constructor error:', e);
     ws = null;
@@ -429,11 +481,21 @@ function connectWS() {
     scheduleProbe();
   };
   ws.onerror = (e) => {
-    console.error('[TMWD-WS] Error:', e);
+    console.warn('[TMWD-WS] Connection warning:', e);
     // onclose will fire after this, which triggers reconnect
   };
 }
 
+function reconnectWS() {
+  if (ws) {
+    try { ws.onclose = null; ws.close(); } catch (_) {}
+  }
+  ws = null;
+  chrome.alarms.clear('tmwd-ws-probe');
+  chrome.alarms.clear('tmwd-ws-keepalive');
+  connectWS();
+}
+
 // Initial connect + wake-up hooks
 connectWS();
 injectContentScriptsIntoExistingTabs();

package/assets/tmwd_cdp_bridge/config.js

@@ -1 +1 @@
-const TID = '__agent_browser_cli_bridge_26c9f1';
+globalThis.__agent_browser_cli_TID = '__agent_browser_cli_bridge_26c9f1';

package/assets/tmwd_cdp_bridge/content.js

@@ -1,4 +1,5 @@
 ;(function(){ if (/streamlit/i.test(document.title)) return;
+const TID = globalThis.__agent_browser_cli_TID || '__agent_browser_cli_bridge_26c9f1';
 if (window.__agentBrowserCliCleanup) window.__agentBrowserCliCleanup();
 if (window.__agentBrowserCliObserverCleanup) window.__agentBrowserCliObserverCleanup();
 document.querySelectorAll('#agent-browser-cli-ind,#agent-browser-cli-style').forEach(e => e.remove());

package/assets/tmwd_cdp_bridge/manifest.json

@@ -10,6 +10,7 @@
     "debugger",
     "scripting",
     "alarms",
+    "storage",
     "declarativeNetRequest",
     "management",
     "contentSettings"
@@ -37,4 +38,4 @@
     "default_popup": "popup.html",
     "default_title": "TMWD CDP Bridge"
   }
-}
+}

package/assets/tmwd_cdp_bridge/popup.html

@@ -3,17 +3,32 @@
 <head>
 <meta charset="utf-8">
 <style>
-body{width:420px;max-height:500px;margin:0;padding:8px;font:12px monospace;background:#1e1e1e;color:#d4d4d4;overflow-y:auto}
+body{width:420px;max-height:560px;margin:0;padding:8px;font:12px monospace;background:#1e1e1e;color:#d4d4d4;overflow-y:auto}
 h3{margin:4px 0;color:#569cd6}
 button{background:#264f78;color:#fff;border:none;padding:4px 12px;cursor:pointer;border-radius:3px;margin-bottom:6px}
 button:hover{background:#37699e}
+input{width:86px;background:#252526;color:#d4d4d4;border:1px solid #3c3c3c;border-radius:3px;padding:4px;font:12px monospace}
+label{display:inline-flex;align-items:center;gap:6px;margin-right:6px}
+.panel{margin-bottom:8px;padding:6px;background:#252526;border-radius:3px}
+.row{display:flex;align-items:center;gap:6px;margin-top:6px}
+.status{color:#9cdcfe}
+.error{color:#f48771}
 pre{white-space:pre-wrap;word-break:break-all;margin:0;padding:6px;background:#252526;border-radius:3px;max-height:420px;overflow-y:auto}
 </style>
 </head>
 <body>
+<h3>🔌 Bridge</h3>
+<div class="panel">
+  <div id="bridgeStatus" class="status">读取连接状态...</div>
+  <div class="row">
+    <label>端口 <input id="port" type="number" min="1" max="65535"></label>
+    <button id="savePort">保存并重连</button>
+  </div>
+  <div id="portMsg"></div>
+</div>
 <h3>🍪 Cookies</h3>
 <button id="refresh">刷新</button>
 <pre id="out">点击刷新获取 cookies...</pre>
 <script src="popup.js"></script>
 </body>
-</html>
+</html>

package/assets/tmwd_cdp_bridge/popup.js

@@ -1,10 +1,49 @@
 document.addEventListener('DOMContentLoaded', () => {
-  const out = document.getElementById('out');
   const btn = document.getElementById('refresh');
+  const savePortBtn = document.getElementById('savePort');
   btn.addEventListener('click', fetchCookies);
+  savePortBtn.addEventListener('click', savePort);
+  refreshBridgeStatus();
   fetchCookies();
 });
 
+async function refreshBridgeStatus() {
+  const status = document.getElementById('bridgeStatus');
+  const portInput = document.getElementById('port');
+  try {
+    const resp = await chrome.runtime.sendMessage({ cmd: 'status' });
+    if (!resp?.ok) throw new Error(resp?.error || 'unknown');
+    const data = resp.data || {};
+    portInput.value = data.wsPort || 18765;
+    status.textContent = `状态: ${data.wsConnected ? '已连接' : '未连接'} ${data.wsUrl || ''}`;
+  } catch (e) {
+    status.textContent = '状态读取失败: ' + e.message;
+    status.className = 'error';
+  }
+}
+
+async function savePort() {
+  const portInput = document.getElementById('port');
+  const portMsg = document.getElementById('portMsg');
+  try {
+    const port = Number(portInput.value);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+      throw new Error('端口必须是 1-65535');
+    }
+    if (port === 18767) {
+      throw new Error('18767 是 agent-browser-cli API 端口，请换一个插件端口');
+    }
+    const resp = await chrome.runtime.sendMessage({ cmd: 'setPort', port });
+    if (!resp?.ok) throw new Error(resp?.error || 'unknown');
+    portMsg.textContent = `Success: 已保存端口 ${port}，正在使用新端口重连`;
+    portMsg.className = 'status';
+    await refreshBridgeStatus();
+  } catch (e) {
+    portMsg.textContent = '保存失败: ' + e.message;
+    portMsg.className = 'error';
+  }
+}
+
 async function fetchCookies() {
   const out = document.getElementById('out');
   try {
@@ -21,4 +60,4 @@ async function fetchCookies() {
     const str = resp.data.map(c => `${c.name}=${c.value}`).join('; ');
     await navigator.clipboard.writeText(str);
   } catch (e) { out.textContent = 'Error: ' + e.message; }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleepinsummer/agent-browser-cli",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Agent-oriented browser sensing and control CLI backed by a native Rust daemon.",
   "license": "MIT",
   "bin": {
@@ -18,14 +18,16 @@
   ],
   "scripts": {
     "build": "cargo build --release",
+    "version": "node scripts/sync-optional-deps.mjs && git add package.json package-lock.json",
+    "prepack": "node scripts/sync-optional-deps.mjs",
     "postinstall": "node npm/postinstall.js"
   },
   "optionalDependencies": {
-    "@sleepinsummer/agent-browser-cli-darwin-arm64": "0.2.7",
-    "@sleepinsummer/agent-browser-cli-darwin-x64": "0.2.7",
-    "@sleepinsummer/agent-browser-cli-linux-x64": "0.2.7",
-    "@sleepinsummer/agent-browser-cli-linux-arm64": "0.2.7",
-    "@sleepinsummer/agent-browser-cli-win32-x64": "0.2.7"
+    "@sleepinsummer/agent-browser-cli-darwin-arm64": "0.2.9",
+    "@sleepinsummer/agent-browser-cli-darwin-x64": "0.2.9",
+    "@sleepinsummer/agent-browser-cli-linux-x64": "0.2.9",
+    "@sleepinsummer/agent-browser-cli-linux-arm64": "0.2.9",
+    "@sleepinsummer/agent-browser-cli-win32-x64": "0.2.9"
   },
   "engines": {
     "node": ">=18"

package/skills/agent-browser-cli/SKILL.md

@@ -44,7 +44,7 @@ assets/tmwd_cdp_bridge
 扩展配置必须存在：
 
 ```js
-const TID = '__agent_browser_cli_bridge_26c9f1';
+globalThis.__agent_browser_cli_TID = '__agent_browser_cli_bridge_26c9f1';
 ```
 
 对应文件：
@@ -72,13 +72,36 @@ agent-browser-cli restart
 ```
 
 常驻服务端口：
-- `18765`：底层 `TMWebDriver` WebSocket，Chrome 扩展连接使用。
-- `18767`：外层 `agent-browser-cli` HTTP 服务，供 CLI 复用会话。
+- `18765`：默认插件 WebSocket 端口，Chrome 扩展连接使用，可通过插件 popup 或 `agent-browser-cli set-extension-port <port>` 修改。
+- `18767`：外层 `agent-browser-cli` HTTP API 端口，供 CLI 复用会话，不能作为插件端口使用。
+
+插件端口配置文件：
+
+```text
+~/.agent-browser-cli/config.json
+```
+
+最小配置：
+
+```json
+{
+  "extension_port": 18765
+}
+```
+
+CLI 修改插件端口：
+
+```bash
+agent-browser-cli set-extension-port 18766
+```
+
+Chrome 插件 popup 也可以修改插件端口并立即重连。插件端口必须和 CLI 配置中的 `extension_port` 一致。
 
 成功标志：
 - 返回 `status=success`
 - 能看到 `tabs_count`
-- 首次运行会拉起本地 WS 服务 `ws://127.0.0.1:18765`
+- `agent-browser-cli status` 中 `ports.extension.matched=true`
+- `agent-browser-cli status` 中 `connection.extension_connected=true`
 
 ## 推荐 CLI 调用