ZenDesktop Premium Suite v3.4.0 - Performance Engine & Search Transparency | 性能引擎跃升与搜索栏全透美化
🪟 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 onXamlBlurBrushParams) 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
SearchBoxToggleButtonborder element used to display a solid white box under certain visual states. We have explicitly overridden all innerBorderbackgrounds and border brushes of the search box toTransparent. - 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.cppsource files was ignored by Windhawk on startup due to persistent registry DLL paths underLibraryFileName. - Forced Local Compile: The
deploy.batscript 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_MOUSEMOVEscreen 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 默认的浅色/深色主题,我们显式强制重写了开始菜单中搜索框内部核心切换按钮 (
SearchBoxToggleButton和SearchBoxButton) 下的所有边框与背景为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 (请在下方上传这些打包好的压缩文件)
ZenDesktop_OneKeyDeploy_v3.4.0.zip:包含 4 大本地 mods 及 online Windhawk 安装器。ZenDesktop_OneKeyDeploy_v3.4.0_Offline.zip:包含 4 大本地 mods 及 offline 完整离线环境安装器(约 142MB)。ZenDesktop_OneKeyDeploy_v3.4.0_Online.zip:仅包含 4 大 mods 源码与说明(适用于已装有 Windhawk 的用户)。