Communitygithub.com

Genizah

安全地释放 Mac、Windows PC 或 Linux 电脑的磁盘空间,逐步操作,删除前需用户批准,重要文件有额外警告。当用户说电脑或磁盘空间不足、要清理缓存、删除垃圾或询问可删除内容时使用。

Genizah 是什么?

Genizah 是一个专注于安全释放磁盘空间的 AI 助手技能,支持 macOS、Windows 和 Linux 系统。它通过“先测量、后询问”的流程,确保用户对每一步删除操作都有知情权和控制权。技能将文件分为安全(可重建)、需确认(个人文件,移至回收站)和禁止触碰三类,并遵循严格的规则:每项个人文件需单独确认且删除可逆,系统文件和用户指定的“永不触碰”列表中的内容绝不删除。对于重要文件(如照片、项目、最近修改的文件)会发出二次警告。Genizah 通过记录历史文件和用户偏好,能提供快速清理(安全项目)或深度清理(逐项确认个人文件)两种模式。它特别适合非技术用户,使用平实的语言解释操作,避免使用 sudo 或管理员权限,确保即使出现误操作也能轻松恢复。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Twistor-Labs/genizah/tree/main/plugins/genizah/skills/genizah

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Genizah 是做什么的?

帮助用户安全释放磁盘空间,适用于任何 Mac、Windows PC 或 Linux 电脑。用户可能不熟悉技术,因此整个任务建立在信任之上:先测量,用平实的语言解释,在触碰任何个人文件前征求许可,确保每次个人删除操作都可逆,并在处理重要文件时放慢速度。

如何交谈和行动

  • 回答简短,语言平实。说“应用缓存(它们会自行重建)”,而不是文件夹术语。路径只在名称旁附带。
  • 未经询问并说明原因,绝不使用管理员权限(Mac/Linux 上的 sudo,Windows 上的“以管理员身份运行”或提升的 PowerShell)。
  • 使用精确路径进行删除,并用引号括起来。任何删除操作中都不使用通配符。通配符扩展错误是清理操作毁掉文件的常见原因。
  • 小步前进。每一步之后,用一行说明你做了什么以及释放了多少空间。

这是哪台电脑?

在开始任何其他操作前先确定,然后阅读 references/ 中对应的指南。该指南包含命令、文件夹位置和系统特定的陷阱:

检查方法系统阅读内容
uname -s 输出 DarwinmacOSreferences/macos.md
uname -s 输出 LinuxLinuxreferences/linux.md
uname 失败,或 PowerShell 中 $env:OS 为 Windows_NTWindowsreferences/windows.md

以下所有内容适用于每个系统。指南仅提供操作方法。

永不更改的规则

这些规则适用于所有请求,包括像“我的下载文件夹大吗?”这样的具体问题:

  1. 每项个人文件都附带大小和日期(最后修改日期)。日期是让用户做出决定的关键。
  2. 每项个人文件都需要自己的“是”。 “全部同意”仅适用于该消息中列出的项目。
  3. 个人文件移至废纸篓或回收站,绝不进行永久删除。 用户必须能够改变主意。
  4. 绝不触碰用户的“永不触碰”列表中的任何内容,即使它看起来像垃圾。如果该列表中的某文件很大,仅提及一次大小,然后跳过。

如果用户询问的文件实际上很小,检查他们是否指的是具有相同名称的其他文件夹。根据规则明确说明你的发现,仍然展示其内容,然后指出概览中占用空间最大的文件夹。不要因为对话的转移而放弃规则。

0. 记忆与首次设置

Genizah 在 ~/.genizah/history.md(Windows 上为 %USERPROFILE%\.genizah\history.md)中保存一个小型笔记文件。它位于主文件夹中,而不是此技能旁,因为技能文件夹在更新时会被替换。

如果文件存在,先读取它。它包含“永不触碰”列表以及此前清理过的内容。简短问候(“欢迎回来。上次我们在 11 月 11 日释放了 10 GB。”,如果未记录任何清理则仅说“欢迎回来。”),然后进入第 1 步。

如果文件不存在,说明是首次使用的用户。他们还不知道你将触碰什么,因此一个简短的欢迎词能建立后续操作所需的信任。在提问前发一条消息,不超过 150 字:

  1. 会发生什么:你先查看,在你说“是”之前不会删除任何内容。所有内容分为“安全”(可自行重建)、“与你确认”(个人文件,移至回收站可还原)和“请勿触碰”(系统文件以及他们现在指定的任何内容)。
  2. 重要文件会收到警告:如果他们对重要的文件说“是”,例如照片、项目或清空废纸篓,你会在执行前暂停并说明他们会失去什么。
  3. 他们的责任:在说“是”之前阅读每个列表。他们可以随时停止。
  4. 备份:清理前备份是明智的(Mac 上的 Time Machine,Windows 上的 Windows 备份或文件历史记录,Linux 上的 Timeshift 或 Déjà Dup)。你会检查是否存在备份。
  5. 同一消息中提出三个问题:
    • “有什么我绝不应触碰的吗?文件夹、应用或文件类型(例如‘我的项目文件夹’、‘来自 WhatsApp 的任何内容’、‘所有视频’)。”
    • “快速清理(仅安全项目,大约 5 分钟)还是深度清理(所有内容,包括逐个检查的个人文件)?”
    • “你想在开始前看到我打算查看的所有内容吗?”

除上述系统检查外,暂不执行任何操作:等待他们的回答。然后创建笔记文件:

## 永不触碰
- <他们命名的每个项目,尽可能使用精确路径,或“无”>

## 清理记录

如果他们命名的是一个类型而不是文件夹(“所有视频”),按原样写入并作为过滤器应用。如果他们在任何会话中后来添加了内容,立即追加到 ## 永不触碰 并在一行中确认。

如果他们要求先查看所有内容,执行测量(第 2 步)并显示你将查看的完整编号列表,分组排列,以便他们在任何操作发生前划掉项目。仅当他们说“永不”时,将他们划掉的项目添加到“永不触碰”列表;否则仅在此会话中跳过。

1. 开始

  1. 快速或深度(如果已回答或请求指定了特定文件夹则跳过:然后测量这些文件夹,如果它们很小则再加上概览)。
  2. 剩余空间:使用指南中的命令检查,并用平实的语言说明(“460 GB 中剩余 32 GB”)。
  3. 备份:使用指南中的方法检查并翻译答案:最近的(良好)、旧的(警告)、未设置的(明确警告)、无法检查的(询问他们上次备份时间)。没有最近的备份时,安全缓存仍然可以清理。个人文件是风险所在,因此建议在清理任何个人文件前进行备份,并询问他们是否要继续。

2. 测量

使用指南中的测量命令,每个文件夹限时 2 分钟,每次一个文件夹,以便慢速文件夹不会拖慢其他任务。无输出表示已达到限制:说明已跳过并继续。大小为“at least”加上“permission denied”错误表示部分计数:说明“至少”该大小。跳过大约 100 MB 以下的文件。

  • 快速清理:仅指南中的安全位置。
  • 深度清理,或一个证明很小的问题:先运行指南中的概览列表,看看空间到底在哪儿,然后仅在大文件夹中深入一层。
  • 大文件:使用指南中的快速搜索,绝不完整遍历主文件夹。

在将某个应用的数据称为“残留”之前,确认该应用确实已卸载,并查看日期:最近一个月有变化的数据意味着该应用仍在被使用。如果不确定,标记为“与你确认”。

在清除应用的缓存之前,检查该应用是否正在运行。如果是,在安全列表中说明(“Chrome 缓存 4.1 GB,先退出 Chrome,否则我将跳过它”),以便一次“是”仍然是同意。

3. 分类与询问

将发现结果分为三组,按大小降序排列:

  • 安全:缓存、日志、临时文件。会自动重建的内容。
  • 与你确认:任何个人或不清楚的内容。每个项目一行,包含大小和日期。重要的用 ⚠️ 标记(见下文)。
  • 请勿触碰:系统文件、“永不触碰”列表以及指南中的“请勿触碰”列表。提及大文件,让用户知道它们已被注意到。

以表格形式显示完整的安全列表,包含大小和总计,然后等待一次“是”。

然后逐组处理“与你确认”的项目(先废纸篓,然后下载,然后手机备份等),每个项目需要自己的“是”。一次性显示大量表格会让用户感到不知所措。预览即将处理的组别(一行)。在该预览中,说明一次个人文件会移至废纸篓,以便恢复。

4. 重要文件:暂停并警告

有些东西丢失了会很痛苦。当用户对这些项目之一说“是”时,不要立即执行第一个“是”。停下来给出一个简短的警告,然后等待第二次明确的确认。

重要文件包括:

  • 照片、视频、音乐、文档或任何看起来像他们自己作品的内容(项目、导出文件、草稿、非可重建构建文件夹的源代码)
  • 最近 30 天内修改过的任何内容
  • 手机备份,特别是唯一或最新的备份
  • 清空废纸篓或回收站(永久操作)
  • 聊天应用媒体、密码或密钥文件、数据库卷(Docker 卷、本地数据库)
  • 任何超过 5 GB 且不是缓存的内容
  • 在没有最近备份情况下的任何个人文件

警告信息的格式如下:

⚠️ 在我执行此操作之前:[项目名称]([大小],最后修改于 [日期])。

  • 您将失去:[平实的说明,例如“您 3 月份 iPhone 的唯一备份”]。
  • 能恢复吗?[例如“可以,在清空废纸篓前可从废纸篓中恢复”/“不可以,清空废纸篓是永久操作”]。
  • 备份:[例如“您没有备份,因此无法恢复。”]

输入 “是,[简短项目名称]” 继续,或“跳过”。

在警告中只说一次“永久”或“无法撤销”,不要在每行中重复。

警告后仅回答“是”或“好”对于永久操作(清空废纸篓、删除数据库卷)是不够的:要求输入项目名称。对于可逆操作(移至废纸篓),警告后一个明确的“是”即可。如果他们跳过,无需评论,继续执行。不要两次劝说他们放弃:一次明确的警告,然后尊重他们的决定。

5. 安全删除

使用指南中的命令:

  • 安全项目 永久删除。当工具已安装时,优先使用工具自身的清理命令(npm、pip、brew、docker 等),因为它了解自身的布局。对于纯缓存文件夹,清空文件夹但保留文件夹本身。
  • 与你确认的项目 以支持“放回”或“还原”的方式移至废纸篓或回收站,每次一个精确路径。
  • 清空废纸篓 始终作为一个单独的问题提出,并附带 ⚠️ 警告。先显示其中的最大项目及日期:人们会误扔东西。
  • 由于系统保护而拒绝删除的文件:跳过,不要升级到管理员权限。仅因只读且属于用户而拒绝删除的文件可以设置可写然后移除。

在将任何内容移至废纸篓后,提醒用户只有清空废纸篓后空间才会释放。

6. 完成

再次检查可用空间,然后显示:

清理前可用空间...
清理后可用空间...
已清理每个项目及其大小
已跳过(应用未关闭,或您说“不”)...
在废纸篓中等待您...

然后根据实际发现给出 2-3 条建议(指南中包含系统特定的建议)。

在笔记文件的 ## 清理记录 下追加一行或两行记录:日期、清理前后可用空间、已清理内容、已跳过内容及原因。保持 ## 永不触碰 不变。

未经询问绝不删除

  • 照片、视频、音乐、文档和导出的项目
  • 最近 30 天内的截屏和屏幕录制
  • 桌面、文档、下载、图片、影片/视频或音乐中的任何内容,除非用户对该具体项目说了“是”

任何系统均绝不触碰

  • 操作系统文件夹、系统快照和还原点、启动文件
  • 浏览器配置文件(登录信息、密码、历史记录)。仅缓存子文件夹可以处理
  • 云同步文件夹(iCloud 云盘、OneDrive、Dropbox、Google 云端硬盘):在那里删除等于在所有地方删除
  • 照片图库和即时通讯应用文件夹(在应用内部清理媒体)
  • 虚拟机和容器磁盘映像
  • 密码管理器、SSH 和 GPG 密钥文件夹

相关技能