diff --git a/README.md b/README.md index 525df39..6ea5a6e 100644 --- a/README.md +++ b/README.md @@ -53,7 +53,9 @@ OpenCLI connects to your browser through a lightweight **Browser Bridge** Chrome ### Browser Bridge Extension Setup -1. Install the **opencli Browser Bridge** extension in Chrome (from the Chrome Web Store or load the `extension/` folder as unpacked). +1. Install the **opencli Browser Bridge** extension in Chrome: + - Open `chrome://extensions`, enable **Developer mode** (top-right toggle) + - Click **Load unpacked**, select the `extension/` folder from this repo 2. That's it! The daemon auto-starts when you run any browser command. No tokens, no manual configuration. > **Tip**: Use `opencli doctor` for ongoing diagnosis: @@ -254,8 +256,7 @@ npx vitest run tests/e2e/ # E2E tests ## Troubleshooting - **"Extension not connected"** - - Ensure the opencli Browser Bridge extension is installed and **enabled** in your running Chrome. - - Restart Chrome if you just installed the extension. + - Ensure the opencli Browser Bridge extension is installed and **enabled** in `chrome://extensions`. - **Empty data returns or 'Unauthorized' error** - Your login session in Chrome might have expired. Open a normal Chrome tab, navigate to the target site, and log in or refresh the page. - **Node API errors** diff --git a/README.zh-CN.md b/README.zh-CN.md index 43a6d9a..5f3011d 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -54,7 +54,9 @@ OpenCLI 通过轻量化的 **Browser Bridge** Chrome 扩展 + 微型 daemon 与 ### Browser Bridge 扩展配置 -1. 在 Chrome 中安装 **opencli Browser Bridge** 扩展(从 Chrome Web Store 安装或加载 `extension/` 文件夹作为未打包扩展)。 +1. 在 Chrome 中安装 **opencli Browser Bridge** 扩展: + - 打开 `chrome://extensions`,启用右上角的 **开发者模式** + - 点击 **加载已解压的扩展程序**,选择本仓库的 `extension/` 文件夹 2. 完成!运行任何浏览器命令时 daemon 会自动启动。无需 token,无需手动配置。 > **Tip**:后续诊断用 `opencli doctor`: @@ -237,8 +239,7 @@ opencli cascade https://api.example.com/data ## 常见问题排查 - **"Extension not connected" 报错** - - 确保你当前的 Chrome 已安装且**开启了** opencli Browser Bridge 浏览器扩展。 - - 如果是刚装完扩展,需要重启 Chrome 浏览器。 + - 确保你当前的 Chrome 已安装且**开启了** opencli Browser Bridge 扩展(在 `chrome://extensions` 中检查)。 - **返回空数据,或者报错 "Unauthorized"** - Chrome 里的登录态可能已经过期。请打开当前 Chrome 页面,在新标签页重新手工登录或刷新该页面。 - **Node API 错误 (如 parseArgs, fs 等)** diff --git a/SKILL.md b/SKILL.md index 8ae61ac..ef87f84 100644 --- a/SKILL.md +++ b/SKILL.md @@ -34,7 +34,7 @@ npm update -g @jackwener/opencli Browser commands require: 1. Chrome browser running **(logged into target sites)** -2. **opencli Browser Bridge** Chrome extension installed (load `extension/` as unpacked or install from Chrome Web Store) +2. **opencli Browser Bridge** Chrome extension installed (load `extension/` as unpacked in `chrome://extensions`) 3. No further setup needed — the daemon auto-starts on first browser command > **Note**: You must be logged into the target website in Chrome before running commands. Tabs opened during command execution are auto-closed afterwards.