bilibili-subtitle by hamsterider-m/bilibili-subtitle
npx skills add https://github.com/hamsterider-m/bilibili-subtitle --skill bilibili-subtitle从 Bilibili 视频提取字幕,支持 AI 字幕检测和 ASR 转录回退。
| 任务 | 命令 |
|---|---|
| 前置检查 | pixi run python -m bilibili_subtitle --check |
| 基本提取 | pixi run python -m bilibili_subtitle "BV1234567890" |
| 快速模式 | pixi run python -m bilibili_subtitle "URL" --skip-proofread --skip-summary |
| JSON 输出 | pixi run python -m bilibili_subtitle "URL" --json-output |
| 双语输出 |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
pixi run python -m bilibili_subtitle "URL" --output-lang zh+en┌─────────────────────────────────────────────────────────┐
│ Layer 0: Preflight Check (前置检查) │
│ --check → 验证 BBDown/API Keys/登录状态 │
├─────────────────────────────────────────────────────────┤
│ Layer 1: Video Detection (视频检测) │
│ URL → BBDown → 字幕存在性检测 │
├─────────────────────────────────────────────────────────┤
│ Layer 2: Content Extraction (内容提取) │
│ 有字幕 → 加载 SRT → 校对 │
│ 无字幕 → 下载音频 → ASR 转录 → 校对 │
├─────────────────────────────────────────────────────────┤
│ Layer 3: Enhancement (增强处理) │
│ 校对(ANTHROPIC_API_KEY) → 摘要(ANTHROPIC_API_KEY) │
└─────────────────────────────────────────────────────────┘
必须先运行 ,验证环境配置:
pixi run python -m bilibili_subtitle --check
输出示例:
✅ BBDown: Installed (1.6.3)
✅ BBDown Auth: Logged in
✅ ffmpeg: Installed
⚠️ ANTHROPIC_API_KEY: Not set (required for proofreading)
⚠️ DASHSCOPE_API_KEY: Not set (required for ASR)
✅ Python Dependencies: All installed
JSON 格式输出(便于父 skill 解析):
pixi run python -m bilibili_subtitle --check --check-json
| Code | Level | 说明 | 修复建议 |
|---|---|---|---|
| E001 | FATAL | BBDown 未安装 | ./install.sh |
| E002 | FATAL | BBDown 未登录 | BBDown login |
| E003 | RECOVERABLE | 下载失败 | 检查 URL/网络 |
| E004 | RECOVERABLE | 无字幕 | 自动触发 ASR |
| E005 | FATAL | ASR 未配置 | 设置 DASHSCOPE_API_KEY |
| E006 | RECOVERABLE | AI 功能未配置 | 使用 --skip-* 或设置 API Key |
| E007 | FATAL | ffmpeg 未安装 | pixi install |
| E008 | FATAL | URL 无效 | 提供正确的 BV/URL |
| E010 | FATAL | 视频不存在 | 检查视频是否删除/私有 |
退出码 :
0 - 成功1 - 致命错误(FATAL)2 - 可恢复错误(RECOVERABLE,部分完成)3 - 部分成功(有警告)pixi run python -m bilibili_subtitle "<URL>" \
-o /tmp/bilibili_output \
--skip-summary \
--json-output
0 或 2*.transcript.md{
"exit_code": 0,
"success": true,
"output": {
"video_id": "BV1xxx",
"title": "视频标题",
"files": {
"transcript": "/path/to/xxx.transcript.md",
"srt": "/path/to/xxx.srt",
"vtt": "/path/to/xxx.vtt",
"summary_json": null
}
},
"warnings": [],
"errors": []
}
from bilibili_subtitle import build_cli_command, ExitCode
cmd = build_cli_command(
"BV1xxx",
output_dir="/tmp/output",
skip_proofread=True,
skip_summary=True,
)
# ['pixi', 'run', 'python', '-m', 'bilibili_subtitle', 'BV1xxx', ...]
output/
├── {title}.srt # SRT 字幕
├── {title}.vtt # VTT 字幕
├── {title}.transcript.md # Markdown 逐字稿
├── {title}.summary.json # 结构化摘要 (可选)
└── {title}.summary.md # 摘要 Markdown (可选)
| Key | Provider | 用途 | 必需性 |
|---|---|---|---|
ANTHROPIC_API_KEY | Anthropic | 校对/摘要 | 推荐 |
DASHSCOPE_API_KEY | 阿里云 | ASR 转录 | 无字幕时必需 |
cd ~/.agents/skills/bilibili-subtitle
./install.sh
BBDown login # 扫码登录
版本 : v0.2.0
每周安装量
648
仓库
GitHub 星标数
5
首次出现
2026年1月23日
安全审计
安装于
opencode606
codex590
cursor590
gemini-cli589
github-copilot571
kimi-cli558
从 Bilibili 视频提取字幕,支持 AI 字幕检测和 ASR 转录回退。
| 任务 | 命令 |
|---|---|
| 前置检查 | pixi run python -m bilibili_subtitle --check |
| 基本提取 | pixi run python -m bilibili_subtitle "BV1234567890" |
| 快速模式 | pixi run python -m bilibili_subtitle "URL" --skip-proofread --skip-summary |
| JSON 输出 | pixi run python -m bilibili_subtitle "URL" --json-output |
| 双语输出 | pixi run python -m bilibili_subtitle "URL" --output-lang zh+en |
┌─────────────────────────────────────────────────────────┐
│ Layer 0: Preflight Check (前置检查) │
│ --check → 验证 BBDown/API Keys/登录状态 │
├─────────────────────────────────────────────────────────┤
│ Layer 1: Video Detection (视频检测) │
│ URL → BBDown → 字幕存在性检测 │
├─────────────────────────────────────────────────────────┤
│ Layer 2: Content Extraction (内容提取) │
│ 有字幕 → 加载 SRT → 校对 │
│ 无字幕 → 下载音频 → ASR 转录 → 校对 │
├─────────────────────────────────────────────────────────┤
│ Layer 3: Enhancement (增强处理) │
│ 校对(ANTHROPIC_API_KEY) → 摘要(ANTHROPIC_API_KEY) │
└─────────────────────────────────────────────────────────┘
必须先运行 ,验证环境配置:
pixi run python -m bilibili_subtitle --check
输出示例:
✅ BBDown: Installed (1.6.3)
✅ BBDown Auth: Logged in
✅ ffmpeg: Installed
⚠️ ANTHROPIC_API_KEY: Not set (required for proofreading)
⚠️ DASHSCOPE_API_KEY: Not set (required for ASR)
✅ Python Dependencies: All installed
JSON 格式输出(便于父 skill 解析):
pixi run python -m bilibili_subtitle --check --check-json
| Code | Level | 说明 | 修复建议 |
|---|---|---|---|
| E001 | FATAL | BBDown 未安装 | ./install.sh |
| E002 | FATAL | BBDown 未登录 | BBDown login |
| E003 | RECOVERABLE | 下载失败 | 检查 URL/网络 |
| E004 | RECOVERABLE | 无字幕 | 自动触发 ASR |
| E005 | FATAL | ASR 未配置 | 设置 DASHSCOPE_API_KEY |
| E006 | RECOVERABLE | AI 功能未配置 | 使用 --skip-* 或设置 API Key |
退出码 :
0 - 成功1 - 致命错误(FATAL)2 - 可恢复错误(RECOVERABLE,部分完成)3 - 部分成功(有警告)pixi run python -m bilibili_subtitle "<URL>" \
-o /tmp/bilibili_output \
--skip-summary \
--json-output
0 或 2*.transcript.md{
"exit_code": 0,
"success": true,
"output": {
"video_id": "BV1xxx",
"title": "视频标题",
"files": {
"transcript": "/path/to/xxx.transcript.md",
"srt": "/path/to/xxx.srt",
"vtt": "/path/to/xxx.vtt",
"summary_json": null
}
},
"warnings": [],
"errors": []
}
from bilibili_subtitle import build_cli_command, ExitCode
cmd = build_cli_command(
"BV1xxx",
output_dir="/tmp/output",
skip_proofread=True,
skip_summary=True,
)
# ['pixi', 'run', 'python', '-m', 'bilibili_subtitle', 'BV1xxx', ...]
output/
├── {title}.srt # SRT 字幕
├── {title}.vtt # VTT 字幕
├── {title}.transcript.md # Markdown 逐字稿
├── {title}.summary.json # 结构化摘要 (可选)
└── {title}.summary.md # 摘要 Markdown (可选)
| Key | Provider | 用途 | 必需性 |
|---|---|---|---|
ANTHROPIC_API_KEY | Anthropic | 校对/摘要 | 推荐 |
DASHSCOPE_API_KEY | 阿里云 | ASR 转录 | 无字幕时必需 |
cd ~/.agents/skills/bilibili-subtitle
./install.sh
BBDown login # 扫码登录
版本 : v0.2.0
Weekly Installs
648
Repository
GitHub Stars
5
First Seen
Jan 23, 2026
Security Audits
Gen Agent Trust HubFailSocketPassSnykWarn
Installed on
opencode606
codex590
cursor590
gemini-cli589
github-copilot571
kimi-cli558
对话音频生成工具:使用Dia TTS创建逼真多说话人对话,支持情感控制和节奏调整
7,400 周安装
ontology 本体论技能:类型化知识图谱构建与验证系统
2,100 周安装
Smithery AI CLI:AI智能体市场命令行工具,连接10万+工具与技能
2,100 周安装
JSON 转 React 组件渲染器 | @json-render/react 动态 UI 生成库
613 周安装
RivetKit SwiftUI客户端:快速连接Rivet Actors构建iOS/macOS应用
2,000 周安装
RivetKit Swift 客户端:连接 Rivet Actors 的 iOS/macOS 开发库
2,000 周安装
Framer Motion动画制作器 - 使用声明式API构建React交互式动画教程
2,100 周安装
| E007 | FATAL | ffmpeg 未安装 | pixi install |
| E008 | FATAL | URL 无效 | 提供正确的 BV/URL |
| E010 | FATAL | 视频不存在 | 检查视频是否删除/私有 |