Windows-Tool/README.md

Windows 工具箱

面向 Windows 10/11 的中文 WPF 系统工具。主程序以普通权限运行；修改系统设置时才启动独立管理员执行器。所有可恢复功能会在第一次修改前保存基线快照，重复执行不会覆盖原始状态。

已实现功能

• Windows 11 经典右键菜单：启用、恢复；修改后自动重启 Explorer，在 Build 26200 上立即生效。
• 快捷方式箭头：隐藏、恢复，并生成本地透明图标资源。
• Windows 更新：暂停 1—35 天、每日自动续期、强力关闭、每日关闭守护、恢复原始状态。
• Windows 安全：检测防篡改保护、关闭可控制的 Defender 防护、可选关闭防火墙、恢复原始设置。
• 自动登录：恢复 netplwiz 中可能隐藏的密码复选框并打开 Windows 自带账户控制；工具不读取密码。
• 桌面归档：使用 Known Folder API 识别真实桌面，按 yyyy-MM-dd 归档普通文件和普通文件夹；排除快捷方式、系统项及重解析目录，自动处理同名文件/文件夹，支持撤销和每月计划任务。
• KMS：内置微软公开的 Windows 10/11 GVLK，使用用户填写的本地 KMS 地址，连接成功后才安装密钥，支持恢复原 KMS 主机。
• 系统状态、逐步执行结果及最近 100 次操作历史。
• 多尺寸应用图标，同时用于窗口标题栏、任务栏和 EXE 文件。

启动时只运行一个有 5 秒硬超时的可选状态查询进程，主窗口不会等待它才显示；普通功能完成后只刷新注册表基础状态，不再重复等待 Defender 与许可证查询。

运行

开发构建输出位于：

src\WindowsToolbox.App\bin\Debug\net8.0-windows\WindowsToolbox.App.exe

发布目录生成后运行：

artifacts\WindowsToolbox\WindowsToolbox.App.exe

运行环境需要 Windows 10/11 x64 和 .NET 8 Desktop Runtime。涉及系统修改的按钮会出现 UAC 提示。

构建

仓库已经配置本地 .NET 8 SDK 位置。执行：

.\scripts\build-release.ps1

生成便携发布目录：

artifacts\WindowsToolbox\

项目没有第三方 NuGet 运行依赖。

数据位置

%LOCALAPPDATA%\WindowsToolbox\
├─ ArchiveManifests\   桌面归档恢复清单
├─ Logs\               操作历史
├─ Pending\            临时提权命令及结果
└─ Profiles\           桌面归档配置

%PROGRAMDATA%\WindowsToolbox\
├─ Assets\             透明快捷方式图标
└─ Snapshots\          系统设置基线快照

重要边界

• “强力关闭更新”会关闭可控制的策略、服务和任务，并每日重新检查；Windows 就地修复或重大升级后仍可能恢复受保护组件。
• 工具不会绕过 Defender 防篡改保护。关闭 Defender 前必须由用户在 Windows 安全中心手动关闭防篡改保护。
• 家庭版不支持 KMS 客户端激活。Windows 客户端的正规 KMS 服务还需要满足微软规定的客户端数量门槛。
• KMS 恢复功能可以恢复主机和端口，但 Windows 不提供旧完整产品密钥，无法自动恢复未知旧密钥。
• 跨磁盘文件移动不是文件系统原子操作；移动失败会保留在恢复清单和操作日志中。

更多内部设计见 docs/ARCHITECTURE.md 和 docs/OPERATIONS.md。