🎭 ZenDesktop Premium v4.0.0 - ExplorerBlurMica Integration & Persistent Desktop Icon Hide | 资源管理器透明程序整合与桌面图标隐藏重启保持

🎭 ZenDesktop Premium v4.0.0 - ExplorerBlurMica Integration & Persistent Desktop Icon Hide 🚀
资源管理器优秀外部透明程序集成与双击隐藏状态重启保持 / Premium ExplorerBlurMica Integration & Persistent Desktop Icon Manual Hide State

ZenDesktop Premium v4.0.0 is here! This milestone release retires the unstable Windhawk C++ File Explorer mod, replacing it with the robust external program ExplorerBlurMica developed by Maplespe. We also introduce a redesigned Visual Customizer GUI frontend panel developed by Lanbo for seamless graphical control, and improve the desktop icon toggle mod to persist the manual hide state across system reboots or explorer restarts.
ZenDesktop Premium v4.0.0 迎来重磅更新！本版本正式退役了较不稳定的 Windhawk C++ 资源管理器透明 Mod，转而深度集成了由 Maplespe 开发的优秀外部透明增强程序 ExplorerBlurMica。同时，本套件内置了由 Lanbo 编写的全新控制面板（GUI），方便一键调节各组件的透明参数并可视化配置资源管理器透明效果；双击隐藏桌面图标 Mod 也迎来了稳定性修复，重启系统后仍能完美保持隐藏状态。

🌟 English Release Notes

1. 📁 File Explorer Transparency (ExplorerBlurMica Integration) [NEW]

• Retires the legacy Windhawk C++ File Explorer mod (local@zen-fileexplorer-acrylic.wh.cpp).
• Integrates the external open-source program ExplorerBlurMica by Maplespe (GitHub: Maplespe/ExplorerBlurMica), supporting stable Blur, Acrylic, and Mica effects inside Windows 10/11 File Explorer.
• The packaging builder script and deployers have been fully updated to distribute the suite under a 4 mods + 1 program structure.

2. 🎛️ ZenDesktop Customizer (Visual Frontend Panel) [NEW]

• Adds ZenDesktopCustomizer.py and launcher run_customizer.bat developed by Lanbo.
• Provides a unified graphical user interface using CustomTkinter to customize colors, opacity, blur, and luminosity for the Taskbar, Start Menu, and Notification Center mods in real-time.
• The "资源管理器 (Explorer)" tab serves as an interactive wrapper dashboard for ExplorerBlurMica, allowing users to:
  • Register & Enable: Register the DLL with admin privileges via ShellExecuteW.
  • Configure Visuals: Launch the visual configurations editor (config-editor-wpf.exe).
  • Uninstall & Disable: Safely unregister and disable the transparency DLL.

3. 🖱️ Desktop Icon Toggle and Auto-Hide (local@zen-desktop-toggle-icons) [v4.0.0]

• State Persistence: Improved the mod to store the manual hide state in the registry under HKCU\Software\ZenDesktop\HideDesktopIcons. The hidden state of desktop icons will now remain correctly active even after restarting the computer or reloading the Windows Explorer process.

4. 🛠️ Deploy Script & Build Automation

• Cleared legacy File Explorer settings registry initialization logic from deploy.ps1.
• Built three aligned v4.0.0 release zip archives packaging the 4 local mods, deployers, customizer GUI, and the entire ExplorerBlurMica directory.

---

🇨🇳 简体中文更新说明

1. 📁 资源管理器优秀外部透明程序集成 (ExplorerBlurMica) [全新引入]

• 正式下线原 Windhawk C++ 资源管理器插件 (local@zen-fileexplorer-acrylic.wh.cpp)。
• 深度集成由 Maplespe 创作的开源程序 ExplorerBlurMica (项目地址: https://github.com/Maplespe/ExplorerBlurMica )，为 Windows 10/11 资源管理器提供极致稳定、清澈的 Acrylic、Mica 和经典毛玻璃模糊特效。
• 打包构建系统与部署脚本已全面更新为 “4个本地Mod + 1个外部程序” 的极简现代套件结构。

2. 🎛️ 视觉控制中心前端面板 (ZenDesktop Customizer) [全新引入]

• 内置由 Lanbo 专门开发编写的 CustomTkinter 图形化控制面板 ZenDesktopCustomizer.py 与快速启动器 run_customizer.bat。
• 支持实时一键无级调节任务栏、开始菜单、通知中心的透明基色预设、毛玻璃模糊半径、色彩浓度与亮度参数，即时保存并全局同步。
• 专门为资源管理器透明设计了管理标签页，提供图形化快捷操作：
  • 注册/启用透明效果：以管理员权限一键运行 register.cmd 注册 DLL。
  • 打开高级透明配置：免命令行后台拉起可视配置编辑器 config-editor-wpf.exe。
  • 注销/停用透明效果：以管理员权限一键注销 DLL 还原系统默认样式。

3. 🖱️ 桌面图标双击切换与自动隐藏 (local@zen-desktop-toggle-icons) [v4.0.0]

• 隐藏状态重启保持：彻底修复了重启系统或重启 Explorer 进程后，原本手动双击隐藏的桌面图标会再次复显的 Bug。现将状态写入注册表 HKCU\Software\ZenDesktop\HideDesktopIcons 维持记忆，重启后依然保持清爽的隐藏状态。

4. 🛠️ 部署脚本与构建自动化优化

• 从一键部署脚本 deploy.ps1 中彻底清理了原已失效的 File Explorer 插件注册表配置逻辑。
• 构建程序自动遍历目录，将 4 个核心 C++ 插件、一键部署脚本、控制中心 GUI 以及整个 ExplorerBlurMica 程序目录完美打包为 3 个发布压缩文件。

---

📁 附件下载说明 (Assets Guide)

🟢 ZenDesktop_OneKeyDeploy_v4.0.0.zip (Standard version - includes online installer) / (标准在线版 - 包含在线安装包)
🔵 ZenDesktop_OneKeyDeploy_v4.0.0_Offline.zip (Offline version - includes offline installer) / (离线完整版 - 内置 Windhawk 离线安装包)
🟡 ZenDesktop_OneKeyDeploy_v4.0.0_Online.zip (Online version - lightweight files only) / (轻量纯净版 - 仅包含脚本与 Mod 源码)

---

Developed with ❤️ by Lanbo & Maplespe
若您喜欢本项目，欢迎在 GitHub 点个 Star 🌟 支持我们！
Sponsor AFDian / 爱发电支持赞助通道: https://ifdian.net/a/Lanboo

🛠️ ZenDesktop Premium Suite v3.8.0 - Core 5-Mod Performance & Aesthetics Update | 五大核心Mod性能与全透美化重磅更新

🪟 ZenDesktop Premium Suite v3.8.0 (Stable Release)
五大核心 Mod（任务栏、开始菜单、通知中心、文件资源管理器、桌面图标双击隐藏）全透美化、整窗前景透明度控制翻转与状态持久化更新！
ZenDesktop Premium v3.8.0 is here! This stable release updates the five core mods with deep file explorer transparency fixes, user-intuitive window transparency inversion, and persistent desktop icon hide state support, packaged with our new Python customizer GUI launcher.

💖 Support / 赞助支持
If you love this project and want to support its active development, you can sponsor me here:
如果您喜欢这个项目，并希望支持它的持续开发，欢迎点击下方链接赞助支持我：
👉 Sponsor on AFDian / 爱发电赞助通道: https://ifdian.net/a/Lanboo 👈

🌟 English Release Notes

1. 📁 File Explorer Transparency & UXTheme Hooking (local@zen-fileexplorer-acrylic)

• UXTheme API Hooks: Added uxtheme.dll hooks to intercept backgrounds for column headers (SysHeader32), active sorted columns, navigation splitters, and container borders. Opaque black elements in Details View are resolved.
• Brush Migration: Migrated to stable WinUI SolidColorBrush to prevent black-screen fallbacks on Windows 11.

2. 🎛️ Window Transparency Inversion ("Default 0, Larger is More Transparent")

• Transparency Scale: Inverted zenWholeWindowAlpha so that 0 represents fully opaque text & icons, and larger values increase transparency.
• Auto Value Migration: Built-in registry upgrade migration safely maps legacy 100% config values to new 0% scale.

3. 🖱️ Persistent Desktop Icon Hide State (local@zen-desktop-toggle-icons)

• State Saving: Manual double-click hides are saved to HKCU Registry and persist automatically across user logoffs, system restarts, and explorer resets.

4. 🐍 Python GUI Customizer & Launcher (run_customizer.bat)

• One-click launch launcher automatically packages, verifies, and installs CustomTkinter dependencies for a clean tray-style config panel.

---

🇨🇳 简体中文更新说明

1. 📁 文件资源管理器（File Explorer）避黑深度全透

• 【UxTheme 挂钩】：挂钩拦截了 uxtheme.dll 绘制接口，在底层避开详细信息列表下列标题栏（SysHeader32）、排序高亮列、侧边栏分割线的默认背景，消灭黑底黑线瑕疵。
• 【原生画刷移植】：将易失效的 WindhawkBlur 重构为原生 SolidColorBrush，依托全局 Mica/Acrylic 带来晶莹透亮的玻璃质感。

2. 🎛️ 整窗前景透明度控制翻转（“默认为0，数值越大越透明”）

• 【透明滑块翻转】：zenWholeWindowAlpha 默认值调整为 0%（图标与文字不透明）。数值越大越透光。
• 【兼容自动迁移】：检测到老版本配置会自动以 新值 = 100 - 旧值 映射保存，避免老用户升级后瞬间看不清。

3. 🖱️ 桌面图标双击隐藏“持久化保存”

• 【状态记忆】：双击隐藏的状态将记录至 HKCU 注册表，在重启电脑、重启资源管理器后仍然自动保持隐藏。

4. 🐍 Python 图形化控制面板 (Customizer GUI) 一键运行

• 【一键运行】：新增 run_customizer.bat，双击即可全自动在后台配置依赖并启动精美的毛玻璃设置滑块面板。

---

📁 附件下载说明 (Assets Guide)
🟢 ZenDesktop_OneKeyDeploy_v3.8.0.zip (Standard version - includes online installer) / (标准在线版 - 包含在线安装包)
🔵 ZenDesktop_OneKeyDeploy_v3.8.0_Offline.zip (Offline version - includes offline installer) / (离线完整版 - 内置 Windhawk 离线安装包)
🟡 ZenDesktop_OneKeyDeploy_v3.8.0_Online.zip (Online version - lightweight files only) / (轻量纯净版 - 仅包含脚本与 5 大 Mod 源码)

Developed with ❤️ by Lanbo & m417z and co-created with the AI pair-programmer Antigravity.
If you like this project, please give us a Star 🌟 on GitHub!
若您喜欢本项目，欢迎在 GitHub 点个 Star 🌟 支持我们！
Sponsor AFDian / 爱发电支持赞助通道: https://ifdian.net/a/Lanboo

🎭 ZenDesktop Premium v3.3.0 - Start Menu Text Modes & Dynamic XAML Brush Fixes | 开始菜单文字三阶显示与任务栏画刷修复

🎭 ZenDesktop Premium v3.3.0 - Start Menu Text Modes & Dynamic XAML Brush Fixes 🚀

亚克力文字三阶显示功能与任务栏/通知中心画刷闪退修复 / Premium Start Menu Label Visibility Modes & Taskbar/NC Custom Brush Escape Quotes Fix

ZenDesktop Premium v3.3.0 is here! This milestone release introduces a premium 3-way text visibility controller for the Start Menu and resolves a critical XAML dynamic brush syntax error affecting the Taskbar and Notification Center styling mods under "Custom Glass" theme mode, restoring absolute fluidity, zero-latency transitions, and zero explorer lag.

ZenDesktop Premium v3.3.0 迎来重磅更新！本版本为开始菜单重磅引入了文字三阶显示模式，并彻底修复了任务栏与通知中心插件在“自定义玻璃”主题下因 C++ 动态拼接 XAML 引号缺失导致解析失败回退实色背景的致命缺陷，全面恢复亚克力与毛玻璃的无缝透明联动。

---

🌟 English Release Notes

1. 🚀 Start Menu Acrylic Styler (local@zen-startmenu-acrylic) [v3.3.0]

• Label Visibility Dropdown: Replaced the simple boolean hide labels toggle with a premium 3-way Label Visibility choice:
  • Show Text (show): Keeps all application and folder labels visible with correctly resolved themed foregrounds (fixed base theme text bug).
  • Hide Text (hide): Permanently hides labels using standard Opacity=0 to keep the grid layout fully intact (preventing layout shifting/icon jumping).
  • Hover to Show (hover): Ties label visibility directly to the parent containers' CommonStates visual state group using custom opacity mappings (Opacity@Normal=0, Opacity@PointerOver=1, Opacity@Pressed=1).
• Themed Color Preservation: Fully preserves your customized foreground colors (e.g. white, dark, system-aware, colored presets) upon hovering.

2. 🎛️ Taskbar Acrylic Styler (local@zen-taskbar-acrylic) [v3.3.0]

• XAML Custom Brush Fix: Fixed a critical dynamic brush generation bug where malformed XAML (missing escape quotes on properties like Color, BlurAmount, TintColor, TintOpacity) caused silent parsing failures and defaulted back to solid theme colors.
• Fully restored seamless, real-time adjustments for Blur Preset and Opacity Preset under Custom Glass mode.

3. 🔔 Notification Center Acrylic Styler (local@zen-notificationcenter-acrylic) [v3.3.0]

• XAML Custom Brush Fix: Corrected XAML escape quotes for dynamic SolidColorBrush and WindhawkBlur structures to ensure quick, stable styling changes without falling back quietly to solid grey backgrounds.

---

🇨🇳 简体中文更新说明

1. 🚀 开始菜单文字三阶显示重构 (local@zen-startmenu-acrylic) [v3.3.0]

• 【三阶文字模式】：将原有的简单隐藏开关升级为 “显示文字” (show)、“隐藏文字” (hide)、“悬浮显示文字” (hover) 三阶下拉配置菜单。
  • 显示文字：默认全部显示，结合主题默认前景色提供高清晰文字。
  • 隐藏文字：采用全局 Opacity=0 保证完全清爽，既隐去文字又保留网格物理占位，完全避免传统 Collapsed 方案引发的图标排版位移。
  • 悬浮显示文字：完美注入 Windows 原生视觉状态机监听，实现平时文字透明（Opacity=0），鼠标悬停（PointerOver）或点击（Pressed）时秒显原生文字（Opacity=1），极其高端清爽。

2. 🎛️ 任务栏亚克力样式修复 (local@zen-taskbar-acrylic) [v3.3.0]

• 【XAML 动态画刷修复】：彻底修复了“自定义玻璃”主题下，无论如何调节模糊度和透明度都静默失效（卡在深灰色）的 Bug。根本原因是 C++ 代码在生成 XAML 画刷时，拼接属性漏掉了关键的转义双引号 \" 导致 XAML 解析静默失败。
• 修复后，模糊度、透明度、基色调再次完全恢复丝滑平滑过渡。

3. 🔔 亚克力通知中心画刷修复 (local@zen-notificationcenter-acrylic) [v3.3.0]

• 【XAML 动态画刷修复】：同步修复了通知中心/日历面板/控制中心插件中相同的动态 XAML 画刷拼接引号缺陷，告别静默回退默认实色的问题。

---

📁 附件下载说明 (Assets Guide)

• 🟢 ZenDesktop_OneKeyDeploy_v3.3.0.zip (Standard version - includes online installer) / (标准在线版 - 包含在线安装包)
• 🔵 ZenDesktop_OneKeyDeploy_v3.3.0_Offline.zip (Offline version - includes offline installer) / (离线完整版 - 内置 Windhawk 离线安装包)
• 🟡 ZenDesktop_OneKeyDeploy_v3.3.0_Online.zip (Online version - lightweight files only) / (轻量纯净版 - 仅包含脚本与 Mod 源码)

---

Developed with ❤️ by Lanbo & m417z and co-created with the AI pair-programmer Antigravity.
If you like this project, please give us a Star 🌟 on GitHub!
若您喜欢本项目，欢迎在 GitHub 点个 Star 🌟 支持我们！
Sponsor AFDian / 爱发电支持赞助通道: https://ifdian.net/a/Lanboo

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 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 默认的浅色/深色主题，我们显式强制重写了开始菜单中搜索框内部核心切换按钮 (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 (请在下方上传这些打包好的压缩文件)

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 的用户）。

ZenDesktop Premium v3.0.0 - Notification Center Acrylic & Double-Click Reconstructed | 亚克力通知中心与双击隐藏颠覆性重构

🎭 ZenDesktop Premium v3.0.0 - Milestone Release 🚀

亚克力通知中心重磅回归与桌面双击隐藏颠覆性重构 / Native Acrylic Notification Center & Reconstructed Double-Click Toggle

ZenDesktop Premium v3.0.0 is here! This milestone release represents a deep collaboration with Windhawk's official creator m417z. It introduces the all-new native Acrylic Notification Center and features a complete structural rewrite of the desktop icon toggle mod, delivering industrial-grade stability, fluid transitions, and zero explorer latency.

ZenDesktop Premium v3.0.0 迎来里程碑式大更新！本版本携手 Windhawk 官方作者 m417z 深度合作共创，重磅引入了原生亚克力通知中心，并对双击隐藏桌面图标进行了底层级的颠覆性重构，带来了工业级的极致稳定与流畅体验。

---

🌟 English Release Notes

1. 🔔 Notification Center Acrylic Styler (local@zen-notificationcenter-acrylic) [NEW]

• Deep Collaboration: Co-created with m417z to support the Windows 11 Notification Center, calendar panel, and Quick Settings/System Tray panel natively.
• Premium Aesthetics: Renders high-fidelity real-time Acrylic/Frosted Glass effects while maintaining standard WinUI shadows and smooth opening animations.

2. 🖱️ Reconstructed Double-Click Icon Toggle (local@zen-desktop-toggle-icons)

The subclassing core has been completely rewritten in pure Win32 C++ to address historic Explorer hangs and screen flashes:

• Asynchronous Message Pipeline: Utilizes PostMessageW asynchronous message dispatching instead of synchronous blocking calls, completely preventing Explorer thread lockups or hangs.
• Full-Screen Window Guard: Automatically suspends double-click capture and auto-hide tracking during full-screen games, movie playback, or active presentations to ensure zero gameplay or media interference.
• Physical Coordinate Guard (Zero-Latency): Statically captures and validates physical cursor coordinates during transitions. This successfully blocks synthetic WM_MOUSEMOVE messages natively dispatched by SysListView32 on toggle, eliminating screen flicker with absolute zero latency.
• Dynamic CS_DBLCLKS Detection: Automatically queries target window classes, ensuring zero interference with native double-click behaviors of standard system elements and third-party apps.
• Robust Lifecycle Verification: Incorporates window subclass state checking on module destruction, preventing detached dangling hooks and ensuring Windows Explorer stability on service restarts.

3. 🛠️ Robust Deployment Script (deploy.bat)

• Process-Kill Priority: Swapped the service shutdown execution flow to forcefully terminate windhawk.exe via taskkill first before invoking net stop. This bypasses service stops hanging due to hooked handles in active Explorer instances.
• Cache Eviction: Automatically resets registry LibraryFileName cache keys, guaranteeing that every redeployment triggers a fresh, local background compile immediately.

4. 🎨 Aesthetic Refinements

• Compiler Error Elimination: Stripped all non-ASCII character markers (e.g., legacy line separators like ═) from source comments to prevent GBK/ANSI token collapse (missing terminating '"' character errors) under non-UTF-8 local compilation environments.
• Documentation: Overhauled README.md and Readme.txt to cover all 4 core mods in full bilingual details.

---

🇨🇳 简体中文更新说明

1. 🔔 亚克力通知中心重磅回归 (local@zen-notificationcenter-acrylic) [全新引入]

• 深度共创：与 Windhawk 官方作者 m417z 联合开发，完美适配 Windows 11 通知中心、日历面板以及 Quick Settings 托盘面板。
• 沉浸美学：引入原生高饱和度 Acrylic/Frosted Glass 亚克力磨砂玻璃透射特效，保留原生优雅的 WinUI 投影与流畅过渡动画。

2. 🖱️ 桌面双击隐藏图标插件颠覆性重构 (local@zen-desktop-toggle-icons)

重新用纯 Win32/C++ 底层对子类化（Subclassing）钩子管道进行了重构，杜绝资源管理器（Explorer）假死与黑屏问题：

• 【异步消息管道】：全面采用 PostMessageW 异步机制，绝不阻塞 Win32 主消息循环，彻底根除 Explorer 线程挂起与卡死。
• 【全屏程序守护】：智能检测全屏运行的游戏、影音或投影演示。全屏状态下自动挂起，防止玩游戏时误触隐藏图标。
• 【物理坐标去闪拦截（物理坐标哨兵）】：利用高精度物理坐标过滤，完美过滤 SysListView32 隐藏/显示时系统触发的模拟 WM_MOUSEMOVE，消灭画面闪烁与撕裂。
• 【动态 CS_DBLCLKS 支持】：动态检测窗口类别，确保零干扰系统及第三方应用的双击逻辑。
• 【双重生命周期销毁校验】：在模块卸载或 Explorer 重启时，平滑销毁子类化钩子，100% 避免因钩子悬空或残留引发的崩溃。

3. 🛠️ 一键部署脚本 (deploy.bat) 强健化升级

• 【杀进程防止挂起】：改变服务停止逻辑，优先以 taskkill 强行终止 windhawk.exe 进程，再通过 net stop 停止服务，彻底解决 Windhawk 服务因 Explorer 挂钩导致 net stop 永久卡死的问题。
• 【重置编译缓存】：自动清除 LibraryFileName 注册表缓存，确保每次部署都是 100% 全新编译，告别旧缓存无法加载新代码的痛点。

4. 🎨 视觉细节优化 & 汉化适配

• 【消灭编译报错】：彻底扫除所有 .wh.cpp 注释中 GBK 编码下会导致编译崩溃的非 ASCII 字符（如 ═ 等），保障国内 Windows系统本地 100% 秒速编译通过。
• 【Readme 升级】：全面支持 4 个本地核心插件一键无缝部署与中英双语保姆级上手指南。

---

📁 附件下载说明 (Assets Guide)

• 🟢 ZenDesktop_OneKeyDeploy_v3.0.0.zip (Standard version - includes online installer) / (标准在线版 - 包含在线安装包)
• 🔵 ZenDesktop_OneKeyDeploy_v3.0.0_Offline.zip (Offline version - includes offline installer) / (离线完整版 - 内置 Windhawk 离线安装包)
• 🟡 ZenDesktop_OneKeyDeploy_v3.0.0_Online.zip (Online version - lightweight files only) / (轻量纯净版 - 仅包含脚本与 Mod 源码)

---

Developed with ❤️ by Lanbo & m417z.
If you like this project, please give us a Star 🌟 on GitHub!
若您喜欢本项目，欢迎在 GitHub 点个 Star 🌟 支持我们！

ZenDesktop v2.7.0 - Apple Liquid Glass Premium Update

💎 ZenDesktop v2.7.0 Premium Aesthetics Refinement

This release introduces elite-level visual refinement and absolute system stability updates for Windows 11.

🎛️ Taskbar Acrylic Refinement

• Zero Border Line on Full-Width: Completely eliminated the top horizontal gradient border line in full-width taskbar modes, delivering a seamless edge-to-edge transparent liquid glass.
• Date & Time Layout Restored: Removed all intrusive overrides for clock/date controls. Windows 11 default dual-line system tray clock (time on top, date on bottom) now renders perfectly out-of-the-box.

🚀 Start Menu Acrylic Refinement

• Squircles & Specs: Perfectly refined Apple G2 corner squircles and embossed mercury borders.
• Compiler Error Resolved: Cleaned all risky multi-byte non-ASCII comment characters, preventing local compilation failures under non-UTF-8 GBK locales.

📦 Release Artifacts Included

1. ZenDesktop_OneKeyDeploy_v2.7.0_Online.zip (Online version, without Windhawk engine, super fast download)
2. ZenDesktop_OneKeyDeploy_v2.7.0.zip (Standard Online Setup version, includes the 11.5MB windhawk_setup.exe engine, suitable for users with VPN / network access)
3. ZenDesktop_OneKeyDeploy_v2.7.0_Offline.zip (True Offline version, includes the full 142MB windhawk_setup_offline.exe engine, 100% offline-ready for air-gapped systems)

Developed with ❤️ by Lanbo.

ZenDesktop v2.6.0 - Premium Liquid Glass Suite

🌟 ZenDesktop v2.6.0 - Premium Liquid Glass Suite 液体玻璃美学重磅升级

本版本 (v2.6.0) 迎来了划时代的视觉与易读性重大更新，完美融入了物理高反差折射与高饱满度亚克力阴影美学，彻底攻克文本在极高透明度下的对比度瓶颈，达成真正的 「苹果风格液态玻璃 (Apple Liquid Glass)」 奢华桌面质感。

---

🚀 核心美学突破与功能重构

1. ✨ 物理液态玻璃镜面边缘高光 (Apple Specular Edge Stroke & Glossy Scrim)：

   • 超精密 3D 玻璃边缘高光：在开始菜单的主边框中引入了微亮的多色段反射线性渐变边框 (LinearGradientBrush，斜向 1.2px 物理厚度)，完美勾勒出固体切削玻璃的边缘聚光质感。
   • 液态表面反射层 (Specular sheen overlay)：激活并重构了菜单表面的叠加蒙版 (Border#AcrylicOverlay)，从顶部向下倾注了一层高通透、镜面渐变的微亮反射层，使开始菜单犹如一块温润通透的弧形水晶玻璃浮于屏幕上！
   • G2 曲率连续大圆角：将所有菜单主边框及内容区块圆角半径统一提升至 CornerRadius=18，线条比以往更加有机、连续，符合现代工业设计美学。

2. 🌈 1.8x 色彩饱和度爆表高斯模糊 (Vibrant High-Density Saturation Blur)：

   • 重构了底层 <WindhawkBlur /> 渲染引擎的控制参数。全新亚克力主题在提供 35px 更深邃的毛玻璃模糊的基础上，将背景饱和度拉高至惊人的 1.8 倍 (TintSaturation="1.8")，并将纯白遮罩透明度降低至极其清透的 0.15！
   • 视觉震撼：菜单在掠过桌面鲜艳的壁纸或暗色窗口时，能充分汲取后方的自然色彩并以高饱和度透射出来，产生晶莹剔透的高饱和液态炫彩玻璃效果！

3. 🔤 极简半透明图标背板 (Translucent Icon Tile Backplate & Hierarchical Text)：

   • 智能图标背板：为所有 Pinned 磁贴图标引入了优雅的极简 8% 磨砂高透底座（在暗色高透下为 8% 白色底座，亮色下为 8% 黑色底座，悬浮 hover 自动淡入至 22%）。不仅极富立体触感，更为标签文字提供了永久的局部对比度！
   • 系统原生高易读性文本层：彻底清除了上一版本强制把所有主次文本重写为同一种颜色的粗暴模式，让文本回落至系统的原生 ThemeResource vibrant 架构。现在，主标题字字锐利，次级属性和辅助说明呈现柔和微透的层级高反差对比，无论全透明还是亚克力下，全部字字清晰，彻底告别偏色或亮白致盲缺陷！

4. ✨ 一键智能安装引擎与静默升级：

   • 所有核心插件源文件、自动化配置脚本的版本号同步升级至 v2.6.0，且 deploy.bat 已包含自动拉起离线包的安装引擎，体验极致顺滑。

---

📦 安装与使用说明

1. 下载下方的 ZenDesktop_Offline.zip（离线版，推荐）或 ZenDesktop_v2.6.0_OneKeyDeploy.zip（轻量版）并解压。
2. 鼠标右键点击 deploy.bat，选择 以管理员身份运行 (Run as Administrator)。
3. 安装完成后，打开 Windhawk 软件，等待 3 个本地 Mod 后台自动编译完成。
4. 切换到 TranslucentStartMenu，尽情享受这套绝美奢华的 Windows 11 原生液态玻璃桌面！

---

❤️ 特别鸣谢

• 感谢原作者 m417z 创作的 Windhawk 任务栏与开始菜单美化 Mod，为本套件奠定了坚实的底层代码基础。

ZenDesktop v2.5.1 - Premium Windhawk Customization Suite

🌟 ZenDesktop v2.5.1 - Premium Windhawk 原生美化套装

🚀 核心升级与重构 - 彻底解决全透明/高透背景文字可读性问题

在先前的版本中，当喜爱“极致透明/扁平”的用户将开始菜单设定为 Clear (全透明) 或 Acrylic (高透) 时，若将菜单打开于白色的浏览器或资源管理器窗口前，白色的文字会因背景过亮而与背景融为一体，导致文本完全无法看清。

为彻底、彻底攻克这一顽疾，v2.5.1 重磅引入了全新的 「文字颜色模式 (Text Color Mode)」 控制引擎：

1. 🆕 全新「文字颜色模式 (Text Color Mode)」设置项：

   • 在 Windhawk 设置面板中，我们为开始菜单新增了一个精美独立的配置下拉菜单：
     • Default: 遵循主题预设默认的文字色（极简/深色预设为白字，亮白亚克力为深灰字）。
     • Force White: 强力锁定文字为纯白（适合搭配深色桌面或深色背景窗口）。
     • Force Dark Gray: 强力锁定文字为高对比的半透明深灰黑色 (#CC000000)。如果您喜欢全透明/极致扁平的开始菜单，且经常在亮色应用前使用，开启此项可确保文字字字清晰、100% 完美可读！
     • System-aware: 智能跟随系统应用主题自适应（系统处于 Windows 深色模式时自动选用白字，处于浅色模式时自动选用黑字）。

2. ✨ 极简扁平透明预设 (Clear - 90% / 80% / 70% Transparency)：

   • 完美的零模糊扁平化设计，全面覆盖任务栏及开始菜单。配合新增的文字颜色强控项，即可随时在全透明下拥有完美质感的暗色文字。

3. 📁 苹果风格开始菜单文件夹展开背景遮罩 (macOS/iOS Scrim Blur)：

   • 打开文件夹时提供 20px 景深模糊与高雅遮罩，提升整体立体感。

4. ✨ 统一版本号与自动化脚本升级：

   • C++ 模块、一键部署脚本、自动化安装程序等均完美同步升级至 v2.5.1。

---

📦 安装与使用说明

1. 下载下方的 ZenDesktop_v2.5.1_OneKeyDeploy.zip 并解压。
2. 鼠标右键点击 deploy.bat，选择 以管理员身份运行 (Run as Administrator) 进行全新一键升级。
3. 脚本会自动将最新的 v2.5.1 C++ 模块写入 Windhawk 插件缓存中。
4. 打开 Windhawk 软件界面，点击 Settings (设置) 即可在 Text Color Mode 下随意切换您心仪的字体显示方案（如切换至 Force Dark Gray 体验全透下的完美暗色文字）。
5. 尽情享受丝滑、纯净、高可读性的 Windows 11 原生亚克力桌面美化！

---

❤️ 特别鸣谢

• 感谢原作者 m417z 创作的 Windhawk 任务栏与开始菜单美化 Mod，为本套件奠定了坚实的底层代码基础。

ZenDesktop v2.5.0 - Premium Windhawk Customization Suite

🌟 ZenDesktop v2.5.0 - Premium Windhawk 原生美化套装

🚀 核心升级与重构

本版本在先前版本的基础上，针对“全透明背景下，文字难以在浅色应用窗口前识别”的设计难题，引入了业界顶级美学与易读性兼备的黄金标准解决方案：

1. 🆕 原生 GPU 文字投影 (Drop Shadow / ThemeShadow)：

   • 在开始菜单的图标文字样式中注入了原生 ThemeShadow 动态阴影与三维高度渲染 (Translation=0,0,4)。
   • 超强对比表现：当文字处于全透明背景、且后方衬托有纯白色的浏览器/聊天窗口时，柔和的黑色半透明外阴影会自动把文字的轮廓精细地“托”出来，确保在任何纯白、杂乱背景下，白色文本也依然 100% 可读、极其锐利！而在深色背景下，阴影会自动融于背景，保持纯净高级。

2. 🆕 极简扁平透明预设 (Clear - 90% / 80% / 70% Transparency)：

   • 专为喜爱“零模糊、极致通透扁平”风格的用户在任务栏及开始菜单中全部补齐了三档全透预设：
     • Clear - 90% Transparency（10% 遮罩不透明度，极致柔和清爽）
     • Clear - 80% Transparency（20% 遮罩不透明度）
     • Clear - 70% Transparency（30% 遮罩不透明度）

3. ✨ 精细化透明度选项 (90% & 80% Opacity Presets & Text Adaptive)：

   • 为任务栏和开始菜单均引入了 90% 透明度 与 80% 透明度 档位。
   • 采用重构的文本颜色系统：若选择亮色模式的高透白色预设（Acrylic - 90%/80%），图标文字颜色会自动平滑翻转为高反差的半透明深灰黑色，杜绝亮色下看不清文字的缺陷。
   • 额外补齐了深色模式专用的 Dark Glass - 90% 与 80% 预设，搭配白字极其尊贵雅致！

4. 📁 苹果风格开始菜单文件夹展开背景遮罩 (macOS/iOS Folder Backdrop Blur Scrim)：

   • 点开文件夹时，自动在展开的文件夹弹出层后渲染一层 20px 高斯模糊 + 柔和暗色高透遮罩，极具景深立体感。

5. ✨ 统一版本号与打包升级：

   • 所有核心 C++ 插件、自动化注册表一键安装脚本均同步升级至 v2.5.0，确保系统干净利落。

---

📦 安装与使用说明

1. 下载下方的 ZenDesktop_v2.5.0_OneKeyDeploy.zip 并解压。
2. 鼠标右键点击 deploy.bat，选择 以管理员身份运行。
3. 脚本会自动为您静默安装 Windhawk 并导入所有高级本地 Mod。
4. 打开 Windhawk 软件界面，点击 Settings (设置) 即可在 Theme 下无缝切换 9 种亚克力透明度预设（包含新增的 90% 与 80% 选项）。
5. 尽情享受丝滑、纯净的 Windows 11 原生亚克力桌面美化！

---

❤️ 特别鸣谢

• 感谢原作者 m417z 创作的 Windhawk 任务栏与开始菜单美化 Mod，为本套件奠定了坚实的底层代码基础。

ZenDesktop v2.1.0 - Premium Windhawk Customization Suite

🌟 ZenDesktop v2.1.0 - Premium Windhawk 原生美化套装

🚀 核心升级与重构

本版本在 v2.0.0 的基础上进行了深度微调与视觉美化升级，加入了用户最期待的高级透明度预设与苹果风格的文件夹磨砂遮罩背景：

• 零后台驻留进程：没有任何独立 EXE 运行，0% CPU 占用，免去后台常驻软件的内存压力。
• 原生线程级注入：所有美化 Mod（Acrylic任务栏、Acrylic开始菜单、双击隐藏桌面图标）均以原生 C++ DLL 形式安全注入 explorer.exe 进程空间运行，极速稳定。
• 支持一键秒级部署：运行内置的 deploy.bat 脚本即可自动全自动安装 Windhawk、配置底层注册表、并导入完美汉化对齐的亚克力美化 Mod！

---

🎨 v2.1.0 新增功能与美化细节

1. 🆕 精细化透明度选项 (90% & 80% Opacity Presets)：
   • 为任务栏 (local@zen-taskbar-acrylic) 和开始菜单 (local@zen-startmenu-acrylic) 均引入了 90% 透明度 (TintColor="#E6FFFFFF") 与 80% 透明度 (TintColor="#CCFFFFFF") 档位，完美介于原本的 Standard 亚克力与 Low 低透之间，给桌面壁纸带来更具沉浸感的半透毛玻璃质感。
2. 🆕 苹果风格开始菜单文件夹毛玻璃背景 (macOS/iOS Style Folder Modal Backdrop)：
   • 开启开始菜单内的文件夹时，自动在文件夹容器后方层叠渲染一层 高斯模糊 + 柔和暗色高透遮罩 (BlurAmount="20" TintColor="#60000000" Backdrop Blur Scrim)。
   • 完美复刻苹果 iOS/macOS 文件夹展开时的视觉景深（Depth of Field），极具高级设计质感。
3. ✨ 统一版本号与打包升级：
   • 所有核心 C++ 插件、自动化注册表一键安装脚本均同步升级至 v2.1.0，确保系统干净利落。

---

📦 安装与使用说明

1. 下载下方的 ZenDesktop_v2.1.0_OneKeyDeploy.zip 并解压。
2. 鼠标右键点击 deploy.bat，选择 以管理员身份运行。
3. 脚本会自动为您静默安装 Windhawk 并导入所有高级本地 Mod。
4. 打开 Windhawk 软件界面，点击 Settings (设置) 即可在 Theme 下无缝切换 9 种亚克力透明度预设（包含新增的 90% 与 80% 选项）。
5. 尽情享受丝滑、纯净的 Windows 11 原生亚克力桌面美化！

---

❤️ 特别鸣谢

• 感谢原作者 m417z 创作的 Windhawk 任务栏与开始菜单美化 Mod，为本套件奠定了坚实的底层代码基础。