sifty

Sifty 是一款面向 Windows 的开源维护工具，定位为“从保留项中筛出垃圾”。它强调难以被误用：预览每一项更改、只删除到回收站、并且可以撤销任何一次清理。它提供可脚本化的 CLI 以及全屏终端 UI（TUI）两种使用方式。

用途与定位 Sifty 用于 Windows 系统维护，清理垃圾与缓存、分析磁盘使用情况、查找重复文件，并管理应用、启动项和更新。它还针对开发者机器常见的杂乱项：零散的 node_modules 与构建输出、孤立的 git worktree、以及膨胀的 WSL2 磁盘。

主要能力 清理垃圾类别在执行 sifty junk scan 或 sifty junk clean 时，引擎会针对 junk_categories() 中直接提取的以下类别进行清理。 始终启用的类别包括：

• user-temp：按用户的临时文件（%TEMP% 或 %TMP%）。
• thumbnail-cache：资源管理器缩略图和图标缓存（会自动重建）。
• browser-cache：Chrome、Edge、Brave、Vivaldi 和 Firefox 配置文件的磁盘缓存（绝不涉及 cookies、历史记录或密码）。
• winget-cache：WinGet 下载的临时安装文件。
• onedrive-logs：OneDrive 同步诊断日志（会自动重建）。
• discord-cache：Discord、PTB 和 Canary 频道的磁盘缓存（绝不涉及登录会话数据）。
• crash-dumps：按用户的崩溃转储和错误报告（CrashDumps、WER）。
• windows-temp（需要管理员权限）：系统范围的临时文件（C:\Windows\Temp）。
• windows-update-cache（需要管理员权限）：Windows 更新遗留的已下载更新包。
• event-log-archives（需要管理员权限）：旧的 Windows 事件日志归档（Archive-*.evtx）。活动日志不受影响。
• defender-history（需要管理员权限）：Windows Defender 扫描检测历史日志。
• system-crash-reports（需要管理员权限）：系统范围的崩溃报告和内核小型转储（WER、Minidump）。 默认关闭、需要通过配置选择启用的类别包括：
• downloads-installers：Downloads 文件夹中的安装程序文件（.exe / .msi）。可通过 sifty config set junk.include_downloads_installers true 启用。
• windows-old（需要管理员权限）：功能更新后上一版 Windows 安装的残留（C:\Windows.old）。可通过 sifty config set junk.include_windows_old true 启用。

使用方式 CLI：可脚本化执行清理与检查命令。如果不想安装 Python，可从最新 release 下载独立的 sifty.exe。 TUI：sifty tui 打开全屏应用，带七段侧边栏（Home、Clean、Disk、Apps、Monitor、Reports、AI）。

• Home：卷容量仪表盘和 Run checkup 按钮，可一次扫描全部内容；发现的问题会带有就地修复按钮（清理垃圾、清理过期下载、应用更新，每项都有确认）。
• Clean：Junk / Purge / Optimize / Smart cleanup 集中在一个入口下（标签页）。
• Apps：已安装 / 更新 / 启动 / 服务，支持模糊过滤、排序、批量卸载，卸载后自动进行残留扫描。
• AI：代理式聊天，提出的工具运行会在对话中内联显示 Run/Skip 按钮，扫描结果带有后续操作按钮。对话在重启后持续保存，Sifty 会学习你经常清理哪些类别、拒绝哪些操作，以便建议更贴合你的实际使用习惯。 快捷键：Ctrl+P 打开命令面板（跳转到任意屏幕），F2 提权，Space 标记行以进行批量操作。Reports 屏幕显示随时间回收的空间，并有 Undo last clean 按钮。

AI 设置（可选）

1. 安装 Ollama 并启动。
2. 拉取已配置的模型：ollama pull qwen2.5:3b。
3. sifty ai status 应报告 “running”。 可选 AI 助手通过 Ollama 本地运行：数据不离开你的机器，且它只会看到文件元数据（名称、大小、路径），永不接触文件内容。AI 永不删除任何内容，只提供建议；高风险工具调用始终需要你批准。

安全机制 由于 Sifty 会删除文件并更改系统状态，因此被设计成难以误用：

• 默认预演（Dry-run）：每个破坏性命令都会预览将要执行的操作；实际更改需要显式 --apply。
• 仅回收站，绝不永久删除：所有删除都通过一个由 Send2Trash 支持的 trash() 函数完成，sifty undo 可恢复上一次清理。
• 受保护路径：C:\Windows、Program Files、ProgramData、驱动器根目录和个人资料根目录即使在 --apply --yes 下也会被拒绝。
• 审计日志：每次实际执行的删除都会记录在 %APPDATA%\sifty\audit.log。

适用场景 适合 Windows 桌面用户和开发者进行常规系统维护、磁盘空间回收、重复文件查找、应用与启动项管理、更新管理以及开发者环境清理。

限制与要求

• 仅支持 Windows 平台。
• 部分操作（Windows 临时文件、更新缓存、某些卸载）需要管理员终端。sifty doctor 会提示是否已提权，sifty --admin <cmd> 会通过 UAC 重新以提权方式启动。
• AI 功能为可选，需要本地安装 Ollama 并拉取模型。
• 配置位于 %APPDATA%\sifty\config.toml；sifty config set 仅写入你更改的键，升级时默认值仍会生效。

架构 采用分层设计：轻薄前端依赖 core；core 依赖 windows / infra；不允许反向导入。GUI 也可以调用同一批引擎函数（junk.scan、disk.find_duplicates、checkup.run_checkup）而无需重写。设计依据见 docs/ARCHITECTURE.md。安全护栏是仓库中测试最充分的代码；Windows 环境被 mock，因此测试套件也能在 CI 上运行。

许可证 MIT © Amine Zouaoui