winutil-cn README

The project's README from github.com/yasewang1337-svg/winutil-cn. As one markdown file: README.md.

WinUtil CN

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

基于 Chris Titus Tech Windows Utility,由 Holha1337 汉化与维护。

最新版本 main 分支测试状态 Windows 11 PowerShell 5.1 或 7 MIT 许可证

下载 WinUtil-CN.exe · 发布说明与 SHA256 校验文件

快速开始 · 界面预览 · 使用指南 · 更新记录 · 反馈问题

功能

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

界面预览

软件管理:左侧导航、用途摘要、筛选和操作清单

名称下直接显示用途摘要;悬停在名称、勾选框或行内留白,都能读到完整介绍。右键或 Shift + F10 打开单项操作,安装和卸载前仍会核对范围。

更多页面:Windows 更新、镜像制作与首页

Windows 更新

Windows 更新:纵向排列的恢复、延迟与禁用设置

Windows 镜像

Windows 镜像:选择官方 Windows 10 或 11 ISO,读取版本后制作

首页与浅色主题

WinUtil CN 深色首页

WinUtil CN 浅色首页

预览由本仓库的实际 WPF 界面渲染;下载版本与变更以发布页为准。镜像制作界面预览不代表已完成所有目标系统的启动与安装验证。

快速开始

  1. 下载中文版 → WinUtil-CN.exe,或到发布页查看版本说明与 SHA256 校验文件。
  2. 双击打开 → 按 Windows 提示授予管理员权限,从首页选择用途。
  3. 核对后执行 → 调整软件或设置清单,查看操作范围,执行后检查每项结果。

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

习惯命令行?使用 PowerShell 启动

从同一发布页下载 winutil-cn.ps1 与 SHA256SUMS.txt,先计算哈希并核对清单:

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

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

使用边界

具体步骤和边界见中文上手指南。

文档导航

我想…… 从这里开始
第一次使用,了解每步怎么做 快速上手 · 软件组合推荐
查找设置、修复和更新功能 用户指南 · 常见问题 · 已知问题
调整 Windows 更新、制作安装介质 Windows 更新 · Windows 10 / 11 镜像
通过 AI 客户端查询或操作 MCP 服务器
修改翻译、参与开发 汉化层说明 · 架构与设计 · 贡献指南
了解构建方式与上游同步 EXE 启动器 · 维护说明 · 2026-10 更新调查 · 上游同步进度 #5

遇到问题

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

先查看软件结果窗口中的原因,通过 打开日志文件夹 获取详细记录,再到本项目 Issues反馈。请附上 项目版本、Windows 版本、启动方式、复现步骤和相关错误段落。

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

开发与自动化

从源码构建中文版
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 构建方法见启动器说明。

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

命令行预设、配置清单与 MCP

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

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

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

MCP 服务器供支持 MCP 的客户端查询软件、组合、系统设置和 DNS。0.4.1 默认只读;显式启用修改后,仍须先预览,再用同一参数与一次性计划确认。支持指定软件安装、开发工具换源、受支持的注册表/服务设置和选定网卡 DNS;复杂脚本优化会明确拒绝,并指引使用桌面版。数据来源、执行错误和恢复范围均可查看。MCP 0.4.1 GitHub 安装包,npm 上架暂缓,请使用 MCP 指南中的 GitHub 包地址接入。MCP 与桌面版独立更新。

致谢与许可

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

winutil-cn (yasewang1337-svg/winutil-cn)

Searching Database…

What is this?A Chinese-localized Windows 11 utility for managing software (install/upgrade/uninstall via WinGet or Chocolatey) and maintaining the system (tweaks, Windows Update control, Windows 10/11 ISO creation). It's a fork of Chris Titus Tech's Windows Utility, translated and maintained by Holha1337.
Is this a desktop GUI app or a command-line script?Primarily a WPF desktop GUI app distributed as an EXE, but it can also be launched from an admin PowerShell console using the included winutil-cn.ps1 script if you prefer the command line.
How do I get it running?Download WinUtil-CN.exe from the releases page (or winutil-cn.ps1 plus SHA256SUMS.txt), double-click it and grant admin rights when prompted, then pick what you want to do from the home page and review the checklist before executing.
Do I need to install PowerShell 7 or anything else first?No — the EXE bundles the script and runs on the system's built-in PowerShell 5.1, so PowerShell 7 isn't required. You do need an internet connection since downloading/installing software and updates still relies on package managers.
Does restoring settings actually undo everything the tool changed?No — the settings history only restores recorded registry values and service startup configurations. It doesn't cover removed apps, cleaned files, or other script-based changes, and it's not a substitute for a personal file backup.
Can I make a Windows 10 install USB while running Windows 11?Yes — the Windows Image page reads an official Windows 10/11 x64 ISO, lets you modify it, then exports it or writes it to a USB drive. The tool itself still needs to run on a Windows 11 host, and writing to USB erases the target disk.
What is the MCP server for?It lets MCP-compatible AI clients query software catalogs, bundles, system settings and DNS, and (only if explicitly enabled) apply supported changes — always previewing first and confirming with a one-time plan before anything runs.
Should I use WinGet or Chocolatey for installs?WinGet is the default and recommended package manager. If you want Chocolatey instead, you need to install it yourself first, since the tool no longer auto-downloads and runs Chocolatey's bootstrap script.
What's the difference between the three update policy options?The Windows Update page lets you switch between restoring default update behavior, delaying updates, or disabling them, adjusting how far the tool's update policy reaches.
What if antivirus flags the EXE?Check the security-alert guide, verify the file against the published SHA256 hash, and review the alert details — the project warns that being open-source or passing one scan doesn't guarantee there's no issue, and advises against disabling protection to force a run.
Size
21.2 MB
Stars
975
Age
4mo
Commits · 90 Days