先说为什么折腾这个。

我的桌面右上角原来放着某款商业桌面助手，功能其实够用，但三件事受不了：装的时候捆绑了几个没听说过的软件；后台常驻四五个进程；界面从三年前到现在没变过。

后来想明白，我需要的功能其实很简单——看时间、看天气、看农历、瞄一眼 C 盘还剩多少。这些用 PowerShell 加 WPF 完全能做，全程不用装运行库、不要管理员权限、不依赖任何第三方包。实际做下来，一次性投入大概两小时。这篇文章把过程和我踩过的坑都记下来。

## 做完长什么样![配图1-紧凑条.png](https://developer.qcloudimg.com/http-save/yehe-12774577/06321c793b439afdcca1e84dd570500b.png)![配图2-展开面板.png](https://developer.qcloudimg.com/http-save/yehe-12774577/bafc287342fa74d178b5e472c1fd3b96.png)

默认是一条 320×83 的窄卡片，停在屏幕右上角，显示时间、天气、农历日期和今日状态徽章（假期 / 周末 / 调休上班）。点右侧箭头展开成完整面板，多出空气质量、体感温度、风向风力、下个假期倒计时、A 股休市状态、C 盘与内存占用，还有一个一键清理按钮。

按住左键能拖动，松手自动记住位置。右键菜单有四项：立即刷新、展开收起、回到右上角、退出挂件。关掉之后重新打开，位置和展开状态都还在。![image.png](https://developer.qcloudimg.com/http-save/yehe-12774577/a621444efb991a718b0f0bb64e8afa61.png)

## 动手前必须先定三件事

**一、置顶还是不置顶。** 我一开始选了"贴桌面"方案，就是把它挂到 Progman 窗口下面，看起来优雅——Win+D 不会把它最小化，位置在图标层之下。做完才发现一个物理上的不可兼得：它位于**所有窗口之下**。只要你习惯开最大化窗口，就一次都看不见。

这不是猜测。程序连续运行了 22 小时，日志正常、句柄正常、坐标正确，用户反馈只有一句"没看到东西"。原因是浏览器最大化了，把它 100% 遮住。

最后的做法是默认置顶，另外留一个 `-NoTopmost` 参数可以切回桌面层，把选择权交出来。

**二、紧凑条还是完整面板。** 常驻工具的原则是存在感低、信息密度高。所以做双面板：紧凑条一行时间加一行关键信息加一个展开箭头，完整面板放次要信息。用 `Visibility` 切换两组容器就行，不需要两个窗口。

**三、谁去启动它。** 这是最容易翻车的地方，后面单独说。

## 五件必须实现的事

| 能力 | 做法 | 关键点 |
|---|---|---|
| 单实例 | 全局命名互斥体 `Global_<AppName>` | `createdNew=False` 即已有实例，写日志后退出；退出时**必须** Release 加 Dispose，否则下次启动被自己挡住 |
| PID 文件 | 启动写 `widget.pid`，退出删 | 停止通道的主通道，不依赖 WMI；被强杀会留陈旧文件，启动时先校验该 PID 还活着没有 |
| 停止通道 | 读 PID 文件 → `Stop-Process`，CIM 兜底 | 兜底的过滤条件必须用**完整脚本路径精确比对**。写成 `*MyApp.ps1*` 这类模糊串会误杀同目录的其他脚本进程 |
| 状态记忆 | `widget_state.txt`，格式 `Left,Top,IsCompact` | 拖动事件里写、启动时读回；**越界必须自动回落**，否则换分辨率后窗口跑到屏幕外，用户以为程序坏了 |
| 右键菜单 | 代码构建 `ContextMenu` | 不要写进 XAML——XAML 里声明的元素不在 Window 命名域，`FindName()` 取不到，绑定事件会静默失败 |

## 八个真实踩过的坑

**1. 含中文的 .ps1 必须存成 UTF-8 带 BOM。** PowerShell 5.1 读不带 BOM 的脚本会按系统 ANSI 解析，简体中文环境就是 GBK。后果分两档：中文里含全角标点（括号、引号、逗号）时，重解码后产生非法 token，**报出位置莫名其妙的假语法错**——错误提示指向一段完全合法的代码；如果中文只配半角标点，解析会通过，但输出变乱码，我这边实测是"锁屏"输出成"閿佸睆"。结论很反直觉：**没报错不等于编码没问题，交付前必须看输出有没有乱码。**

**2. PowerShell 变量名不区分大小写。** `$l` 和 `$L` 是同一个变量。我写 `foreach ($l in $new) { $L += ... }`，累加器 `$L` 被循环变量覆盖成字符串，最后落盘只剩一行——而且脚本全程没报错，看起来"写成功了"。累加器一律起长名。

**3. 命令解析优先级是「别名 > 函数 > cmdlet」。** 我定义过一个 `function R {}`，调不到，也不报错。原因是内置别名 `r`（`Invoke-History`）优先级更高，把它静默盖掉了。`r`、`i`、`d`、`s`、`h`、`?`、`%` 都是内置别名。自定义函数用 `Add-Line` 这种动词-名词长名。

**4. `Add-Type` 不要写在行内命令里。** 某些环境会把它当作运行时编译 .NET 而拦掉，一律落成 .ps1 文件再执行。

**5. 右键菜单用代码构建，不要写进 XAML。** 理由同上表。

**6. 输出中文写文件用 `[System.IO.File]::WriteAllLines($path, $lines, (New-Object System.Text.UTF8Encoding($false)))`。** `Out-File -Encoding UTF8` 在前面的环境下会产生乱码或多出 BOM。

**7. `Remove-Item` 在某些受管环境被包装过。** 不认 `-ErrorAction` 这类常用开关而直接抛错，删临时文件改用 `[System.IO.File]::Delete()` 更稳。

**8. 必须有全局 `trap` 兜底。** 脚本主体（`Add-Type` 编译、XAML 解析、建窗）都在 `try` 之外，叠加 `$ErrorActionPreference = 'Stop'` 会**静默退出、日志毫无痕迹**，表现就是双击一闪而过。这是这类工具最常见的故障形态，而且没有日志就完全无从下手。

## 启动与保活：受限环境下怎么活下来

现象：用 `Start-Process` 拉起的常驻 GUI，在发起命令结束后就被回收了。日志停在"进入消息循环"，没有任何退出记录——就是被强杀。

| 现象 | 原因 | 对策 |
|---|---|---|
| 起来后又消失，日志无退出记录 | 它挂在发起进程的进程树里，随父进程一起被清理 | **借 shell 间接拉起**：`Start-Process explorer.exe -ArgumentList ('"' + $bat + '"')`，让新进程挂在 `explorer.exe` 之下 |
| `schtasks.exe` 报安全策略拦截 | 程序进了安全黑名单 | 换 explorer 方案，或交给用户双击启动 |
| 双击 .bat 一闪而过 | 全局 trap 缺失 | 先补 trap 把错误写进日志，再看日志定位 |

另外一定要给用户留常规入口：一个双击即用的 `start_widget.bat`，带轮询自检和可见反馈，再加一个启动文件夹自启项。**不要只给"静默启动"**——出问题时用户拿不到任何信息。

## 验收：不能只信窗口状态

`IsWindowVisible=True` 加上坐标正确加上日志正常，**不等于用户看得见**。窗口可能被别的最大化窗口完全盖住。

我最后用三招交叉验证：

一是静态自检脚本，覆盖语法解析、C# 编译、XAML 解析、控件清单、真实建窗。这里有个细节：`ControlTemplate` 内部的 `x:Name`，外层 `FindName()` 取不到是正常的，不要把它计进缺失清单。

二是渲染核验。加一个 `-Preview` 参数，用 `RenderTargetBitmap` 把窗口渲染成 PNG，然后逐张读图确认文字和布局。这一步抓到两个内容缺陷：星期显示成了"期日"（`"星期日".Substring(1)` 的结果），假期倒计时写成"（5 天）"被误读成"假期 5 天"（实际是倒计时，假期本身只有 3 天）。**这类错误不读图发现不了。**

三是让状态日志说话。用户每点一次展开或收起，就落一条 `state saved: L,T,IsCompact`。往返切换的记录能同时证明三件事——看得见、点得动、记得住。这比截屏更硬，截屏只能证明"画出来了"。

## 它到底占多少资源

| 指标 | 实测 |
|---|---|
| 进程数 | 1 个 powershell.exe |
| 内存 | 约 60–80 MB |
| 空闲 CPU | 接近 0，只在每分钟刷新时间时唤醒一次 |
| 网络 | 每 15 分钟一次天气请求加一次空气质量请求，各几百字节 |
| 磁盘 | 程序本身约 50 KB |

数据源全部用的是免 Key 的公开接口：天气和风况走 Open-Meteo，农历用 .NET 自带的 `System.Globalization.ChineseLunisolarCalendar`，法定节假日内置了国务院通知表。不用注册、不要密钥。

对比捆绑推广、常驻多个后台服务的商业桌面助手，这个开销基本可以忽略。

## 写在最后

整个东西就是一个 PowerShell 脚本加一段 XAML，加起来 1000 行出头。代码在你自己手里，不存在隐私上传，想加行情就加行情，想加待办就加待办。

顺便说下这次开发里帮上忙的地方——因为坑大多集中在"日志一片空白"和"窗口状态正常但用户看不见"这两类现象上，靠肉眼猜很费时间。把脚本和现象描述清楚丢给 WorkBuddy，让它先补 trap 和自检脚本、把失败原因落盘，再根据日志定位，比从零读代码快得多。尤其是"改名星期显示"和"假期倒计时语义"这两个内容缺陷，就是靠它渲染出图后逐张读图发现的。

有想改的地方直接动手就行，改配色、加显示项、换数据源都不难。

我的桌面右上角原来放着某款商业桌面助手，功能其实够用，但三件事受不了：装的时候捆绑了几个没听说过的软件；后台常驻四五个进程；界面从三年前到现在没变过。

#WorkBuddy# 用 PowerShell + WPF 从零做一个 Windows 桌面挂件：全过程与 8 个真实踩坑

我的桌面右上角原来放着某款商业桌面助手，功能其实够用，但三件事受不了：装的时候捆绑了几个没听说过的软件；后台常驻四五个进程；界面从三年前到现在没变过。这是一款绝对干净的桌面助手，占用几乎为零，非常实用。

开发工具

客户端

编程语言

自研PowerShell+WPF桌面挂件，仅50KB单进程常驻，显示时间天气农历C盘内存，免管理员免依赖。支持置顶拖动、双面板切换、状态记忆。实测内存60-80MB，CPU近零。避开八类编码及进程陷阱，含启动保活方案。数据源免Key公开接口，代码全开源可改。

WorkBuddy 

容器

2026上云采购 | AI焕新·智启新局

workbuddy-managed-agents

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

#WorkBuddy# 用 PowerShell + WPF 从零做一个 Windows 桌面挂件：全过程与 8 个真实踩坑-腾讯云开发者社区-腾讯云

#WorkBuddy# 用 PowerShell + WPF 从零做一个 Windows 桌面挂件：全过程与 8 个真实踩坑

#WorkBuddy# 用 PowerShell + WPF 从零做一个 Windows 桌面挂件：全过程与 8 个真实踩坑

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐