Skip to content
 
 

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

简体中文 · English

Windows C盘清理 Skill

一个面向 AI/Codex 的 Windows C 盘扫描与安全清理技能。它不会把“清理 C 盘”变成一次冒险的批量删除,而是让 AI 按步骤完成:先扫描、再解释、按风险建议、逐项确认、精确清理、复核释放空间,并继续展示剩余选项

🚀 复制这段提示词,让 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 中的运行、插件、网络和日志数据;
  • 升级、迁移、换设备或修复过程中产生的 BackupFilesold_backup 等备份。

版本升级、重新安装、修改保存位置或迁移未完全收尾时,旧一代目录、新一代目录和备份可能长期并存,媒体附件又往往远大于文字数据库,因此很容易出现几十 GB 甚至更多的重复占用。

更容易误判的是:新版微信应用内“搜索不到旧聊天”并不代表旧目录为空。 当前应用可能只加载当前数据库,而旧目录仍保留图片、视频、文件或历史数据库。本技能会结合目录结构、账号子目录、最近写入时间、当前配置和运行版本进行判断,把“文字是否可搜索”和“旧附件是否仍存在”分开说明。

清理流程

  1. 扫描 C 盘压力、根目录、所有用户目录、AppData、媒体目录、开发缓存和达标大文件。
  2. 对每个不小于默认阈值的项目解释用途、归属证据、活动时间和潜在影响。
  3. 输出“推荐清理、低风险清理、选项式清理”以及应用级明细表。
  4. 用户通过口令选择一组、一个应用或多个指定项目。
  5. AI 再次核验精确路径、所有者进程、保护项和重解析点,然后执行或生成管理员 CMD。
  6. 清理后重新扫描,分别报告逻辑大小与实际释放空间。
  7. 更新“仍可选择”清单;用户可以继续下一阶段,也可以到此停止。

三档清理建议

1. 推荐清理

面向明确可再生、没有持久用户状态的内容,例如符合年龄规则的临时文件、旧崩溃转储、诊断日志和空目录。默认排除当天文件、数据库、历史记录、凭据、当前微信和 Codex 状态。

2. 低风险清理

面向可以重新下载或重新生成的缓存,例如包管理器缓存、项目 .cache、旧更新下载和部分构建缓存。影响通常是下次启动、索引或构建变慢,而不是丢失源代码。

3. 选项式清理

面向需要用户做决定的内容,例如:

  • 微信旧目录;
  • 半年未用应用缓存;
  • 指定软件缓存;
  • 半年未用项目产物;
  • 疑似卸载残留;
  • 旧安装包和更新包;
  • 历史备份与旧输出。

每一块都会继续拆成具体应用或项目,用户可以只选择其中几项。

安全边界

  • 未经精确预览和明确确认,不删除任何内容。
  • 不因为“半年没使用”就自动删除。
  • 找不到卸载注册表记录,不等于应用一定已经卸载。
  • 不盲删 C:\WindowsProgram FilesProgramData 或整个用户目录。
  • 仅分析空间时不读取聊天正文和个人文件内容,元数据足够时只看元数据。
  • 应用仍在运行时跳过相关目录,不静默强制结束进程。
  • 默认保护当前微信、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 中。

About

Windows C盘智能清理技能:分步扫描、风险分级、引导式清理、微信旧版本与迁移目录专项分析、安全确认后执行

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages