jiuyang5354/bilibili-margin

项目介绍

映间 MARGIN 是一个面向 Edge、Chrome 和 Firefox 的开源 Manifest V3 扩展，用于重新设计 B 站首页、搜索页、视频播放页、图文与专栏阅读页以及账号相关页面。它只改界面布局和视觉，不替换播放能力：原生播放器、弹幕、评论、清晰度选择与全屏操作都保留。项目使用原生 TypeScript、CSS 和 Shadow DOM，借助 Vite 按路由拆分页面模块。

适合希望降低 B 站默认界面信息密度、想要明暗主题、动态背景、按关键词/UP 主/播放量/时长过滤推荐、玻璃风格收藏抽屉、本地观看足迹热力图和命令面板的普通观众。README 明确说明这是独立开源项目，非 B 站官方产品，与哔哩哔哩无关联。

快速使用

1. 从最新版本下载 margin.zip，解压到固定文件夹。
2. 打开 edge://extensions 或 chrome://extensions，开启开发者模式。
3. 点击加载已解压的扩展程序，选择包含 manifest.json 的文件夹。
4. 打开或刷新 B 站。

Firefox 140 及以上版本：下载 margin-firefox.zip，打开 about:debugging#/runtime/this-firefox，点击临时载入附加组件并选择该 zip。临时载入的扩展在 Firefox 重启后会被移除。

临时回到 B 站原版界面时，可在顶栏菜单选择原版、在页面链接中添加 ?margin=off，或在扩展弹窗中关闭 MARGIN。手动安装版更新时，把新版解压到原文件夹，在扩展管理页点击重新加载，再刷新 B 站。

从源码构建

构建需要 Node.js 22：

npm ci
npm run build

构建结果在 dist/，可直接作为解压扩展加载。在提供 zip 命令的环境中运行 npm run pack 会生成 margin.zip。

使用约束

• Brave、Opera、Vivaldi、Arc 等其他 Chromium 浏览器可按 Chrome 的步骤安装，但 README 说明未逐一测试；Safari 暂不支持。
• 部分账号功能需要登录 B 站，是否可用还受 B 站自身接口、权限与地区限制影响。
• 设置、足迹与自定义背景保存在本机。天气功能会向 ipwho.is 发送 IP 以获取粗略城市，并向 Open-Meteo 发送城市或坐标信息，完整说明见隐私政策。
• 动态背景在标签页隐藏时暂停，并遵循系统的“减少动态效果”设置；实际帧率取决于设备和页面负载，不保证固定 60fps，详见性能说明。
• 项目采用 MIT 许可，第三方组件、字体与设计参考各有自己的许可。

HotRepo 点评

该项目在 HotRepo 新项目榜的 TypeScript 语言榜上于 2026-11-02 有一条记录：当天约五小时的观察窗口内新增 13 Star，最新采样为 113 Star、7 Fork。单次快照不足以判断趋势，但能看出在那一小段时间里，一个只改造特定视频站点界面的小工具获得了持续关注。README 对保留原生播放器、本地保存数据、JSON 备份导入导出以及天气服务的信息披露写得具体，读者在安装前可以直接核对这些条件，而不必只看截图。