qing-li-dian-nao

name qing-li-dian-nao description 安全清理电脑、清理C盘、释放磁盘空间、整理下载/桌面/文档、查找大文件/旧文件/重复文件、迁移开发工具缓存、分析Docker/WSL/浏览器/包管理器缓存时使用。用户输入“/清理电脑”“清理电脑”“电脑空间不够”“C盘爆了”“帮我整理文件”“找重复文件”等都应触发。默认只读扫描，生成分级清理/迁移方案，任何删除、移动、改配置前必须逐项确认并保留回滚路径。 清理电脑 核心契约 先证据、后动作。除非用户明确只要建议，否则先做只读扫描，拿到体积、路径、时间、重复候选、风险等级后再判断。 默认不删除、不移动、不改配置。清理动作必须在用户确认具体项目后执行；宽泛确认如“都清了”仍要拆成项目清单再确认。 优先使用可回滚方式：回收站、非 C 盘隔离区、备份清单、undo/manifest。不要默认永久删除或“安全擦除”。 对 C 盘尤其保守。系统目录、程序目录、页面文件、还原点、WSL/Docker 镜像、云同步目录、个人照片/文档必须人工确认。 隐私优先。不得把文件内容、文件名清单、截图或目录树上传到远程 AI/API，除非用户明确同意；默认只在本地分析元数据。 产物放在非 C 盘优先：当前工作区、用户指定非 C 路径、工具自己的临时工作目录，或可用的非 C 盘临时报告目录。扫描报告很小也尽量遵守。 工作流 判定目标：释放空间、整理文件、找重复、迁移缓存、排查 C 盘异常占用，或组合目标。 确定范围：用户给了路径就用该路径；只说“电脑/C盘”时，先扫描当前用户常见目录和已知缓存，不要直接全盘深扫。 运行只读扫描脚本： $env:PYTHONUTF8 = "1" & "<python>" "<skill-dir>\scripts\cleanup_scan.py" ` --include-common --include-known ` --output "<非C盘报告目录>" 用可用 Python 替换 <python> ； <skill-dir> 是当前 skill 的安装目录（例如 Windows 上的 %USERPROFILE%\.codex\skills\qing-li-dian-nao 、其他 AI 编程工具的 skills/prompts 目录，或你自己的工作流仓库路径）。默认优先用当前工具提供的 Python 或系统可用 Python。用户指定目录时加 --root "D:\path" ，大范围首次扫描先不加 --hash-duplicates ，等发现可疑重复候选后再对更窄范围做精确哈希。 默认会跳过系统目录以及 node_modules / .git 这类重型开发目录并在报告中列出；需要完整项目体积分析时再加 --include-dev-heavy 。高风险已知位置只列存在状态，确需测量时再加 --measure-high-risk-known 。 生成行动计划，按收益和风险分组： 可直接清理：临时目录、缩略图缓存、明确可重建的包管理器缓存。 建议迁移：npm/pnpm/yarn/pip/Cargo/Maven/Gradle/NuGet、Docker/WSL 数据、下载目录归档。 需要人工确认：重复文件、旧安装包、大型视频/压缩包、浏览器缓存、回收站。 不建议处理：系统核心、个人资料、项目源码、云同步目录、数据库/虚拟机镜像、页面文件。 执行前给出三件事：将处理的确切路径、预计释放空间、回滚办法。没有这三件事不执行。 执行后复扫或至少重查目标目录/磁盘空闲空间，报告释放量、失败项和残余风险。 安全执行规则 删除类动作优先用回收站；没有回收站能力时，移动到非 C 盘隔离区： cleanup-quarantine\<timestamp>\ ，同时写 manifest.jsonl 记录原路径、大小、mtime、hash(可行时)。 对“默认跳过目录”不要猜测大小；如它们可能是主要占用，先用更窄范围和 --include-dev-heavy 复扫。 对重复文件只自动标记，不自动删除。建议保留：路径更短、mtime 更新、位于正式资料库/项目目录中的副本；删除候选必须逐项确认。 对浏览器缓存优先指导用户用浏览器内置清理入口；直接删除 profile 目录前必须说明可能丢失登录态、IndexedDB、扩展状态。 对开发工具缓存优先使用工具命令： npm cache verify/clean 、 pnpm store prune 、 yarn cache clean 、 pip cache purge 、 cargo cache 、 gradle --stop 后处理缓存。 对 Docker/WSL 先用 docker system df 、 wsl --list --verbose 、实际 vhdx 大小分析； docker system prune -a 、WSL 导出/导入/注销都属于高风险，必须单独确认。 对 Windows 组件只用官方清理通道： Dism /Online /Cleanup-Image /AnalyzeComponentStore 先分析，再决定 StartComponentCleanup 。不要手删 WinSxS 。 禁止对未枚举确认的路径运行递归删除。尤其不要对根目录、用户目录、 AppData 、 Program Files 、 Windows 、云盘同步根目录做通配递归删除。 整理文件模式 当用户想“整理下载/桌面/文档/图片”时： 先生成预览树，不直接移动。 优先按现有目录习惯、扩展名、日期、文件名关键词分类；只有用户同意时才读取文档内容或使用远程 AI。 重命名建议必须清洗非法字符、限制长度、避免覆盖，并保留原扩展名。 默认选择“复制/硬链接到整理目录”或“移动并写 undo 计划”二选一；不确定时选复制/硬链接预览，减少误伤。 输出清单要能让用户一眼看出：源路径、目标路径、分类原因、是否重命名、冲突处理。 资源 scripts/cleanup_scan.py ：标准库只读扫描器，输出 Markdown + JSON 报告。 references/research-synthesis.md ：从参考项目提炼的设计原则、风险矩阵和清理类别。需要深度方案或遇到边界情况时读取。