yasewang1337-svg/winutil-cn · 上手攻略

• 仓库：yasewang1337-svg/winutil-cn
• 链接：https://github.com/yasewang1337-svg/winutil-cn
• 分类：agent · tool
• 作者：Jay
• 更新：2026-10-13

---

TLDR

面向 Windows 11（兼容 Windows 10）的中文一站式软件管理与系统维护工具：软件安装/升级/卸载、系统优化/配置、Windows 更新管理、Windows 10/11 安装镜像制作。内置中文界面，基于 Chris Titus Tech Windows Utility 开发，汉化与本地化由社区独立维护。提供 GUI 和 PowerShell 两种使用方式，支持 MCP 接口（默认只读）。

---

§0 自检

• [x] GitHub URL 已 fetch（README 完整内容）
• [x] 顶会 anchor：无（工具类仓库，非学术论文）
• [x] README 子模块 anchor：docs/content/userguide/getting-started/_index.md · docs/content/userguide/updates/_index.md · mcp/README.md · docs/SECURITY.md
• ⚠️ MCP 版本：npx -y winutil-cn-mcp@0.4.3（版本号以 npmjs.com 或 GitHub releases 为准）
• ⚠️ EXE 为单文件 PowerShell 脚本打包，杀软可能误报；SHA256 校验文件在 Release 页，需比对
• ⚠️ 镜像制作功能仅在 Windows 11 宿主机上运行，制作目标为 Windows 10/11 x64

---

§1 是什么

winutil-cn（WinUtil-CN）是 Chris Titus Tech Windows Utility 的中文本地化独立维护分支，由社区开发者 yasewang1337 主导汉化、主题定制和功能增强。所有汉化层、主题、中文预设和可靠性改进均维护在本仓库，不与上游合并，但保持与上游的功能同步。

核心功能（来自 README）：

模块	功能
软件管理	WinGet / Chocolatey 安装、升级、卸载；搜索、筛选已装软件
系统优化	基础/标准/高级预设方案；注册表与服务配置历史恢复
系统配置	Windows 管理工具快捷入口、系统功能与维护入口
Windows 更新	恢复/延迟/禁用三种策略配置
Windows 镜像	从官方 Windows 10/11 x64 ISO 读取版本，修改后导出 ISO 或写入 U 盘
清单与历史	软件选择和设置变更的导入/导出；操作日志追溯

许可证： MIT

---

§2 解决什么问题

核心痛点： Windows 用户管理软件和系统设置时，往往需要在十几个工具之间切换——WinGet 装软件、控制面板卸软件、组策略改设置、第三方工具做优化……winutil-cn 试图用一个中文工具覆盖全流程，降低 Windows 维护门槛。

适用人群： - 需要批量安装/卸载 Windows 软件的 IT 运维人员 - 重装系统前想快速导出/导入软件清单的用户 - 想用中文界面管理 Windows 更新和系统优化的普通用户 - 需要通过 MCP 接口让 AI 客户端查询/操作 Windows 环境的开发者

---

§3 快速安装

方式一：直接下载 EXE（推荐）

# 下载地址（GitHub Releases latest）
https://github.com/yasewang1337-svg/winutil-cn/releases/latest/download/WinUtil-CN.exe

# ⚠️ 建议同时下载 SHA256SUMS.txt 校验文件
# PowerShell 核对哈希：
Get-FileHash .\WinUtil-CN.exe -Algorithm SHA256
# 结果与 SHA256SUMS.txt 中的值比对

双击运行 → 按 Windows 提示授予管理员权限 → 从首页选择用途

方式二：下载 PS1 脚本（命令行用户）

# 从 Release 页下载 winutil-cn.ps1 和 SHA256SUMS.txt
# 核对哈希后再运行：
Get-FileHash .\winutil-cn.ps1 -Algorithm SHA256

# 管理员 PowerShell 运行：
& .\winutil-cn.ps1

⚠️ 安全注意（来自 SECURITY.md）： - 出现杀软告警或"Windows 已保护你的电脑"时，先按 SECURITY.md 区分检测类型 - 核对文件哈希并保留告警记录 - 不要通过关闭防护或添加排除项来启动 - 开源 + 数字签名 ≠ 绝对安全，仍需自行判断

⚠️ 环境要求： - Windows 11（主）；Windows 10 兼容 - EXE 内嵌 PowerShell 5.1，无需另装 PowerShell 7 - 需要联网以下载包管理器内容和更新

从源码构建中文版

git clone https://github.com/yasewang1337-svg/winutil-cn.git
cd winutil-cn

# 方式 A（推荐，PwSh）
pwsh -File 汉化\run-all.ps1
pwsh -File tools\Test-Build.ps1

# 方式 B（标准 PowerShell）
powershell -NoProfile -File tools\Test-Build.ps1

# 产物为中文版 winutil.ps1

完整回归测试需要 Pester 5.7.1；EXE 构建方法见 tools/launcher/README.md

---

§4 核心用法

GUI 图形界面使用流程

1. 打开 WinUtil-CN.exe → 授予管理员权限
2. 首页选择模块：软件管理 / 系统优化 / 系统配置 / Windows 更新 / Windows 镜像
3. 在各模块勾选要安装的软件或要调整的设置
4. 点击"执行" → 核对操作范围 → 确认
5. 查看每项结果；失败项可单独重试

软件管理示例：

# 检测已安装软件
点击"检测已安装" → 查看软件列表（状态行显示来源和检测时间）

# 仅看已装
点击"仅看已装" → 筛选当前来源识别到的已安装软件

# 安装新软件
勾选软件 → 点击"安装" → 逐项显示结果 → 失败项单独重试

# 卸载软件
勾选软件 → 点击"卸载" → 确认范围 → 执行 → 查看结果

# 批量升级
点击"查看全部升级操作" → 覆盖包管理器可识别的所有软件

系统优化示例：

# 选择预设方案
- Minimal（基础）：减少推荐应用、增加任务栏结束任务入口
- Standard（标准）：基础 + 活动历史策略 + 更新对等传输设置
- Advanced（高级，仅 GUI）：标准 + 创建还原点 + 经典右键菜单

# 勾选要调整的设置 → 点击"直接应用"

命令行预设模式

# 下载 winutil-cn.ps1 和 SHA256SUMS.txt 后
# 管理员 PowerShell 运行：
& .\winutil-cn.ps1 -Preset Minimal    # 应用基础预设
& .\winutil-cn.ps1 -Preset Standard    # 应用标准预设
& .\winutil-cn.ps1 -Preset Advanced    # 应用高级预设（需 GUI）

# 导入配置清单
& .\winutil-cn.ps1 -Config .\my-software-list.json

⚠️ 命令行 -Preset / -Config 是自动执行入口，使用前必须核对配置内容。

MCP 接口（AI 客户端接入）

安装（npm）：

npx -y winutil-cn-mcp@0.4.3

或从 GitHub Releases 下载 MCP 安装包（mcp-v0.4.3）

MCP 默认只读；显式启用修改后，仍须先预览，再用同一参数与一次性计划确认。

可用工具（来自 README）：

工具	说明
查询软件列表	支持按名称、包 ID 搜索
查询组合方案	查看预设方案内容
查询系统设置	查看 DNS、注册表等设置
安装指定软件	⚠️ 需显式启用修改
修改 DNS	⚠️ 需显式启用修改
修改注册表/服务	⚠️ 需显式启用修改

// MCP 客户端配置示例（参考 mcp/README.md）
{
  "mcpServers": {
    "winutil-cn": {
      "command": "npx",
      "args": ["-y", "winutil-cn-mcp@0.4.3"]
    }
  }
}

软件清单导入/导出

# GUI 操作
导出：首页 → 清单与历史 → 导出当前软件与设置选择
导入：首页 → 清单与历史 → 导入清单（仅替换勾选，不自动安装）

⚠️ 组合中的安装状态来自会话缓存，"尚未确认"不等于未安装

---

§5 典型适用场景

场景	说明
新机装机	从微软官网下载 ISO 后，用 WinUtil-CN 快速装驱动、常用软件和系统优化，一气呵成
重装前备份	导出当前软件清单和设置，重装后导入还原
IT 批量部署	用 -Preset Standard 或自定义 -Config 快速配置多台机器
Windows 更新管控	延迟/禁用特定更新，防止更新导致的兼容性问题
AI 客户端调用 Windows	通过 MCP 接口让 Claude/GPT 等客户端查询系统信息、执行维护操作
系统故障恢复	用设置历史恢复注册表和服务启动配置

---

§6 坑与注意

⚠️ 重要工程坑

1. 杀软误报是常态，不是病毒：EXE 是内嵌 PowerShell 脚本的单文件，杀软 heuristic 容易触发警告。先按 SECURITY.md 区分误报类型，核对 SHA256 哈希后再决定是否信任。不要通过关闭防护来运行。

2. Chocolatey 需先安装：如需用 Chocolatey 替代 WinGet，先按 Chocolatey 官方说明完成安装；WinUtil-CN 不再下载并直接执行 Chocolatey 初始化脚本。

3. 镜像制作 ≠ 工具运行环境：镜像制作页在 Windows 11 宿主机上运行，用于生成 Windows 10/11 x64 安装 U 盘或 ISO。写入 U 盘会擦除所选磁盘，操作前务必确认目标盘符。

4. 全部升级不提供逐软件版本清单："查看全部升级操作"只给出整批结果和日志，不提供每款软件的待更新版本信息，也不支持版本回退。

5. 恢复有范围限制：设置历史可恢复有记录的注册表值和服务启动配置；已删除应用、清理文件及脚本的其他改动不在完整恢复范围内，也不能替代个人文件备份。

6. 已装软件检测不保证完整：切换来源、开始软件操作或检测失败后，需要重新检测才能继续使用已装筛选。状态行会显示来源和检测时间；"未识别"不等于"未安装"。

7. MCP 默认只读：接入 AI 客户端时，修改功能需要显式启用（且每次修改都需预览确认）。复杂脚本优化会被明确拒绝，引导使用桌面版。

8. 命令行 -Preset / -Config 无二次确认：图形界面会逐项展示操作范围，命令行直接执行——使用前必须人工核对配置内容。

9. 上游同步有维护成本：本仓库是独立分支，同步上游 Chris Titus Tech WinUtility 时需核对配置、控件 key、功能与翻译兼容性。具体差异见 docs/MAINTENANCE.md。

10. WinGet 和 Chocolatey 行为差异：同一软件在两个包管理器中的版本和可用性可能不同，切换来源后状态独立。

---

§7 与同类对比

维度	WinUtil-CN	Chris Titus WinUtility（上游）	Winget UI	Chocolatey GUI
语言	简体中文	英文	英文	英文
包管理器	WinGet + Chocolatey	WinGet + Chocolatey	WinGet（为主）	Chocolatey
系统优化	预设方案+历史恢复	预设方案	无	无
Windows 更新管理	原生支持	支持	无	无
镜像制作	支持（Windows 10/11 x64）	支持	无	无
MCP 接口	支持（默认只读）	无	无	无
许可证	MIT	MIT	MIT	Apache 2.0
维护方	社区独立分支	Chris Titus Tech	Microsoft	Chocolatey Software

核心差异： WinUtil-CN 是上游 WinUtility 的中文本地化分支，增加了完整汉化、中文预设主题、MCP 接口，以及适合国内用户的软件组合推荐。相比 Winget UI，WinUtil-CN 功能更全（系统优化+更新+镜像）；相比 Chocolatey GUI，门槛更低（中文界面+默认只读 MCP）。

---

§8 一句话推荐结论

如果你需要在 Windows 上一站式管理软件、系统设置、Windows 更新和安装介质，且希望用中文界面和 MCP 接口，WinUtil-CN 是目前中文社区维护最完整、功能最全的工具——注意核对 SHA256 哈希再运行，并善用"核对后执行"原则。

---

⚠️ 存疑标注：MCP 版本号 0.4.3 基于 README 中的 npx 命令，建议以 npmjs.com 或 GitHub Releases 最新发布为准。Chocolatey 与 WinGet 的包冲突场景和恢复范围，建议以 docs/MAINTENANCE.md 和上游文档为准。