bibi

BibiGPT — 视频总结 Agent 技能（总结 / 转录文本 / 章节）

此文件是发现存根，而非使用指南。它会告知你当前所处的模式，以及实时文档的位置。实时来源始终与当前产品保持一致；复制到此文件中的任何内容都会过时。

此技能仅用于观看视频。同一仓库中的其他技能（使用相同 CLI 和账号）：bibi-library（已保存的视频 / 笔记 / 合集）、bibi-feed（订阅 / 最新内容 / 标记为已查看）、bibi-vision（帧 / 思维导图）。 入口：https://bibigpt.co/mcp · 人工安装：https://bibigpt.co/agent 配额：Agent 技能渠道每天 Plus 100 次、Pro 300 次；额外调用使用 API 余额；升级：https://bibigpt.co/shop

1. 检测模式

如果存在，请运行 scripts/bibi-check.sh；否则按顺序检查：

检查	模式	说明
command -v bibi	CLI — 最佳选择：本地文件、桌面登录	macOS / Windows / Linux 桌面应用
已设置 $BIBI_API_TOKEN	API — HTTP 调用，可在任何地方使用	令牌：https://bibigpt.co/user/integration
MCP 客户端可用	MCP — 无需安装	连接 https://bibigpt.co/api/mcp（OAuth 2.1）

两者都不可用 → 安装桌面应用（macOS 上运行 brew install --cask jimmylv/bibigpt/bibigpt，Windows 上运行 winget install BibiGPT，Linux 上运行 curl -fsSL https://bibigpt.co/install.sh | bash），或获取 API 令牌。详情见：references/installation.md。

2. 加载实时文档（按模式）

CLI 模式 — CLI 是始终保持最新的文档来源：

bibi check-update            # once per session; run `bibi upgrade` if outdated
bibi --help                  # full command surface, grouped, with examples
bibi <command> --help        # progressive help — every --help includes examples
bibi commands                # re-fetch server-defined commands (new capabilities
                             # appear here without a binary update)

API 模式 — 机器可读规范是事实来源：

https://bibigpt.co/api/openapi.json      # all endpoints, schemas, auth

references/api.md 提供 curl 示例，但如有冲突，以规范为准。

MCP 模式 — 连接并列出工具；这些工具会自我描述：

https://bibigpt.co/api/mcp               # Streamable HTTP, OAuth 2.1

无需重新安装即可获取最新文档 — 此仓库通过 GitHub 提供原始文件：

https://raw.githubusercontent.com/JimmyLv/bibigpt-skill/main/skills/bibi/SKILL.md
https://raw.githubusercontent.com/JimmyLv/bibigpt-skill/main/skills/bibi/references/<name>.md
https://raw.githubusercontent.com/JimmyLv/bibigpt-skill/main/skills/bibi/workflows/<name>.md

如果下方的本地 workflows/ 或 references/ 路径缺失（通过 bibi skill 进行的仅嵌入式安装），请改为从上方的原始 URL 获取。

3. 意图路由

用户意图	工作流
总结视频/音频 URL	→ workflows/quick-summary.md
按章节拆解、详细分析	→ workflows/deep-dive.md
获取字幕、提取转录文本、原始文本	→ workflows/transcript-extract.md
改写成文章、博客文章、公众号图文、小红书内容	→ workflows/article-rewrite.md
改编成 TikTok / Reels / Shorts 风格的音乐视频	→ workflows/video-to-tiktok-mv.md
检查 SunoMV 音乐视频项目：进度、哪些镜头出现了谁、失败的镜头、项目 JSON	→ workflows/mv-project-read.md
处理多个 URL、批量总结	→ workflows/batch-process.md
跨多个视频研究某个主题	→ workflows/research-compile.md
保存到 Notion、Obsidian，导出笔记	→ workflows/export-notes.md
分析视觉内容、幻灯片、屏幕文字、思维导图	→ 同级技能 bibi-vision（回退方案：workflows/visual-analysis.md / workflows/advanced-tools.md）
查看当前账户、套餐或剩余分钟数	→ workflows/account-check.md
浏览/搜索已保存的视频、“我总结过哪些内容”	→ 同级技能 bibi-library（回退方案：workflows/library-browse.md）
管理频道订阅、列出/订阅/取消订阅	→ 同级技能 bibi-feed（回退方案：workflows/channels-manage.md）
查看订阅内容的新动态、最新动态、每日摘要	→ 同级技能 bibi-feed（回退方案：workflows/feed-latest.md）
管理合集，将已保存的视频列出/创建/分享为合集	→ 同级技能 bibi-library（回退方案：workflows/collections-manage.md）
管理已保存视频的个人笔记、编辑摘要	→ 同级技能 bibi-library（回退方案：workflows/notes-manage.md）
使用自定义提示词重新总结已保存项目、合集聊天	→ 同级技能 bibi-library（回退方案：workflows/advanced-tools.md）
HTTP 402 / “需要付款” / Alipay AI 钱包 / 无 token + 中国用户	→ references/billing-aipay.md

消歧：意图匹配多个工作流 → 先提出一个澄清问题。意图均不匹配 → 询问用户想做什么；不要猜测。没有上下文的裸 URL → 默认使用 workflows/quick-summary.md。

4. 快速单行命令（CLI 模式）

对于无需完整工作流的单命令请求——通过 bibi --help 了解其余用法：

bibi summarize "<URL-or-local-file>"     # quick summary (local: .mp4 .mp3 .m4a ...)
bibi summarize "<INPUT>" --chapter       # chapter summary
bibi summarize "<INPUT>" --subtitle      # transcript only
bibi me                                  # account, plan, remaining minutes

URL 中包含 ? 或 & 时必须加引号。API 模式不支持上传本地文件——先引导用户提供公开 URL（OSS/S3），参见 references/supported-platforms.md。

5. 付款回退方案（HTTP 402）

如果未设置身份验证，且用户拥有 Alipay 账户，BibiGPT 可能会返回 HTTP 402 Payment Required + Payment-Needed 标头（AI 收协议）。bibi CLI 会在任何人类可读的提示之前，将固定标记行 [HTTP/402 Payment Required] 输出到 stderr。出现任一信号时，转到 references/billing-aipay.md，不要将该调用视为失败——Agent 可以通过 @alipay/agent-payment 自动完成付款，或通过一次性二维码购买。