uosc_danmaku_smooth

项目概述

这个插件让 MPV 播放器能够加载弹幕，它基于 uosc 界面框架与弹弹play 开放弹幕网络实现。插件会自动识别视频文件并在弹弹play 上匹配番剧与剧集，加载对应的弹幕，无需手动下载与转换弹幕文件。该项目是 uosc_danmaku 的性能优化分支，通过缓存转义与字号处理、专用二分查找等方式降低了播放时的 Lua 开销。

在 MPV 里一键加载番剧弹幕，播放更顺滑。

主要功能

• 自动匹配弹幕：通过弹弹play 识别视频并获取对应番剧与剧集的弹幕
• 搜索菜单：可从 uosc 控制栏打开搜索菜单，手动选择需要的弹幕
• 弹幕开关：在控制栏一键控制弹幕的开启与关闭
• 弹幕源管理：可从网络地址或本地文件添加弹幕源，并可视化增删或屏蔽
• 样式修改：可在播放过程中实时调整弹幕样式，如字体、字号、颜色与显示范围
• 全自动填装：为同一文件夹加载过一次弹幕后，其余集数会自动关联
• 缓存复用：按视频文件名与大小缓存已匹配的弹幕，并按文件新旧分阶段刷新
• 简繁转换：支持弹幕简体与繁体互转，解决简繁混杂问题
• 合并重复弹幕：可合并一定时间范围内内容相同的弹幕
• 保存弹幕：支持把当前弹幕保存为本地 XML 文件

适用人群

• 使用 MPV 观看番剧、希望自动加载弹幕的用户
• 对弹幕显示效果与播放流畅度有要求的用户
• 需要离线保存弹幕文件的用户

快速上手

1. 从 Releases 下载插件，将文件夹重命名为 uosc_danmaku 后放入 mpv 配置目录的 scripts 下
2. 为 bin 目录下的文件赋予可执行权限
3. 在 script-opts/uosc.conf 的 controls 配置项中加入弹幕搜索按钮与弹幕开关
4. 重启 mpv 播放视频，插件会自动匹配并加载弹幕
5. 需要手动搜索时，点击控制栏上的弹幕搜索按钮选择剧集
6. 想开启全自动填装时，在 script-opts/uosc_danmaku.conf 中设置 auto_load=yes

核心优势

• 性能优化：缓存转义、字号与样式处理，减少播放过程中的重复计算
• 免手动整理：自动识别并匹配弹幕，不必自己下载与转换文件
• 记忆省事：同文件夹加载过一次后，其余集数自动关联，无需重复搜索
• 可离线：支持把弹幕保存为本地 XML，断网时也能加载

系统要求

项目	要求
播放器	MPV，哈希匹配需基于 LuaJIT 或 Lua 5.2 构建
界面框架	uosc（建议安装，未安装时部分功能不可用）
操作系统	Windows、Linux
网络	在线获取弹幕需要联网

注意事项

• 未安装 uosc 框架时，弹幕样式与延迟等部分图形化功能不可用
• 插件目录必须命名为 uosc_danmaku，否则需同步修改 uosc 控件配置
• 哈希匹配自动加载准确率有限，关联到错误剧集时请手动重新加载
• 弹幕来自弹弹play 开放弹幕网络，部分番剧可能没有弹幕或时间轴存在偏差