opencli-explorer

从零到发布：API 发现 → 认证策略 → 写适配器 → 测试验证。 [!CAUTION] 必须通过浏览器打开目标网站去探索！ 不要只靠静态分析。 很多 API 是 懒加载 的——字幕、评论、关注列表等深层数据只有点击后才触发。 用上方工作流打开页面 → 模拟交互 → 抓包。关注： Vue + Pinia → 可用 Store Action 绕过签名（Tier 4）。 先复用现有适配器 ，不要从零开始： 改 3 处即可： name 、API URL、字段映射。 Bilibili 平台 SDK （ clis/bilibili/utils.js ）： 所有适配器统一使用 cli() API，放入 clis/ / .js 即自动注册。 完整模板（Tier 1~4）、分页模式、错误处理规范（ throw CliError + YAML envelope）→ adapter-templates.md 最简结构 （Tier 2 Cookie）： 级联请求、tap 调试、抗变更模式 → advanced-patterns.md 构建通过 ≠ 功能正常 。必须实际运行并确认输出。 两种开发场景 ： Done 标准 ：命令运行后返回非空表格，且字段符合预期。 生成的候选 TS 保存在 .opencli/explore/mysite/candidates/ ，复制到 clis/mysite/ 并微调。 - URL pattern ： /api/v2/hot?limit=20 → 要调用的端点 - Method ：GET / POST - Request Headers ：Cookie? Bearer? 自定义签名头（X-s、X-t）? - Response Body ：数据路径（ data.items 、 data.list ） - 后缀爆破法 ( .json ) ：Reddit、雪球等，URL 加 .json 直接拿 REST 数据（Tier 2 秒杀） - 全局状态法 ( __INITIAL_STATE__ ) ：SSR 站点（B站、小红书）首页数据挂载在 window 上 - 主动交互触发法 ：懒加载 API 需要点击按钮（"CC"、"展开全部"）才触发 - 框架 Store 截断 ：Vue + Pinia 站点，Store Action 代替你完成签名 - XHR/Fetch 拦截 ：最后手段，用 installInterceptor 抓包 - fetchJson(page, url) → 普通 Cookie-tier API - apiGet(page, path, {signed, params}) → URL 含 /wbi/ 的接口（自动签名） - getSelfUid(page) / resolveUid(page, input) → 用户 UID 处理 - Repo 贡献 ：文件放 clis/ / .js ， npm run build 后自动注册 - 私人 adapter （本地使用，无需提 PR）：文件放 ~/.opencli/clis/ / .js ，无需 build