261025-1306 · 卡片抖动与歌词扫描修复

• 修复媒体进度在重复状态更新时回退、抖动的问题，保持播放进度平稳前进。
• 改善歌词扫描的连续性，减少停顿与回跳，同时保留换行、暂停和手动跳转时的正确对齐。
• 修复频繁状态更新打断动画节奏的问题，改善卡片元素和封面过渡的流畅度。
• 下一行歌词或译文暂时为空时，保持当前歌词位置稳定，避免上下跳动。
• 优化卡片重绘，复用绘图画刷并统一文字抗锯齿，减少重复资源创建。
• 二级菜单完成绘制后再显示，避免短暂闪现上一份列表内容。

261025-0040 · 快捷卡片交互、材质与加载修复

本版汇总近期快捷卡片的显示、交互与稳定性修复。

显示与材质

• 修复多张快捷卡片失去焦点后 Mica 效果不能持续显示的问题，改善重新打开后的材质恢复。
• 修复设备、播放来源选择框和下拉列表文字偏上的问题，统一垂直居中。
• 调整媒体卡片标题、单行歌词与空状态提示的位置，封面音符占位符上下居中；无来源时显示明确提示。

流量图与刷新

• 修复重复天气状态导致整组卡片频繁重绘、重新置顶的问题，保持流量图和菜单显示稳定。
• 修复流量图偶发未加载：避免天气或音频读取拖慢流量加载，读取失败后自动重试。
• 暂时无效的流量响应不再清空已加载的热力图数据。

点击、菜单与操作反馈

• 修复隐藏的媒体按钮拦截监测窗口点击的问题，改善卡片重新打开时的恢复行为。
• 修复二级菜单位置不正确、被卡片盖住的问题，支持再次点击选择器收起菜单。
• 完善菜单方向键、Enter/Space、Esc、Tab 和滚轮操作；鼠标在同一项内松开才提交，移出后松开取消。
• 所属卡片关闭、禁用或位置改变时正确关闭菜单，避免残留浮层。
• 修复音频设备操作失败提示被同版本状态更新丢弃的问题。
• 同步屏幕阅读器焦点、键盘焦点与菜单选择，避免确认到旧选项。

261024-2323 · 卡片入口与流量高光修复

• 修复点击任务栏窗口无法打开快捷卡片的问题，任务栏与托盘入口统一连接原生卡片。
• 改善流量卡热力图：收敛光晕，恢复清晰的格子间距和流量色阶，保留选中日期边框。
• 修复卡片运行环境重复初始化时可能触发的崩溃。

261024-2033 · 原生快捷卡片与资源优化

原生快捷卡片与资源优化

• 天气、流量、音频设备和媒体快捷卡片改为原生绘制，保留独立卡片布局、自定义 Mica 和明暗主题。
• 设置窗口按需启动，关闭后释放设置进程；快捷卡片的按需模式会回收闲置窗口与绘图资源。
• 改善歌词逐词扫描、换行与长句滚动、封面切换，以及设备和播放源菜单交互。
• 修复卡片点击、音量和进度拖动、键盘关闭、高 DPI 绘制及主题预览同步问题。
• 保留天气刷新、空气质量与预警来源说明，以及此前的天气连接和设置保存修复。
• 修复更新失败回滚时 SQLite 数据库临时文件可能残留的问题。

TaskBarWidgets 261024-1906

TaskBarWidgets 261024-1906

Windows 11 x64。修复天气设置的统一保存，优化天气卡片的数据来源显示。

用户可见变更

• 修改天气来源、选择城市或编辑连接配置后，顶部会显示待应用状态，并可通过“应用更改”统一保存；连接验证失败保留输入，便于修改重试。
• 保存普通设置时保留天气页面状态，撤销天气编辑后正确清除待保存提示。
• 天气卡片底部不再显示整条归因网址，改为简洁的“和风天气 · 数据来源”链接，保留其他来源说明。
• 改进和风天气连接错误提示，共享连接故障停止后续请求，避免重复报错。
• 空气质量使用新版接口，显示 AQI 及对应标准；空气质量或预警获取失败时显示独立提示，并标明保留数据可能过时。

升级与运行

升级保留已有城市、设置、天气凭据和历史，无需删除配置。和风天气连接使用账户控制台提供的完整 API Host 和 API Key；密钥留空保留已有值。

需要 Windows 11 x64、.NET 8 Desktop Runtime x64 最新 8.0 补丁、Windows App Runtime 2.5.1 x64 或兼容的更新 2.x，以及管理员权限。完整解压后运行 TaskBarWidgets.exe。

提供完整 ZIP、SHA256SUMS.txt 和 update.json，不包含个人配置、凭据或历史，保留第三方许可证。

GitHub Release

TaskBarWidgets 261023-1616 — 天气预警与单曲偏移页面修复

• 迁移和风天气新版预警接口，按城市坐标获取预警，完善预警等级、正文、发布时间及来源归因展示。
• 中国天气网与和风天气均补充预警获取失败提示，保留旧预警时明确标注，恢复成功后清除过时提示。
• 和风天气连接先验证再保存；明确区分当前生效来源和未保存草稿，支持切换来源并刷新，避免误刷旧来源或旧城市。
• 修复单曲偏移页面收到数据后整页重建、重复播放入场动画的问题，保留搜索内容及尚未应用的偏移输入。

TaskBarWidgets 261023-1521 — 任务栏浏览器媒体文字底部截断修复

任务栏媒体

• 浏览器播放时，任务栏媒体里标题下方的歌手／来源行不再被裁掉字底：中文字形与 g、y、p 这类下伸字母现在完整显示。
• 两行按各自的真实行高上下排列，并在播放按钮左侧垂直居中；字号、颜色和过长的省略号截断保持原样。

TaskBarWidgets 261023-1400 — 天气卡空状态刷新入口

天气卡

• 天气数据没有取到时，空状态现在会显示刷新按钮，可以直接在卡片上重试。
• 没有设置城市时，空状态仍然显示“打开天气设置”。
• 刷新中的进度与失败提示会显示在卡片上，重试后不再毫无反馈。

TaskBarWidgets 261022-1945 — 跨版本更新兼容修复

版本说明

本版本包含已撤回的 261022-1921 全部更新内容，并修复其无法从 261022-1616 等旧版本通过应用内更新升级的问题。261022-1945 取代并替代 261022-1921。

本次修复

• 修复旧版客户端创建 protocolVersion: 1 更新作业后，新版更新健康检查拒绝该作业并自动回滚的问题。
• 新版主程序只在升级启动阶段兼容旧版更新作业；新版更新器创建和执行的后续作业仍严格使用 protocolVersion: 2。
• 已回滚的旧更新作业不再阻止新版启动；仍处于安装中的旧作业仍会保留恢复保护。
• 261022-1616 用户现在可以直接通过应用内更新升级到本版本。

撤包版本包含的更新内容

单目录数据布局

• 便携版运行数据统一到 <安装目录>\Data\，不再将 %APPDATA%\TaskBarWidgets 作为运行数据目录。
• 配置按写入者分开保存：Data/config/app.ini、battery.ini、power.ini、weather.ini、media.json。
• 不可重建歌词数据位于 Data/lyrics/；可重建缓存位于 Data/cache/lyrics/。
• 日志、迁移归档和备份分别位于 Data/logs/、Data/migration/、Data/backups/。
• global_cfg.ini 只作为旧版迁移输入，迁移后归档，不再作为模式开关使用。

自动迁移

• 首次启动会检查旧安装目录布局和旧 AppData 数据，目标新文件优先且绝不覆盖。
• 冲突文件和旧来源归档到 Data/migration/archive/<UTC时间>/。
• 迁移先暂存并校验 JSON、INI、流量文件和 SQLite 完整性，全部通过后才提交。
• 迁移失败会回滚本次变更并阻止启动，不静默使用旧配置或旧数据回退。

天气凭据

• 天气 AppKey 使用当前 Windows 用户的 DPAPI 加密，保存到 Data/secrets/weather-appkey.bin。
• 活动 weather.ini 不保留明文 AppKey；空输入保持原密钥，显式清除才会删除密文。
• 旧 WeatherPro.ini 会原样归档，归档中可能仍有明文 AppKey，请勿公开或分享迁移归档。
• 跨用户或跨机器恢复时 DPAPI 密文无法使用，需要重新输入天气密钥。

数据与备份

• “常规 → 数据与备份”新增数据根、布局版本、迁移结果、各类占用、密钥状态和待恢复状态。
• 提供打开数据目录、立即备份、恢复备份、重新导入旧数据和清理可重建缓存。
• 手动备份包含配置、流量历史、不可重建歌词数据、布局文件和 DPAPI 密文。
• 备份排除缓存、日志、迁移归档、其他备份、临时文件和 SQLite -wal/-shm。
• 恢复会校验路径、大小和哈希；冷启动前自动生成 pre-restore-latest.zip，失败时回滚。

更新与发布

• 更新器使用 protocolVersion: 2，只接受 <安装目录>\Data 作为统一数据根。
• 发布 ZIP 和 app-files.json 不包含 Data、备份、迁移归档、日志或天气凭据。
• 更新前保留配置、历史、不可重建歌词数据、密钥密文和布局文件；缓存、日志、归档和备份不进入更新回滚包。

升级注意事项

• 当前 261022-1616 可以直接使用应用内更新升级。
• 已经手工安装 261022-1921 的用户应更新到本版本。
• 首次启动可能执行一次数据迁移；建议升级前自行备份旧安装目录和旧 AppData 数据。
• 手工升级时请使用完整 ZIP，保留安装目录中的 Data\，不要单独运行 Media 或 UI 辅助程序。

运行要求

• Windows 11 x64。
• .NET 8 Desktop Runtime x64，安装最新 8.0 补丁。
• Windows App Runtime 2.5.1 x64 或兼容的更新 2.x。
• 仅需运行库，不需要开发 SDK。

附件

• TaskBarWidgets-261022-1945-win-x64.zip：完整便携发行包。
• SHA256SUMS.txt：ZIP 校验值。
• update.json：应用内更新元数据。

本 Release 的 ZIP 不包含个人配置、流量历史、歌词数据库、缓存、日志、迁移归档或天气密钥。运行后产生的个人数据请勿公开分享。

TaskBarWidgets 261022-1616 — 频谱采集修复

Windows 11 x64。修复音频频谱被误报"被安全软件阻止"且采集无法恢复的问题。

• 修复音频频谱每次启动都无法采集、反复提示"系统音频采集被系统或安全软件阻止"的问题。真实原因是媒体组件与 NAudio 的 COM 枚举类声明了同一个系统 CLSID，先被其他音频功能注册的类型会接管后续所有同名创建，频谱每次创建设备枚举器都抛出类型强转异常，直到重启进程也不会恢复；现在直接按底层 COM 接口创建枚举器，不再依赖进程内的类型统一，频谱恢复正常显示。
• 修复按应用识别播放来源时的同类创建失败；此前该路径失败会被静默跳过。
• 频谱异常提示按真实原因区分：内部初始化错误不再显示"被安全软件阻止"；无可用播放设备、音频设备已失效或被移除时分别给出对应提示；仅当真正被拒绝访问时保留原提示，并继续自动重试。

性能与占用优化

本版本同时包含一组任务栏性能与资源占用优化：

• 降低常驻资源占用：媒体/歌词与监测界面在隐藏或空闲时释放不需要的图像等资源，减少任务栏的整体内存占用。
• 精简图片处理链路：封面、专辑图等传输按尺寸限制、频谱复用内部缓冲，避免大图带来的内存峰值与反复分配。
• 提升刷新稳定性：媒体加载失败与任务栏刷新路径的失败原因可被准确记录，便于后续快速定位。

升级说明

不改动配置项名称和含义，升级后无需删除配置，个人配置、流量历史与歌词库全部保留。

运行与附件

需要 Windows 11 x64、.NET 8 Desktop Runtime x64 最新 8.0 补丁、Windows App Runtime 2.5.1 x64 或兼容的更新 2.x，以及管理员权限。完整解压后运行 TaskBarWidgets.exe，不要单独启动 Media/UI 内的辅助程序。

提供完整 ZIP、SHA256SUMS.txt 和 update.json。发行包不包含个人配置、天气凭据、历史、数据库、日志或截图，保留第三方许可证；更新保留已有个人数据。