v0.5.0

新增

• 歌曲排行新增“下一首播放”按钮，鼠标悬停歌曲行时显示；播放次数榜与收听时长榜均可使用。连续添加按点击顺序插入，不再弹出添加成功的绿色通知。
• 新增统计入口位置开关，可在顶部图标和左侧栏目间切换；左侧栏目名称为“统计”，切换栏目时保持正确的选中状态。
• 统计页右上角新增齿轮按钮，可直接打开本插件的配置界面。

调整

• 设置按“常规、显示、动画、更新与诊断”分组，保留原有配置。
• 关于弹窗的作者信息移至项目链接右侧，同排显示。
• 更新开关统一命名为“自动检查更新”，说明补充“Steam创意工坊渠道无需开启”。

修复

• 修复导入或停用插件时，同步等待界面线程可能导致超时并提示必须重启的问题。

安装与兼容性

• 手动安装包：SPW-Stats-v0.5.0.spmod，在 SPW 的“模组管理”中本地导入；保留原有统计数据、计算规则和备份格式。
• 如果当前已加载的旧版在导入时提示必须重启，请完全退出并重新启动 SPW，使新版生效。
• 基于 SPW 1.19.3 构建。侧栏、配置跳转和队列操作依赖宿主内部接口；空队列时添加歌曲可能由宿主开始播放。
• 已完成源码编译、静态和合成回归及包结构检查；实际音频、队列和导入行为仍需实机确认，不能据此保证其他宿主版本的兼容性。

v0.4.1

新增

• 歌曲排行支持双击播放所选单曲。
• 新增时长单位设置，概览与排行／歌曲明细可分别选择中文或 h/m/s，默认使用中文。
• 返回关闭统计页后，可通过鼠标前进侧键恢复统计页。
• “关于”弹窗新增作者、项目主页、问题反馈和开源许可入口。

安装与兼容性

• 手动安装包：SPW-Stats-v0.4.1.spmod，在 SPW 的“模组管理”中本地导入。
• 基于 SPW 1.19.3 构建，保留原有统计数据、计算规则和备份格式。
• 双击播放和前进恢复依赖宿主内部接口，当前按 SPW 1.19.3 核对；实际音频、队列与鼠标侧键行为仍需实机确认，静态和合成检查不代表跨版本兼容性已经验收。

v0.4.0

v0.4.0

性能提升

• 统计刷新更快：数据没有变化时，不再重复计算统计和排行；听歌记录较多时，新增记录后的刷新速度也得到改善。
• 再次启用更快：首次启用会查找播放器中的页面和入口，后续启用及重启播放器后可复用结果，减少等待。播放器内容或插件版本变化时会重新查找。
• 长范围图表悬停更流畅：查看跨月、跨年的折线或曲线图时，移动鼠标更流畅，保留全部每日数据、原有曲线形状和日期选择精度。

新增更新提醒

• 微软商店渠道的SPW支持自动检测更新了，Steam 创意工坊的更新仍由 Steam 处理。
• 统计页右上角新增“ⓘ 关于”按钮，可查看插件版本、上次成功检查时间和更新状态，也可手动检查更新。
• 增加“为微软商店版启用更新提醒”开关，默认关闭。开启后自动检查 GitHub 正式版本，至少间隔 24 小时；自动检查失败不打扰，手动检查失败会提示原因。
• 发现新正式版本时，“关于”按钮显示蓝点，每个新版本最多自动提醒一次。
• 点击“查看发布页”后自行下载安装，不会自动下载或安装更新。
• 检查更新不发送听歌记录。

界面修复

• 修复打开“关于”或日期范围弹窗后，移动鼠标导致背景变暗、闪烁的问题。
• 精简“关于”窗口布局，调整部分按钮的排列和对齐。
• 改善插件启用失败时的处理，避免重复入口。

安装说明

• 手动安装包：SPW-Stats-v0.4.0.spmod，在 SPW 的“模组管理”中本地导入。
• 继续使用原有数据目录，听歌时长、播放次数的计算规则和备份格式不变。

Full Changelog: v0.3.4...v0.4.0

v0.3.4

更新日志

• 修复导入、导出文件框在 SPW Compose 环境中导致卡死或崩溃的问题。
• 文件选择改为独立后台线程调用，取消页面或停用插件时会关闭文件框。
• 增强备份异常诊断，记录操作、线程、结果和完整堆栈。
• 日志达到 1 MB 后自动轮转，保留最近 3 个历史文件。

注意事项

低于v0.3.3版本的微软商店用户(不包括v0.3.3) 安装前请先在SPW中删除旧版本mod，并手动清理残留文件：

1. 打开以下目录： C:\Users\用户名\AppData\Roaming\Salt Player for Windows\workshop\plugins
2. 删除该目录下所有以 SPW-stats 开头的文件。
3. 如果文件无法删除，请彻底退出 SPW 后重试。
4. 清理完成后，重新打开SPW导入新版安装包即可。

Full Changelog: v0.3.3...v0.3.4

v0.3.3

更新日志

• 修复 Linux 下统计页面无法打开的问题，改进宿主程序定位方式。
• 修复 Linux 下听歌数据库无法定位的问题，优化不同系统及 Steam 订阅目录的路径识别。
• 修复 Windows 下卸载插件时 SQLite JDBC 文件被占用的问题。
• 优化数据库连接及资源释放机制，提高插件停用、重新启用和卸载时的稳定性。
• 完善诊断日志，增加数据库候选路径及文件状态信息。

微软商店用户安装前请先在SPW中删除旧版本mod，并手动清理残留文件：

1. 打开以下目录：
   C:\Users\用户名\AppData\Roaming\Salt Player for Windows\workshop\plugins
2. 删除该目录下所有以 SPW-stats 开头的文件。
3. 如果文件无法删除，请彻底退出 SPW 后重试。
4. 清理完成后，重新导入新版安装包即可。

What's Changed

• 修复 Linux 兼容问题及 Windows 卸载时的文件占用 by @GaBoron in #6

New Contributors

• @GaBoron made their first contribution in #6

Full Changelog: v0.3.2...v0.3.3

v0.3.2

v0.3.2

发布日期：2026-10-26

变化

• 新增排行指标菜单，可在播放次数和累计实际收听时长之间切换。
• 歌曲、艺术家和专辑排行均支持收听时长排序、搜索与分页；时长按已合并事件的实际收听片段累计，暂停和拖动跳过的时间不计入。
• 未达到 50% 播放次数门槛但存在实际收听片段的歌曲，也会出现在收听时长排行中。
• 宿主 Listen 表改为启用会话内的只读缓存：无变化时复用快照，连续追加时读取新增 rowid，发现更新、删除、重建或并发变化时安全回退全量读取。
• 停用插件时释放宿主数据库连接，并补充数据库增量读取与时长排行回归测试。

构建与兼容性

基于 SPW 1.19.2 构建。包结构、Manifest 版本和排行／数据库回归检查已通过；真实窗口、AOT 模式、多插件共存、DWM 材质和跨版本宿主兼容性仍需实机核对。宿主内部结构或 API 变化仍可能需要后续适配。

v0.3.1

v0.3.1 2026-10-25

变化

• 统一歌曲明细表头与排行表列布局，补充卡片底部的歌曲数量和精确到秒的时长摘要。
• 修正歌曲明细时长列、表头和图表真实端点的对齐。

构建与兼容性

基于 SPW 1.19.2 构建。包结构、Manifest 版本和离屏检查已通过；真实窗口、AOT 模式及多插件共存效果仍需实机核对。宿主内部结构或 API 变化仍可能需要后续适配。

v0.3.0

变更

从 v0.2.5 到 v0.3.0：

• 增加时段听歌明细展示，表格支持标题、歌手、专辑与本时段收听时长。
• 优化统计页与宿主页面的进入、退出和切换体验，补充真实快照刷新与显示偏好处理。
• 改进热力图、时长分布、图表交互、深色材质卡片与导航视觉细节。
• 更新明细提示文案与列对齐，并同步预览页面。
• 持续完善歌曲、歌手、专辑排行及封面、备份与宿主兼容性处理。

v0.2.5

更新日志

v0.2.5 正式版 · 2026/10/23

• 优化页面进入动画，旧页面淡出与统计页滑入同步进行。
• 新增后台数据预读与快照复用，减少加载等待和页面闪烁。
• 优化刷新逻辑，避免重复播放页面及热力图动画。
• 读取失败时保留上次数据并提示错误，恢复后自动更新。
• 修复加载期间切换或退出后，旧请求导致页面意外打开的问题。

基于 SPW 1.19.2 构建。多插件兼容性未知。

听歌统计 v0.2.4

更新日志

v0.2.4 正式版 · 2026/10/23

• 修复 SPW 1.19.2 更新后统计页面无法打开的问题。
• 改为每次启用时动态识别宿主页面、导航和主题，减少混淆名称变化造成的失效。
• 更新页面动画设置说明。

已基于 SPW 1.19.2 构建并通过静态／离屏检查，不保证未来版本自动兼容。