安全释放磁盘空间的清理顾问
CLI 给决策、TUI 给探索、GUI 给人工清理。扫描只读,删除默认进回收站,每一步都留审计日志。
一条命令出空间简报:主要占用、风险分类、Top 50 文件明细,直接给决策。
diskoala all — 安全全盘扫描diskoala plan 20g — 生成释放方案diskoala explain PATH — 解释每个判断终端里交互浏览:上下导航、文件/目录模式切换、选中即见元数据与风险解释。
j / k — 上下导航f / d — 文件/目录模式/ — 换路径扫描图形界面人工清理:风险筛选、treemap 占用图、按目标自动勾选,删除必须人来点。
扫描结果按三级风险分类,每一项都给出分类理由和更安全的下一步。系统路径永不建议删除。
safe
node_modules、dist、target、各类缓存——可重建的构建产物,确认项目不在运行即可清理。
review
压缩包、大媒体、备份归档、下载残留——有价值与否只有你知道,逐项确认后处理。
risky
Windows、Program Files、pagefile.sys——系统受管路径,双重锁定,只建议走系统设置。
~/.diskoala/cleanup-log.jsonl,随时可查。便携单文件,无需安装 Python,拷到 U 盘也能跑。当前版本 v1.2.0。
SKILL.md + 便携 CLI,教你的 agent 走「扫描 → 解释 → 方案 → 把删除交还用户」的安全工作流。
下载 diskoala-skill-cli.zip…所有发布文件的 SHA-256 汇总在 SHA256SUMS.txt,与上方卡片一致。PowerShell 对比:
Get-FileHash .\diskoala.exe -Algorithm SHA256
exe 未做代码签名,Edge/Defender 可能提示「Windows 已保护你的电脑」:点「更多信息 → 仍要运行」。让 agent 安装时建议直接用命令行下载(不触发 SmartScreen):curl -O https://diskola.kodingstudio.xyz/download/diskoala-skill-cli.zip
手动链路同样一等公民:下载 zip → 校验哈希 → 解压 → 运行 install-skill.cmd。install.ps1 是短小的纯文本脚本,可先在浏览器打开审阅再运行。
macOS / Linux:克隆仓库后在 yao-scai-cli 下运行 ./install.sh(无第三方依赖,TUI 用标准库 curses)。
把 Diskoala 装进 agent 环境后,直接说「C 盘满了帮我看看」就行。Agent 只做只读分析与方案,删除永远回到你的手里。
irm https://diskola.kodingstudio.xyz/install.ps1 | iex
mkdir -p ~/.agents/skills/diskoala && curl -fsSL https://diskola.kodingstudio.xyz/SKILL.md -o ~/.agents/skills/diskoala/SKILL.md
需要 agent 代为清理?标配 diskoala-trash.ps1:默认 dry run,你逐项确认后才 -Yes 移入回收站;系统路径硬拦截,全程审计日志。