啥是 OpenCLI

说实话，这玩意儿听起来像科幻。

其实它就是把各种网站、桌面 App、甚至本地工具，统一包装成一条条命令行。

你在终端敲 opencli github repo list，背后立马打开 Chrome、跑脚本、抓数据，然后把 JSON 扔回给你。

哈哈，这种“先开浏览器再回 CLI”的思路挺新鲜的。

先说 CLI，那是用户入口。

每一次 opencli xxx，dou把请求发到本机的 Daemon，再交给 Chrome Extension 去真正动手。

这个 Extension 就像桥梁，一边跟浏览器聊得嗨，一边把结果打包回 Daemon。

代码里主要是 dist/src/cli.js 负责解析参数、查找适配器，然后走 /command 接口。

别kan名字叫 HTTP POST，其实是本地环回，只要加上特制的 X-OpenCLI 头，就不会被普通浏览器拦截。

它负责两件事：

转发命令：把 CLI 发来的 JSON 包装进 WebSocket，送给 Extension。

结果回传：Extension 把执行结果推回 Daemon，再由 Daemon 用 HTTP 响应给 CLI。

The real worker.

P.S. 这里不是 Playwright，也不是直接 CDP。所有操作dou是通过 extension 的 API 完成的，比如 scripting.executeScript, TAB.create, TAB.update.

它不使用 Playwright，不从 CLI 进程直接发请求，而是在你Yi登录的 Chrome 浏览器里操作。

核心函数在 /dist/src/registry.js, 名叫 normalizeCommand. 它会根据适配器声明的 strategy 决定是否要打开浏览器，以及是否预先导航到首页。

function normalizeCommand {
    const strategy = cmd.strategy ?? ;
    const needBrowser = !.includes;
    let navigateBefore;
    if  && cmd.domain) {
        navigateBefore = `https://${cmd.domain}`;
    }
    return { ...cmd, strategy, needBrowser, navigateBefore };
}

- NAVIGATE： 打开目标 URL；

- EVALUATE： 在 V8 环境里跑自定义 JS；

- SLEEP／WAIT： 等页面稳定；

- SCRAPE／TRANSFORM： 提取 DOM 或拦截 XHR；

- CUSTOM OUTPUT： JSON、表格或 CSV。

说实话，这套 Pipeline Zui大亮点在于「自动重试」——只要一步出错，就会按照预设次数重新来一次基本不用手动调参。

opencli xiaohongshu search "旅行日记" -f csv
# 输出类似：
title,author,likes,url
"夏日海边","小明",1245,"https://www.xiaohongshu.com/note/xxxx"
...

背后发生了什么？大概流程如下：

Clique 打开 Chrome 并定位到搜索页；

# 注入 MutationObserver 等待列表渲染完毕；

# 用 page.evaluate 把每条 note 的标题、作者等信息读出来；

# 将数组通过 Daemon 返回给 CLI，再由 CLI 格式化为 CSV。

实际上还有一步「滚动加载」——因为采用无限滚动，需要循环滚到底部才Neng抓全量。

滚动逻辑封装在 `page.autoScroll` 里。

X‑OpenCLI Header: 必须带上自定义头部，否则 Extension 会直接拒绝连接。

No CORS: Daemon 不返回任何 Access‑Control‑Allow‑Origin，让普通网页无法直接访问。      

Body 限制: Zui大 1 MB，防止 OOM 攻击。

连接前检查 Origin 必须是 chrome-extension:// 开头。