BilibiliSponsorBlock项目分P视频支持的技术实现分析

背景与问题发现

BilibiliSponsorBlock作为一款B站视频自动跳过特定片段的开源工具，在初期开发时由于B站对分P视频策略的调整，开发者曾认为平台会逐步淘汰分P视频功能，因此未对分P视频场景做特别适配。然而近期B站不仅保留了分P视频功能，还在合集系统中重新加入了对分P视频的支持，这导致插件在处理分P视频时出现了标记内容跨P错误跳过的技术问题。

技术挑战分析

分P视频的技术处理主要面临以下核心挑战：

1. 视频标识问题：传统方案仅使用BVID(BV号)作为视频唯一标识，无法区分同一视频的不同分P内容
2. 数据兼容性：现有用户已提交的标记数据需要平滑迁移到新系统
3. 接口一致性：需要保持API接口的向后兼容，避免影响现有客户端功能

解决方案设计

项目团队经过深入讨论，确定了以下技术实现方案：

1. 视频标识体系升级

引入CID(内容ID)作为核心标识符，构建三级标识体系：

• BVID：视频基础标识
• CID：分P内容唯一标识
• 分P序号：人工可读的辅助标识

2. API接口改造

对核心API接口进行增强：

• skipSegments接口：新增cid参数，支持精确查询特定分P的标记片段
• sha256HashPrefix接口：返回数据中增加cid字段，支持多分P片段返回
• 提交接口：强制要求提交cid信息，未提供时默认视为P1

3. 数据结构优化

在原有数据结构基础上新增cid字段：

{
  videoID: "BVxxx",  // BVID
  segments: [{
    cid: "123456",   // 新增的CID字段
    segment: [0, 15.23],
    UUID: "...",
    category: "...",
    // 其他原有字段...
  }]
}

技术实现考量

1. 兼容性保障：所有接口变更都确保向后兼容，不影响现有客户端功能
2. 数据迁移策略：利用当前数据量较小的窗口期，快速完成全量数据迁移
3. 性能优化：通过合理的索引设计确保新增字段不会影响查询效率
4. 客户端适配：提供清晰的字段规范，方便第三方客户端集成

未来展望

这一技术改进不仅解决了当前的分P视频问题，还为项目未来发展奠定了基础：

1. 支持更复杂的视频组织结构
2. 为可能的分布式部署预留扩展空间
3. 增强数据统计分析能力

该方案体现了开源项目在面对平台政策变化时的灵活应对能力，也展示了技术决策中平衡创新与稳定的智慧。通过这次架构升级，BilibiliSponsorBlock将能够更好地服务于B站多样化的视频内容生态。