docs: fix extension install instructions — no store yet, no restart needed

- Remove 'Chrome Web Store' references (not published yet)
- Add detailed unpacked extension install steps (chrome://extensions)
- Remove 'restart Chrome' advice (Service Worker activates immediately)
- Direct users to chrome://extensions for troubleshooting
This commit is contained in:
jackwener committed 2026-03-19 16:57:40 +08:00
1 parent beda0b714c
commit 3b6f72ca08
3 files changed
+9 -7

No files matched your search

+4 -3
View File
@@ -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**
+4 -3
View File
@@ -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 等)**
+1 -1
View File
@@ -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.