# Bv2sub

> B站视频字幕转写工具。使用此skill可以快速将B站视频BV号转换为字幕文件(srt/txt/vtt格式)。触发场景：用户提及"BV转写"、"B站字幕"、"视频转文字"、"BV2sub"等。

- Skill: `heiyixiake/bv2sub` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add heiyixiake/bv2sub`
- Raw SKILL.md: https://api.skillmd.com/api/skills/heiyixiake/bv2sub/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Heiyixiake (https://skillmd.com/u/heiyixiake)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/heiyixiake/bv2sub

---


# BV2Sub - B站视频字幕转写

## Overview

此skill提供B站视频语音转写功能，通过yt-dlp下载视频音频，使用Whisper进行本地语音识别，输出多种字幕格式。

## 使用方法

### 环境准备

首次使用需安装依赖：

```bash
# 安装 yt-dlp
pip install yt-dlp

# 安装 ffmpeg (macOS)
brew install ffmpeg

# 安装 Whisper
pip install openai-whisper

# 下载默认模型
whisper --model small --download-base
```

### 执行转写

```bash
python ~/.codebuddy/skills/bv2sub/scripts/bv2sub.py BV1Zo9MB9EUU
```

指定模型：

```bash
python ~/.codebuddy/skills/bv2sub/scripts/bv2sub.py BV1Zo9MB9EUU medium
```

## 优化说明

当前版本已优化转写质量：
- 默认使用 `small` 模型（比base更准确）
- 使用 `--beam_size 5` 提升准确率
- 添加提示词 `--initial_prompt` 改善效果
- 降低 `--temperature` 减少随机性
- 使用 `bestaudio` 获取最佳音质

### 模型选择

| 模型 | 准确率 | 速度 | 推荐场景 |
|------|--------|------|----------|
| base | 一般 | 快 | 快速测试 |
| small | 较高 | 中 | ✅ 推荐日常 |
| medium | 高 | 较慢 | 重要内容 |
| large | 最高 | 慢 | 最高精度 |

## 输出格式

脚本自动生成：
- `*.srt` - SRT字幕
- `*.txt` - 纯文本
- `*.vtt` - WebVTT字幕
- `*.json` - 详细JSON

## Resources

脚本位置：`scripts/bv2sub.py`