# Bilibili Downloader

> 用于下载哔哩哔哩视频并支持截图功能的技能。当用户输入"下载b站"等相关关键词时触发，支持cookie登录、高清视频下载、多种截图模式和自然语言时间戳解析。

- Skill: `guozheng07/bilibili-downloader` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add guozheng07/bilibili-downloader`
- Raw SKILL.md: https://api.skillmd.com/api/skills/guozheng07/bilibili-downloader/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: guozheng07 (https://skillmd.com/u/guozheng07)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/guozheng07/bilibili-downloader

---


# Bilibili 视频下载与截图技能

## 功能介绍

本技能用于下载哔哩哔哩（B站）视频并提供截图功能，支持以下特性：

- 支持高清视频下载（默认4K）
- 支持cookie登录（可访问会员内容）
- 自动检测并转码不兼容编码（AV1/HEVC）
- 多种截图模式：固定时间点截图、等间隔截图
- 支持自然语言时间戳解析（如"26分26秒"）
- 跨平台支持（Windows、macOS）

## 触发条件

当用户输入以下关键词时触发本技能：
- "下载b站"
- "B站视频下载"
- "下载哔哩哔哩视频"
- "b站视频截图"

## 工作流程

### 步骤1：获取视频链接

1. 触发技能后，首先询问用户提供B站视频链接
2. 等待用户输入视频链接

### 步骤2：获取Cookie信息

1. 提示用户获取B站Cookie信息的方法：
   - 使用浏览器访问B站并登录
   - 安装Cookie-Editor插件
   - 导出JSON格式的Cookie
   - 复制Cookie内容并粘贴
2. 等待用户输入Cookie信息

### 步骤3：下载视频

1. 使用提供的Cookie信息和视频链接开始下载
2. 默认下载最高清视频（4K）
3. 默认下载路径：
   - Windows：桌面\bilibili_downloads
   - macOS：桌面/bilibili_downloads
4. 显示下载进度
5. 下载完成后显示视频保存位置

### 步骤4：截图操作

1. 询问用户是否需要对下载的视频进行截图
2. 如果用户选择是，说明支持的截图模式：
   - 固定时间点截图：用户指定具体时间点
   - 等间隔截图：按照指定时间间隔自动截图
3. 根据用户选择的模式执行截图操作

### 步骤5：自然语言时间戳解析

当用户选择固定时间点截图时，支持以下自然语言格式：

- "26分26秒" → 转换为 "26:26"
- "1小时30分" → 转换为 "1:30:00"
- "15秒" → 转换为 "15"

## 脚本说明

本技能使用以下脚本：

- `scripts/bilibili_downloader.py`：核心下载和截图功能
- `scripts/chat_handler.py`：处理用户输入和对话流程
- `scripts/time_parser.py`：自然语言时间戳解析

## 参考文档

参考文档位于 `reference/` 目录，包含详细的使用说明和技术文档。

## 使用示例

### 示例1：基本下载流程

用户：下载b站

技能：请提供B站视频链接

用户：https://www.bilibili.com/bangumi/play/ep1231575

技能：请提供B站Cookie信息（JSON格式）

用户：[{"domain":".bilibili.com","name":"SESSDATA","value":"xxx"}]

技能：正在下载视频...
技能：视频下载完成，保存位置：桌面\bilibili_downloads\xxx.mp4
技能：是否需要对视频进行截图？

用户：是

技能：支持的截图模式：
1. 固定时间点截图：例如"00:07:48"
2. 等间隔截图：例如每10分钟一张
请选择截图模式并提供参数

用户：固定时间点，26分26秒

技能：正在截图...
技能：截图完成，保存位置：桌面\bilibili_downloads\screenshots

### 示例2：仅截图操作

用户：下载b站

技能：请提供B站视频链接

用户：https://www.bilibili.com/bangumi/play/ep1231575

技能：请提供B站Cookie信息（JSON格式）

用户：[{"domain":".bilibili.com","name":"SESSDATA","value":"xxx"}]

技能：正在下载视频...
技能：视频下载完成，保存位置：桌面\bilibili_downloads\xxx.mp4
技能：是否需要对视频进行截图？

用户：否

技能：操作完成，视频已保存到桌面\bilibili_downloads

## 注意事项

1. 请确保只下载自己拥有版权或获得授权的内容
2. Cookie信息具有时效性，过期后需要重新获取
3. 部分视频可能需要B站大会员权限才能下载高清版本
4. 下载和转码过程可能需要较长时间，请耐心等待
5. 截图功能需要FFmpeg支持，请确保已安装

## 依赖要求

- Python 3.8+
- yt-dlp
- FFmpeg
- Cookie-Editor浏览器插件（用于获取Cookie）

## 错误处理

- 如果下载失败提示需要登录，请检查Cookie信息是否正确
- 如果视频无法播放，可能需要转码，请重新尝试
- 如果截图失败，请检查FFmpeg是否正确安装

## 输出格式

### 视频保存格式

```
桌面/bilibili_downloads/
├── 视频文件名_分辨率.mp4
└── screenshots/
    ├── 视频文件名_分辨率_screenshot_001_00-00-00.png
    └── ...
```

### 截图命名格式

```
{视频名}_{分辨率}_screenshot_{序号}_{时间}.png
```

例如：`凡人修仙传第167集_2160_screenshot_001_00-07-48.png`

## 技能目录结构

```
bilibili-downloader/
├── SKILL.md          # 技能配置和使用说明
├── scripts/          # 脚本目录
│   ├── bilibili_downloader.py  # 核心下载和截图功能
│   ├── chat_handler.py         # 用户对话处理
│   └── time_parser.py          # 自然语言时间解析
└── reference/        # 参考文档目录
    └── README.md     # 参考文档
```

## 正确运行方法

### 方法1：从技能目录运行

```powershell
# 打开命令提示符或 PowerShell
cd "C:\Users\Administrator\Desktop\bilibili-downloader\scripts"
python chat_handler.py
```

### 方法2：使用完整路径运行

```powershell
# 打开命令提示符或 PowerShell
python "C:\Users\Administrator\Desktop\bilibili-downloader\scripts\chat_handler.py"
```

### 注意事项

- **正确路径**：脚本位于 `bilibili-downloader\scripts\` 目录下
- **避免错误**：不要尝试从其他目录运行脚本，可能会导致路径错误
- **依赖检查**：运行前请确保已安装 Python 3.8+、yt-dlp 和 FFmpeg

## 运行前准备

1. **安装 Python**：从官网下载并安装 Python 3.8 或更高版本
2. **安装 yt-dlp**：运行命令 `pip install yt-dlp`
3. **安装 FFmpeg**：
   - Windows：下载并解压到 `C:\ffmpeg\bin`，然后添加到系统环境变量
   - 或使用 scoop 安装：`scoop install ffmpeg`