当前位置：首页 > news >正文

一天一个开源项目（第64篇）：OpenCLI - 把任意网站、Electron 应用与本地工具变成统一 CLI

news 2026/5/23 13:43:07

引言

“Make any website, Electron App, or Local Tool your CLI.”

这是「一天一个开源项目」系列的第 64 篇文章。今天介绍的项目是OpenCLI（GitHub）。

终端里的「万能入口」一直是开发者梦寐以求的形态：既要能调gh、docker，又要能刷 B 站热榜、查知乎、管小红书，最好还能让 AI Agent 一眼发现、一键调用。OpenCLI的定位很直接：把任意网站、Electron 桌面应用或本地 CLI 工具，标准化成统一的命令行接口；通过Browser Bridge（Chrome/Chromium 扩展 + 微守护进程）复用你已登录的浏览器会话，配合70+ 预置适配器、CLI Hub 透传（opencli gh、opencli docker等）、Electron 应用适配（如 Cursor、Antigravity、ChatGPT 桌面版等），以及面向 AI 的opencli-operate技能（点击、输入、截图、抽取等浏览器操作），让「人」和「Agent」共用同一套工具目录。

为什么值得看？

🧩统一 CLI Hub：一个opencli入口，内置站点命令 + 外部 CLI 注册与发现
🔐账号相对安全：浏览器命令复用 Chrome/Chromium 登录态，凭据不离开浏览器语境（以官方 README 说明为准）
🤖为 AI Agent 设计：Skills、AGENT.md/.cursorrules里配置opencli list便于自动发现
🌐网站即 CLI：explore/synthesize/record等流程，把交互沉淀为可脚本化命令
🖥️Electron 也可 CLI 化：桌面 AI 应用、IDE、IM 等可通过适配从终端驱动
📦输出可管道化：table/json/yaml/md/csv，Unix 退出码约定便于 CI

你将学到什么

OpenCLI 的产品分层：Browser Bridge、守护进程、CLI 本体、扩展之间的关系
内置能力：站点适配器、CLI Hub、Electron 适配、插件机制
AI 侧集成：opencli-operate、explore/synthesize/cascade等工作流
隐私与边界：登录态复用、Provider 条款、Sparkle 式更新以外的数据流（以文档为准）
本地开发与排障：opencli doctor、常见错误码与扩展连接问题

前置知识

Node.js 20+（或 Bun 1.0+）与 npm 全局安装经验
Chrome / Chromium 与「加载未打包扩展」的基本操作
熟悉终端与管道（jq、脚本、CI）更佳
若开发适配器：TypeScript / YAML、浏览器自动化概念（可选）

项目背景

项目简介

OpenCLI是一个Node.js 编写的通用命令行运行时：一侧连接浏览器（通过扩展 + 本地守护进程，复用用户已登录站点），另一侧聚合本地已安装的 CLI（gh、docker、飞书lark-cli等），并可把Electron 桌面应用通过 CDP 等方式纳入同一「命令表」。项目强调Deterministic（相同命令、稳定输出结构）、可脚本化、对 AI Agent 友好（Skills、命令发现、文档内嵌工作流）。

典型用法包括：在终端拉取各站内容（JSON 管道给 LLM）、让 Agent 通过operate控制真实浏览器完成复杂页面操作、把团队内部工具opencli register后纳入统一发现列表。

作者/团队介绍

维护者：jackwener（仓库主账号）
分发：npm 包名为@jackwener/opencli
许可证：Apache-2.0

项目数据

⭐GitHub Stars: 约 12,570（以仓库页面为准，会随时间变化）
🍴Forks: 以 GitHub 页面为准
📦版本：见 npm 与 Releases
📄License: Apache-2.0
🌐文档：仓库内README.md、README.zh-CN.md、docs/

主要功能

核心作用

网站 → CLI：对 Bilibili、知乎、小红书、Twitter/X、Reddit、YouTube 等提供子命令；总计70+ 适配器（文档中有完整列表入口）。
浏览器自动化（operate）：为 AI Agent 提供可脚本化的页面操作指令集（open、click、type、screenshot 等，见官方 Skills）。
CLI Hub：opencli gh、opencli docker等透传；缺失时可尝试通过包管理器自动安装（如 README 所述brew install再执行）。
Electron / 桌面应用：内置多类桌面应用适配说明（Cursor、Codex、Antigravity、ChatGPT 桌面版等），并给出扩展阅读文档链接。
插件生态：支持社区 YAML/TS 插件安装与更新。
输出与退出码：多格式输出 + 对齐sysexits.h的退出码，便于 shell 与 CI。

使用场景

终端里消费站点数据
- 热榜、搜索、时间线等，配合-f json管道给脚本或模型。
AI Agent 统一工具发现
- 在AGENT.md或.cursorrules中引导执行opencli list，减少「不知道有哪些工具」的摩擦。
把重复网页操作固化成命令
- 使用record/ 生成适配器相关工作流，将一次性操作变为可复用 CLI。
在自动化里驱动桌面 AI 应用
- 通过文档中的 Electron 适配路径，从终端编排「应用级」任务（需阅读对应适配文档与合规边界）。
与现有 CLI 共存
- 不替换gh或docker，而是通过 Hub 统一入口与发现。

快速开始

1. 安装 Browser Bridge 扩展

从 GitHub Releases 下载opencli-extension.zip，在chrome://extensions开启开发者模式后Load unpacked。

2. 安装 CLI

npminstall-g@jackwener/opencli

3. 自检与试用

opencli doctor opencli daemon status opencli list opencli hackernewstop--limit5opencli bilibili hot--limit5

说明：hackernews等可走公开 API；需要登录态的站点需先在 Chrome/Chromium 中登录对应网站（见 README 前置说明）。

4.（可选）为 AI 安装 Skills

npx skillsaddjackwener/opencli# 或按需安装 opencli-usage、opencli-operate、opencli-explorer、opencli-oneshot

核心特性

CLI All Electron：将部分 Electron 应用暴露为可脚本化命令（详见docs/adapters/desktop/）。
Browser Automation（operate）：面向 Agent 的浏览器操控能力，与opencli-operateSkill 配套。
Website → CLI：大量预置适配器 +explore/synthesize/generate等生成与注册流程。
账号与风控：复用真实浏览器登录；README 宣称多层反自动化指纹处理（webdriver、chrome 对象等），以降低被站点风控的概率（效果因站点策略而异）。
CLI Hub 与 register：opencli register mycli将自有 CLI 纳入列表。
插件：opencli plugin install等子命令管理社区插件。
多格式输出：table（默认）、json、yaml、md、csv。
Self-healing：opencli doctor诊断扩展、守护进程与连接。
运行时零 LLM 费用：README 强调常规命令运行不消耗大模型 Token（与「生成适配器时是否调用模型」需区分阅读文档）。

项目优势

对比项	OpenCLI	单一站点爬虫脚本	纯 Playwright 自写
统一入口与发现	✅`opencli list`+ Hub	❌ 各写各的	⚠️ 需自建规范
登录态	✅ 复用用户浏览器	⚠️ 常要单独处理 Cookie	⚠️ 需自行维护会话
AI 集成	✅ Skills + operate 工作流	❌ 通常无	⚠️ 需自建
输出规范	✅ 多格式 + 退出码约定	⚠️ 视项目而定	⚠️ 视项目而定
学习成本	⚠️ 需装扩展与理解概念	✅ 单点脚本简单	❌ 工程量大