卡牌大师
以游戏化卡牌统一管理用户脚本与网页能力。
AI 脚本生成 · 内容过滤 · 深色主题 · 媒体控制 · 视频增强 · 游戏手柄
下载发布版 · 问题反馈 · 林亦LYi B站主页 · 第三方声明
视觉一览
卡背 · 杀 · 时光飞龙 · 了不起的脚本小子
核心能力
- 📜 用户脚本 — 安装、导入、更新、启停、隐藏；新装默认启用
- ✨ AI 脚本工坊 — 搜索、创建、解释、修复；兼容 Responses 与 Chat Completions
- 🖼️ 新标签页 — AI 每日回顾壁纸、电子相框和搜索 · Chromium / Firefox
- ⚔️ 杀 — 点选隐藏广告或其他内容
- 🌙 暗夜降临 — 重算页面明暗 · 新装默认停用
- 🐉 时光飞龙 — 统一调节网页音视频速度
- 🐑 顺手牵羊 — 发现并取得页面媒体 · Chromium / Firefox，新装默认停用
- 🎬 视频增强 — 流量探险家、合成大弹幕、绯红空降，以及 B 站 / YouTube SponsorBlock
- 🎮 科乐美秘技 — 鼠标、键盘、手柄一套操作；含屏幕键盘、拼音和语音
- ☁️ WebDAV 同步 — 在「设置 → 数据管理 → 跨设备同步」连接自己的服务，统一同步脚本、卡牌与插件配置，支持合并预览、冲突选择和历史恢复。
同一套核心代码打 Chromium、Firefox、Safari 三份包。
安装
到 Releases
下载对应 zip，并核对 SHA256SUMS.txt。
这些 zip 不是安装包。Chromium 内核浏览器和 Firefox 必须先解压，再加载那个 带
manifest.json的文件夹。
| 平台 | 产物 | 加载方式 |
|---|---|---|
| Chromium（Chrome、Edge、Brave、Arc 等） | card-master-v*-chromium.zip |
解压 → 加载未打包扩展 |
| Chromium（保留浏览器新标签页） | card-master-v*-chromium-browser-new-tab.zip |
解压 → 加载未打包扩展 |
| Firefox | card-master-v*-firefox.zip |
解压 → 临时载入附加组件 |
| Firefox（保留浏览器新标签页） | card-master-v*-firefox-browser-new-tab.zip |
解压 → 临时载入附加组件 |
| macOS Safari | 暂不提供下载 | 等待苹果公证完成，进展见 Issue #2 |
保留浏览器原生新标签页
请选择文件名带 browser-new-tab 的包。它与同平台标准版仅在 manifest.json 的新标签页接管声明上不同，不接管浏览器新标签页，普通网页的卡牌、脚本与 AI 功能照常使用。浏览器原生页面受浏览器权限限制，不显示网页牌阵；如果还有其他新标签页扩展接管，需要在浏览器中另行调整。
已安装卡牌大师时，将对应包完整解压并覆盖到原安装目录（其中直接包含 manifest.json），在扩展管理页重新加载，再新建标签页。不要卸载扩展、清除存储或改到新目录重新安装，以免丢失原扩展身份对应的数据。切回标准版也使用同样的方法，原有牌库、API 配置和自定义网址设置会保留。
设置中的“使用卡牌大师页面”只用于清空标准版的自定义网址；恢复浏览器原生页需要切换上述安装包。保留浏览器新标签页版仍可从扩展设置的“打开卡牌大师页面”入口手动打开卡牌大师页面。
Chromium
- 解压
card-master-v*-chromium.zip。 - 打开扩展管理页（Chrome 为
chrome://extensions，其他 Chromium 浏览器路径类似）。 - 打开右上角「开发者模式」。
- 「加载未打包的扩展程序」→ 选中解压后的文件夹。
- 打开扩展详情，开启「允许运行用户脚本」，再重新加载扩展。
不打开「允许运行用户脚本」，所有用户脚本都不会跑，包括预装脚本。 路径：扩展管理页 → 卡牌大师 → 详情。
查看开关位置
某个网站显示「未允许」时，点扩展图标或详情里的「有权访问的网站」，允许当前站或所有站。
Firefox
解压后打开 about:debugging#/runtime/this-firefox，选「临时载入附加组件」，
再选目录里的 manifest.json。弹出用户脚本权限时请允许。
Safari
当前版本暂不提供 Safari 下载，请勿使用旧版未公证预览包或关闭系统安全检查。 以下权限说明供源码构建使用，正式分发恢复后同样适用。
打开 Card Master.app 之后，还要在 Safari 里勾完权限。只开 App、不授权网站，
网页上不会出现牌阵。
- Safari → 设置 → 扩展 → 勾选「卡牌大师」。
- 点 在每个网站上始终允许…，确认对所有网站允许。
- 更新或重装后，先完全退出 Safari 再打开。
牌阵快捷键是 ⌘⇧E。Safari 没有 Chromium 那项用户脚本开关，脚本走扩展自带注入。
查看「在每个网站上始终允许」位置
Safari 没有新标签页和顺手牵羊
Safari 网页扩展没有 history、bookmarks、topSites、downloads 和完整
webRequest。每日回顾读不到浏览历史，顺手牵羊也没有可运行的上游实现，
所以这两张卡和相关页面都不会出现。不是漏装。
从源码构建
需要 Node.js 22+ 和 pnpm 11.18.0。
pnpm install --frozen-lockfile pnpm check pnpm extension:package --platform=all
产物在 extension-dist/。Chromium 和 Firefox 构建同时生成对应的 *-browser-new-tab/ 目录，用于保留浏览器新标签页；与同平台标准版共用全部运行时文件。
参与贡献
用 Issues
提问题和建议。提交代码前请跑通 pnpm check，并保持改动范围可验证。
致谢
直接依赖、嵌入运行时、预装脚本和许可证见
upstreams.json 与
THIRD_PARTY_NOTICES.md。
查看完整第三方项目列表
- 内容过滤与页面能力： AdGuard tsurlfilter、 AdGuard DNR Rulesets、 Dark Reader、 Video Speed Controller、 Speeder、 Hayame、 Cat Catch。
- 用户脚本平台参考： Violentmonkey、 Tampermonkey historical source、 ScriptCat。
- Bilibili 与 YouTube： TabulaBili、 pakku.js、 BilibiliSponsorBlock、 SponsorBlock、 BiliKit、 Bilibili Favorites Fix、 Copying Lifted。
- 手柄、导航与输入： Remapad、 Gaming Controller Tester、 Spatial Nav CSS、 Pinyin IME、 Lumno。
- 运行时与工具链： React、 Lucide、 GSAP、 Acorn、 react-markdown、 remark、 rehype、 tldts、 Cinzel、 TypeScript、 Vite、 Vitest、 Biome、 esbuild、 sharp。
卡牌式信息层级、牌阵和动效语言参考了包括 GWENT 在内的收藏卡牌游戏界面研究。 GWENT 及其相关名称、商标与官方素材归 CD PROJEKT RED 所有；Card Master 与其 不存在从属、授权或背书关系。
关于林亦LYi
卡牌大师由 林亦LYi 团队策划与开发， 是林亦LYi 自媒体内容与开源实验的一部分。欢迎前往 B 站主页关注我们的视频与后续项目。
许可证
代码与第一方媒体资产以 GPL-3.0-only 发布。第三方代码、数据、字体与预装脚本仍受各自许可证约束，见
THIRD_PARTY_NOTICES.md。