简体中文 · English
一个面向 AI/Codex 的 Windows C 盘扫描与安全清理技能。它不会把“清理 C 盘”变成一次冒险的批量删除,而是让 AI 按步骤完成:先扫描、再解释、按风险建议、逐项确认、精确清理、复核释放空间,并继续展示剩余选项。
请从 GitHub 仓库 https://github.com/xiayukun/windows-c-drive-cleanup-skill 安装 Codex 技能 windows-c-drive-cleanup-skill 到当前 AI 客户端使用的标准技能目录。安装完成后,请完整读取 SKILL.md,并使用该技能扫描我的 Windows C 盘。第一阶段只读分析,不要删除任何内容;默认不显示小于 10 MB 的项目;结果直接用 Markdown 表格回复,不生成 CSV、Excel 或分析报告文件;解释每个达标文件夹大致存放什么,并把清理建议分为“推荐清理、低风险清理、选项式清理”,为每一组和每个具体应用提供可复制的触发口令。重点检查微信当前目录、退役目录、3.x 旧目录、4.x 运行目录和迁移/设备备份。任何删除都必须先展示精确路径并取得我的明确确认;如果 AI 宿主安全策略阻止已经确认的删除,请按技能规则生成带固定白名单和管理员权限检查的 CMD 文件供我审阅后手动运行。
上面的提示词同时完成“安装技能”和“开始只读扫描”。你只需要整段复制给支持技能安装的 AI。
| 特点 | 它解决的问题 |
|---|---|
| 按步骤清理 | 扫描、解释、确认、执行、复核彼此分离,不会刚扫描完就开始删 |
| 按轻重分级建议 | 区分推荐清理、低风险清理和选项式清理,重要数据不会和临时缓存混在一个按钮里 |
| 引导式交互 | 每个清理大类、每个具体应用都有可复制口令,用户可以一块一块清理,随时停止 |
| 应用级缓存分析 | 结合 AppData 路径、安装信息、进程、更新时间判断归属,不只展示陌生目录名 |
| 微信专清 | 区分微信 3.x、4.x、退役位置、运行数据和迁移备份,避免误删当前聊天记录 |
| 直接表格输出 | 默认直接在对话中展示,不额外生成 CSV、Excel、JSON 或分析报告 |
| 清理结果可核验 | 分开报告“逻辑删除大小”和“C 盘实际增加的可用空间” |
| 安全策略兜底 | AI 无法直接删除时,生成经过固定白名单校验的管理员 CMD,交给用户审阅执行 |
微信并不是永远只使用一个固定目录。Windows 电脑上可能同时存在:
- 微信 3.x 使用的
WeChat Files; - 微信 4.x 当前使用的
xwechat_files; - 修改存储位置后留下的另一个、已经退役的 4.x 目录;
AppData\Roaming\Tencent\xwechat中的运行、插件、网络和日志数据;- 升级、迁移、换设备或修复过程中产生的
BackupFiles、old_backup等备份。
版本升级、重新安装、修改保存位置或迁移未完全收尾时,旧一代目录、新一代目录和备份可能长期并存,媒体附件又往往远大于文字数据库,因此很容易出现几十 GB 甚至更多的重复占用。
更容易误判的是:新版微信应用内“搜索不到旧聊天”并不代表旧目录为空。 当前应用可能只加载当前数据库,而旧目录仍保留图片、视频、文件或历史数据库。本技能会结合目录结构、账号子目录、最近写入时间、当前配置和运行版本进行判断,把“文字是否可搜索”和“旧附件是否仍存在”分开说明。
- 扫描 C 盘压力、根目录、所有用户目录、AppData、媒体目录、开发缓存和达标大文件。
- 对每个不小于默认阈值的项目解释用途、归属证据、活动时间和潜在影响。
- 输出“推荐清理、低风险清理、选项式清理”以及应用级明细表。
- 用户通过口令选择一组、一个应用或多个指定项目。
- AI 再次核验精确路径、所有者进程、保护项和重解析点,然后执行或生成管理员 CMD。
- 清理后重新扫描,分别报告逻辑大小与实际释放空间。
- 更新“仍可选择”清单;用户可以继续下一阶段,也可以到此停止。
面向明确可再生、没有持久用户状态的内容,例如符合年龄规则的临时文件、旧崩溃转储、诊断日志和空目录。默认排除当天文件、数据库、历史记录、凭据、当前微信和 Codex 状态。
面向可以重新下载或重新生成的缓存,例如包管理器缓存、项目 .cache、旧更新下载和部分构建缓存。影响通常是下次启动、索引或构建变慢,而不是丢失源代码。
面向需要用户做决定的内容,例如:
- 微信旧目录;
- 半年未用应用缓存;
- 指定软件缓存;
- 半年未用项目产物;
- 疑似卸载残留;
- 旧安装包和更新包;
- 历史备份与旧输出。
每一块都会继续拆成具体应用或项目,用户可以只选择其中几项。
- 未经精确预览和明确确认,不删除任何内容。
- 不因为“半年没使用”就自动删除。
- 找不到卸载注册表记录,不等于应用一定已经卸载。
- 不盲删
C:\Windows、Program Files、ProgramData或整个用户目录。 - 仅分析空间时不读取聊天正文和个人文件内容,元数据足够时只看元数据。
- 应用仍在运行时跳过相关目录,不静默强制结束进程。
- 默认保护当前微信、Codex 会话/技能/配置、仓库、数据库、凭据、模型和用户指定保留的数据。
- 对宽泛根目录、通配符、变量未解析路径和重解析点执行拒绝策略。
最简单的方式是复制本页顶部提示词给 AI。手动安装时,请把仓库克隆或复制到当前 Codex 客户端的技能目录,并保持目录名为 windows-c-drive-cleanup-skill,随后重启或刷新技能发现。
示例调用:
使用 $windows-c-drive-cleanup-skill 扫描我的 Windows C 盘。先只读分析,用表格给出分阶段清理选择,未经确认不要删除。
SKILL.md:技能入口、工作流和安全约束agents/openai.yaml:Codex 展示名称和默认提示词scripts/inventory-storage.ps1:按阈值进行完整目录/文件清单扫描scripts/analyze-wechat-storage.ps1:微信目录代际、活跃度和账号结构分析scripts/cleanup-preview.ps1:只读清理候选预览scripts/discover-storage.ps1:快速查看 C 盘压力和热点scripts/check-boundary.ps1:存储边界与迁移建议references/:AppData、微信、清理菜单、热点和边界详细规则
本项目最初参考并仿照了 Quehd/windows-disk-boundary-manager。特别感谢 Quehd 提供“发现(Discover)—治理(Govern)—边界(Boundary)”的原始设计,并以 MIT 许可证开放项目。
在原项目基础上,本项目继续扩展了完整阈值清单、每用户和 AppData 分层分析、应用级缓存归属、分阶段风险清理、可复制触发口令、微信多版本专项识别、对话内直接表格、实际释放空间复核,以及安全策略受限时的管理员 CMD 兜底。
使用 MIT License。原项目版权声明已保留在 LICENSE 中。