bilibili downloader

Other Community
Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Other
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@guozheng07 · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
macOS · Windows
Runtime requirements
Python >=3.8
Detected file/system behavior
  • Read-only
  • Shell exec
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Author source file SKILL.md

# 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`

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.