Bilibili-Evolved/README.md
2018-12-20 23:23:01 +08:00

255 lines
12 KiB
Markdown

# Bilibili-Evolved
增强哔哩哔哩Web端体验的油猴脚本: 修复界面瑕疵, 删除广告, 使用夜间模式浏览, 下载视频或视频封面, 以及增加对触屏设备的支持等.
- [安装](#安装)
- [了解所有功能](#功能概览)
- [浏览设置项](#设置)
- [浏览器兼容性](#兼容性)
- [版本历史与更新日志](https://github.com/the1812/Bilibili-Evolved/releases)
- [🕊](https://github.com/the1812/Bilibili-Evolved/wiki/Coming-Features)
# 安装
需要浏览器拥有[Tampermonkey](https://tampermonkey.net/)插件.
[正式版](https://github.com/the1812/Bilibili-Evolved/raw/master/bilibili-evolved.user.js) | [预览版](https://github.com/the1812/Bilibili-Evolved/raw/preview/bilibili-evolved.preview.user.js) | [离线版](https://github.com/the1812/Bilibili-Evolved/raw/master/bilibili-evolved.offline.user.js) | [预览离线版](https://github.com/the1812/Bilibili-Evolved/raw/preview/bilibili-evolved.preview-offline.user.js)
----- | ----- | ----- | -----
正式发布的版本, 最稳定, 更新频率较低. | 新增内容测试的地方, 更新频率高, 但功能不稳定. | 内置所有依赖项, 体积较大, 更新频率高于正式版. | 兼备预览版和离线版的特点.
> 某些破坏性的大更新会使旧版脚本**完全**无法工作, 请及时检查更新.
# 设置
脚本启用后, 在网页左侧中央会有一个齿轮图标, 点击即可打开设置.
设置项的说明见[功能概览](#功能概览)一节.
**设置保存后, 需要刷新网页才能生效.**
![设置](images/gui-settings.png)
## 默认值
### 视频
- 默认播放器模式: `常规`
- 使用默认视频画质: `关闭`
- 画质设定: `自动`
- 使用默认弹幕设置: `关闭`
- 开启弹幕: `开启`
- 记住弹幕屏蔽类型: `关闭`
- 播放时自动关灯: `关闭`
- 自动展开弹幕列表: `开启`
- 自动展开视频简介: `开启`
- 自动从历史记录点播放: `关闭`
### 样式
- 主题颜色: `浅蓝色(#00A0D8)`
- 样式调整: `开启`
- 顶栏(对横幅)透明度: `0.382`
- 夜间模式: `关闭`
- 夜间模式计划时段: `关闭`
- 起始时间: `18:00`
- 结束时间: `6:00`
- 搜索栏置顶: `开启`
- 显示顶部横幅: `开启`
- 显示排行榜图标: `开启`
- 模糊视频控制栏背景: `关闭`
- 控制栏着色: `开启`
- 不透明度: `0.64`
- 缩放直播看板娘: `开启`
- 删除直播水印: `开启`
- 删除视频标题层: `关闭`
- 强制宽屏: `关闭`
- 触发宽度: `1368px`
### 工具
- 删除广告: `开启`
- 稍后再看重定向: `开启`
- 隐藏搜索推荐: `关闭`
- 展开动态标题: `开启`
### 触摸
- 顶栏触摸优化: `关闭`
- 播放器触摸支持: `关闭`
- 启用实验性动画效果: `关闭`
> 决定是否要对触摸调整的提示框使用出现/消失动画, 此动画可能导致掉帧.
- 启用双击控制: `关闭`
### 其他
- 显示消息: `开启`
- 显示内部错误消息: `关闭`
- 启用缓存: `开启`
# 功能概览
为保证最佳体验, 设备分辨率建议在1080P及以上, 并且已登录哔哩哔哩账户.
## 视频
### 下载视频(实验性)
在视频播放页面中, `下载视频`按钮将在`附加功能`中启用, 点击可以选择清晰度并下载.
如果你更喜欢使用其他的多线程下载软件, 可以在选择清晰度后选择`复制链接`. **下载时的请求Header必须包含`Origin=https://www.bilibili.com`和`Referer=当前视频网址`**
> 目前此功能只支持普通视频, 对番剧和电影无效. 下载后的格式通常为`.flv`, 若需要`.mp4`格式则要手动用其他软件转换.
> **分段**的视频会把所有视频打包成`.zip`格式.
> 能够下载的清晰度取决于当前登录的账号, 例如`高清 1080P60`需要已登录大会员账号.
### 下载弹幕
在视频播放页面中, `下载弹幕`按钮将在`附加功能`中启用, 点击可以下载XML格式的弹幕. XML格式可以在[其他站点](https://tiansh.github.io/us-danmaku/bilibili/)转换为ASS格式.
### 查看封面
在视频播放页面/直播间中, `查看封面`按钮将在`附加功能`中启用, 点击可以查看或保存封面. (其实还可以看专栏的封面, 不过专栏的封面本来就显示在标题上方了)
![查看封面与下载视频](images/download-video-view-cover.png)
### 默认播放器模式
设置默认的播放器模式, 可以为`常规`, `宽屏`或`网页全屏`(`全屏`还未完成). 默认模式将在进入视频页面的首次播放时应用.
### 默认视频画质
进入视频时自动选择指定的画质, 若视频最高画质低于所选画质, 则使用视频的最高画质.
### 默认弹幕设置
设置默认是否开启弹幕, 以及是否记住弹幕屏蔽类型.
### 播放时自动关灯
首次播放时, 自动进入关灯模式.
### 自动展开弹幕列表
新版播放页面中, 弹幕列表默认收起以显示推荐的其他视频. 启用此功能可在每次加载视频时自动展开弹幕列表.
### 自动展开视频简介
长的视频简介默认会被折叠, 启用此功能可以强制展开完整的视频简介.
### 自动从历史记录点播放
播放视频时如果检测到历史记录信息(`上次看到...`消息), 则自动跳转到相应的时间播放.
## 样式
### 主题颜色
设定顶栏(样式调整启用时)和夜间模式使用的主题色, 可以点击颜色预览的圆圈打开色板, 其中含有预定义的16种主题色, 也可以在右侧的文本框直接输入任何有效的16进制颜色值(`#rrggbb`或`#rgb`).
![颜色设置](images/theme-color.png)
![粉色](images/new-navbar-stardust.png)
![紫色](images/new-navbar-purple.png)
![蓝色](images/new-navbar-lightBlue.png)
![绿色](images/new-navbar-teal.png)
![暗蓝色](images/new-navbar-blueGrey.png)
### 样式调整
**主要**会改变顶栏的样式, 并有一些其他地方的界面微调:
- 为播放器增加主题色投影
- 可控制顶栏对横幅的透明度
- 使播放器按钮垂直对齐
- 使部分搜索栏的提示文字的颜色更清晰
- 隐藏播放页面的"返回旧版"侧栏
- 修复直播间一些文字初始状态不正确
#### 顶栏效果
![主站](images/new-navbar.png)
![播放](images/new-navbar-stardust.png)
### 夜间模式(实验性)
夜间模式更适合光线暗的环境, 并会大量应用主题颜色.
目前仅支持部分常用页面, 其他页面会陆续添加, 不支持推广板块(会被`删除广告`功能去除的部分).
#### 启用前
![日间](images/light-style.png)
#### 启用后
![夜间](images/dark-style.png)
#### 夜间模式计划时段
设置一个使用夜间模式的时间段, 进入/离开此时间段时, 会自动开启/关闭夜间模式.
> 结束时间小于起始时间时将视为次日, 如`18:00`至`6:00`表示晚上18:00到次日6:00.
### 搜索栏置顶
在主站中总是把搜索框置于顶栏, 如果页面里没有搜索栏则不会显示.
#### 启用前
![不调整](images/original-navbar.png)
#### 启用后
![调整](images/override-navbar.png)
#### 显示顶部横幅
在搜索栏置顶启用的时候, 还可以使用此功能显示/隐藏顶部横幅.
![不移除](images/override-navbar.png)
![移除](images/no-banner.png)
#### 显示排行榜图标
在搜索栏置顶启用的时候, 还可以使用此功能显示/隐藏排行榜入口.
![排行榜图标](images/ranklist.png)
### 模糊视频控制栏背景
模糊视频控制栏背景, 原版的阴影效果将无效.
此功能需要浏览器支持背景模糊效果, 详情见[兼容性](#兼容性)一节.
#### 启用前
![不模糊背景](images/blur-video-control-disabled.png)
#### 启用后
![模糊背景](images/blur-video-control.png)
### 控制栏着色
给视频控制栏附上半透明的黑色, 代替原来的阴影, 黑色的不透明度可在设置中调整.
#### 启用前
![原版](images/custom-control-background-disabled.png)
#### 启用后
![着色](images/custom-control-background.png)
### 缩放直播看板娘
根据屏幕DPI缩放直播看板娘的大小以提高像素的清晰度, DPI缩放为100%的用户不需要此功能.
### 删除直播水印
删除观看直播时角落的水印.
### 删除视频标题层
删除视频里鼠标经过时出现在顶端的标题覆盖层.
标题覆盖层的位置:
![标题覆盖层](images/remove-top-mask.png)
### 强制宽屏
对主站强制使用宽屏样式, 将在宽度达到`1300px`时启用. 此功能的适用范围为屏幕宽度介于`1300px`至`1400px`的设备.
> 原有的宽屏样式会在宽度超过`1400px`时自动启用, 如果你的屏幕宽度大于`1400px`, 则没有必要开启此功能.
> 非宽屏样式下, 首页视频排行为2行**3**列; 宽屏样式下, 首页视频排行为2行**4**列.
#### 启用前
![默认布局](images/force-wide-before.png)
#### 启用后
![宽屏布局](images/force-wide-after.png)
## 工具
### 删除广告
删除站内的各种广告. 包括首页的推广模块, 手机app推荐, 视频页面右侧的广告等.
#### 删除前
![删除前](images/remove-ads-before.png)
#### 删除后
![删除后](images/remove-ads-after.png)
### 稍后再看重定向
将稍后再看的链接重定向为普通播放网址, 以使用新版播放页面.
### 隐藏搜索推荐
将搜索框的推荐词替换为`搜索`.
### 展开动态标题
在顶栏的动态预览框中:
- 关闭时, 长名称的后半部分会用`...`代替.
![关闭时](images/full-tweets-title-off.png)
- 启用时, 不管名称多长, 总是完全展开up主和视频的标题.
![启用时](images/full-tweets-title-on.png)
## 触摸
### 顶栏
删除顶栏右侧的一级链接(从`大会员`到`历史`), 以方便触屏设备快速预览信息. 被删除的链接可从各预览中的`查看更多`进入.
### 播放器
#### 启用触摸控制
- 左右滑动可调整进度
- 上下滑动可调整音量
- 进度调整可在左上角和右上角取消
- 在不同位置滑动, 可以使用3档不同的灵敏度.
![进度调整](images/adjust-playback.png)
![音量调整](images/adjust-volume.png)
已知问题: 滑动调整的音量不会保存, 下次打开视频将恢复原音量.
#### 启用双击控制
将操作方式更改为: 单击显示/隐藏控制栏, 双击播放/暂停.
#### 增大间距
增大控制栏的按钮间距, 使触摸操作更准确.
##### 启用前
![放大前](images/player-buttons-original.png)
##### 启用后
![放大后](images/player-buttons-large.png)
## 其他
关于脚本自身的一些设定.
### 显示消息
允许在网页左下角显示来自本脚本的消息, 如更新提醒, 错误提示等.
![消息](images/toast.png)
#### 显示内部错误消息
开启后, 错误消息将显示详细的技术性错误信息及堆栈跟踪, 这通常用于准确地确定问题发生的原因, 所以报告问题时这些信息会非常有用.
### 启用缓存
使用缓存以提高脚本的加载速度, 此选项只对非离线版有效, 可在`附加功能`中清除脚本的缓存.
# 兼容性
## Chrome
- 背景模糊效果(`backdrop-filter`)需要手动在`chrome://flags/#enable-experimental-web-platform-features`中开启.
- 含有背景模糊效果的动画有掉帧现象.
## Firefox
- 滚动条样式无效.
- 背景模糊效果无效.
- 触摸调整的进度预览有弹跳现象.(来自`transition: all 0.2s;`. 短时间内总是从原数值开始变化, 而不是当前数值)
## Edge
- 滚动条样式无效.
- 由于Edge的CSS渲染bug(主要集中在`filter`和`color`), 部分主题颜色错乱.
- 顶栏触摸体验不佳.
- 触摸功能需要手动在`about:flags`中开启.
## Safari
- 尚未在Safari中测试.
**喜欢的话就点个⭐Star吧(°∀°)ノ**
[返回顶部](#Bilibili-Evolved)