# DeskGuard **Repository Path**: SunshineC/DeskGuard ## Basic Information - **Project Name**: DeskGuard - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-18 - **Last Updated**: 2026-11-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 工位守护 · DeskGuard 一个用于 Windows 的键盘、鼠标输入锁工具。离开工位时,通过快捷键暂停键鼠操作,桌面和正在运行的内容继续显示;支持自动解锁和开机自启。 **当前版本:1.2.1** · Windows 10 / 11 x64 · C# / WPF · .NET Framework 4.8 ## 功能 - 自定义全局锁定、解锁快捷键,收起到托盘后仍可使用。 - 锁定不遮罩、不黑屏、不切换工作窗口;视频和动画继续播放。 - 松开触发按键或鼠标按钮后立即锁定,没有固定倒计时等待。 - 锁定、解锁成功后显示 2 秒提示,不抢焦点,无需确认。 - 支持倒计时解锁、指定日期时间解锁、仅手动解锁。 - 提供“试锁 5 秒”,便于首次使用时验证恢复操作。 - 可选开机自启,登录 Windows 后在托盘运行。 - 单文件运行,无需安装、管理员权限或网络连接。 ![工位守护设置界面](界面预览-倒计时.png) ## 快速开始 1. 将 `DeskGuard.exe` 放在固定文件夹,双击运行。系统需具备 .NET Framework 4.8。 2. 点击锁定、解锁快捷键输入框,按下新组合键,再点击“保存设置”。也可以直接使用默认快捷键。 3. 选择自动解锁方式,设置时长或日期时间,保存设置。 4. 首次使用先点击“试锁 5 秒”,确认能够正常恢复输入。 5. 点击“收起到托盘”,返回工作窗口,按锁定快捷键。松开所有按键和鼠标按钮后开始拦截输入。 6. 按解锁快捷键,或等待自动解锁。 锁定和解锁时会分别短暂显示“锁定成功”“解锁成功”。除提示外,程序不添加遮罩或锁屏画面。点击设置窗口中的锁定按钮时,该窗口会留在原处;若希望保留工作画面,请先收起到托盘。 ## 快捷键 以下为首次运行的默认值;界面显示的是你当前保存的组合。 | 操作 | 默认快捷键 | | --- | --- | | 锁定键鼠 | `Ctrl + Alt + Shift + F11` | | 解锁键鼠 | `Ctrl + Alt + Shift + F12` | | 应急恢复 | `Ctrl + Alt + Del`,然后返回桌面 | 自定义组合至少包含 `Ctrl`、`Alt`、`Shift` 中的两个,再搭配字母、数字或常见功能键 `F1–F12`,例如 `Ctrl + Alt + K` / `Ctrl + Alt + U`。两个组合必须不同,且不能被其他程序占用。 录入有效组合后会自动结束录入;按 `Esc` 也可结束。更改后点击“保存设置”才会生效。数字组合使用主键盘上排数字,与数字小键盘不同;部分笔记本的功能键需要配合 `Fn`。 ## 自动解锁 | 模式 | 设置方式 | 计时行为 | | --- | --- | --- | | 倒计时 | 输入 1–1440 分钟,或选 5 / 15 / 30 / 60 分钟 | 从实际进入锁定时开始计时,不受系统时间调整影响 | | 指定时间 | 选择本地日期、小时和分钟 | 在指定时间解锁;修改系统时间会影响该模式 | | 仅手动 | 无需设置时间 | 使用解锁快捷键或应急方式恢复 | 指定时间必须晚于当前时间。“试锁 5 秒”会在实际锁定 5 秒后恢复,不修改已保存的计时方式,期间也可使用解锁快捷键。 从设置窗口点击锁定或试锁,会先保存当前设置;后台快捷键和托盘菜单锁定使用已经保存的设置。等待锁定和锁定期间不能保存新设置。 若按键或鼠标按钮一直未松开,程序最多等待 5 秒,随后取消本次锁定。 ## 开机自动启动 勾选 **“开机自动启动”**,再点击 **“保存设置”**。下次登录 Windows 后,程序会在托盘运行,启用已保存的快捷键,不弹出设置窗口,也不会自动锁定键鼠。取消勾选并保存即可关闭。 - 首次运行默认关闭,仅对当前 Windows 用户生效。 - 自启依赖 EXE 的完整路径。移动或重命名程序后,请从新位置运行,重新勾选并保存。 - 如果在 Windows 任务管理器中禁用了该启动项,还需在那里重新启用。 - 删除程序前,请先取消自启并保存。 启动项位于当前用户注册表的 `Software\Microsoft\Windows\CurrentVersion\Run`,名称为 `DeskGuard`,启动命令为带引号的 EXE 完整路径和 `--startup` 参数。关闭自启只删除本程序的值;设置文件保存失败时会尝试恢复原有启动项。 ## 托盘与退出 关闭设置窗口、最小化或点击“收起到托盘”后,程序继续运行,快捷键保持有效。双击托盘图标可重新打开设置。 右键托盘图标可打开设置、锁定键鼠、调用 Windows 系统锁屏或退出。选择 **“退出”** 才会完全关闭程序,同时解除本程序的输入拦截。同一 Windows 会话只运行一份。 ## 使用范围 输入锁适合防误触和临时防操作,**不能替代 Windows 身份验证锁屏**。知道快捷键、按 `Ctrl + Alt + Del` 或结束程序均可能恢复操作;普通权限也不能保证拦截所有管理员窗口、触控、手写笔和特殊驱动输入。 锁定前和锁定期间会检查前台应用权限。当前台应用权限更高,或 Windows 拒绝读取其权限时,程序会拒绝锁定或解除当前输入锁,并在设置窗口或托盘通知中提示原因。操作管理员权限的应用时,请先从托盘退出工位守护,再右键 EXE 选择“以管理员身份运行”。开机自启仍使用普通权限,不会自动提权。 需要保护文件和账号时,请使用 `Win + L` 或界面中的“Windows 系统锁屏”。系统锁屏需要身份验证,不能通过本工具定时自动登录。 程序会在切换安全桌面、切换会话、睡眠或恢复时解除输入锁。它不会阻止系统自动睡眠或锁屏,也不会唤醒睡眠中的电脑;这些系统行为仍可能改变画面。 ## 设置与删除 快捷键、解锁方式和时间保存在: ```text %LOCALAPPDATA%\DeskGuard\settings.xml ``` 设置按 Windows 用户保存,不随 EXE 自动迁移。程序采用临时文件加原子替换写入;设置损坏时恢复默认值,并在界面提示。工具没有密码功能,设置文件不含密码。 删除工具时,先关闭自启并保存,再从托盘退出,最后删除程序文件。需要清除个人设置时,可删除上述 `DeskGuard` 设置目录。 ## 源码结构 ```text DeskGuard/ ├─ DeskGuard.exe # 可直接运行的程序 ├─ README.md # 项目说明 ├─ 使用说明.md # 补充使用和验证说明 ├─ build.ps1 # 编译脚本 ├─ test.ps1 # 测试脚本 ├─ src/ │ ├─ Program.cs # 程序入口与单实例控制 │ ├─ MainWindow.xaml # 设置界面 │ ├─ AppController.cs # 界面事件、托盘与快捷键调度 │ ├─ Core.cs # 配置、快捷键和解锁计划 │ ├─ InputGuard.cs # 输入拦截与释放 │ ├─ InputAccess.cs # 前台应用权限检查 │ ├─ Native.cs # Windows API 与全局快捷键 │ ├─ StartupRegistration.cs # 当前用户启动项管理 │ ├─ StatusToast.cs # 锁定、解锁成功提示 │ ├─ AssemblyInfo.cs # 版本信息 │ ├─ app.manifest # 程序清单 │ ├─ app.ico # 程序图标 │ └─ Assets/shield.png # 盾牌图标资源 └─ tests/ # 核心、输入锁、界面、自启和快捷键测试 ``` ## 编译与测试 使用 Windows 自带的 .NET Framework C# 编译器,无需 NuGet 或第三方库。在本目录打开 PowerShell;编译前先从托盘退出运行中的程序,释放 EXE 文件。 ```powershell .\build.ps1 .\test.ps1 ``` 编译结果为本目录中的 `DeskGuard.exe`。XAML 和图标已经嵌入 EXE,运行时只需该文件。 检查全局快捷键生命周期时,先退出运行中的工位守护,避免组合键冲突,然后执行: ```powershell .\test.ps1 -CheckHotkeys ``` 测试覆盖配置读写、快捷键判定、解锁计划、界面控件、自启设置和快捷键消息路由,不会实际锁定键鼠。输入锁测试使用原生 API 替身,验证权限检查失败时拒绝锁定、前台权限变化后释放、键鼠回调和过期检查不会释放新的锁。自启测试使用独立的临时注册表项,不更改真实启动项。实际物理按键、键鼠拦截和应急恢复请通过“试锁 5 秒”在目标电脑确认。 ## 常见问题 **锁定后仍能操作当前代码编辑器怎么办?** 先从托盘退出旧版,使用 1.2.1 或更新版本。若提示前台应用权限过高或无法读取权限,请退出工位守护后右键 EXE 选择“以管理员身份运行”,再进行试锁。权限检查通过并不代表特殊驱动或所有输入路径都可拦截,仍需在实际使用的编辑器中验证。 **快捷键无效怎么办?** 确认程序仍在托盘运行,且界面提示“快捷键已启用”;修改组合后需要保存。若提示被占用,请更换组合。核对主键盘数字与小键盘的区别,以及笔记本是否需要按 `Fn`。 **关闭窗口为什么还在运行?** 关闭窗口会收起到托盘,便于继续使用全局快捷键。需要结束程序时,请选择托盘菜单中的“退出”。 **需要安装吗?** 无需安装。双击 EXE 即可运行,目标电脑需要 .NET Framework 4.8。开机自启是可选设置。 **启用自启后没有运行怎么办?** 确认已保存、自启项未被任务管理器禁用,并且 EXE 仍位于启用时的路径。移动程序后,从新位置重新勾选并保存。 ## 版本说明 ### 1.2.1 - 锁定前检查前台应用权限,避免权限不足时仍提示锁定成功。 - 锁定期间持续检查前台权限,无法确认拦截范围时释放输入并立即提示原因。 - 增加输入锁回归测试,保留自动解锁、快捷键解锁和安全桌面恢复。 ### 1.2.0 - 新增开机自动启动开关与当前用户启动项管理。 - 登录后静默运行到托盘,自动启用保存的快捷键。 - 重复后台启动安静退出,设置保存失败时恢复原有启动项。