laohan-xiazai

# 从互联网拿内容 按平台选择正确方法，一步到位。先看平台路由表，再读对应 reference 文件。平台方法不行时，按品类降级链逐层深入——每层解决不同问题，能浅不深。 ## 核心理念 能浅不深——先用最轻的方法（HTTP 请求），不行再加重量（浏览器渲染→反检测→AI 操作→手动控制）。成本递增，每层解决不同问题，不要跳层。 ## 不适用场景 - 批量爬取/爬虫开发 → 这不是爬虫框架，是一次性内容获取工具 - 需要登录才能访问且用户未登录 → 告诉用户先登录对应平台，web-access CDP 可以接管已登录的 Chrome - 下载付费内容/会员内容 → 不处理侵权场景 ## 前置检查（定期更新，命令报错时必做） > opencli 高频发版（每周 2-3 次），但**不需要每次使用都更新**——定期（如每周）更新，或命令报错/找不到新命令时再更新即可。 ### 第1步：更新 opencli（npm 包） ```bash npm update -g @jackwener/opencli ``` ### 第2步：更新 opencli skills（npx 管理） ```bash npx skills update -g -y ``` opencli 自带 4 个辅助 skill，随 opencli 仓库更新但独立于 npm 包。必须单独更新： - **opencli-usage**：查命令总览，不确定有什么命令时用 - **opencli-autofix**：命令失败时自动诊断修复（SELECTOR 错误、页面结构变化等） - **opencli-browser**：浏览器自动化操作 - **opencli-adapter-author**：写新的 opencli 适配器 ### 第3步：查最新命令比对文档 ```bash opencli <platform> --help ``` opencli 经常加新命令（如 4 月加了 bilibili download、xiaohongshu download），SKILL 文档可能滞后。**发现新命令时更新对应 reference 文件。** ### 第4步：检查 Browser Bridge ```bash opencli doctor ``` 3 项全绿（Daemon + Extension + Connectivity）才能用 Cookie 命令。失败时排障： 1. `opencli doctor` 看哪项失败 2. daemon 没跑 → `opencli daemon restart`（opencli 自带 daemon 管理，**不要用 launchctl**——opencli 不提供 LaunchAgent） 3. daemon 在跑但扩展未连 → 让用户 `chrome://extensions/` 关开 OpenCLI 扩展 4. 都 OK 还连不上 → `opencli daemon stop` 后再跑任意 `opencli <命令>` 触发 daemon 自启 ### 命令失败时的处理 1. 先用 **opencli-autofix** skill 诊断：`OPENCLI_DIAGNOSTIC=1` 重跑失败命令 2. 修复成功 → 更新 reference 文件记录正确方法 3. 修复失败 → 按降级链切换方法 ## 快速路由 ### 场景 A：下载（视频/音频/字幕/博主数据） 先判断平台，再读对应的 reference 文件： | ...