BibiGPT CLI（bibi）

通过终端调用 BibiGPT API，对视频、音频及播客内容进行摘要。

安装

macOS（Homebrew）

brew install --cask jimmylv/bibigpt/bibigpt

Windows

从以下地址下载安装程序：https://bibigpt.co/download/desktop

winget install BibiGPT --source winget

验证安装

bibi --version

认证

安装完成后，用户需至少通过桌面端应用登录一次。CLI 会自动从桌面端应用的设置中读取已保存的会话信息。

或者，可手动设置 API Token：

export BIBI_API_TOKEN=

在 Windows（PowerShell）中：

$env:BIBI_API_TOKEN=""

命令

对 URL 内容生成摘要

重要提示：URL 中若包含 ? 或 & 字符，必须用引号包裹，以避免 Shell 通配符解析错误。

# 基础摘要（Markdown 格式输出至 stdout）
bibi summarize ""

# 异步模式 —— 推荐用于时长较长的视频（>30 分钟）
bibi summarize "" --async

# 按章节生成摘要
bibi summarize "" --chapter

# 仅获取字幕/转录文本（不触发 AI 摘要）
bibi summarize "" --subtitle

# 输出完整 JSON 响应
bibi summarize "" --json

# 组合使用多个标志
bibi summarize "" --subtitle --json

支持的 URL 类型：YouTube、Bilibili、播客、音频文件，以及 BibiGPT 支持的所有其他 URL。

认证管理

# 检查当前认证状态
bibi auth check

# 打开浏览器进行登录
bibi auth login

# 显示如何设置 API Token
bibi auth set-token 

更新

# 检查是否有新版本可用
bibi check-update

# 下载并安装最新版本
bibi self-update

输出格式

• 默认格式：Markdown 摘要文本输出至 stdout；进度信息输出至 stderr。
• --json：将完整的 API 响应以美化格式的 JSON 输出至 stdout。

因此，您可以直接对输出进行管道操作：

bibi summarize "" > summary.md
bibi summarize "" --json | jq '.summary'

错误处理

使用技巧

• 对于极长的视频，请使用 --async 参数，以避免 HTTP 超时。
• 使用 --subtitle 可获取原始字幕/转录文本，跳过 AI 摘要环节。
• 当需要结构化数据（例如 sourceUrl、htmlUrl、detail）时，请使用 --json。
• --chapter 标志可提供分章节摘要，适用于课程讲解或教学类视频。
• 该 CLI 不会启动任何 GUI 窗口 —— 所有输出均定向至终端。
• 建议定期运行 bibi check-update，及时获取新功能与错误修复。