AI缓存清道夫

安装

1. 拿到 AI缓存清道夫_v0.3.2.zip 后，解压到任意有写入权限的文件夹（不建议放在 C:\Program Files 这类需要管理员权限的位置）。
2. 主程序未做数字签名，Windows 首次运行时可能提示“未知发布者”。点击“更多信息”，再选择“仍要运行”即可。

启动

1. 打开解压后的文件夹，双击 AI缓存清道夫.exe。
2. 启动后会看到主界面：

扫描本机 AI 终端残留

这个功能做什么：在你不做任何选择的情况下，先把本机 AI 工具留下的缓存、日志、会话、配置和更新包找出来，列成清单。

操作步骤：

1. 点击左上角的【开始扫描】。
2. 扫描过程中，按钮会变成不可点状态，旁边显示“扫描中…”。如果扫描时间较长，可以点【停止】保留已发现的结果。
3. 扫描结束后，四张概览卡和结果表会自动填充。

操作后你会看到：顶部显示“扫描完成”，四张卡片分别给出“可放心清理”“需要你确认”“已受保护”“条目/文件”的合计；结果表按“智能推荐”排序，又大又久没动的条目排在前面。

扫描只覆盖本机固定磁盘上的用户目录和 AppData；映射盘、网络共享盘不会进入扫描范围。遇到没有权限的目录会跳过，不会弹窗打扰你；早于 2010 年的异常时间会被标成“时间未知”，避免被误判成“很久没动”。

看懂 S / A / B / C 四级

这个功能做什么：用四个等级告诉你每个条目“能不能删、删了会怎样”。等级不是装饰，它决定默认勾选状态和后端是否放行。

操作步骤：

1. 在结果表里看“等级”列，S 是绿色、A 是黄色、B 是蓝色、C 是红色锁标记。
2. 想展开某个终端时，点击它左边的三角箭头。

操作后你会看到：展开后能看到该终端下的子项，以及每个子项的等级、大小、文件数和最近修改时间。C 级条目前面没有复选框，只显示锁标记和“禁止清理”。

查看终端明细

这个功能做什么：把某个 AI 工具占用的空间拆开看，判断哪一块最值得处理。

操作步骤：

1. 在结果表里展开对应终端，例如 .codex。
2. 查看每一行的“分类”“大小”“文件数”“最近修改”“状态”和“说明”。
3. 把鼠标停在“名称”或“说明”上，可以看到完整路径和操作建议。

操作后你会看到：同一个终端下的日志、会话、缓存、配置分开显示，大小和文件数各自统计；标记为 C 的凭据会单独列出，提醒你“本工具永不清理”。

筛选、排序与搜索

这个功能做什么：条目多的时候，快速缩小范围，只看你关心的等级、大小或终端。

操作步骤：

1. 在左侧“等级”里勾选想看的等级（默认四级全显示）。
2. 在“体积下限”里选择 10 MB、100 MB、500 MB 或 1 GB，只看超过该体积的条目。
3. 在“排序”里切换“智能推荐”“大小↓”“文件数↓”“最久未修改”等。
4. 在“终端（点击筛选）”里点选某个终端，只看它名下的条目。
5. 在“搜索”框输入路径关键词或终端名。

操作后你会看到：结果表立即按你的条件刷新；底部“已选”区域只统计当前勾选的条目。清空搜索框或把条件改回“不限”，清单会恢复。

试算并清理

这个功能做什么：在真正删除之前，先给你一份清单，写清要删什么、能回收多少、哪些会归档、哪些会被安全规则拦下。

操作步骤：

1. 在结果表里勾选要清理的条目（S 级默认已勾选；A 级需要你自己勾）。
2. 点击右下角的【试算并清理】。
3. 在确认框里检查：本次清理多少项、估算回收多少、哪些会先归档、哪些不会归档、最大的几项是什么。
4. 点击【确认清理】执行；如果不想删，点击【取消】，不会做任何改动。

操作后你会看到：确认框顶部固定显示三条警示，其中第一条明确写着“本次删除不经过系统回收站，文件将被直接移除”。如果选中了 A 级或 B 级，还会追加对应提醒。执行完成后会弹出“清理完成”报告，显示实际释放、估算回收、已删除项数、可还原与不可还原项数。

清理完成后，主界面底部状态栏会显示“完成：实际释放…，删除…项”。如果想看清理后的最新占用，再点一次【开始扫描】即可。

注意：删除不经过系统回收站。S 级不归档，删了不能还原；A 级默认先归档、B 级强制归档，只有已归档并校验通过的条目才能在“清理记录”里还原。

清理记录与还原

这个功能做什么：查看每一次清理的结果，并对已归档的条目执行还原。

操作步骤：

1. 点击菜单栏【工具】→【清理记录与还原】。
2. 在记录列表里看时间、估算回收、实际释放、条目数、可还原、不可还原和状态。
3. 选中一条记录，底部会显示记录文件名和详情；如果该记录有可还原项，【还原选中记录（仅已归档项）】按钮会变为可用。
4. 点击还原，软件会把归档副本放回原路径；如果原路径已有同名文件，会加 .restored-时间 后缀，不会覆盖现有文件。

操作后你会看到：还原成功的条目回到原位置；未归档的条目在记录里显示“不可还原”，不会给出能点的还原按钮。

为什么“实际释放”有时比“估算回收”小，甚至显示 0 B？因为归档会先复制一份到归档区，复制占用的空间和删除释放的空间会相互抵消。实际释放始终以磁盘剩余空间的前后差值为准，软件不会拿估算值冒充。

瘦身建议

这个功能做什么：根据扫描结果给出只读建议，告诉你哪些终端可能不再使用、哪个文件特别大、哪些缓存占用高。它不会自动删除或修改任何东西。

操作步骤：

1. 先完成一次扫描。
2. 点击菜单栏【工具】→【瘦身建议】。
3. 在列表里浏览建议；选中一条可以在下方看到详细说明。
4. 如果建议的动作是“在列表里选中”，点击后弹窗会关闭，并回到主窗口把对应条目勾选出来；是否清理仍由你走一次完整的确认流程。

操作后你会看到：每条建议只说明问题和建议动作，没有“立即清理”“自动执行”按钮。建议的触发条件都来自扫描到的事实，例如体积、最近修改时间、文件数；时间未知的目录不会参与“久未使用”判断。

SKILL / AGENT 盘点

这个功能做什么：把散落在各终端目录里的技能、命令、插件、MCP 配置和 AGENTS.md/CLAUDE.md 等规范文件列清楚，让你知道自己的“能力资产”在哪里、占多少。它只盘点，不清理。

操作步骤：

1. 先完成一次扫描。
2. 点击菜单栏【工具】→【盘点 SKILL/AGENT 文件】。
3. 展开分组查看每一处的位置和大小。
4. 选中一条，点击右侧【打开所在文件夹】可以在资源管理器里定位。

操作后你会看到：分组按技能目录、自定义命令、插件目录、MCP 配置、AGENTS.md 规范、.cursorrules 等归类；底部汇总发现多少处、多少文件、占多少空间。

设置

这个功能做什么：调整清理行为、扫描参数，并查看归档区、清理记录和扫描缓存的占用。

操作步骤：

1. 点击菜单栏【工具】→【设置…】。
2. 在“清理行为”里可以开关“清理会话历史/配置前先归档一份”，选择归档保留时长（3/7/14/30 天），以及是否允许清理 B 级。
3. 在“扫描”里可以设置并行线程数、默认排序、是否把可移动盘也纳入扫描。
4. 在“本机占用”里查看归档区、清理记录、扫描缓存的占用，并可清理过期归档。
5. 点击【保存】生效；点击【取消】不修改。

操作后你会看到：设置立即写入，下次清理按新设置执行。软件不提供“跳过确认”“定时自动清理”开关；删除方式固定为直接删除、不经过回收站。

B 级默认不可勾选。只有在设置里打开“允许清理 B 级”后，B 级条目才可勾选；删除前仍会强制归档，并给出专项提醒。C 级不受任何设置影响，永远不可删。

导出清理报告

这个功能做什么：把最近一次清理的结果导出成 JSON 和 CSV，方便留档或做表。

操作步骤：

1. 先完成一次清理。
2. 点击菜单栏【文件】→【导出报告…】。
3. 选择保存位置和文件名，确认。

操作后你会看到：同一位置会生成一个 .json 和一个 .csv 文件。报告包含路径与统计信息，不包含任何文件正文；CSV 带 UTF-8 BOM，可以直接用 Excel 打开。没有清理记录时，软件会提示“没有可导出的清理记录”，不会生成空文件。