# WinUtil CN

Windows 11 上的软件管理与系统维护工具，提供中文界面、软件操作清单、设置历史，以及 Windows 10 / 11 安装镜像制作。

基于 [Chris Titus Tech Windows Utility](https://github.com/ChrisTitusTech/winutil)，由 [yesewang1337](https://github.com/yasewang1337-svg) 汉化与维护。

<p align="center">
  <a href="https://github.com/yasewang1337-svg/winutil-cn/releases/latest"><img src="https://img.shields.io/github/v/release/yasewang1337-svg/winutil-cn?style=flat-square&amp;label=release&amp;color=16877c" alt="最新版本"></a>
  <a href="https://github.com/yasewang1337-svg/winutil-cn/actions/workflows/unittests.yaml"><img src="https://img.shields.io/github/actions/workflow/status/yasewang1337-svg/winutil-cn/unittests.yaml?branch=main&amp;style=flat-square&amp;label=tests" alt="main 分支测试状态"></a>
  <img src="https://img.shields.io/badge/Windows-11-3178c6?style=flat-square" alt="Windows 11">
  <img src="https://img.shields.io/badge/PowerShell-5.1%20%7C%207-526c91?style=flat-square" alt="PowerShell 5.1 或 7">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-526c91?style=flat-square" alt="MIT 许可证"></a>
</p>

**[下载 WinUtil-CN.exe](https://github.com/yasewang1337-svg/winutil-cn/releases/latest/download/WinUtil-CN.exe)** · [中文文档网站](https://yasewang1337-svg.github.io/winutil-cn/) · [发布说明与 SHA256 校验文件](https://github.com/yasewang1337-svg/winutil-cn/releases/latest)

<p align="center">
  <a href="#快速开始">快速开始</a> ·
  <a href="#界面预览">界面预览</a> ·
  <a href="https://yasewang1337-svg.github.io/winutil-cn/userguide/getting-started/">使用指南</a> ·
  <a href="https://github.com/yasewang1337-svg/winutil-cn/releases/latest">更新记录</a> ·
  <a href="https://github.com/yasewang1337-svg/winutil-cn/issues/new/choose">反馈问题</a>
</p>

## 功能

| 页面 | 可以做什么 |
| :--- | :--- |
| **软件管理** | 检测已安装软件、按检测结果或已选清单筛选；搜索名称、用途或包 ID，预览组合后通过 WinGet / Chocolatey 安装、升级、卸载。结果逐项显示，失败项可单独重试。 |
| **系统优化** | 查看基础设置、标准与高级方案，核对后执行；按历史记录恢复支持的注册表与服务启动配置。 |
| **系统配置** | 打开 Windows 管理工具，运行系统功能与维护入口。 |
| **Windows 更新** | 查看恢复、延迟与禁用三种配置的范围，调整工具涉及的更新策略。 |
| **Windows 镜像** | 从官方 Windows 10 / 11 x64 ISO 读取版本，修改后导出 ISO 或写入 U 盘。制作目标与本工具的运行环境是两回事。 |
| **清单与历史** | 导出软件与设置选择，下次导入核对；查看当前会话的软件结果和有记录的设置变更。 |

## 界面预览

主界面沿用启动皇冠的金色：深色主题使用石墨底色与香槟金，浅色主题使用冷灰白与古铜金。选中项、主操作和键盘焦点使用一致的提示，开源软件与危险操作仍保留各自的颜色。

![软件管理：左侧导航、用途摘要、筛选和操作清单](docs/assets/images/screenshots/software-cn.png)

名称下直接显示用途摘要，检测结果有效时会标明“已识别安装”；悬停在名称、勾选框或行内留白，都能读到完整介绍。点击行末 **⋯**、右键或 `Shift + F10` 打开单项操作，安装和卸载前仍会核对范围。分类标题显示当前结果数，空结果可以直接清除筛选。

`Ctrl + F` 聚焦当前页面的搜索框并选中已有文字；在没有搜索框的页面会进入软件搜索。在搜索框内按 `Esc` 清空当前搜索，不取消勾选。更换搜索或筛选条件后从结果顶部查看，勾选软件时保留当前阅读位置。

点击 **检测已安装** 不会改变勾选，可用 **仅看已装** 查看当前来源识别到的目录软件。状态行显示来源和检测时间；未识别不代表未安装。切换来源、开始软件操作或检测失败后，需要重新检测才能继续使用已装筛选。

<details>
<summary><b>更多预览：系统优化、系统配置、Windows 更新与皇冠首页</b></summary>

### 系统优化与系统配置

![系统优化：用途摘要、整行说明与待执行清单](docs/assets/images/screenshots/tweaks-cn.png)

勾选项与标有“直接应用”的开关分开表达；底部汇总待执行数量，查看范围后再运行。设置名称、摘要和留白共用完整说明，键盘聚焦后可按 `F1` 查看、`Esc` 收起。

![系统配置：功能组件与修复操作](docs/assets/images/screenshots/config-cn.png)

### Windows 更新

![Windows 更新：纵向排列的恢复、延迟与禁用设置](docs/assets/images/screenshots/updates-cn.png)

### Windows 镜像

![Windows 镜像：选择官方 Windows 10 或 11 ISO，读取版本后制作](docs/assets/images/screenshots/windows-iso-cn.png)

### 首页与浅色主题

![WinUtil CN 石墨与香槟金深色首页](docs/assets/images/screenshots/home-cn.png)

![WinUtil CN 冷灰白与古铜金浅色首页](docs/assets/images/screenshots/home-light-cn.png)

### 皇冠启动动画

![实际终端录制的大幅皇冠启动动画](docs/assets/images/screenshots/startup-crown.gif)

皇冠以暗金轮廓亮起，随后呈现斜向流光与宝石闪光，完成后定格。小窗口自动切换紧凑版；非交互启动直接显示静态内容。

首页启动不再收集未使用的完整电脑信息，软件列表首次打开时才构建，后台线程池在实际任务需要时创建。关闭窗口不再强制全量内存回收；仍有任务时会明确提示，保留任务继续完成。

</details>

<sub>界面截图由本仓库的实际 WPF 界面渲染，启动截图来自真实终端；下载版本与变更以发布页为准。镜像制作界面预览不代表已完成所有目标系统的启动与安装验证。</sub>

## 快速开始

1. **下载中文版** → [WinUtil-CN.exe](https://github.com/yasewang1337-svg/winutil-cn/releases/latest/download/WinUtil-CN.exe)，或到[发布页](https://github.com/yasewang1337-svg/winutil-cn/releases/latest)查看版本说明与 SHA256 校验文件。
2. **双击打开** → 按 Windows 提示授予管理员权限，从首页选择用途。
3. **核对后执行** → 调整软件或设置清单，查看操作范围，执行后检查每项结果。

> **使用环境**：Windows 11。EXE 内嵌本版本脚本，使用系统自带的 PowerShell 5.1，无需另装 PowerShell 7。准备包管理器、下载安装软件和更新仍需联网。

<details>
<summary><b>习惯命令行？使用 PowerShell 启动</b></summary>

从同一[发布页](https://github.com/yasewang1337-svg/winutil-cn/releases/latest)下载 `winutil-cn.ps1` 与 `SHA256SUMS.txt`，先计算哈希并核对清单：

```powershell
Get-FileHash .\winutil-cn.ps1 -Algorithm SHA256
```

核对来源、内容和哈希后，在管理员 PowerShell 中运行 `& .\winutil-cn.ps1`。执行策略或杀软拦截的处理见[安全告警说明](docs/SECURITY.md)；不要通过关闭防护或添加排除项启动。

</details>

## 使用边界

- **选择之后再执行。** 确认软件组合只加入清单；图形界面导入清单只替换勾选，不自动安装或修改系统。组合中的安装状态来自会话缓存，“尚未确认”不等于未安装。
- **恢复有范围。** 设置历史可恢复有记录的注册表值和服务启动配置；已删除应用、清理文件及脚本的其他改动不在完整恢复范围内，也不能替代个人文件备份。
- **全部升级有区别。** “查看全部升级操作”覆盖包管理器可识别的软件，只提供整批结果与日志；不提供逐软件待更新清单或软件版本回退。
- **优先使用默认 WinGet。** 如果改用 Chocolatey，请先按其官方说明完成安装；本工具不再下载并直接执行 Chocolatey 初始化脚本。自动登录与 PowerShell 配置安装入口改为打开官方指南。
- **镜像制作与宿主系统分开。** 本工具运行环境仍为 Windows 11；Windows 镜像页用于制作 Windows 10 / 11 x64 安装介质，写入 U 盘会擦除所选磁盘。步骤见[镜像制作指南](docs/content/userguide/win11Creator/_index.md)。

具体步骤和边界见[中文上手指南](docs/content/userguide/getting-started/_index.md)。

## 文档导航

| 我想…… | 从这里开始 |
| :--- | :--- |
| 第一次使用，了解每步怎么做 | [快速上手](docs/content/userguide/getting-started/_index.md) · [软件组合推荐](docs/content/userguide/recommendations/_index.md) |
| 查找设置、修复和更新功能 | [用户指南](docs/content/userguide/_index.md) · [常见问题](docs/content/faq.md) · [已知问题](docs/content/KnownIssues.md) |
| 调整 Windows 更新、制作安装介质 | [Windows 更新](docs/content/userguide/updates/_index.md) · [Windows 10 / 11 镜像](docs/content/userguide/win11Creator/_index.md) |
| 通过 AI 客户端查询或操作 | [MCP 服务器](mcp/README.md) |
| 修改翻译、参与开发 | [汉化层说明](汉化/README.md) · [架构与设计](docs/content/dev/architecture.md) · [贡献指南](.github/CONTRIBUTING.md) |
| 了解构建方式与上游同步 | [EXE 启动器](tools/launcher/README.md) · [维护说明](docs/MAINTENANCE.md) · [2026-10 更新调查](docs/UPDATE-AUDIT-2026-10.md) · [上游同步进度 #5](https://github.com/yasewang1337-svg/winutil-cn/issues/5) |

## 遇到问题

出现杀毒告警或“Windows 已保护你的电脑”时，先按[安全告警说明](docs/SECURITY.md)区分检测类型、核对文件哈希并保留告警记录。开源、数字签名或单次扫描通过都不能保证没有问题。

先查看软件结果窗口中的原因，通过 **打开日志文件夹** 获取详细记录，再到[本项目 Issues](https://github.com/yasewang1337-svg/winutil-cn/issues/new/choose)反馈。请附上 **项目版本、Windows 版本、启动方式、复现步骤和相关错误段落**。

<details>
<summary><b>展开查看日志位置</b></summary>

| 内容 | 默认位置 |
| :--- | :--- |
| 软件任务结果与日志 | `%LOCALAPPDATA%\WinUtil-CN\Logs\Packages` |
| 系统设置历史 | `%LOCALAPPDATA%\WinUtil\TweakHistory` |
| 一般运行日志 | `%LOCALAPPDATA%\winutil\logs` |
| 启动错误 | `%TEMP%\winutil-cn-error.log` |

</details>

## 开发与自动化

<details>
<summary><b>从源码构建中文版</b></summary>

```powershell
git clone https://github.com/yasewang1337-svg/winutil-cn.git
cd winutil-cn
pwsh -File 汉化\run-all.ps1
pwsh -File tools\Test-Build.ps1
powershell -NoProfile -File tools\Test-Build.ps1
```

构建产物为中文版 `winutil.ps1`。完整回归测试需要 Pester 5.7.1；EXE 构建方法见[启动器说明](tools/launcher/README.md)。

翻译数据集中在汉化层，中文组合、主题和可靠性改进另行维护。同步上游时需核对配置、控件 key、功能与翻译兼容性；当前基线及迁移差异见[维护说明](docs/MAINTENANCE.md)。

</details>

<details>
<summary><b>命令行预设、配置清单与 MCP</b></summary>

图形界面选择方案只勾选项目；命令行 `-Preset` / `-Config` 是**自动执行入口**，使用前必须核对配置内容。

| 设置方案 | 当前内容 |
| :--- | :--- |
| `Minimal`（基础设置） | 减少推荐应用、增加任务栏结束任务入口 |
| `Standard`（标准） | 基础设置，加活动历史策略和更新对等传输设置 |
| `Advanced`（高级，仅图形界面） | 标准方案，加创建还原点和经典右键菜单 |

自动模式仅支持软件操作及可记录的基础注册表设置（含受支持的开关）；脚本、服务、预装应用移除（Appx）、DNS 和系统功能等复杂操作需要在图形界面核对。具体项目见 [config/preset.json](config/preset.json)。

[MCP 服务器](https://yasewang1337-svg.github.io/winutil-cn/mcp/)供支持 MCP 的客户端查询软件、组合、系统设置和 DNS。默认只读；显式启用修改后，仍须先预览，再用同一参数与一次性计划确认。支持指定软件安装、开发工具换源、受支持的注册表/服务设置和选定网卡 DNS；复杂脚本优化会明确拒绝，并指引使用桌面版。数据来源、执行错误和恢复范围均可查看。使用 [MCP 指南](mcp/README.md)中的 `npx -y winutil-cn-mcp@0.4.3` 接入；对应 [npm 包](https://www.npmjs.com/package/winutil-cn-mcp/v/0.4.3)与 [GitHub 安装包](https://github.com/yasewang1337-svg/winutil-cn/releases/tag/mcp-v0.4.3)保留版本和源码证据。MCP 与桌面版独立更新。

</details>

## 致谢与许可

感谢 [Chris Titus Tech 与上游贡献者](https://github.com/ChrisTitusTech/winutil)提供 Windows Utility，感谢 [constansino/WinUtil_CN](https://github.com/constansino/WinUtil_CN) 提供借用层翻译。本项目是独立维护的中文本地化分支，沿用 [MIT 许可证](LICENSE)。中文版本的下载、构建与反馈均使用本仓库入口。