Bilibili All In One

核心功能

bilibili-all-in-one 是一款功能全面的Bilibili（哔哩哔哩）综合工具，整合六大核心模块：

• 🔥 Hot Monitor 热门监控：实时获取B站热门视频、热搜话题、每周必看及分区排行榜，支持动漫、音乐、游戏、科技等12个分类筛选
• ⬇️ Downloader 视频下载：支持360p至4K多画质选择，MP4/FLV/MP3多格式输出，单视频及批量下载，高清下载需登录凭证
• 👀 Watcher 数据追踪：查看视频详情、实时统计播放量/点赞/投币等互动数据，支持定时追踪及多视频对比分析
• 📝 Subtitle 字幕处理：下载官方CC字幕，自动格式转换（SRT/ASS/VTT/TXT/JSON），无字幕时智能 fallback 至语音识别（faster-whisper）或弹幕提取
• ️ Player 播放与弹幕：获取直链播放地址、分P信息、弹幕数据（支持滚动/底部固定/顶部固定三种模式）
• 📤 Publisher 视频投稿：完整支持上传发布、草稿保存、定时发布、视频编辑，需完整B站登录凭证

显著优点

1. 功能高度集成：单一工具覆盖B站内容消费到生产的完整链路，无需切换多个工具
2. 认证分层设计：热门监控、基础下载、字幕列表、弹幕获取等核心功能无需任何凭证即可使用，降低使用门槛
3. 智能字幕 fallback：无官方字幕时自动启用AI语音识别+弹幕提取双重备份，提升可用性
4. 多接口支持：同时提供CLI命令行和Python API，适合脚本自动化及程序化调用
5. 安全透明：开源MIT协议，网络流量仅限官方B站域名，无第三方数据上报

局限与风险

| 方面 | 说明 |

|------|------|

| **版权合规** | 视频下载功能可能触及B站用户协议及内容版权，需用户自行承担合规责任 |

| **凭证敏感性** | 投稿及高清下载需完整浏览器会话Cookie（SESSDATA/bili_jct），非受限API密钥，泄露即等同于账号失陷 |

| **稳定性依赖** | 深度依赖B站未公开API，接口变更可能导致功能失效 |

| **语音识别成本** | faster-whisper fallback 需额外安装及本地GPU/CPU运算资源 |

| **无官方背书** | 社区开源项目，非B站官方工具，无SLA保障 |

适合人群

• 内容创作者：批量监控热门趋势、定时投稿管理
• 数据分析师：追踪视频数据变化、竞品对比
• 字幕组/翻译者：高效提取、转换、合并字幕文件
• 开发者：需要B站数据接口自动化集成的技术用户

常规风险

• 账号封禁：高频API调用或异常下载行为可能触发B站风控
• 凭证泄露：持久化存储（可选）虽采用0600权限，但仍存在本地文件泄露风险
• 法律边界：下载受版权保护内容（番剧、电影等）存在法律风险

核心功能

bilibili-all-in-one 是一款功能完备的 Bilibili 内容处理工具，将六大独立模块整合为统一接口：

• 🔥 Hot Monitor：实时监控热门榜单、热搜话题、每周必看、分区排行榜，支持全品类筛选
• ⬇️ Downloader：多清晰度视频下载（360p-4K），支持批量下载、音视频分离、MP3提取
• 👀 Watcher：视频数据追踪，监控播放量、点赞、投币等互动指标的变化趋势
• 📝 Subtitle：字幕下载与格式转换（SRT/ASS/VTT/JSON），无CC字幕时自动触发语音识别或弹幕提取作为备选方案
• ▶️ Player：获取播放直链、弹幕数据（danmaku）、分P列表，支持多清晰度切换
• 📤 Publisher：视频投稿、定时发布、草稿管理和元数据编辑

显著优点

1. 权限分级设计：大部分功能（热门监控、标清下载、字幕列表、弹幕获取、数据查看）无需任何凭据即可使用；高清下载（1080p+/4K）和投稿功能才需要登录态，实现最小权限原则。

2. 安全机制完善：

• 投稿模块默认启用 dry-run 模式，需显式确认才会执行写操作
• Cookie 默认内存存储，可选持久化时强制 0600 权限并拒绝不安全目录
• ffmpeg 子进程调用无 shell=True，参数列表传递，路径经 sanitize_filename 处理

3. 降级容错策略：字幕模块在无官方 CC 字幕时，自动回退至 faster-whisper 语音识别或弹幕提取，确保可用性。

4. 接口统一：CLI 与 Python API 双模式，所有操作返回标准化 JSON，便于集成。

潜在局限

• 投稿功能依赖完整会话 Cookie（SESSDATA/bili_jct/buvid3），非受限 API Key，权限等同于浏览器登录态
• 可选凭据持久化存在泄露风险：虽默认关闭且权限严格，但用户误操作或环境不安全时仍可能暴露
• 外部 API 依赖：功能完全依赖 Bilibili 官方 API，接口变更可能导致故障
• faster-whisper 为可选依赖：语音识别需单独安装，模型下载可能访问外部资源
• 个人维护项目：开发者为独立社区贡献者（T3 来源），无组织级安全背书

适合人群

• 内容创作者：批量下载素材、监控数据表现、自动化投稿 workflow
• 数据研究者：趋势分析、弹幕情感研究、视频元数据采集
• 效率工具用户：需要免安装客户端即可快速获取 Bilibili 内容的场景

常规风险

• 账号安全：提供 Cookie 即授予完整账号权限，强烈建议使用测试账号，主账号启用二步验证
• 版权合规：下载功能需遵守 Bilibili 用户协议，禁止未经授权的商用分发
• 速率限制：高频 API 调用可能触发平台限流，批量操作建议添加延迟
• 持久化残留：启用 persist 后若未主动清理，凭据文件可能长期留存于磁盘