使用/开发文档
Documentation
软件概述
BASpark 是一款基于 Windows 平台的桌面鼠标特效工具,深度复刻《蔚蓝档案》(Blue Archive)风格的点击动效
软件采用 “WPF 骨架 + WebView2 渲染” 混合架构,具有轻量、高效、资源占用低的特点。本软件完全开源,采用 MIT 许可证
实时状态预览
安装与卸载
安装步骤
- 下载后双击运行
BASpark_Installer_vX.X.X_x64.exe - 按安装向导提示点击“下一步”并选择目录
- 安装完成后,软件将自动运行并常驻系统托盘
卸载步骤
- 打开 Windows “设置” → “应用” → “已安装的应用”
- 在列表中找到 “BASpark” 并点击“卸载”
基础设置
开关控制
- 独立开关:可选择开启“鼠标点击特效”或“鼠标常驻拖尾”
- 按键过滤:支持“仅左键”、“仅右键”、“左右键”及“中键按下触发”
- 应用更改:重要! 修改参数后需点击右上角「应用更改」按钮才能生效
进阶功能
- 截图兼容模式:开启后,在检测到 QQ 截图或系统截图快捷键时,特效将自动隐藏以便框选窗口
- 以管理员权限运行:若需在“任务管理器”等界面看到特效,请勾选此项
- 触摸屏模式:*开启后,即便系统隐藏了鼠标指针特效依然生效,仅适用于触摸屏或特定的全屏应用环境
- 开机自动启动:*开启后,软件将尝试在系统开机时自动运行
- 静默启动:*开启后,软件将尝试在系统开机时不弹出主窗口,自动最小化启动运行
视觉表现调节
在“视觉表现”子设置菜单中,您可以通过滑块或精确数字输入(按回车确认)调整以下参数:
- 缩放比例:支持 0.5x 到 3.0x,适配不同屏幕分辨率
- 全局不透明度:调节特效的整体视觉浓度
- 动画播放速度:调节特效的整体播放速度
- 动画速度同步:默认同步速度,取消勾选后可独立调整“点击速度”与“拖尾速度”
- 拖尾刷新率:最高支持 240Hz,数值越高轨迹越丝滑,但会占用更多资源(相对)
主题配色
点击「更改颜色」按钮可唤起调色板,支持自定义粒子的核心颜色
恢复默认设置
点击「恢复默认设置」按钮可自定义选择需恢复默认数值的设置项
智能环境过滤
环境感知设置
- 智能环境探测:自动实时感知当前鼠标所在窗口
- 全屏自动暂停:检测到全屏游戏或视频时,自动挂起特效渲染以节省性能并防干扰
- 桌面特效开关:可选择是否在 Windows 桌面上显示粒子
多配置组管理
支持针对不同使用场景(如“办公”、“游戏”)创建多套独立的过滤规则,并支持以下操作:
创建空白的配置组
自定义配置组名称方便识别
删除不再需要的配置组
进程过滤模式
在当前所选的配置组内,可切换三种模式:
- 🚫 关闭过滤:全局开启特效,不应用列表规则
- ❌ 黑名单模式:仅列表中的程序不显示特效
- ✅ 白名单模式:仅在列表中的程序显示特效
添加进程方式
支持三种灵活方式录入需要过滤的程序:
多屏显示管理
BASpark 具备显示器识别与记忆功能,以适配多显示器用户
硬件 ID 记忆
软件会记录每个显示器的分辨率与唯一硬件 ID,断开重连后自动恢复配置
独立开关
你可以手动勾选要在哪个屏幕上显示特效,避免副屏干扰问题
动态刷新
插拔显示器后,点击“刷新显示器”即可重新扫描当前拓扑结构
实时公告与自动更新
云端实时公告
软件首页集成了实时公告系统,我们可能会通过此渠道发布:
- 新版本的特性介绍与优化细节
- 已知问题的临时解决方案
- 社区活动信息或重要通知
- 节日彩蛋等内容...
自动检查更新
无需手动前往官网查看最新版本,在软件的「关于」页面中,点击「检查更新」按钮:
系统将自动检测本地版本与服务器最新版本的差异
检测到新版后,支持自动弹窗通知更新内容
* 注意:自动更新功能需要网络连接,若在严格的防火墙环境下,可能获取数据失败
常见问题
Q: 修改参数没反应?
A: 请确保点击了“参数配置”标题右侧的「应用更改」按钮,设置才会推送到渲染引擎
Q: 安装时提示“WebView2 未安装”?
A: 本软件依赖微软 WebView2 运行环境,请根据弹窗提示点击下载,或前往微软官网手动安装 Runtime
Q: 为什么在某些窗口(如任务管理器、开始菜单等)上没有特效?
A: 这是由于 Windows 相关安全机制,可尝试在设置中勾选「以管理员权限运行」,并重新启动软件即可覆盖部分高权限窗口
Q: 占用资源如何?
A: 在测试环境下,静态待机内存占用低于 100MB,即便是在高频点击下,CPU 占用波动也较小
Q: 如何让软件开机自启动?
A: 在“基础设置”中勾选「开机自启」即可。若被安全软件拦截,请在相应软件的白名单中放行
Q: 多显示器环境下特效位置偏移?
A: 软件支持 DPI 自动缩放适配。如果出现偏移,请尝试重启软件
Q: 为什么点击“检查更新”按钮没反应?
A: 请检查网络连接,公告和自动更新功能需要访问软件服务器,如果网络环境受限,建议手动前往项目官网查看
没能解决您的问题?
您可以加入我们的官方 QQ 群或在 GitHub 提交反馈
