Skip to content

ZenDesktop Premium Suite v3.4.0 - Performance Engine & Search Transparency | 性能引擎跃升与搜索栏全透美化

Choose a tag to compare

@Liset999 Liset999 released this 30 May 13:38
· 21 commits to main since this release

🪟 ZenDesktop Premium Suite v3.4.0 (Stable Re-Release)

ZenDesktop Premium v3.4.0 稳定修复版正式发布!本次更新带来了全局 300ms 原子防抖(彻底解决高频切换设置导致 Explorer 崩溃)一键部署脚本自动清空编译缓存(保证源码修改 100% 重编译生效)开始菜单搜索框全透明视觉统一低延迟 XamlBlurBrush 渲染缓存,并对开源性能贡献者致以谢意!


💖 Support / 赞助支持

If you love this project and want to support its active development, you can sponsor me here:
如果您喜欢这个项目,并希望支持它的持续开发,欢迎点击下方链接赞助支持我:

👉 Sponsor on AFDian / 爱发电赞助通道 👈


🌟 English Release Notes

1. 🛡️ Explorer Stability Protection (300ms Atomic Debounce)

  • Zero Explorer Crashes: Rapidly changing background colors or presets in the Windhawk UI previously triggered rapid loading/unloading of WinUI styles, crashing the DWM and Explorer host process.
  • Atomic Counter Safeguard: Introduced a 300ms counter-based atomic sleep debounce handler in Wh_ModSettingsChanged() across all three core modules. Intermediate settings triggers are cleanly skipped, reducing rendering stress and guaranteeing 100% explorer stability.

2. ⚡ High-Performance Start Menu Caching Engine & Stable Taskbar

  • Lag-Free Start Menu Transitions: Successfully integrated a strict parameter caching system (operator== comparison on XamlBlurBrushParams) in the Start Menu styler. WinRT Composition rendering layer allocations are bypassed when properties haven't changed.
  • Ultra-Stable Taskbar: The Taskbar mod has been reverted to the highly reliable and tested pre-caching version, ensuring zero display glitches or compatibility issues on explorer focus resets.

3. 🔍 Start Menu Search Box Border Transparency Unification

  • Zero White Borders: In standard Windows light/dark themes, the internal SearchBoxToggleButton border element used to display a solid white box under certain visual states. We have explicitly overridden all inner Border backgrounds and border brushes of the search box to Transparent.
  • Flawless Glass Blending: The search box now blends dynamically with the underlying acrylic background under all active, inactive, hovered, and disabled folder states, establishing a premium look.

4. 🛠️ New Compiler-Cache-Clearing Admin Deployer (deploy.bat)

  • Recompilation Bug Fix: Previously, replacing .wh.cpp source files was ignored by Windhawk on startup due to persistent registry DLL paths under LibraryFileName.
  • Forced Local Compile: The deploy.bat script now automatically extracts the Mod ID for each copied file and clears the registry compiler cache. Restarting Windhawk now 100% forces a native back-end recompile of the latest C++ source codes without requiring manual UI clicking.

5. 🖱️ Reconstructed Double-Click to Hide Desktop Icons

  • Async PostMessageW: Utilizes asynchronous Win32 message pipelines to prevent Explorer thread hanging.
  • Fullscreen Application Guard: Automatically suspends mouse-click detection when running full-screen games, video players, or PPT presentations.
  • Flicker-Free Sentinel: Employs physical cursor tracking to suppress synthetic system WM_MOUSEMOVE screen flicker.

🤝 Special Thanks to Contributor

A big shoutout to @ygzzfyh123 for submitting Pull Request #4! Your XamlBlurBrush caching structures laid the foundation for our high-frame-rate rendering engine, ensuring premium glass aesthetics without any CPU lag.


🇨🇳 中文更新日志

1. 🛡️ 全局 300ms 原子防抖(彻底解决资源管理器崩溃)

  • 根治高频崩溃:针对用户在 Windhawk UI 界面中快速连续点击、切换颜色或预设导致 explorer.exe 重启的顽疾进行了底层重构。
  • 原子计数器限流:在三大核心 Mod 的 Wh_ModSettingsChanged() 入口加入基于原子自增计数器的 300ms 延时防抖。只有在用户停止操作 300ms 后才会触发重载,完美杜绝了 WinUI 状态机由于高频加载/卸载发生死锁而导致的桌面重启。

2. ⚡ 开始菜单高频缓存优化 & 极度稳定的任务栏

  • 开始菜单丝滑过渡:在开始菜单 Styler 中集成了高频 XamlBlurBrush 缓存机制,实现严密的深度参数比对。如果画刷参数未发生改变,底层会立即拦截重复的 WinRT Composition 对象重建,杜绝状态转换时的卡顿掉帧。
  • 任务栏稳健回退:任务栏模块回退到了经过深度测试的极速、高稳定基础代码,彻底根除了多显示器或虚拟桌面重绘时可能导致的视觉 Bug。

3. 🔍 开始菜单搜索框全透明视觉统一

  • 彻底消除白色方块:针对 Windows 默认的浅色/深色主题,我们显式强制重写了开始菜单中搜索框内部核心切换按钮 (SearchBoxToggleButtonSearchBoxButton) 下的所有边框与背景为 Transparent
  • 任何状态都保持晶莹:无论是正常的未激活状态、鼠标悬停点击状态,还是点击文件夹触发模态导致其处于 Disabled 的特殊状态,搜索框均展现出高折射率的液态玻璃美感,与壁纸完美融合。

4. 🛠️ 解决编译缓存失效的一键部署脚本 (deploy.bat)

  • 清空 DLL 路径指针:修复了简化版部署脚本导致 C++ 修改不生效的 Bug。Windhawk 启动时如果检测到注册表中包含已编译 DLL 路径(LibraryFileName 键值),会直接加载旧 DLL 而忽略源码更改。
  • 一键全自动编译:部署脚本现在会在拷贝源码时自动解析 Mod ID 并将 LibraryFileName 键值强制清空(重置为 "")。Windhawk 重启后百分百会在后台全自动重新编译最新源码,彻底告别必须手动去 Windhawk 界面点“保存并编译”的繁琐步骤!

5. 🖱️ 桌面双击隐藏图标极致优化

  • 异步消息管道:采用 PostMessageW 异步分发机制,彻底消除 Win32 消息循环导致的资源管理器(Explorer)假死挂起。
  • 全屏窗口避让:全屏玩游戏或看电影时自动挂起隐藏判定,杜绝误触。
  • 物理坐标防抖去闪:利用高精度物理坐标过滤,完美抹除系统切换状态时模拟 WM_MOUSEMOVE 产生的频闪,达到零延迟的丝滑过渡。

🤝 特别鸣谢

特别鸣谢贡献者 @ygzzfyh123 提交的 Pull Request #4!他引入了最初的 XamlBlurBrush 参数缓存设计,我们在此基础上进行了深度比对与失效重构,成功让 ZenDesktop 实现了“极致液态玻璃画质”与“零延迟、无卡顿高帧率”的完美共存!


📦 Releases Assets to Upload (请在下方上传这些打包好的压缩文件)

  1. ZenDesktop_OneKeyDeploy_v3.4.0.zip:包含 4 大本地 mods 及 online Windhawk 安装器。
  2. ZenDesktop_OneKeyDeploy_v3.4.0_Offline.zip:包含 4 大本地 mods 及 offline 完整离线环境安装器(约 142MB)。
  3. ZenDesktop_OneKeyDeploy_v3.4.0_Online.zip:仅包含 4 大 mods 源码与说明(适用于已装有 Windhawk 的用户)。