## 简介
ba-click-fx 是为网页和 Windows 桌面打造的**《蔚蓝档案》风格点击特效与光标拖尾**:点击时爆出溶解圆环、中心光盘和碎片,移动鼠标拖出连续光带。参数直接移植自游戏 Unity 资源,视觉还原度拉满。
- **网页版 ba-click-fx(v1.3.3)**:零依赖 JS 库 + CDN + Chrome / Edge / Firefox 浏览器插件,任何网页秒变游戏手感的点击反馈
- **桌面版 ba-click-fx-desktop(v0.2.19)**:Windows 10/11 x64 原生应用,全系统范围特效,支持背景感知、控制中心和 OBS 透明特效输出


## 网页版 ba-click-fx —— 给网页加游戏特效
### 核心特性
- 点击溶解圆环、中心光盘、碎片爆发与连续拖尾,**参数级还原** Unity ParticleSystem 颜色/大小/旋转曲线
- 拖尾沿路径连续缩短(旧点先消失),而不是整条线同时淡出
- 粒子尺寸随画布高度持续缩放,保持 Unity UI 相对比例
- 默认 WebGL2 后端,可选 WebGPU 与实验性 HDR 输出,GPU 不足时自动回退 Canvas 2D
- 支持主题色(六位十六进制值)与运行时调参,数十项可调参数
- 无活跃特效时自动停止动画调度,省电省资源
**浏览器插件:**
| 商店 | 地址 |
|------|------|
| Chrome | [Chrome Web Store](https://chromewebstore.google.com/detail/clphaaacolnifhgmeblfeofapccgoami) |
| Edge | [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/ba-click-fx/gocfepocmghimclocjafcihcplnpjpkc) |
| Firefox | [Firefox Add-ons](https://addons.mozilla.org/zh-CN/firefox/addon/ba-click-fx/) |
装上插件后,浏览所有网页都有蔚蓝档案点击特效和光标拖尾。
## 桌面版 ba-click-fx-desktop —— Windows 全局点击特效
### 简介与架构
独立实现(不复用网页版 JS/WebGL/WebGPU 代码),使用 **C++20、Win32、D3D11、HLSL 和 DirectComposition** 从零编写。面向 Windows 10/11 x64,提供透明覆盖层、原生控制中心和 OBS 透明特效输出。架构上分为两个进程:
- **Host**:负责渲染特效
- **Control Center**:负责设置与启停(支持简体中文/英文,即时切换)
### 安装与使用
官方 Release 提供四种 Full 版资产:安装器与便携 ZIP,各带 `.sha256` 校验文件。
| 场景 | 选择 |
|---|---|
| 日常使用、开始菜单快捷方式 | 安装版 `*-setup-windows-x64.exe`(需 UAC) |
| 无管理员权限、解压即用 | 便携版 `*-Portable-windows-x64.zip` |
打开 Control Center → 点击"启动 Host" → 点击或按住鼠标拖动即可看到特效。发布包无需另装 Visual C++ 运行库或 Windows App SDK。
### 常用设置
Control Center 提供五个页面:**基础设置 / 高级参数 / 显示与性能 / 快捷键 / 系统**。常用设置包括效果大小、拖尾长度与宽度、Bloom 强度与质量、随 Windows 启动,以及内置和自定义特效预设。
**三种背景模式:**
| 背景模式 | 适用场景 |
|---|---|
| 背景感知(默认) | 捕获背景参与合成,捕获不可用时仅显示特效(FX-only) |
| 录屏兼容(测试) | 尝试让录屏软件也能捕获特效(仅 OS build 26300+ 可选) |
| 浅色背景优化 | 无需捕获背景,降低透明度上限,浅色桌面更清晰 |
**快捷键**:默认全部未绑定,可配置暂停/恢复、常驻拖尾、下一个预设和退出 Host;支持 Ctrl / Alt / Shift / Win + 单主键组合。
### OBS 直播/录屏透明特效输出
桌面版支持通过 **Spout2** 向 OBS 输出纯透明特效层(不含桌面背景),无需录屏兼容模式:
1. 安装与 OBS 匹配的 [Spout2 接收插件](https://github.com/Off-World-Live/obs-spout2-plugin/releases/),在 Control Center 勾选"启用 OBS 透明特效输出"
2. OBS 中游戏/桌面捕获置底,`Spout2 Capture` 来源置顶,发送者选择 `ba-click-fx-desktop`
3. Composite Mode 选 `Premultiplied Alpha`,混合保持 `Default` / `Normal`
4. 执行 `Transform -> Fit to Screen`,空闲时全透明,点击/拖动时叠加特效
### 支持范围(重要提醒)
- 当前人工特效审核以**单主屏 SDR** 为准
- 背景感知依赖 Windows Graphics Capture(WGC)系统授权
- HDR、多显示器、混合 DPI/刷新率、跨显卡尚未完成完整硬件验收
- 安装器没有公有代码签名,SmartScreen 可能显示"Unknown Publisher"
## 常见问题
- **移动鼠标没有拖尾?** 默认只在按住鼠标时产生拖尾,开启"拖尾常驻"后普通移动也有
- **屏幕出现黄色边框?** 这是 Windows 的捕获提示,可在基础设置里取消
- **关闭控制中心后特效还在?** Control Center 与 Host 是独立进程,彻底停止请点击"关闭 Host"
## 系统要求
- 网页版:浏览器(Chrome/Edge/Firefox)或任何支持现代 JS 的网页宿主,Node.js ≥24 仅开发时需要
- 桌面版:Windows 10/11 x64,安装器最低 OS build 19041
## 来源
[网页版](https://github.com/CialloKing/ba-click-fx)
[桌面版](https://github.com/CialloKing/ba-click-fx-desktop)
👁️
0 浏览
❤️
0 点赞
💬
0 评论
⭐
0 收藏