C盘清理搭子
好知行FED出品。基于 niuhai/skill-c-cleaner 的非官方社区适配,来源及MIT授权见 NOTICE.txt、LICENSE.txt。支持 Windows 10/11,Windows PowerShell 5.1或PowerShell 7,且当前环境允许执行本地脚本。无需Python、Node.js、外部MCP或其他Skill。WorkBuddy必须提供本地终端和文件读写能力;无此能力时说明限制,不能伪造扫描结果。
开始前
先读 @references/windows-and-safety.md。技能文件相对安装目录解析;报告保存到用户指定的工作目录,不写入技能安装目录,不上传扫描报告。对话中解读报告仍会使用宿主模型,不宣传完全不消耗Token或保证释放多少GB。
“分析”“看看”“C盘满了”只授权诊断,不能据此删除文件。用户说“清理”但没有确定具体清单时,先完成扫描和预览。保留用户已明确给出的范围;确认清单后只执行选中的项目,不扩大目标。
1. 扫描与报告
先检查当前宿主的PowerShell版本、可执行文件路径与执行策略,选择可运行本地脚本的Windows PowerShell或PowerShell 7;不要硬编码其他AI客户端私有运行时路径。若默认powershell.exe受限且没有允许的替代环境,停止脚本执行并说明限制,不绕过策略。使用终端获取Windows版本及C盘可用空间;不默认提升管理员权限、不修改执行策略。以用户指定的输出文件夹运行:
powershell.exe -NoProfile -NonInteractive -File '<技能目录>\scripts\scan.ps1' -Categories 'B,D' -OutputDirectory '<用户输出目录>'
尖括号必须替换成真实绝对路径。宿主使用PowerShell 7时也可调用pwsh.exe。参数与分类见 @references/diagnosis.md。默认B、D检查临时和浏览器缓存;需要AI工具、聊天软件、大文件等再选择对应分类,避免未经需要就全盘扫描。扫描写入独立运行目录中的报告和日志,不修改被扫描的数据。
读取返回的JSON报告、Status、FailedCategories与MeasurementWarnings;Status为partial时不得报告扫描完整成功。拒绝访问、跳过链接、部分扫描或扫描异常必须标明,不将未知当零。上游safe、cleanable、总额度只是候选标签,不能当删除授权;文件夹较大不等于里面都是垃圾。先展示最大的几个占用来源、具体路径、大小、风险和建议,包含个人数据的目录单独标出。父子目录、硬链接、虚拟磁盘可能重叠,不能简单相加。不要原样转发上游Markdown中的固定页面文件配置或卸载建议。
2. 预览可处理文件
先读 @references/cleanup.md。本版自动清理仅限当前用户C盘 LocalAppData\Temp 内、创建和修改时间均早于7天的普通文件。默认只预览,不删除目录、不清空回收站,不附带上游的一键批量cleaner。
powershell.exe -NoProfile -NonInteractive -File '<技能目录>\scripts\temp-cleanup.ps1' -Mode Preview -PlanPath '<报告目录>\temp-plan.json'
可用ScopePath缩小到Temp中的某个子目录,不能把桌面/下载/应用数据当作Temp。PlanPath使用Temp外的新文件名。读取计划Items,展示路径、大小及“永久删除、不经过回收站”的后果;年龄较老也不代表文件无用。提醒保存正在编辑的工作,使用中的文件应保留。扫描Limited为true时说明只完成部分检查。
3. 确认与执行
只有用户确认了具体清单或明确列出要处理的项,才将所选ID传入:
& '<技能目录>\scripts\temp-cleanup.ps1' -Mode Apply -PlanPath '<原计划绝对路径>' -ItemId @('已确认的ID1','已确认的ID2') -ConfirmDelete
此示例在PowerShell中执行;不要把数组语法当字符串传给其他shell。脚本拒绝越界路径、junction/符号链接、24小时之前的计划、过新或自预览以来已变化的文件。拒绝、锁定或无权访问时记录原因,不提权、不接管所有权、不强杀进程后重试。诊断引擎已移除批量删除函数;不能另写递归删除命令绕过这个入口。
其他应用缓存通过软件设置或其官方命令处理,具体方案先列给用户。微信/QQ聊天记录、WPS备份和云同步、浏览器账号、Downloads、项目、模型、运行时不是可随意删除的缓存。WinSxS、Windows.old、更新缓存、虚拟磁盘等走Windows或厂商官方入口,不能手动删除系统目录或执行磁盘压缩、修改页面文件、关闭休眠。迁移只给方案,不自动创建链接或剪切整个AppData。
4. 验证与交付
执行前会先建立JSONL回执,每行是独立JSON,读取result事件区分删除、跳过、失败;attempt事件只表示尝试,不能当成功。若回执无法创建则不会开始删除,若写入中途失败会停止后续处理。复查处理路径,重读C盘可用空间。报告“逻辑文件字节”和“可用空间实测变化”,两者不能混淆,后台写入也可能抵消增量。未运行删除时明确“仅完成预览”。提供报告与回执绝对路径。不会自动创建定时清理、后台驻留或遥测上传任务。