Repository navigation
Releases: hyt315/windows-cleanup-optimize
Releases · hyt315/windows-cleanup-optimize
Release list
v1.9.0: 微软官方规范基线落地、系统级深度清理防误损体系与工作流动作内联升级
新增特性与底层优化
1. 微软官方底层规范与深度清理避坑库(references/windows-cleanup-optimize-pitfalls.md)
- WinSxS 组件存储库与 DISM
/ResetBase风险防控:- 明确系统核心文件与 WinSxS 硬链接(Hard Link)存储机理,破除虚胖假象;
- 严格规范组件清理步骤,禁止默认附带
/ResetBase参数,彻底杜绝当前累积更新(LCU)被永久固化、丧失系统故障回滚能力的严重生产隐患。
- OneDrive / iCloud "文件随选 (Files On-Demand)" 水合雪崩防御:
- 在目录遍历与大文件扫描中加入
ReparsePoint(重解析点)与SparseFile(稀疏文件)属性拦截; - 严禁对云端占位文件执行读取内容操作,杜绝 Filter Driver 触发云端全量数据静默水合下载从而撑爆本地 C 盘的灾难性问题。
- 在目录遍历与大文件扫描中加入
- Windows Installer (
C:\Windows\Installer) 注册缓存误删拦截:- 设立系统核心缓存保护底线,明确禁止手动批量删除
.msi与.msp文件; - 防控因误删安装源导致 Office、Visual Studio、SQL Server、AutoCAD 等大型软件永久无法更新、修复或卸载的故障。
- 设立系统核心缓存保护底线,明确禁止手动批量删除
- 卷影副本 (VSS) 与系统还原点防误清:
- 严禁脚本默认执行
vssadmin delete shadows /all; - 保护用户本地关键系统还原点与文件历史版本快照,确立安全容量调整与只读查询机制。
- 严禁脚本默认执行
- CompactOS 原生系统文件无损压缩规范:
- 规范基于 WOF 微筛选驱动的
compact /compactos:always压缩调用,安全稳定释放 2.0GB ~ 4.5GB C 盘空间且不损伤冷启动性能。
- 规范基于 WOF 微筛选驱动的
- 休眠文件
hiberfil.sys瘦身权衡:- 推荐优先采用
powercfg /h /type reduced,体积缩减 50% 同时完整保留 Windows 快速启动(Fast Startup)特性。
- 推荐优先采用
2. 工作流指令就近内联动作重构与弱引用治理(SKILL.md)
- 就近内联动作指令升级:
- 彻底消灭主流程中的“详见/可参考”弱引用逃避性措辞;
- 升级为标准的
👉 动作:先读 [文件]就近内联指令范式,杜绝 Agent 调度执行时的视而不见与偷懒跳步。
- 模块化安全策略挂载:
- 将底层避坑准则与官方规范基线深度融入核心安全原则与分阶段执行流程。
3. 自动化回归测试套件强化(scripts/selftest.py)
- 扩展
REQUIRED_REFS必检清单,纳入全新深度避坑文档; - 增加针对
ResetBase、ReparsePoint、Installer缓存等底层核心防御断言的内容级回归门禁。
v1.8.0: 规范分层事实卡交付、Zero-Mutation安全纪律、AST语法门禁与开源视觉门面
🧹 Windows 清理与优化助手 (windows-cleanup-optimize) v1.8.0
📊 标准交付成果:Windows 分层体检事实卡 (Fact Card)
- 在
SKILL.md中规范了标准交付成果模版,涵盖 L1 磁盘与缓存、L2 自启动与驻留、L3 流氓软件与弹窗、L4 服务与内存效能 四层关键指标。 - 强制要求排查阶段以「检查项、测量实值、正常基线、状态判定」标准化表格形式向用户呈报,用确凿客观事实说话。
🛡️ 只读优先与显式授权安全纪律 (Zero-Mutation)
- 核心原则确立阶段 1 排查完全只读(Zero-Mutation 原则),排查期间绝不擅自修改任何系统配置或移动/删除文件。
- 破坏性写操作(移入回收站、注册表修改、服务禁用、IFEO 映像劫持、目录迁移等)严格与排查解耦,必须经用户明确授权同意后手动执行,并提供完整回滚与安全恢复对策。
⚙️ 代码级 AST 语法树回归门禁与 Pytest 支持
scripts/selftest.py引入System.Management.Automation.Language.Parser对 23KB 核心扫描器scripts/full_scan.ps1进行 PowerShell AST 静态语法解析,并引入 Pythonast.parse静态分析。- 新增
tests/test_skill.py提供 Pytest 自动化测试发现入口。 - 强化针对坏语法脚本与破坏样本的负向对抗校验(DY002)。
✨ 视觉门面升级与元数据工程 (Visual Facade & Metadata)
- 新增
assets/banner.svg高分辨率暗色系矢量封面,集成磁盘护盾、性能表盘与零伤害核心特性徽章。 - 补充规范的
manifest.json元数据文件。 - 全量通过 Skill Doctor 工业级静态与动态全套 39 项体检,综合进化指数 (SEI) 跃升至 100/100 满分。
v1.7.0: 刚需软件IFEO弹窗静音、WMI持久化与快捷方式劫持审计、Win11后台与TCP精准调优
What's Changed in v1.7.0
-
刚需软件免卸载“弹窗彻底静音”与 IFEO 底层阻断 (
references/bloatware-catalog.md):- 针对用户日常无法卸载但高频弹窗骚扰的办公软件(如 WPS、搜狗输入法、FlashCenter、好压等),提供基于 Windows 映像劫持(Image File Execution Options, IFEO)的免卸载静音 SOP。
- 将弹窗专用进程(
wpscenter.exe、ksobulletin.exe、SGDownload.exe、SogouNews.exe、FFNewTask.exe、HaoZipPopup.exe等)的 Debugger 键值重定向至系统内置静默退出程序systray.exe,彻底切断后台弹窗拉起,同时保证文字编辑、打字输入、解压缩等主体功能 100% 正常运行。 - 提供一键批量静音与完整回退恢复脚本。
-
活动弹窗进程秒级定位器 (
references/software-uninstall.md+ 模板 20):- 新增基于 Win32 原生 API(
GetForegroundWindow/GetWindowThreadProcessId)的 3 秒瞬时弹窗归属溯源工具。 - 弹窗出现时点击窗口,脚本即可精准提取对应进程 ID、进程名、可执行文件物理路径与完整启动命令行,彻底解决伪装/无标题流氓弹窗来源难以溯源的痛点。
- 新增基于 Win32 原生 API(
-
WMI 事件订阅持久化常驻与快捷方式劫持审计 (
references/startup-mechanisms.md+references/startup-audit.md+ 模板 19):- 升级第 18 类自启动机制:深度解析流氓软件利用 WMI
CommandLineEventConsumer、__EventFilter和__FilterToConsumerBinding在系统底层无进程、无服务隐蔽常驻的机制,并提供精准检测与三体协同清理命令。 - 新增桌面与开始菜单
.lnk快捷方式目标路径与参数审计,检测并清洗静默追加的恶意推广网址、推广渠道 ID 或静默唤醒参数。
- 升级第 18 类自启动机制:深度解析流氓软件利用 WMI
-
Windows 11 现代后台与网络性能优化 (
references/services-optimization.md+references/performance-tuning.md):- Win11 小组件与后台 WebView2 冻结:通过策略配置
AllowNewsAndInterests = 0彻底封冻Widgets.exe与常驻后台的msedgewebview2.exe,释放多余内存与 CPU 资源。 - Windows 聚焦后台静音:抑制锁屏壁纸与后台热点推送在空闲时段频繁唤醒网络与磁盘。
- TCP 协议栈现代化规范:补充 Win10/Win11 原生 TCP 自动调谐级别校验(
autotuninglevel=normal)、CUBIC 拥塞控制确认及网卡节能以太网(EEE)延迟规避指南。
- Win11 小组件与后台 WebView2 冻结:通过策略配置
-
权威避坑指南扩充至 86 条 (
references/pitfalls.md):- 避坑 85:TCP Nagle 算法(
TcpAckFrequency/TCPNoDelay)必须写入当前有效物理网卡 GUID 路径(Tcpip\Parameters\Interfaces\{GUID}),写在全局根路径下为无效空跑。 - 避坑 86:IFEO 映像劫持拦截弹窗时,Debugger 必须指向系统合法静默宿主(如
systray.exe),不可随意填空或不存在的路径,防止系统抛错中断或子进程异常循环。
- 避坑 85:TCP Nagle 算法(
-
系统调优缺陷修复与路径规范:
- TCP Nagle 注册表路径修复:修正此前将优化参数写入
Tcpip\Parameters根目录的缺陷,改为动态获取当前具有默认网关的活动网卡 GUID 并精准写入。 - 服务拼写修正:修正
GammingServices为官方正确服务名称GamingServices。 - PyTorch 缓存路径修正:规范模型权重缓存探测路径为官方统一的
$env:USERPROFILE\.cache\torch。
- TCP Nagle 注册表路径修复:修正此前将优化参数写入
-
全量扫描脚本与自测套件升级 (
scripts/full_scan.ps1+scripts/selftest.py):- 全量扫描脚本模板总数扩充至 20 项,集成
[T19]WMI 持久化常驻与快捷方式劫持自动审计,版本同步升级为v1.7.0。 - 自测试套件扩展深度内容断言,覆盖网卡 GUID TCP 注册表路径、GamingServices 拼写、Win11 Widgets 优化、IFEO 映像劫持 SOP、Win32 弹窗定位器与 WMI 消费者检查,确保知识库的严谨性与可靠性。
- 全量扫描脚本模板总数扩充至 20 项,集成
v1.6.0: 现代开发工具链换盘、WSL2稀疏磁盘缩容与微信4.0残留治理
What's Changed in v1.6.0
- 现代开发工具链官方换盘与安全缓存修剪 (
references/drive-migration-official.md):- Python uv:新增对 Astral
uv现代包管理器的支持,提供UV_CACHE_DIR环境变量迁移与uv cache prune/uv cache clean官方修剪命令。 - Android AVD 模拟器:支持通过
ANDROID_AVD_HOME环境变量将动辄数十 GB 的安卓虚拟设备镜像官方重定向至 D 盘。 - ModelScope 魔搭社区 & PyTorch:提供
MODELSCOPE_CACHE与TORCH_HOME官方模型缓存换盘指引。
- Python uv:新增对 Astral
- WSL 2.0+ 原生稀疏虚拟磁盘(Sparse VHDX)自动缩容 (
references/drive-migration-official.md):- 引入 Windows 11 23H2/24H2 & WSL 2.0+ 原生特性:
wsl --manage <发行版> --set-sparse true,实现 Linux 删除文件后宿主机物理 VHDX 自动释放空间;同时保留diskpart compact vdisk通用离线压缩方案。
- 引入 Windows 11 23H2/24H2 & WSL 2.0+ 原生特性:
- 微信 4.0 升级后旧版 3.x 孤岛残留处置 (
references/chat-apps-migration.md):- 针对升级 4.0 并迁移后旧版
Documents\WeChat Files变成 30GB~80GB 独立孤岛的真实痛点,建立只读核验与 SafeRecycle 安全回收 SOP。 - 补充企业微信(WeCom / WXWork)的数据迁移与安全缓存清理支持。
- 针对升级 4.0 并迁移后旧版
- GitHub 顶级开源经验吸收与规范升级 (
references/software-uninstall.md,references/system-cleanup.md):- 正式推荐顶级开源项目 BCUninstaller (Bulk Crap Uninstaller),引入残留扫描“置信度分级(Confidence Levels)”原则。
- 驱动存储库清理命令升级为现代官方规范:
pnputil /delete-driver oemXX.inf /uninstall。 - 引入 Windows 原生传递优化 Cmdlet:
Clear-DeliveryOptimizationCache -Force。 - 补充系统崩溃全内存转储(
MEMORY.DMP)与小型转储日志安全清理机制。
- 全量扫描脚本升级 (
scripts/full_scan.ps1):- 新增
[T5E]专项:只读探测本地大模型、uv 缓存、AVD 镜像与 WSL/Docker VHDX 占用。 - 新增
-Quick快速模式参数。 - 画像反推新增
🤖 AI创作者/虚拟化用户智能标签。
- 新增
v1.5.0 全量扫描入口
v1.5.0 全量扫描入口
🆕 新增
全量扫描主脚本 (scripts/full_scan.ps1):
- 一次性跑完 18 个模板
- 输出三段式报告(按档位 / 按类型 / 按来源模板)
- 末尾自动反推用户画像(家庭 / 开发者 / 游戏玩家 / 笔记本 / OEM)
- 输出文件:
%USERPROFILE%ull_scan_<timestamp>.txt
Shell 扩展审计升级:
- 修复 Win11 新增系统组件(Previous Versions / Portable Devices / CD Burning / ModernSharing 等)被误判为"未知"的实战痛点
📝 变更
- SKILL.md 阶段 0 拆分为"入口选择(
🅰️ /🅱️ )"和"用户画像(仅🅱️ 模式)" - SKILL.md 阶段 1 增加"
🅰️ 全量扫描模式"分支说明 - SKILL.md 阶段 2 新增"画像自动反推"小节(仅
🅰️ 模式) - README.md 核心特性表更新为"两种扫描入口"
🧪 测试
- selftest.py 通过 ✅
- skill-doctor 静态 + 动态 PASS ✅
- 手动全量扫描验证通过 ✅
📥 使用
\scriptsull_scan.ps1详细变更见 CHANGELOG.md
v1.4.0 - 软件深度根治、AI模型换盘、Win11 24H2支持与18个脚本模板
🧹 Windows 清理与优化助手 v1.4.0 发布日志
本版本是一个全方位深度重构与功能扩充版本,彻底解决了常规优化工具「仅关表面、死灰复燃」的问题,全面覆盖了现代国产顽固全家桶、本地大模型大文件吞噬、Win11 24H2 新系统特性与 18 个自动化脚本模板。
🌟 核心更新亮点
1. 软件深度治理与常驻守护彻底封杀(software-uninstall.md + bloatware-catalog.md + pitfalls.md 79-81)
- WPS Office 四层复活链根治:
- 配置层(治本):修改注册表
UpdateMode=manual与LastUpdateMode=manual,阻断每次打开文档时的静默检查与任务重注册; - 任务层(连根拔):禁用
WpsUpdateTask、WpsUpdateLogonTask、WpsWakeWnsLogonTask; - 服务层(降级):禁用
wpscloudsvr系统云服务; - 网络层(防火墙阻断):防火墙出站拦截
wpscloudsvr.exe与wpsupdate.exe,并清理旧插件池addons/pool/win-i386/。
- 配置层(治本):修改注册表
- 百度网盘:系统常驻探测守护服务
YunDetectService停止/禁用/删除、BaiduNetdiskUpdateTask计划任务禁用、右键 Shell 扩展与 AppData 缓存清理。 - 迅雷:
XLServicePlatform与ThunderNetwork后台 P2P 上传守护服务彻底禁用与下载引擎缓存清理。 - 搜狗输入法:
SogouCloud.exe云计算候选与SGDownload.exe弹窗下载器出站防火墙阻断及更新任务禁用。 - 夸克网盘:开机常驻守护与临时分片目录治理。
2. 浏览器策略级锁定与「启动提升」纠偏(startup-audit.md + pitfalls.md 68-70)
- Microsoft Edge:向组策略
HKLM\SOFTWARE\Policies\Microsoft\Edge写入StartupBoostEnabled=0、BackgroundModeEnabled=0与LaunchEdgeOnWindowsStartupEnabled=0(Edge ≥153),使浏览器内部开关锁定变灰,彻底断绝启动时自动写回MicrosoftEdgeAutoLaunch_<hash>Run 键的能力。 - Google Chrome 纠偏:澄清 Chrome 没有「启动提升」(那是 Edge 专属),其对应项为「关闭后继续运行后台应用」(
BackgroundModeEnabled)。
3. 本地 AI 框架与模型大户官方迁移(drive-migration-official.md §3.3)
- Ollama 本地大模型:官方原生环境变量
OLLAMA_MODELS=D:\OllamaModels换盘指南(拯救 20~80GB C 盘空间)。 - Hugging Face / PyTorch:预训练权重缓存环境变量
HF_HOME=D:\HF_Cache迁移指南。 - Cursor AI IDE:代码库嵌入索引缓存(
workspaceStorage)与更新包残留治理。 - Gradle / Android SDK:
GRADLE_USER_HOME与ANDROID_HOME重定向。
4. 微信 4.x / QQ NT / 钉钉深度治理(chat-apps-migration.md)
- 微信 4.x:数据目录
xwechat_files;解析 OneDrive 冲突时的 Fallback 回退机制;%APPDATA%\Tencent\xwechat目录细分(config保护、xplugin沙箱引擎、log/crashinfo安全清理)。 - QQ NT 版(v9.9+):确切设置路径(「设置 → 存储管理」聊天记录迁移与「设置 → 文件管理」接收文件保存位置)。
- 钉钉:文件存储换盘与缓存清理,提供
AlibabaProtect保镖服务提权清理命令。
5. Windows 11 24H2 系统特性与避坑(system-cleanup.md + pitfalls.md 82-84)
- 24H2 “8.63 GB 更新清理显示残留” 误报提醒:官方确认属于 UI 计算显示 Bug,严禁强删
C:\Windows\WinSxS。 - BitLocker 全盘加密前置检测:提供
manage-bde -status C:预检与 48 位恢复密钥备份提示。 - Dev Drive(ReFS 开发者卷)适配:将包管理器与构建缓存设在 Dev Drive 上享受 Copy-on-Write 加速。
6. 扫描脚本模板库扩充至 18 个模板(scan-scripts.md)
- 模板 17:本地 AI 框架与大模型缓存探测(Ollama/HuggingFace/Cursor/Gradle)
- 模板 18:顽固后台常驻服务与守护进程深度审计(百度网盘/迅雷/搜狗/WPS)
7. SKILL.md 精简与全量体检 PASS
- SKILL.md 主入口精简至 158 行(Token 降低 60%),保留完整的六阶段工作流与零伤害安全原则。
- 回归自测(
selftest.py) 深度内容断言 100% PASS。 - 自带技能
skill-doctor体检:37 项静态+动态检查 37 OK,0 WARN,0 FAIL(100% 满分通过)。
v1.3.0 - 微信4.x/QQ NT/钉钉治理、AutoRuns实操与文档精简
[1.3.0] - 2026-09-02
亮点更新
- 微信 4.x / QQ NT / 钉钉深度治理(
chat-apps-migration.md):- 微信 4.x
%APPDATA%\Tencent\xwechat目录结构与安全清理口径(config保护、xplugin保留、log/crashinfo安全清理) - 微信 4.x
xwechat_files与 OneDrive 文件夹重定向 Fallback 机制解析与探测脚本 - QQ NT 版(v9.9+)确切设置路径(「设置 → 存储管理」聊天记录迁移与「设置 → 文件管理」接收文件保存位置)
- 钉钉 PC 缓存支持与范围(文件存储换盘、应用内缓存清理,禁止整体搬移
%LOCALAPPDATA%\DingTalk_91,提供AlibabaProtect残留服务提权清理命令)
- 微信 4.x
- 自启动审计与 AutoRuns 升级(
startup-mechanisms.md+startup-audit.md):- 补充 AutoRuns
-accepteula与-vtVirusTotal 首次交互同意实操提示 - 补充 Edge 中文策略名(「启用启动增强」)与 UI 界面名称(「启动提升」)映射表
- 补充 AutoRuns
- selftest.py 深度内容断言增强(
scripts/selftest.py):- 新增深度内容级断言(自动验证自启策略关键词、微信 4.x 目录、官方迁移限制与决策树存在性)
- SKILL.md 精简重构:
- 将冗长脚本抽离至
scan-scripts.md,主入口行数从 525 行优化至 150 余行,提升 Agent 读取效率并消除规范告警(通过 skill-doctor 全部 37 项体检)
- 将冗长脚本抽离至
- 双语 README 架构完善(
README.md/README.en.md):- 补齐 15 个参考手册的完整架构清单与中英文说明
v1.2.0
v1.2.0 更新内容
自启动「彻底关闭」(修复"关了还会自启")
- 新增
startup-mechanisms.md:Windows 20+ 启动点全清单(Run/Winlogon/Active Setup/AppInit/策略 Run/StartupApproved/WMI 等)+ 官方工具 AutoRuns 一键审计指南 startup-audit.md重写浏览器专项:Edge(启动提升 + 后台模式 + AutoLaunch + 新策略)与 Chrome(后台模式 + AutoLaunch)"先切开关层再删 Run 键"完整清单;纠正「Chrome 有启动提升」误传
迁移「官方优先,mklink 兜底」(修复"搬不彻底")
- 新增
drive-migration-official.md:官方方案优先决策树 + 系统级/软件级官方迁移手段(全部带官方来源) - 新增
chat-apps-migration.md:微信 4.x/旧版、QQ NT、钉钉官方迁移与缓存清理(微信官方入口已核实:设置→账号和存储) mklink-migration.md升级:微软官方限制、12 类真实失败案例、兼容性预检清单
其他
- pitfalls 新增 68-78 条实战踩坑;README 双语 / CHANGELOG / selftest 同步
v1.1.0 - 零伤害 Windows 清理优化技能
1.1.0 - 2026-08-21
零伤害 Windows 清理与优化 Agent Skill 首个公开发布。
新增 / New
- 多路径检测方法学(bloatware-catalog.md):注册表反查 -> 多候选根 -> 进程路径三步法,解决非标准安装路径漏检
- WPS 反复复活三层防护(software-uninstall.md + pitfalls.md):配置层(UpdateMode=manual) + 任务层 + 服务层
- 模板 16:右键菜单 / Shell 扩展审计(scan-scripts.md)
- pitfalls 新增 59-66(非标准路径 / HKCR 通配 / 根目录任务权限 / schtasks 隐藏错误 / 脚本污染 / updater 残留 / 服务权限分级)
内容 / Contents
- SKILL.md(六阶段工作流 + 零伤害原则 + 四档风险)
- 12 个 references / 16 个 PowerShell 模板 / 66 条踩坑
- selftest.py 回归测试
- 全套社区健康文件(LICENSE / README / CONTRIBUTING / CODE_OF_CONDUCT / SECURITY / CHANGELOG / Issue+PR 模板)
详见 CHANGELOG.md