Skip to content

MariaMa-GitHub/bilibili-annotator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

B站注释器

一款用于标注 Bilibili 视频的 Chrome 扩展程序。为任意视频添加带时间戳的笔记、摘要、标签和评分——所有数据均存储在本地浏览器中。

English Version


功能

  • 标注 — 为视频中的任意时间点添加笔记。点击时间戳可直接跳转至对应位置。支持分类(精彩 / 重要 / 搞笑 / 笔记 / 自定义)和颜色标记(8 种预设颜色,显示为左侧色条)。删除时显示内联确认(确定 / 取消),防止误操作。
  • 摘要 — 为每个视频编写短摘要和长摘要,输入时自动保存。
  • 标签 — 为视频添加标签,便于后续筛选。支持从历史标签和内置常用分类中自动补全。
  • 评分 — 点赞/点踩或 1–5 星评分,附带自由文本评价理由。
  • 观看进度 — 自动记录观看进度和上次观看时间。侧边栏显示精确时间戳(M:SS / M:SS — X%)。对于多 P 视频,显示跨所有分 P 的全局进度(全局位置 / 总时长)。暂停、跳转或切换标签时立即保存,另有定时备份。
  • 视频库 — 在一个页面浏览全部已标注视频(仅展示至少含有一条标注、摘要、评分或点赞/点踩的视频)。可按标题、摘要、标注内容和标签搜索;通过三个独立筛选控件过滤(标签多选下拉、👍/👎 切换按钮、星级评分切换按钮([3★+] [4★+] [5★]));按最近观看、添加日期、标注数量或评分排序(同分时按标题字母顺序)。卡片显示进度条、精确时间戳(X% · M:SS / M:SS)和上次观看日期,超过 20 条时分页展示。
  • 导出 / 导入 — 将完整数据导出为 JSON 文件,并可在其他设备上导入。

所有数据通过 chrome.storage.local 存储在本地,不会向任何服务器发送数据。


安装

本扩展未上架 Chrome 网上应用店,需以开发者模式加载:

  1. 克隆或下载本仓库。
  2. 在 Chrome 中打开 chrome://extensions
  3. 启用右上角的开发者模式
  4. 点击加载已解压的扩展程序,选择项目根目录。

使用方法

侧边栏

侧边栏会在所有 www.bilibili.com/video/* 页面上显示。

  • 展开/收起 — 点击屏幕右侧的标签页、点击扩展图标,或按 Alt+S
  • 键盘快捷键Alt+A 打开标注表单,并自动填入当前时间戳。可在设置中修改。
  • 全屏模式 — 进入全屏或网页全屏时侧边栏自动隐藏,退出后恢复显示。

视频库

在任意页面按 Alt+D,或在非 Bilibili 视频页面点击扩展图标,即可在新标签页中打开视频库。视频卡片显示标题、标签、观看进度条、精确时间戳和上次观看日期。

导出 / 导入

在视频库页面,点击导出数据下载 .json 备份文件;点击导入数据恢复数据,可选择跳过已有记录或覆盖已有记录。

导出文件包含全部数据(视频记录、标签索引、设置)。导入时仅恢复视频记录和标签索引;设置不会被导入,以防止通过共享文件意外覆盖本机设置。


键盘快捷键

快捷键 功能
Alt+A 打开标注表单(自动填入当前时间戳)
Alt+S 展开/收起侧边栏
Alt+D 打开视频库

Alt+SAlt+D 为浏览器级快捷键,可通过 chrome://extensions/shortcuts 修改;即使焦点在视频播放器内也能触发。

Alt+A 可通过两种方式修改:

  • 扩展内设置:点击侧边栏底部的 ⚙ 设置面板(页面获得焦点时生效)
  • 浏览器级设置:通过 chrome://extensions/shortcuts 修改(即使焦点在视频播放器内也能触发;快速标注 条目默认无绑定,需手动设置)

设置

点击侧边栏底部的 ⚙ 图标进入设置。

设置项 默认值 说明
侧边栏模式 悬浮 悬浮(浮于页面上方)或推移(将页面内容向左推)
默认展开侧边栏 关闭 开启后,每次打开视频页面时侧边栏自动展开
键盘快捷键 Alt+A 打开标注表单的快捷键
进度追踪间隔 30 秒 观看进度的定时保存频率(暂停、跳转时也会即时保存)
功能开关 全部开启 可单独启用或禁用观看进度、摘要、标签、评分功能

数据说明

所有数据存储在扩展的 chrome.storage.local 中,不会发起任何外部请求。

每个视频以 BV 号为键存储。导出格式为纯 JSON,便于阅读和用其他工具处理。


技术说明

  • Manifest V3
  • 原生 JS(ES2020+),无框架,无构建工具
  • 无外部依赖
  • 内容脚本通过 manifest 加载顺序共享作用域(utils.jsstorage.jscontent.js
  • Bilibili SPA 页面导航通过监听 <title>MutationObserver 检测
  • 视频库为固定视口布局,超过 20 条记录时分页显示

About

一款用于标注 Bilibili 视频的 Chrome 扩展程序

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors