wehub/shanselman--peekdesktop
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity

docs: make Chinese README the default

Browse Source
This commit is contained in:
wehub-resource-sync
2026-07-13 10:23:41 +00:00
parent 3b95da5690
commit 75aa595c7a
1 changed files with 119 additions and 113 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+119 -113
View File
@@ -1,114 +1,120 @@
<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/shanselman/PeekDesktop) · [上游 README](https://github.com/shanselman/PeekDesktop/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
# PeekDesktop 👀
**Click empty desktop wallpaper (or empty taskbar area) to reveal your desktop — just like macOS Sonoma.**
**点击空白桌面壁纸（或空白任务栏区域）即可显示桌面 — 就像 macOS Sonoma 一样。**
PeekDesktop brings macOS Sonoma's "click wallpaper to reveal desktop" feature to Windows 10 and 11. By default it uses Explorer's native **Show Desktop** behavior, and it also includes an optional **Fly Away** experimental style plus tray toggles for **Require Double-Click**, **Peek on Desktop Click**, and **Peek on Taskbar Click**. Click or drag desktop icons normally without accidentally triggering peek. When you're done, click any window, the taskbar, or the wallpaper again and everything comes right back where it was.
PeekDesktop 将 macOS Sonoma 的「点击壁纸显示桌面」功能带到了 Windows 10 和 11。默认情况下，它使用资源管理器（Explorer）原生的 **Show Desktop** 行为，同时还包含可选的 **Fly Away** 实验性样式，以及托盘开关：**Require Double-Click**、**Peek on Desktop Click** 和 **Peek on Taskbar Click**。你可以正常点击或拖动桌面图标，而不会意外触发 peek。完成后，点击任意窗口、任务栏或壁纸，一切就会回到原来的位置。
<p align="center">
<img src="img/demo.gif" alt="PeekDesktop demo showing windows minimizing when you click the wallpaper" width="900" />
<img src="img/demo.gif" alt="PeekDesktop 演示：点击壁纸时窗口最小化" width="900" />
</p>
## Download
## 下载
📥 **[Download the latest release](https://github.com/shanselman/PeekDesktop/releases/latest)**
📥 **[下载最新版本](https://github.com/shanselman/PeekDesktop/releases/latest)**
### Install with Winget
### 使用 Winget 安装
PeekDesktop is submitted to the Windows Package Manager community repository as `Hanselman.PeekDesktop` when tagged releases are published. After the community manifest is accepted, install it with:
PeekDesktop 在发布带标签的版本时，会以 `Hanselman.PeekDesktop` 的形式提交到 Windows Package Manager 社区仓库。社区清单被接受后，可使用以下命令安装：
```powershell
winget install Hanselman.PeekDesktop
```
### Download a release
### 下载发行版
| File | Platform |
|------|----------|
| `PeekDesktop-vX.Y.Z-win-x64.zip` | Intel/AMD (most PCs) |
| `PeekDesktop-vX.Y.Z-win-arm64.zip` | ARM64 (Surface Pro X, Snapdragon, etc.) |
| `PeekDesktop-vX.Y.Z-win-x64.zip` | Intel/AMD（大多数 PC） |
| `PeekDesktop-vX.Y.Z-win-arm64.zip` | ARM64（Surface Pro X、骁龙等） |
No installer needed. Download the zip, extract it, and run `PeekDesktop.exe`. Release builds are **self-contained**, so you do not need to install .NET separately. It lives in your system tray and **updates itself automatically** — when a new version is available, it downloads, verifies the code signature, and restarts in place.
无需安装程序。下载 zip 文件，解压后运行 `PeekDesktop.exe`。发行版构建为 **self-contained（自包含）**，因此无需单独安装 .NET。它驻留在系统托盘中，并会 **自动更新** — 有新版本可用时，会下载、验证代码签名，并原地重启。
## Documentation
## 文档
- **[Engineering Deep Dive](Docs/PeekDesktop-Engineering-Deep-Dive.md)** - architecture, shell internals, experiments, debugging workflow, undocumented API notes, and release tradeoffs
- **[Auto-Updater](Docs/Auto-Updater.md)** - how the in-place auto-update system works, security model, swap dance, testing
- **[工程深入剖析](Docs/PeekDesktop-Engineering-Deep-Dive.md)** - 架构、Shell 内部机制、实验、调试工作流、未公开 API 说明及发行版权衡
- **[自动更新器](Docs/Auto-Updater.md)** - 原地自动更新系统的工作原理、安全模型、交换流程与测试
## How It Works
## 工作原理
1. **Click empty desktop wallpaper or empty taskbar area** (not an icon or taskbar button) -> your desktop is revealed
2. **Stay on the desktop** -> click or drag icons, right-click, and rearrange things while windows stay hidden
3. **Click any app, the taskbar, or empty wallpaper again** -> all windows restore to exactly where they were
1. **点击空白桌面壁纸或空白任务栏区域**（不是图标或任务栏按钮）-> 显示你的桌面
2. **停留在桌面上** -> 点击或拖动图标、右键点击并重新排列，同时窗口保持隐藏
3. **再次点击任意应用、任务栏或空白壁纸** -> 所有窗口恢复到原来的确切位置
That's it. It just works.
就这么简单。开箱即用。
## Peek Styles
## Peek 样式
- **Show Desktop (Explorer)** — the default and recommended mode. Uses Explorer's native Show Desktop behavior.
- **Fly Away (Experimental)** — animates windows offscreen. Fun but has known quirks with external window management (Win+D, taskbar). Use for the visual flair, but know it can get confused if the shell changes window state behind its back.
- **Show Desktop (Explorer)** — 默认且推荐的模式。使用 Explorer 原生的 Show Desktop 行为。
- **Fly Away (Experimental)** — 将窗口动画移出屏幕。有趣，但在与外部窗口管理（Win+D、任务栏）配合时存在已知怪癖。适合追求视觉效果，但若 Shell 在后台改变了窗口状态，可能会出现混乱。
### Under the Hood
### 底层原理
PeekDesktop uses lightweight Windows APIs:
PeekDesktop 使用轻量级 Windows API：
- **`SetWindowsHookEx(WH_MOUSE_LL)`** — low-level mouse hook to detect desktop clicks
- **`WindowFromPoint`** — identifies the window under your cursor
- **MSAA hit-testing (`AccessibleObjectFromPoint`)** — distinguishes empty wallpaper from desktop icons
- **UI Automation hit-testing** — classifies empty taskbar space without firing on Start, pinned apps, or tray buttons
- **Taskbar Show Desktop button click** — primary path, immune to keyboard remapping (PowerToys, etc.)
- **Win+D `SendInput`** — fallback if taskbar button is unavailable
- **`EnumWindows` + `WINDOWPLACEMENT`** — captures exact position and state (including maximized) of every window
- **`SetWinEventHook(EVENT_SYSTEM_FOREGROUND)`** — watches for when you switch back to an app
- **`SetWindowPlacement`** — restores windows to their exact previous positions
- **`SetWindowsHookEx(WH_MOUSE_LL)`** — 底层鼠标钩子，用于检测桌面点击
- **`WindowFromPoint`** — 识别光标下方的窗口
- **MSAA hit-testing (`AccessibleObjectFromPoint`)** — 区分空白壁纸与桌面图标
- **UI Automation hit-testing** — 分类空白任务栏空间，不会在「开始」、固定应用或托盘按钮上触发
- **Taskbar Show Desktop button click** — 主要路径，不受键盘重映射影响（PowerToys 等）
- **Win+D `SendInput`** — 任务栏按钮不可用时的备用方案
- **`EnumWindows` + `WINDOWPLACEMENT`** — 捕获每个窗口的精确位置和状态（包括最大化）
- **`SetWinEventHook(EVENT_SYSTEM_FOREGROUND)`** — 监视你切换回应用的时刻
- **`SetWindowPlacement`** — 将窗口恢复到之前的精确位置
No admin rights required. Uses < 5 MB RAM idle.
无需管理员权限。空闲时占用 < 5 MB 内存。
## System Tray
## 系统托盘
Right-click the tray icon for options:
右键点击托盘图标可查看选项：
- ✅ **Enabled** — toggle the peek feature on/off
- 🔁 **Start with Windows** — launch automatically at login
- 🖱️ **Require Double-Click** — optionally require a double-click on the desktop to trigger peek
- 🎮 **Pause While Gaming / Full-Screen** — on by default for exclusive full-screen and known gaming fullscreen apps
- 🖥️ **Peek on Desktop Click** — on by default; turn it off for taskbar-only activation
- 📌 **Peek on Taskbar Click** — optionally trigger peek from empty taskbar space
- 🪟 **Restore All Windows on App Switch** — on by default; in Explorer show desktop mode, taskbar/Alt+Tab app switches restore all hidden windows behind the selected app
- 👀 **Peek Style** — switch between Explorer and fly-away modes
- ℹ️ **About** — version info
- ⬇️ **Check for Updates** — download and install newer versions automatically
- 🔄 **Auto-Check for Updates** — on by default; silently checks for updates on startup
- ❌ **Exit** — quit PeekDesktop
- ✅ **Enabled** — 开启/关闭 peek 功能
- 🔁 **Start with Windows** — 登录时自动启动
- 🖱️ **Require Double-Click** — 可选择在桌面上双击以触发 peek
- 🎮 **Pause While Gaming / Full-Screen** — 默认开启，适用于独占全屏和已知的游戏全屏应用
- 🖥️ **Peek on Desktop Click** — 默认开启；关闭后仅通过任务栏激活
- 📌 **Peek on Taskbar Click** — 可选择在空白任务栏空间触发 peek
- 🪟 **Restore All Windows on App Switch** — 默认开启；在 Explorer show desktop 模式下，通过任务栏/Alt+Tab 切换应用时，会在所选应用背后恢复所有隐藏窗口
- 👀 **Peek Style** — 在 Explorer 与 fly-away 模式之间切换
- ℹ️ **About** — 版本信息
- ⬇️ **Check for Updates** — 自动下载并安装较新版本
- 🔄 **Auto-Check for Updates** — 默认开启；启动时静默检查更新
- ❌ **Exit** — 退出 PeekDesktop
When Windows is in dark mode, the tray menu also follows the system theme when supported by the OS.
当 Windows 处于深色模式时，托盘菜单也会在操作系统支持的情况下跟随系统主题。
## What's New
## 新特性
- **Small Native AOT single-file builds** for both x64 and ARM64
- **Peek on Taskbar Click** — optional trigger from empty taskbar space
- **Taskbar-only activation** — disable desktop-click peeking while keeping taskbar peeking enabled
- **Dark tray menu support** — follows Windows dark mode when available
- **Taskbar button Show Desktop** — bypasses keyboard remappers (PowerToys Keyboard Manager, etc.)
- **Pause While Gaming / Full-Screen** — avoids interference during gaming sessions
- **Require Double-Click** — optional double-click trigger for desktop peek
- **In-place auto-updater** — downloads, verifies Authenticode signature, swaps, and restarts automatically
- **小型 Native AOT 单文件构建**，同时支持 x64 和 ARM64
- **Peek on Taskbar Click** — 可选择在空白任务栏空间触发
- **仅任务栏激活** — 禁用桌面点击 peek，同时保持任务栏 peek 启用
- **深色托盘菜单支持** — 在可用时跟随 Windows 深色模式
- **Taskbar button Show Desktop** — 绕过键盘重映射器（PowerToys Keyboard Manager 等）
- **Pause While Gaming / Full-Screen** — 在游戏过程中避免干扰
- **Require Double-Click** — 桌面 peek 的可选双击触发
- **原地自动更新器** — 自动下载、验证 Authenticode 签名、交换并重启
## macOS Sonoma vs PeekDesktop
## macOS Sonoma 与 PeekDesktop 对比
| Feature | macOS Sonoma | PeekDesktop |
|---------|-------------|-------------|
| Click wallpaper to peek | ✅ | ✅ |
| Restore on app click | ✅ | ✅ |
| Restore on second wallpaper click | ✅ | ✅ |
| Clicking/dragging icons does not trigger peek | ✅ | ✅ |
| Desktop icons accessible | ✅ | ✅ |
| Exact window position restore | ✅ | ✅ |
| System tray control | ❌ | ✅ |
| Multi-monitor support | ✅ | ✅ |
| Start with OS | Login Items | ✅ Registry |
| Smooth animation | ✅ | Fly Away mode |
| 点击壁纸以 peek | ✅ | ✅ |
| 点击应用后恢复 | ✅ | ✅ |
| 再次点击壁纸后恢复 | ✅ | ✅ |
| 点击/拖动图标不会触发 peek | ✅ | ✅ |
| 可访问桌面图标 | ✅ | ✅ |
| 精确恢复窗口位置 | ✅ | ✅ |
| 系统托盘控制 | ❌ | ✅ |
| 多显示器支持 | ✅ | ✅ |
| 随系统启动 | Login Items | ✅ Registry |
| 平滑动画 | ✅ | Fly Away 模式 |
## Build from Source
## 从源码构建
**Requirements:** [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)
@@ -118,7 +124,7 @@ cd PeekDesktop
dotnet build src/PeekDesktop/PeekDesktop.csproj
```
### Run it
### 运行
```bash
dotnet run --project src/PeekDesktop/PeekDesktop.csproj
@@ -133,7 +139,7 @@ dotnet run --project src/PeekDesktop.InteropHarness/PeekDesktop.InteropHarness.c
.\test.ps1 -Iterations 10000 -VerboseOutput
```
### Publish a self-contained single-file exe
### 发布自包含单文件 exe
```bash
# For Intel/AMD
@@ -143,11 +149,11 @@ dotnet publish src/PeekDesktop/PeekDesktop.csproj -c Release -r win-x64 --self-c
dotnet publish src/PeekDesktop/PeekDesktop.csproj -c Release -r win-arm64 --self-contained -p:PublishSingleFile=true
```
### Release packaging
### 发行版打包
Release builds use **.NET Native AOT** — the exe is a fully native binary with no .NET runtime dependency. Current releases ship as self-contained single-file executables for both x64 and ARM64. Earlier experiments also used [PublishAotCompressed](https://github.com/MichalStrehovsky/PublishAotCompressed) (LZMA), but current builds favor compatibility and predictable startup behavior.
发行版构建使用 **.NET Native AOT** — exe 是完全原生二进制文件，不依赖 .NET 运行时。当前发行版以自包含单文件可执行文件形式发布，同时支持 x64 和 ARM64。早期实验也曾使用 [PublishAotCompressed](https://github.com/MichalStrehovsky/PublishAotCompressed) (LZMA)，但当前构建更注重兼容性和可预测的启动行为。
## Architecture
## 架构
```
src/PeekDesktop/
@@ -169,54 +175,54 @@ src/PeekDesktop/
└── NativeMethods.cs # Win32 P/Invoke declarations
```
## Contributing
## 贡献
PRs welcome! Current status and next ideas:
欢迎 PR！当前状态与后续计划：
- [x] Click empty wallpaper to peek
- [x] Click empty taskbar area to peek (opt-in)
- [x] Restore on app click or taskbar click
- [x] Restore on a second wallpaper click
- [x] Clicking or dragging desktop icons does **not** start peek
- [x] Right-click desktop icons while peeking (context menus stay open)
- [x] Desktop icons remain usable while peeking
- [x] Exact window positions are restored
- [x] GitHub release-based update checks
- [x] Works with PowerToys Keyboard Manager (keyboard remapping)
- [ ] Smooth minimize/restore animations (slide/fade)
- [ ] Hotkey support (e.g., `Ctrl+F12` to toggle peek)
- [ ] Per-monitor peek (only minimize windows on the clicked monitor)
- [ ] Exclude specific apps from being minimized
- [x] 点击空白壁纸以 peek
- [x] 点击空白任务栏区域以 peek（可选开启）
- [x] 点击应用或任务栏后恢复
- [x] 再次点击壁纸后恢复
- [x] 点击或拖动桌面图标**不会**触发 peek
- [x] peek 时右键桌面图标（上下文菜单保持打开）
- [x] peek 时桌面图标仍可使用
- [x] 精确恢复窗口位置
- [x] 基于 GitHub release 的更新检查
- [x] 可与 PowerToys Keyboard Manager 配合使用（键盘重映射）
- [ ] 流畅的最小化/恢复动画（滑动/淡入淡出）
- [ ] 快捷键支持（例如，用 `Ctrl+F12` 切换 peek）
- [ ] 按显示器 peek（仅最小化被点击显示器上的窗口）
- [ ] 排除特定应用不被最小化
## .NET Native AOT — The Size Journey 💾
## .NET Native AOT — 体积优化之路 💾
PeekDesktop is a showcase for how small a .NET Native AOT application can get. Starting from a standard WinForms app, we systematically eliminated every managed framework dependency until the binary was pure Win32 P/Invoke — then compressed it to fit on a floppy disk.
PeekDesktop 展示了 .NET Native AOT 应用可以做得多小。从一个标准的 WinForms 应用出发，我们系统性地移除了每一处托管框架依赖，直到二进制文件变为纯 Win32 P/Invoke —— 再压缩到能放进一张软盘。
| Version | Binary Size | What Changed |
| 版本 | 二进制体积 | 变更内容 |
|---------|------------|--------------|
| v0.4.5 | ~65 MB | Self-contained .NET (no AOT) |
| v0.5.0 | 17.5 MB | Enabled Native AOT |
| v0.6.0 | 4.2 MB | Dropped WinForms — pure Win32 P/Invoke for tray icon, menus, message loop |
| v0.6.1 | 2.3 MB | Replaced `HttpClient` with OS-native WinHTTP (`winhttp.dll`) |
| v0.7.2 | 1.88 MB | Eliminated JSON source generator, `System.Reflection`, `Process.Start` |
| v0.7.2 + LZMA | **~564 KB** | **LZMA compression via [PublishAotCompressed](https://github.com/MichalStrehovsky/PublishAotCompressed)** |
| v0.4.5 | ~65 MB | 自包含 .NET（无 AOT） |
| v0.5.0 | 17.5 MB | 启用 Native AOT |
| v0.6.0 | 4.2 MB | 移除 WinForms —— 托盘图标、菜单、消息循环改用纯 Win32 P/Invoke |
| v0.6.1 | 2.3 MB | 用操作系统原生 WinHTTP（`winhttp.dll`）替换 `HttpClient` |
| v0.7.2 | 1.88 MB | 移除 JSON source generator、`System.Reflection`、`Process.Start` |
| v0.7.2 + LZMA | **~564 KB** | **通过 [PublishAotCompressed](https://github.com/MichalStrehovsky/PublishAotCompressed)** 进行 LZMA 压缩 |
**What's left in the 1.88 MB (pre-compression)?**
- ~1.2 MB — .NET Native AOT runtime (GC, threading, exception handling, type system)
**压缩前 1.88 MB 里还剩什么？**
- ~1.2 MB — .NET Native AOT runtime（GC、线程、异常处理、类型系统）
- ~0.4 MB — `Utf8JsonReader`/`Utf8JsonWriter` + async task machinery
- ~0.2 MB — App code, P/Invoke stubs, string literals
- ~0.08 MB — PE headers and metadata
- ~0.2 MB — 应用代码、P/Invoke stubs、字符串字面量
- ~0.08 MB — PE headers 与 metadata
**Key techniques:**
- **No WinForms, no System.Drawing** — `Shell_NotifyIcon`, `CreatePopupMenu`, `TrackPopupMenuEx`, `MessageBoxW`, `CreateIconIndirect` via P/Invoke
- **No HttpClient** — `WinHttpOpen`/`WinHttpSendRequest` uses the OS HTTP+TLS stack at zero binary cost
- **No JSON source generator** — hand-written `Utf8JsonReader`/`Utf8JsonWriter` for the two tiny JSON shapes we need
- **No System.Reflection** — PE version resources read via `GetFileVersionInfoExW` P/Invoke
- **No managed delegates for WndProc** — `UnmanagedCallersOnly` function pointers avoid marshaling overhead
- **`OptimizationPreference=Size`** + `InvariantGlobalization` + stripped diagnostics
**关键技术：**
- **无 WinForms、无 System.Drawing** — 通过 P/Invoke 使用 `Shell_NotifyIcon`、`CreatePopupMenu`、`TrackPopupMenuEx`、`MessageBoxW`、`CreateIconIndirect`
- **无 HttpClient** — `WinHttpOpen`/`WinHttpSendRequest` 以零二进制成本使用操作系统 HTTP+TLS 栈
- **无 JSON source generator** — 为所需的两个极小 JSON 结构手写 `Utf8JsonReader`/`Utf8JsonWriter`
- **无 System.Reflection** — 通过 `GetFileVersionInfoExW` P/Invoke 读取 PE version resources
- **WndProc 不使用托管委托** — `UnmanagedCallersOnly` 函数指针避免 marshaling 开销
- **`OptimizationPreference=Size`** + `InvariantGlobalization` + 精简 diagnostics
Special thanks to [Michal Strehovský](https://github.com/MichalStrehovsky) — the architect of .NET Native AOT — whose [PR #5](https://github.com/shanselman/PeekDesktop/pull/5) inspired the final round of optimizations that eliminated the JSON source generator, reflection, and managed delegates. When the person who *built* the AOT compiler optimizes your app, you pay attention. 🙏
特别感谢 [Michal Strehovský](https://github.com/MichalStrehovsky) —— .NET Native AOT 的架构师 —— 他的 [PR #5](https://github.com/shanselman/PeekDesktop/pull/5) 启发了最后一轮优化，移除了 JSON source generator、reflection 与托管委托。当*构建* AOT 编译器的人亲自优化你的应用时，你会格外重视。🙏
## License
## 许可证
[MIT](LICENSE)