| name | disk_manager |
| description | 磁盘空间分析与清理建议、系统环境全面备份（浏览器/游戏存档/桌面/系统设置）。 触发词：清理硬盘、磁盘清理、空间不足、备份系统、环境备份、游戏存档备份。 当用户提到磁盘空间、清理垃圾文件、备份电脑环境、系统迁移时触发。 ⚠️ 全面备份功能未经测试，执行时必须提醒用户并全程跟进。
|
磁盘管理 Skill
概述
协助清理硬盘空间和全面备份系统，所有操作必须经过用户审核确认，绝不擅自删除或移动任何文件。
⚠️ 未测试提醒：全面备份功能（backup_env.py 的全量备份模式）尚未经过实际测试。
当用户要求执行全面备份时，必须明确告知此功能未测试，执行过程中需全程跟进并记录问题。
软件名称对应关系
.lmstudio / lm-studio-updater → LM Studio（已卸载）
.paddlex → PaddleX
.lingma → 通义灵码
.catpawai / CatPawAI → CatPawAI
.codex → OpenAI Codex
.qq-chat-exporter → QQ聊天导出工具
.abdm → ABDownloader（在用）
.trae-cn / .trae → Trae AI（在用）
.secoresdk / 360se6 → 360安全浏览器（已卸载）
.GreenCore7z / greencore → 360安全浏览器（已卸载）
.360safe → 360安全卫士
.KRLauncher → 鸣潮启动器（在用，不删）
.ima.copilot / ima.copilot → 知识库工具（在用）
.sankuai → 美团内部工具
HT → 异环游戏（在用，不删）
GeePlayer → 爱奇艺播放器
EBWebView → Outlook内嵌浏览器
.modelscope → ModelScope模型
.cache\huggingface → HuggingFace模型
.cache\puppeteer → Chromium/Puppeteer
.cache\modelscope → ModelScope模型缓存
QQMusicCache → QQ音乐播放缓存（可达10GB+）
一、文件清理方案
铁律
- 所有操作必须用户审核确认 - 脚本只生成报告和建议，不执行任何删除/移动
- 尽量减少磁盘扫描 - 使用轻量级扫描策略，避免全盘遍历
- 分类清晰 - 每个建议都标注原因和风险等级
空间分析工作流（scan → drill → find → dry-run → delete）
用户说"清理磁盘/空间不足"时，走以下闭环：
Step 1: scan — 空间概览
scan_disk.py scan <path> --json -d 4 -n 10
拿到紧凑 tree JSON（每层 top 10 目录 + other 折叠），快速定位大目录。
Step 2: drill — 下钻定位
scan_disk.py drill <path>/<大目录> --json -d 5
对 scan 发现的大目录下钻，收窄路径看更细的 tree。
Step 3: find — 按目录名定位（可选）
scan_disk.py find <path> node_modules .venv __pycache__ --json
全树搜指定目录名，返回路径+大小，适合批量定位已知费空间目录。
Step 4: dry-run — 出清理回执
cleanup.py --dry-run --json
拿到逐项可回收字节回执（id/path/size_bytes/size_human），不删任何文件。
Step 5: 用户勾选 → delete
cleanup.py --delete --items cache-0,cache-3,cache-6 --json
用 AskUserQuestion 把 dry-run 回执交给用户勾选，只删确认项，走 ctypes 回收站（可恢复）。
补充：
- Chrome缓存提醒用户用
chrome://settings/clearBrowserData 清理
- E/F盘用户自行管理，不干预
- 需要找最大单个文件时用
scan_disk.py files <path> -n 10 --json
定期清理清单（每次清理检查这些位置）
第一梯队：安全删除，自动重建
%LOCALAPPDATA%\NVIDIA\DXCache # DX着色器缓存（可达15GB+）
%LOCALAPPDATA%\pip\cache # pip缓存（可达9GB+）
%LOCALAPPDATA%\npm-cache # npm缓存
%LOCALAPPDATA%\CrashDumps # 崩溃转储
%LOCALAPPDATA%\Temp # 临时文件
%APPDATA%\Tencent\WeChat\log # 微信日志
%LOCALAPPDATA%\GameViewer\webviewcache # 向日葵缓存
%LOCALAPPDATA%\Steam\htmlcache # Steam商店缓存
%APPDATA%\Trae CN\logs # Trae日志
%APPDATA%\Tencent\WeChat\radium\WmpfCache # 微信WmpfCache
%APPDATA%\Tencent\WeMeet\Global\Data\WebkitCacheData # 腾讯会议WebKit缓存
C:\ProgramData\NVIDIA Corporation\NVIDIA app\UpdateFramework\ota-artifacts # NVIDIA驱动安装包（可达7GB+）
%LOCALAPPDATA%\NVIDIA Corporation\NVIDIA App\CefCache # NVIDIA App浏览器缓存
%LOCALAPPDATA%\NVIDIA Corporation\NVIDIA Overlay\CefCache # NVIDIA覆盖层缓存
%LOCALAPPDATA%\Microsoft\Windows\Explorer # 缩略图缓存
E:\<data_drive>:\<system_data_root>\QQMusicCache\downloadproxyNew\tp2p\.tpfs\duty # QQ音乐播放缓存（可达10GB+）
第二梯队：需关闭对应程序
Chrome缓存 → chrome://settings/clearBrowserData（勾选缓存，所有时间）
第三梯队：软件更新器（安装后可删）
%LOCALAPPDATA%\*-updater # 所有updater目录
第四梯队：可选清理（删了会重建，但重建可能较慢）
%LOCALAPPDATA%\Unity\cache # Unity包缓存（2.6GB+）
%LOCALAPPDATA%\Unity\npm # Unity包管理器缓存（921MB+）
%LOCALAPPDATA%\Microsoft\Olk\EBWebView # Outlook WebView缓存（737MB+）
%APPDATA%\IQIYI Video\GeePlayer # 爱奇艺播放器缓存（458MB+）
%USERPROFILE%\.cache\modelscope # ModelScope模型缓存（2.2GB+）
%USERPROFILE%\.cache\huggingface # HF模型缓存（1.5GB+）
%USERPROFILE%\.cache\puppeteer # Chromium缓存（583MB+）
%LOCALAPPDATA%\Google\Chrome\User Data\Default\Service Worker\CacheStorage # 网站缓存（3GB+）
%APPDATA%\Code\CachedExtensionVSIXs # VS Code扩展缓存（648MB+）
Windows系统清理命令
dism /online /cleanup-image /startcomponentcleanup /resetbase # 组件存储清理（释放assembly/Installer/LCU空间）
cleanmgr /d C # 磁盘清理工具
二、全面备份方案
设计理念
备份不仅仅是复制文件，而是完整迁移一个工作环境。目标是：换一台电脑，运行恢复脚本后，能快速恢复到熟悉的工作状态。
备份层次
┌─────────────────────────────────────────┐
│ L1: 文件同步（已有filesync） │ ← 你已有
├─────────────────────────────────────────┤
│ L2: 系统环境备份（新增） │ ← 本次设计
│ - 浏览器数据（书签/扩展/密码/设置） │
│ - 游戏存档 │
│ - 桌面布局 │
│ - 系统设置/注册表 │
│ - 已安装软件列表 │
├─────────────────────────────────────────┤
│ L3: 一键恢复脚本（新增） │ ← 本次设计
│ - 自动恢复L2备份项 │
│ - 环境调整清单（需手动确认的项） │
└─────────────────────────────────────────┘
L2: 系统环境备份详情
1. 浏览器数据
| 数据 | Chrome路径 | 备份方式 |
|---|
| 书签 | %LOCALAPPDATA%\Google\Chrome\User Data\Default\Bookmarks | 直接复制 |
| 扩展列表 | chrome://extensions 导出ID列表 | 脚本提取 |
| 密码 | Chrome不提供明文导出，需用户手动导出CSV | 提示用户 |
| 搜索引擎 | Preferences JSON中的search_engines | 直接复制 |
| 油猴脚本 | Extensions\*tampermonkey*\ | 直接复制 |
2. 游戏存档
| 游戏/平台 | 存档位置 |
|---|
| Steam云存档 | 自动同步，无需备份 |
| Steam本地存档 | C:\Program Files (x86)\Steam\userdata\ |
| Epic | %LOCALAPPDATA%\Epic Games\* |
| 单机游戏常见路径 | %<data_drive>:\Documents%\My Games\, %APPDATA%\*, %LOCALAPPDATA%\* |
| 特殊游戏 | 需用户补充列表 |
3. 桌面布局
| 数据 | 方式 |
|---|
| 桌面图标位置 | 注册表 HKCU\Software\Microsoft\Windows\Shell\Bags |
| 任务栏固定 | 注册表 + 快捷方式文件 |
| 开始菜单布局 | PowerShell导出 Export-StartLayout |
4. 系统设置
| 数据 | 方式 |
|---|
| 环境变量 | reg export "HKCU\Environment" + reg export "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" |
| 右键菜单 | HKCR\Directory\Background\shell, HKCR\*\shell |
| 文件关联 | HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\FileExts |
| 输入法设置 | 注册表导出 |
| 电源计划 | powercfg /export |
| Windows Terminal配置 | %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_*/LocalState/settings.json |
| hosts文件 | C:\Windows\System32\drivers\etc\hosts |
| PATH变量 | 环境变量备份中已包含 |
5. 已安装软件列表
| 方式 | 命令 |
|---|
| 已安装程序 | wmic product get name,version 或 PowerShell Get-ItemProperty HKLM:\Software\* |
| Chocolatey | choco list --local-only |
| Scoop | scoop list |
| pip | pip list --format=freeze |
| npm全局 | npm list -g --depth=0 |
| uv | uv tool list |
L3: 一键恢复脚本设计
恢复流程：
1. 运行 restore_env.bat
2. 自动恢复：
- 注册表项（环境变量、右键菜单、文件关联）
- 桌面图标位置
- hosts文件
- Windows Terminal配置
- 浏览器书签
3. 半自动恢复（需确认）：
- 安装软件（从列表生成安装命令）
- 恢复游戏存档（确认游戏已安装后复制）
- 恢复浏览器扩展（逐个确认安装）
4. 手动恢复（生成清单）：
- 密码导入
- 需要重新配置的软件设置
- 系统偏好设置（深色模式、缩放比例等）
备份文件组织
E:\<data_drive>:\<backup_root>\SystemBackup\{日期}\
├── registry\ # 注册表导出
│ ├── env_user.reg
│ ├── env_system.reg
│ ├── context_menu.reg
│ └── desktop_layout.reg
├── browser\ # 浏览器数据
│ ├── bookmarks.json
│ ├── extensions_list.txt
│ └── preferences.json
├── game_saves\ # 游戏存档
│ └── {game_name}\
├── system\ # 系统配置
│ ├── power_plan.pow
│ ├── terminal_settings.json
│ ├── hosts
│ └── start_layout.xml
├── software\ # 软件列表
│ ├── installed_programs.txt
│ ├── choco_list.txt
│ ├── pip_requirements.txt
│ └── npm_global.txt
├── desktop\ # 桌面文件和快捷方式
│ └── *.lnk
├── restore_env.bat # 一键恢复脚本
└── manual_checklist.md # 需手动确认的清单
三、与filesync的协作
你的filesync工具处理文件同步，新增的系统环境备份需要加入filesync配置：
E:\<data_drive>:\<backup_root>\SystemBackup → J:\SystemBackup |重复文件:检查日期和大小 |增删文件处理:增量更新 |状态:启用
备份脚本执行后，filesync会自动同步到移动硬盘。
四、扫描策略（保护磁盘寿命）
- 紧凑 tree：
scan 默认深度 4、每层 top 10，other 折叠小目录，JSON 通常几 KB
- 下钻收窄：
drill 对大目录逐层下钻，不做一次性全盘深扫
- 按名定位：
find 全树搜指定目录名（如 node_modules），匹配后计算大小即停（不重复下钻）
- 硬上限保护：
--max-files（默认10万）、--max-dirs（默认2万）、-d 深度上限，达到即停报告 stop_reason
- symlink/junction 不跟随：用
st_file_attributes & 0x400 检测 reparse point，跳过不递归
- 增量备份：只备份变更的文件，不全量复制
触发词
- 清理硬盘、磁盘清理、空间不足、清理文件
- 备份系统、全面备份、系统迁移、环境备份
- 游戏存档备份、浏览器备份
工具脚本
scan_disk.py - 磁盘空间扫描（子命令：scan/drill/find/files，--json 直返上下文，symlink/junction 不跟随，硬上限保护）cleanup.py - 磁盘清理（--dry-run 出逐项回执 → --delete --items 走 ctypes 回收站，路径白名单保护）backup_env.py - 系统环境备份（浏览器数据/游戏存档/桌面布局/系统设置/软件列表）
