v1.2.0 Windows 10/11 免费 · 离线可用

Diskoala 磁盘考拉

安全释放磁盘空间的清理顾问

CLI 给决策、TUI 给探索、GUI 给人工清理。扫描只读,删除默认进回收站,每一步都留审计日志。

✓扫描全程只读,不碰任何文件
✓删除默认进回收站,可恢复
✓每次删除写入审计日志

三个入口,一件事:安全地把空间还给你

>_

CLI

一条命令出空间简报:主要占用、风险分类、Top 50 文件明细,直接给决策。

  • diskoala all — 安全全盘扫描
  • diskoala plan 20g — 生成释放方案
  • diskoala explain PATH — 解释每个判断
▤

TUI

终端里交互浏览:上下导航、文件/目录模式切换、选中即见元数据与风险解释。

  • j / k — 上下导航
  • f / d — 文件/目录模式
  • / — 换路径扫描
▦

GUI

图形界面人工清理:风险筛选、treemap 占用图、按目标自动勾选,删除必须人来点。

  • 高风险项双重锁定,无法勾选
  • 回收站 / 永久删除两种模式
  • 明暗主题 · 完全离线

安全模型:先解释,再动手,永远可追溯

扫描结果按三级风险分类,每一项都给出分类理由和更安全的下一步。系统路径永不建议删除。

可安全关注 safe

node_modules、dist、target、各类缓存——可重建的构建产物,确认项目不在运行即可清理。

需要确认 review

压缩包、大媒体、备份归档、下载残留——有价值与否只有你知道,逐项确认后处理。

高风险锁定 risky

Windows、Program Files、pagefile.sys——系统受管路径,双重锁定,只建议走系统设置。

删除只发生在 GUI默认移入回收站(可恢复);永久删除需两步红色确认,5 秒自动解除。
全程审计每次删除动作追加写入 ~/.diskoala/cleanup-log.jsonl,随时可查。
服务端再校验每次删除调用都会重新过滤高风险与重叠路径,不只靠前端。

下载

便携单文件,无需安装 Python,拷到 U 盘也能跑。当前版本 v1.2.0。

CLI / TUI

命令行扫描、解释、生成方案。装完即得 diskoala 命令(兼容旧名 scai / bf / scan)。

Windows·~9 MB
下载 diskoala.exe
SHA-256…

GUI

图形界面人工清理。双击即用,需要系统 WebView2(Win10/11 自带)。

Windows·~18 MB
下载 diskoala-gui.exe
SHA-256…

Agent Skill 包

SKILL.md + 便携 CLI,教你的 agent 走「扫描 → 解释 → 方案 → 把删除交还用户」的安全工作流。

Windows·~9 MB
下载 diskoala-skill-cli.zip
SHA-256…

下载后校验完整性

所有发布文件的 SHA-256 汇总在 SHA256SUMS.txt,与上方卡片一致。PowerShell 对比:

PowerShell
Get-FileHash .\diskoala.exe -Algorithm SHA256

SmartScreen 拦截了下载?

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)。

给你的 Agent 装一个磁盘顾问

把 Diskoala 装进 agent 环境后,直接说「C 盘满了帮我看看」就行。Agent 只做只读分析与方案,删除永远回到你的手里。

PowerShell
irm https://diskola.kodingstudio.xyz/install.ps1 | iex
curl (SKILL.md)
mkdir -p ~/.agents/skills/diskoala && curl -fsSL https://diskola.kodingstudio.xyz/SKILL.md -o ~/.agents/skills/diskoala/SKILL.md
1扫描 — 只读统计占用与风险
2解释 — 每一项为什么能删/不能删
3方案 — 按目标生成释放计划
4交还 — 删除由你在 GUI 完成

需要 agent 代为清理?标配 diskoala-trash.ps1:默认 dry run,你逐项确认后才 -Yes 移入回收站;系统路径硬拦截,全程审计日志。