Repository navigation
Releases: visual-life/ClearDesk
Release list
ClearDesk 2.2.9
ClearDesk 2.2.8
ClearDesk 2.2.7
ClearDesk 2.2.6
ClearDesk 2.2.5
ClearDesk 2.2.4
2.2.4 更新
- 加强组件位置和设置的保存、备份与恢复，改善重启后位置丢失问题。具体原因尚未在反馈用户的电脑上复现。
- 透明任务栏组件支持内置副本校验与自动修复，新增诊断日志和修复入口。
- 五套测试通过，新增 47 项测试。
已知问题：时钟显示较长的英文星期名时文字可能碰到组件边缘，此问题在 2.2.3 中也存在。
详细说明见仓库的 docs/releases/2.2.4.md。
ClearDesk 2.2.3
ClearDesk 2.2.3
2026-10-27 · Windows 11 · 完整 zip，解压后运行 ClearDesk.exe
这个版本修了什么
- Dock 里有的程序不显示图标（如 Antigravity），或 UWP 程序（如系统「设置」）显示成空白窗口图标、名称为「Application Frame Host」。
原因：取图标失败时被永久缓存，之后一直空白；UWP 窗口属于ApplicationFrameHost.exe，Dock 取了宿主 exe 的图标和名称。
现在：按「应用包图标 → exe 图标 → 窗口自己的图标 → 开始菜单快捷方式 → 通用图标」取；失败不缓存，先显示首字母图标并在 2 / 5 / 15 / 45 秒后自动重试；UWP 应用显示开始菜单里的名称和图标。ClearDesk.exe --dock-diag新增「图标解析」，可逐个应用查看每一级来源。 - 无边框文字阴影更清爽：模糊半径 7 → 2.5（偏移 1、不透明度 0.55），细体字不再被一圈灰雾罩住。屏幕实测时钟数字周围的暗区面积约降到原来的三分之一，仍保留阴影。
- 结束 TranslucentTB 后再打开 ClearDesk，提示「任务栏组件校验失败」而无法启动：可选的透明任务栏组件出问题（文件缺失、损坏、被安全软件隔离、被占用）不再阻止 ClearDesk 启动；会先从
%LOCALAPPDATA%\ClearDesk\taskbar-good的完好备份自动还原，还原不了就暂时关闭该功能并弹出不阻塞的提示，1 / 5 / 30 分钟后自动重试。你自己结束了 TranslucentTB 时，ClearDesk 只记日志，不会强行重新拉起。 - 最小化动画的窗口事件监听失败不再致命。
需要如实说明的
- Antigravity 偶发空白的那一次没能在现场复现（这台电脑上它能正常取到图标）；修复针对的是「失败被永久缓存、没有备用来源」这一机制。
- 「结束 TranslucentTB 后校验失败」里的哈希不匹配本身没能复现（正常安装的
taskbar文件夹校验都通过）；原因多半是组件文件被替换 / 覆盖了一半、被安全软件隔离或扫描占用。无论哪种，原来「致命退出」的处理方式是错的，已改成非致命并自动修复。 - 文字清晰度：默认大小、有边框的组件 2.2.1 与 2.2.2 的渲染数值完全一致，变虚来自无边框阴影和非默认尺寸。为后者做过「按最终字号排版」的实验，实测没有稳定收益，已默认关闭（环境变量
CLEARDESK_CRISPTEXT=1可开启）。文字阴影只在 100% 系统缩放下实测。 - 测试：自检、回归、客户端歌词、LRCLIB 在线、在线更新端到端五套随包测试记录通过。
下载与校验
- 文件：
ClearDesk-2.2.3.zip（7,648,046 字节） - SHA256：
FCE12423D2974923B1DD65C0F1CC062EA4B66144664C797DF04761B5139C1AC3 - 校验：PowerShell 运行
Get-FileHash .\ClearDesk-2.2.3.zip -Algorithm SHA256，结果应与上面一致；包内还有逐文件的SHA256SUMS.txt。 - 官网也提供同一个文件。包内附完整源码（
source/，含外壳扩展与签名工具源码）。
升级
- 已装 2.1.0 及以上：设置 → 关于 → 软件更新 → 检查更新；或退出旧版本，把 zip 完整解压到新文件夹（不要覆盖旧文件夹），运行其中的
ClearDesk.exe，再确认设置里「登录后自动启动」指向当前这份。 - 2.0.9 及更早版本需要手动升级一次。设置和数据（
%LOCALAPPDATA%\ClearDesk）保留。 - 系统：Windows 11（在 Windows 11 上验证；Windows 10 兼容路径尚未实测），需要 .NET Framework 4.8。
累计更新
以下保留 2.0.9 – 2.2.2 的合并说明，方便连续查看更新。2.1.1、2.2.0、2.2.2 已有单独的 GitHub Release。
累计更新说明：2.0.9 → 2.2.3
这份说明合并了 2.0.9、2.1.0、2.1.1、2.2.0、2.2.1、2.2.2、2.2.3 七个版本的发布说明。2.1.1、2.2.0、2.2.2 已有单独的 GitHub Release；这里按从新到旧排列，方便连续查阅。最新版本是 2.2.3。
- 2.2.3：Dock 图标（Antigravity / UWP）、无边框文字阴影、结束 TranslucentTB 后无法启动。
- 2.2.2：实时模糊下桌面收纳闪烁、Dock 稳定性、组件位置保存、多实例组件、自定义背景、无边框透明背景。
- 2.2.1：番茄钟自定义、图片相册可用、内置音量合成器、收纳系统图标、右键位置新建组件。
- 2.2.0：Dock 管理员权限窗口还原、新增 8 个组件。
- 2.1.1：天气更稳定，显示到区县。
- 2.1.0：签名在线更新。
- 2.0.9：开机自启动修复。
ClearDesk 2.2.3
发布日期：2026-10-27（2.2.2 之后的修补版本）
修复
1. Dock 里有的程序不显示图标（Antigravity、系统「设置」等）
现象：Dock 里正在运行但没有固定的程序，图标是空白，或者是一个通用的「窗口」图标，提示文字还是「Application Frame Host」。
原因（两处，都在 2.2.2 之前就存在，2.2.0 起 Dock 只靠「进程 exe」取图标）：
- 失败被永久缓存。
IconCache在后台线程取图标，取不到就把null存进缓存，之后同一个程序一律显示空白，直到重启 ClearDesk。程序刚启动、exe 暂时被占用、外壳图标缓存还没准备好等瞬时失败都会这样。 - UWP / 打包应用的窗口属于 ApplicationFrameHost.exe。 Dock 取的是窗口所属进程（ApplicationFrameHost.exe）的 exe 图标——它没有自己的图标，显示的是系统默认的空白窗口；名称也是它的文件说明「Application Frame Host」。
修复：
- 新的图标解析链（
AppIcons）：UWP 宿主窗口先取「开始菜单里该应用的图标」（按 AppUserModelID 走 shell:AppsFolder，256 像素）；其余程序先取 exe 图标（跳过系统「通用应用」图标），再取窗口自己的图标（WM_GETICON 大 / 小 / 小2 与窗口类图标，取最大的），再取 AppUserModelID 图标，再取开始菜单里指向该程序的快捷方式图标，最后才是 exe 的通用图标。全透明的图也算失败。 - 失败不再缓存。 取不到时显示一个带首字母的彩色图标，并在 2、5、15、45 秒后自动重试（共 4 次），每次 Dock 重建也会再试；找到后直接替换同一个控件。
- UWP 应用的名称和图标来自「开始菜单」里的应用（例如「设置」），不再显示 Application Frame Host。
ClearDesk.exe --dock-diag现在会逐个列出正在运行的应用以及每一级图标来源的结果，并把每级图标存成 PNG（dock-diag-icons文件夹），方便排查。
验证：在这台电脑上用 --dock-diag 实测——「设置」（ApplicationFrameHost）→ 取到 256 像素的包图标，名称「设置」；Antigravity → exe 图标 256 像素、窗口图标 512 像素。新增 16 项测试（解析顺序、空白 / 通用图标、失败不缓存、重试、UWP 包图标）。
没有复现的部分： 这台电脑上 Antigravity 当前能正常取到图标，所以「Antigravity 空白」的那一次瞬时失败没能在现场复现；修复覆盖的是这类失败的机制（失败不缓存 + 有备用来源 + 自动重试）。
2. 文字不清晰
我们逐项对比了 2.2.1、2.1.1 和 2.2.2 的渲染（把组件在屏幕上真实画出来再截图，同一个灰色背景上量化）：默认大小、有边框的组件，2.2.1 与 2.2.2 的清晰度数值完全一致，没有代码层面的回退；变糊来自无边框模式（2.2.2 新增）和非默认尺寸这两种用法。
原因：
- 无边框文字阴影太糊（主要原因，已量化）：2.2.2 的阴影模糊半径 7、不透明度 0.6、性能优先渲染，细体字（Segoe UI Light）周围罩了一圈灰雾，看起来像字发虚。屏幕实测，时钟数字周围被阴影压暗的面积（每个文字像素对应的暗区像素数）：无阴影 0.00，2.2.2 为 3.34，2.2.3 为 1.10。
- 组件不是默认尺寸时，文字是先按默认大小排版再整体放大的，笔画落在小数像素上，边缘变成两个像素的灰边（默认大小的组件不受影响）。
修复：
- 无边框文字阴影改为：模糊半径 2.5、偏移 1、不透明度 0.55、高质量渲染——仍有阴影（深色壁纸 / 亮色壁纸上都可读），但暗区面积降到原来的三分之一。有测试断言：2.2.3 的暗区小于 2.2.2，且大于无阴影。
- 为第 2 点做了「文字块按最终字号排版再用 1/缩放 缩回」的实验（
CrispText，对所有组件的所有文字块生效，自动处理后来添加的文字、组件自己改字号、缩放回 1 时恢复）。实测结论：没有稳定收益——在 5 种组件 × 3 种放大倍数（15 组）里，亮色笔画「完全点亮」比例的平均变化约 +0.004（9 组变好、6 组变差，时钟 ×1.35 明显变差），属于噪声。所以默认关闭（不改变任何组件的排版），只保留代码和测试，设置环境变量CLEARDESK_CRISPTEXT=1可以打开继续试。我们没有把一个没有被测量证实的改动默认发给所有组件。
验证与对比图：docs/images/2.2.3（shadow-before-after.png：2.2.2 / 2.2.3 / 无阴影的时钟实拍，shadow-before-after-zoom.png 放大 3 倍）；测试输出里的 text shadow (screen) 行是上面的数字。
局限：这一项只在 100% 缩放的这台电脑上量过；125% / 150% 系统缩放下没有实机对比（离屏渲染无法复现系统 DPI 的取整）。如果你的屏幕是 125% / 150% 且仍觉得字发虚，请告诉我们系统缩放比例和是哪个组件，需要单独看。
3. 退出 TranslucentTB 后再打开 ClearDesk，提示「任务栏组件校验失败」无法启动
现象（用户反馈）：在任务管理器里结束 TranslucentTB.exe，再打开 ClearDesk，弹出「任务栏组件校验失败」，ClearDesk 起不来。
原因：「透明任务栏」是 ClearDesk 自带的可选组件（TranslucentTB）。2.2.2 及以前，ClearDesk 启动时就在主流程里校验 taskbar 文件夹里的每个文件（SHA-256 对照 verified.sha256），任何一项不符、缺失、被占用、被安全软件移走，都会直接抛异常，走到「ClearDesk 启动失败」对话框并退出——一个可选功能出了问题，整个程序都不能用；而且「透明任务栏」开关是保存在设置里的，所以每次启动都会再失败一次，用户只能手动改设置文件。结束 TranslucentTB 本身不会改动文件内容，所以真正让校验不通过的一般是：组件文件被替换 / 覆盖了一半（运行中的 exe 被占用，覆盖解压时旧 exe 留下而清单是新的）、被安全软件隔离或改写、或文件正被扫描占用；在我们这台电脑上，正常安装的两份 taskbar 文件夹校验都是通过的，所以没有能直接复现「结束进程后校验失败」这个哈希不匹配本身——但可以确定：不管是哪种原因，2.2.2 的处理方式（致命退出）是错的。
修复（2.2.3）：
- 启动不再因为可选组件而失败：
Services.Apply()外加保护，组件校验失败只记日志、弹一条不阻塞的托盘提示（「透明任务栏暂不可用…ClearDesk 其他功能不受影响」），ClearDesk 照常启动。窗口事件监听失败（最小化动画）同样不再致命。 - 按需校验：只有在要启动透明任务栏时才校验；校验时用共享方式读文件（运行中、正被扫描的文件也能读），被占用就重试几次，仍被占用算「暂时不可用」而不是「损坏」。
- 自动修复：第一次校验通过后，把完好的组件备份到
%LOCALAPPDATA%\ClearDesk\taskbar-good；之后发现文件缺失、被改动、被隔离、清单缺失或无效，先从备份还原（正在被占用的文件先改名挪开再写入），还原后再次校验通过就正常启动。 - 没法修复时：关闭这个功能（不改你保存的开关），并在约 1 分钟、5 分钟、30 分钟后自动再试；在设置里把开关关掉再打开也会重试。
- 你自己在任务管理器里结束了 TranslucentTB：ClearDesk 发现后只记一条日志，不会自动再拉起来跟你对着干（下次启动 ClearDesk，或把开关关掉再打开，才会重新启动它）；过期的恢复状态文件不会影响下一次启动（按进程路径核对，不会误关别的进程）。
- 已有独立运行的 TranslucentTB 时：只给出提示，不改它的配置（和以前一致，但不再导致 ClearDesk 无法启动）。
测试（V223TaskbarTests，20 项，用一个假的组件目录，不碰真实的 TranslucentTB）：健康启动并保留完好备份；进程被结束后的过期状态；文件损坏 / exe 缺失（相当于被隔离）/ 清单缺失 / 清单无效 → 从备份还原并启动；文件被独占锁定 → 不崩溃、不启动、稍后重试，锁释放后启动；文件正被别处打开且已损坏 → 改名挪开后还原；损坏且无备份 → 返回原因而不抛异常（旧的 Start() 仍抛异常，兼容旧调用）；独立 TranslucentTB 在运行；DesktopServices 启动路径不抛异常、修好后重试成功、运行中 TranslucentTB 被结束后 ClearDesk 继续运行。
其他
- 版本号统一为 2.2.3。
- 新增诊断与测试：
--dock-diag的「图标解析」；tests/V223Tests.cs、tests/V223TaskbarTests.cs、tests/TextProbe.cs（屏幕实拍的清晰度度量）。
ClearDesk 2.2.2 发布说明
发布日期：2026-10-27
本版回应 7 条反馈：桌面收纳激活时闪一下、Dock 偶尔跳动、部分组件重启后位置变化、图片相册只能新建一个、时钟组件可去掉边框、所有组件可自定义背景图、组件放大时边长（边距）没有按比例缩放。
1. 点别的窗口再点「桌面收纳」会闪一下
- 现象的前提：设置里开启了「动态壁纸实时模糊」（你的设置里是开的）。实时模糊不是画在组件里的，而是组件正下方的一个独立窗口（DWM 主机背景）。
- 原因：组件被激活 / 被固定到桌面最底层（2.0.8 的「锁定后固定在最底层」）时，z 序改变，但模糊窗口只在组件移动 / 改大小时才跟着调整，其余靠每 1.5 秒一次的定时器——这段时间里模糊层停在组件上面，看到的就是一块没有图标和文字的模糊块，然后「闪」回正常。
- 修复：给组件窗口挂
WM_WINDOWPOSCHANGED，z 序或位置一变立刻把模糊窗口放回组件正下方。 - 测试：对真实的 DWM 模糊窗口反复切换 HWND_BOTTOM / HWND_TOP / NOTOPMOST，每次都必须紧贴在组件下方（4/4）；另有「复现」测试，关闭修复后同样的操作 3 次里 3 次错位。
2. Dock 栏有时不稳定、会跳动
- 原因（代码分析 + 计数测试，没有在你的机器上抓到现场）：Dock 订阅「运行中的应用」变化，任何程序开 / 关任何窗口都会触发整个 Dock 重建，重建会让悬停放大归零、底板重新排版；另外自动隐藏在窗口激活 / 最小化的瞬间会得到忽大忽小的矩形，Dock 就滑出又滑回。
- 修复：重建请求合并 250 毫秒，并比较「应用列表 + 顺序 + 运行状态」的签名，相同就跳过（
RebuildCount/SkippedRebuilds计数）；自动隐藏后重新出现需遮挡消失 280 毫秒；隐藏、指针唤出仍然立即。 - 测试：签名规则、延迟显示规则、对真实 Dock 连发 5 次「应用变化」不重建。
3. 有些组件重启后位置变了
排查了保存和恢复路径，找到三处，已逐一修复并加测试：
- 新建组件的位置不立即保存：
NewWidget在创建窗口之前保存，创建后的位置（尤其是 2.2.1 的「出现在鼠标右键位置」）要等到下一次无关的保存才写盘；直接重启就回到默认位置。现在创建后立即保存。 - 系统移动窗口被当成用户移动：显示器 / 缩放 / 工作区变化（登录、睡眠恢复、接拔显示器、顶部任务栏收放）时 Windows 或 WPF 会挪动窗口，旧代码把每一次
LocationChanged都写进 settings.json。现在新增PositionGuard：组件刚加载后的 4 秒、以及收到WM_DPICHANGED/WM_DISPLAYCHANGE/WM_SETTINGCHANGE/DisplaySettingsChanged后的 2.5 秒内，没有拖动、没有按住鼠标的位置变化不保存，稳定后若与已保存位置不同且已保存位置可见，就放回去。 - 启动时的「是否在屏幕内」检查：旧代码拿 DIP 坐标去和像素的
WorkingArea比较，还受顶部任务栏保留区影响，不合格就改到 (20,20)。现在按 DIP 和整块屏幕判断，真的不可见时只在视觉上救回，不覆盖已保存的位置（用户下次拖动才更新）。
说明：你这台是单显示器、100% 缩放，我没能在这台机器上复现「系统挪动窗口」的现场，2 的机理来自代码分析和模拟（测试里用 NoteSystemChange + 手动改 Left/Top 模拟）；1 是确定可复现的（测试里：新建 → 不做别的 → 读磁盘上的 settings.json）。
测试：14 种组件「放置 → 保存 → 像 settings.json 一样序列化 → 关闭 → 读回 → 重新创建」位置不变；右键新建后磁盘上立即有位置；不可见的保存位置不被覆盖；系统挪动不保存且会放回；正常拖动仍然保存。
4. 图片相册（及其他）可以放多个
- 实例编号：第一个仍叫
album（所有 2.2.x 的文件、文件夹、设置原样可用），后面是album~2、album~3…；每个实例有独立的设置项（settings.json的Widgets）、数据文件（widgets\album~2.json）、图片文件夹（widgets\album-images~2）、背景图。 - 适用：图片相册、待办清单、倒计时 / 番茄钟、日程、快捷启动。仍是单个：剪贴板历史（只有一个系统剪贴板）、网速流量、日出日落 + 空气质量，以及时钟、天气、音乐、日历、黄历、性能、快捷控制。
- 用法：桌面右键 / 组件右键 → 新建组件 → 图片相册，已有一个在桌面上时会新建「图片相册 2」，窗口标题带编号，默认位置错开一点；设置 → 组件管理逐个列出（名称带编号），可显示 / 关闭 / 重置大小 / 定位 / 删除。关闭只是隐藏（再显示是原来那个，不会新建）；删除第 2 个及以后的实例会清掉它的数据和图片副本，第一个保持 2.2.x 的行为（保留数据文件）。编号被释放后会复用（得到一个空的）。
- 迁移：不需要迁移——已有的单个组件就是第一个实例，数据文件和图片文件夹没有移动。
- 测试：2.2.1 布局的相册升级后设置和图片完整；创建 3 个相册，图片、间隔、铺放、背景、位置、锁定、大小各自独立；序列化后重启全部恢复；组件管理列表 / 隐藏 / 再显示 / 删除只影响自己；待办条目、番茄钟设置各自独立；剪贴板、网速、日出日落仍是单个。
5. 无边框 / 透明背景
- 右键 →「无边框 / 透明背景」：不画玻璃面板、边框、材质、模糊，只显示内容；「文字阴影（无边框时）」默认开，保证在任何壁纸上可读。
- 仍可拖动（空白处也接收鼠标，只是不画出来）、调整大小（悬停时才出现右下角手柄）、锁定、折叠；设置按组件保存，重启保留；每个实例单独设置。
- 可用：时钟、日历、黄历、天气、音乐、性能、快捷控制、待办、倒计时 / 番茄钟、日程、剪贴板、网速、快捷启动、图片相册、日出日落、桌面收纳。不提供：便签（本身就是彩色纸）、Dock、启动台。
- 和自定义背景可同时用：无边框 + 背景图 = 只有一张圆角图片加内容。
- 测试：开关后外圈 6 像素内完全没有像素（对比玻璃时 5935 个）；空白处命中测试仍有目标；阴影可关；锁定可用；保存、重启恢复、关闭后边框回来。
6. 所有组件的自定义背景
- 右键 →「自定义背景」：选择图片…、从剪贴板粘贴（复制的图片或图片文件）、把图片拖到组件上（相册、收纳格、便签、快捷启动自带拖放行为，仍用菜单）；填充方式：填充（裁剪铺满）/ 适应（完整显示）/ 拉伸；图片不透明度 100–20%；压暗 0–60%（默认 25%，让文字看清）；移除背景。
- 图片复制进
%LOCALAPPDATA%\ClearDesk\widgets\backgrounds（每个组件实例一份，原文件删除后仍可用；最大 40 MB；非图片或损坏的文件会被拒绝并保留现有背景；超大图按 2400 像素宽解码）；换图 / 移除时删除旧副本。 - 随组件缩放：背景是铺在组件内容下面的一层，跟随组件宽高实时变化（填充模式居中裁剪）；圆角裁剪；和玻璃 / 雾面材质、实时模糊、无边框、锁定、多实例同时使用。
- 测试：中文文件名、复制进数据文件夹、放大 1.8 倍后图层与组件同尺寸、三种填充、不透明度 / 压暗、各组件互不影响、原文件删除 + 重启 + 锁定 + 自定义大小后恢复、换图删旧副本、移除只删自己的、拖放文件（跳过不存在的）、拖放图片数据、粘贴、非图片 / 损坏文件拒绝、便签和收纳格也能用。
7. 组件放大时边长（边距）自适应
- 理解：组件放大时内容会按比例放大，但边距、间距、字号层级看上去没有跟着变——我把「边长」理解为边距 / 间距 / 圆角这类边框度量。（如果你指的是别的现象，请告诉我。）
- 原因：① 内容缩放上限 2.5 倍，而尺寸上限是 4 倍...
ClearDesk 2.2.2 — 组件背景、多实例与稳定性改进
主要更新
- 修复实时模糊下桌面收纳闪烁，改善 Dock 重建和自动隐藏的稳定性。
- 改进组件位置的保存和恢复，减少显示环境变化造成的位置偏移。
- 图片相册、待办、倒计时 / 番茄钟、日程和快捷启动支持多个独立实例。
- 支持组件自定义背景图片、无边框透明背景和可选文字阴影。
- 改善组件放大时的内容、边距与间距缩放。
Dock 跳动及系统移动窗口的原因依据代码分析和模拟测试，尚未在原现场复现。边长缩放按边距、间距与内容缩放理解。
升级与验证
2.1.0 及以上版本可通过设置中的软件更新检查新版；也可退出旧版，完整解压附件后运行 ClearDesk.exe，原有设置继续保留。随包提供的五套测试记录通过。
- 下载：ClearDesk-2.2.2.zip
- 大小：7,445,361 字节
- SHA-256：
11c946465b0b2c7efe65df10db6ac023ed5ee4a13fef8dc25090d91301092ef0 - 完整说明见源码 docs/releases/2.2.2.md。
ClearDesk 2.2.0 — Dock 修复与 8 个新组件
ClearDesk 2.2.0
发布日期：2026-10-26
- 修复 Dock 中 Sparkle、英雄联盟等管理员权限窗口最小化后点击无法恢复的问题，并识别启动器对应的客户端窗口。
- 新增待办清单：添加、勾选、排序、到期时间与一次性提醒。
- 新增倒计时 / 番茄钟：倒数日、每年重复、开始、暂停、跳过与长休息。
- 新增日程：查看今天和明天、本地编辑、导入 .ics 文件。
- 新增剪贴板历史：文字与图片、置顶、暂停；默认只保存在内存，可选加密保存文字。
- 新增网速流量：实时上下行、今日累计流量与折线图。
- 新增快捷启动：拖入文件、文件夹、网址与软件，使用系统图标，最多 60 项。
- 新增图片相册：淡入淡出轮播、适应 / 填充、间隔与随机播放。
- 新增日出日落 + 空气质量：离线计算日出日落，多来源 AQI 与缓存，并标明国标或美标。
- 8 个新组件均支持自由摆放、锁定、调整大小、材质、辅助线、组件管理与桌面右键新建；空输入框增加提示。
- 新增 Dock 诊断命令 --dock-diag 和 --dock-activate。
升级
2.1.0 及以上版本可在「设置 → 关于 → 软件更新」中检查更新。手动升级请退出旧版，完整解压后运行 ClearDesk.exe，保留包内的 taskbar 文件夹及外壳菜单相关文件，已有设置继续保留。
功能边界
管理员权限程序隐藏到托盘时，ClearDesk 可能需要重新启动该程序，由其单实例机制弹出窗口。该兜底和托盘显示仅有模拟窗口单元测试；Sparkle 和 LeagueClientUx 的最小化还原有随版本提供的真实测试记录。
日程不直接读取 Windows 日历，导入 .ics 时不展开重复规则。剪贴板点击条目仅重新复制，粘贴仍需按 Ctrl+V；会跳过密码管理器及被标记排除的内容。文字最多 40 条、图片最多 6 张，图片不会写入磁盘。
空气质量使用的国标与美标不可直接比较，组件会标明来源和标准。
验证
随包提供的自检、回归、客户端歌词、LRCLIB 在线测试、在线更新端到端测试记录均通过。本次发布另核对原始 ZIP 的 SHA256 与包内 219 个文件的校验值；未重新操作用户的软件窗口。
完整发布说明见源码 docs/releases/2.2.0.md。
下载与校验
下载附件 ClearDesk-2.2.0.zip，完整解压后运行 ClearDesk.exe。
- ZIP 大小：6,483,970 字节
- SHA256：
9a362d6eeb84f32a055bb6484956b111c8924738f874b7b4f49ed88a026795a0 - 源码标签：
v2.2.0。
ClearDesk 2.1.1 — 天气更稳定，定位到区县
ClearDesk 2.1.1
发布日期：2026-10-25
- 改进天气定位：支持 Windows 定位、国内优先的多服务 IP 定位，以及手动搜索选择区县；显示简体区县名称。
- 天气支持腾讯天气、Open-Meteo、met.no、wttr.in 多个来源，主来源较慢时并行启动备用来源。
- 联网失败时继续显示缓存天气及上次更新时间；失败后退避重试，网络切换和睡眠恢复后立即刷新。
- 设置新增「使用 Windows 定位」「重新定位」「手动选择区县」与「恢复自动」。
- 修复 deflate 响应解码错误，新增
ClearDesk.exe --weather-diag诊断模式。
升级
2.1.0 用户可以在「设置 → 关于 → 软件更新」中检查更新。其他版本请退出旧版，完整解压新版后运行 ClearDesk.exe，原有用户设置继续保留。
IP 定位只能达到城市级精度。需要准确区县时，请允许 Windows 位置服务或手动选择。
完整发布说明见仓库中的 docs/releases/2.1.1.md。
下载与校验
下载附件 ClearDesk-2.1.1.zip，完整解压后运行 ClearDesk.exe。安装包包含完整源码、第三方许可证和随包测试记录。
- ZIP 大小：6,353,536 字节
- SHA-256：
E9AAE304378B9F7323550240E73BA4CA6A37688E3BAF9D131633D208E0420102 - 本次发布复核：包内 206 个文件逐一校验通过，更新清单签名自检通过。
- 源码标签：
v2.1.1。