mirror of
https://github.com/jackwener/OpenCLI.git
synced 2026-09-14 18:25:42 +08:00
GanFanNewOrder
81de69be3a
* feat(1688): add browser adapter and docs * fix(1688): retry alternate store seed offers * feat(1688): harden adapter contracts and search pagination --------- Co-authored-by: 泽加武 <zejiawu@zejiawudeMac-mini.local>
2.2 KiB
2.2 KiB
Troubleshooting
Common Issues
"Extension not connected"
- Ensure the opencli Browser Bridge extension is installed and enabled in
chrome://extensions. - Run
opencli doctorto diagnose connectivity.
Empty data 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.
- Some sites have geographic restrictions (e.g., Bilibili, Zhihu from outside China).
Browser command opens the page but still cannot read context
- A healthy Browser Bridge connection does not guarantee that the current page target exposes the data your adapter expects.
- Some browser adapters are sensitive to the active host or page context.
- Example:
opencli 1688 itemmay fail withdid not expose product contextif the target is too broad. - Retry on a real item page, refresh the page in Chrome, and if needed narrow the target, for example:
OPENCLI_CDP_TARGET=detail.1688.com opencli 1688 item 841141931191 -f json
Node API errors
- Make sure you are using Node.js >= 20. Some dependencies require modern Node APIs.
- Run
node --versionto verify.
Daemon issues
# Check daemon status (PID, uptime, extension connection, memory)
opencli daemon status
# View extension logs
curl localhost:19825/logs
# Stop or restart the daemon
opencli daemon stop
opencli daemon restart
# Full diagnostics
opencli doctor
The daemon auto-exits after 4 hours of inactivity (no CLI requests and no extension connection). Override with
OPENCLI_DAEMON_TIMEOUT(milliseconds,0= never timeout).
Desktop adapter connection issues
For Electron/CDP-based adapters (Cursor, Codex, etc.):
- Make sure the app is launched with
--remote-debugging-port=XXXX - Verify the endpoint is set:
echo $OPENCLI_CDP_ENDPOINT - Test the endpoint:
curl http://127.0.0.1:XXXX/json/version
Build errors
# Clean rebuild
rm -rf dist/
npm run build
# Type check
npx tsc --noEmit
Getting Help
- GitHub Issues — Bug reports and feature requests
- Run
opencli doctorfor comprehensive diagnostics