pakku.js 安装配置完整教程：5分钟让B站刷屏弹幕乖乖合并

【免费下载链接】pakku.js拯救B站的弹幕体验！项目地址: https://gitcode.com/gh_mirrors/pa/pakku.js

你有没有过这种体验：点开一个热门视频，弹幕像洪水一样涌上来，满屏的"23333""哈哈哈"和复制粘贴的口号，把画面挡得严严实实。想看的细节被盖住，名场面被错过，最后只能含泪关掉弹幕——可没了弹幕，看视频又总觉得少了点什么。

pakku.js 就是为解决这个矛盾而生的浏览器插件：它自动合并 B 站视频中的刷屏弹幕，保留氛围、清除遮挡，让你在弹幕的陪伴下依然看清每一帧画面。下面这份安装配置教程，会带你从零开始跑通它，全程不到 5 分钟。

✅ 先看看它凭什么打动你

在动手之前，先用几个要点建立信心。pakku.js 的核心能力可以概括为四点：

• ✅智能合并重复弹幕：同一时刻内容相似的弹幕会被合并成一条，并标注合并数量，刷屏瞬间"瘦身"
• ✅弹幕密度分析图：进度条上呈现弹幕密度分布，哪里是名场面、哪里是冷场，一眼看穿
• ✅自动调整弹幕大小：弹幕密集时自动放大字号，兼顾信息量与可读性
• ✅弹幕信息提示框：鼠标悬停即可查看这条弹幕的合并来源、出现次数等统计信息
• ✅可编程用户脚本：支持用 JavaScript 深度定制弹幕处理逻辑，可玩性极高

📋 30 秒环境自检：你具备哪些条件？

在开始前，对照下面这张清单快速自查，全部满足即可顺利上手：

如果你不想自己构建，直接从浏览器扩展商店搜索"pakku 哔哩哔哩弹幕过滤器"安装即可；想体验最新功能或参与修改，就走下面的源码路径。

⚡ 快速上手：一条命令链跑通构建

最快的路径是直接构建浏览器扩展并加载。打开终端，依次执行：

# 克隆项目仓库到本地 git clone https://gitcode.com/gh_mirrors/pa/pakku.js # 进入项目目录并安装依赖 cd pakku.js npm install # 构建 Chrome 版扩展 npm run build:chrome

构建完成后，产物会出现在dist/C目录。接着打开 Chrome，在地址栏输入chrome://extensions/，开启右上角"开发者模式"，点击"加载已解压的扩展程序"，选中dist/C文件夹即可。

为什么是build:chrome而不是笼统的build？因为项目针对不同浏览器做了差异化处理（Firefox 的 manifest 结构不同），构建脚本按目标分派。装好后打开任意 B 站视频，等待几秒，你会看到重复弹幕开始合并，画面立刻清爽起来——这就是 pakku.js 弹幕过滤开箱即用的效果。

🔧 深度玩法：三种场景，按需选用

快速上手只是开胃菜，下面的进阶操作才真正体现这款工具的可玩性。

场景一：Firefox 用户从源码构建

Firefox 的扩展签名机制与 Chrome 不同，加载方式也略有差异：

cd pakku.js npm run build:firefox # 产出 Firefox 专用构建 cd dist/F # 构建产物目录

然后在 Firefox 地址栏输入about:debugging#/runtime/this-firefox，点击"临时加载附加组件"，选择dist/F/manifest.json。注意 Firefox 临时加载会在重启后失效，重新加载一次即可，不影响日常使用。

场景二：用用户脚本定制弹幕规则

这是高级玩家最爱的功能。打开选项页，勾选"我是高级用户"，即可在"实验室"中进入用户脚本编辑器。脚本通过回调函数介入弹幕处理流程，最常用的两个是tweak_before_pakku（pakku 处理前）和tweak_after_pakku（pakku 处理后）。

比如你想屏蔽一年内的弹幕防剧透，在 pakku 处理前把它们筛掉：

// 过滤 2025 年 1 月 1 日之后发送的弹幕，防止剧透 const TARGET = +new Date('2025/1/1') / 1000; tweak_before_pakku(chunk => { chunk.objs = chunk.objs.filter(dm => dm.sendtime < TARGET); });

又比如你觉得合并数少于 5 条的弹幕不必合并，可以读取dm.pakku.peers字段把弹幕"拆出来"。保存脚本后按 F12 打开控制台，就能看到 pakku 输出的处理日志：

更完整的函数签名、回调优先级和示例，见项目内的用户脚本文档：userscript_docs/README.md，类型定义参考 pakkujs/core/types.ts。

场景三：实验室选项的精细调校

在选项页的"实验室"区域，有两个容易被忽略但很实用的开关：

• 阻止弹幕动态更新：选中后弹幕不再实时刷新，适合需要稳定弹幕池做分析的场景
• 关怀小屏幕用户：把总长度超过设定像素值的弹幕转为滚动弹幕，小窗口看视频也不糊

⚖️ 效果对比：合并前后的弹幕世界

使用前，热门视频的弹幕是"同一句话刷十遍"的复读机现场；使用后，相似弹幕合并为一条，并附带统计信息。把鼠标悬停在弹幕上，提示框会展示这条弹幕的出现次数、被放大倍数、合并数量等明细：

弹幕密度分析图还能帮你快速定位视频的高潮时段，从此跳转、回顾都有据可依。

🚑 避坑指南：四个常见问题一次说清

• 问题：安装后打开视频没有任何变化？原因：视频页在安装前已加载，或浏览器版本过低。解法：刷新视频页面；确认浏览器满足 Chrome/Edge ≥ 99、Firefox ≥ 113。
• 问题：Firefox 加载扩展时报错？原因：误用了 Chrome 版构建产物。解法：使用npm run build:firefox生成的dist/F目录，不要混用。
• 问题：全局用户脚本保存失败？原因：浏览器对同步存储有约 6.4KB 的体积限制。解法：改用"外部用户脚本"（配合 Tampermonkey 分发）或通过importScripts引入外部文件。
• 问题：脚本报错，图标出现红色角标？原因：用户脚本存在语法或逻辑错误。解法：点击红色角标查看堆栈，或在脚本里写debugger;下断点单步排查：

🎯 结语：弹幕的自由，从你动手开始

pakku.js 的价值不在功能堆砌，而在"把选择权交还给观众"：想看清画面时它帮你合并刷屏，想分析弹幕时它给你数据和脚本接口。安装只是第一步，真正的乐趣在深度玩法里——去选项页打开"实验室"，写一个属于你自己的弹幕规则吧。想深入源码，可以从 pakkujs/page/options.ts 开始读配置逻辑，参与改进或提交想法，让这款工具更好用。现在，打开一个热门视频试试效果，你会回来感谢自己的。

【免费下载链接】pakku.js拯救B站的弹幕体验！项目地址: https://gitcode.com/gh_mirrors/pa/pakku.js