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:
1 parent
beda0b714c
commit
3b6f72ca08
3 files changed
+9
-7
No files matched your search
@@ -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
@@ -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 等)**
|
||||
|
||||
@@ -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.
|
||||
|
||||
Reference in new issue
Block a user