DEEPDRIVECLEANER / DDC 命令

为开发者和智能体打造的快速磁盘清理工具。

原生应用与 CLI,供你和你的智能体使用,共用同一引擎。

查找开发遗留文件,检查 JSON 报告,预览清理计划,再决定删除什么。

ddc.sh 是 DeepDriveCleaner 的 CLI 指南,与 deepdrivecleaner.app 介绍的是同一款产品。 了解 Mac 应用

获取 ddc 命令

v0.3.0
macOS · Apple Silicon / ARM64 · 独立 CLIdeepdrivecleaner-0.3.0-aarch64-apple-darwin.tar.gz
下载 CLI 压缩包

解压后将 deepdrivecleaner 放入 PATH,并为 ddc 添加别名或符号链接。如需同时安装应用和 CLI,请使用 Homebrew:

brew install --cask smartandpoint/tap/deepdrivecleaner

原生应用仅支持 macOS。CLI 构建版本的可用情况单独列出。

发布文件可用情况核对于 2026 年 10 月 28 日。

同一套流程:在终端中,或通过智能体。

以下是已安装工具的操作说明。此网站不会运行命令。

01

检查

执行只读扫描。智能体或脚本需要完整报告时,请使用 JSON。

ddc scan --json
02

预览计划

查看拟执行的操作,不更改文件。扫描报告不代表删除授权。

ddc clean --dry-run
03

审阅并清理

在交互式终端中检查计划、调整选择,再确认清理。

ddc clean

交互式清理需要终端。没有终端的智能体应在检查和预览后停止;不得悄悄改用 --yes。

清理会删除文件。请审阅计划,并确认你的选择。 免责声明 ↗

工具可读取的报告

JSON 报告和公开的 schema 便于检查条目与执行结果。

智能体负责构建,你来审阅清理计划。

仅为示例数据 · 并非对你设备的扫描

示例总量128.4 GiB

智能体参与的开发可能留下依赖目录、缓存和构建产物。先查看实际内容,再选择清理什么。

大小仅为示例,不是空间释放承诺。分类取决于规则与上下文。

safe

下载缓存

软件包下载缓存会在需要时重新下载。这类内容默认选中;工具支持时,清理会使用工具自身提供的命令。

~/.npm/_cacache
~/.cache/uv
Homebrew 下载缓存

默认选中。清理之前,请先检查计划。

清理前的检查

在向智能体分配清理任务前,先了解这些边界。

再次检查条目

操作前会检查文件身份、规则匹配、受保护路径等。已更改或被拒绝的条目会跳过,并说明原因。

定时扫描不会清理

后台扫描只报告条目,不会调用清理执行器。

记录执行操作

适用时,review 类条目默认移到废纸篓。其他操作可能永久删除文件,或使用工具自身的清理命令。日志不具备撤销功能。

明确选择与非交互式使用

应用使用明确的条目列表。脚本和智能体在获得预期选择的授权后,也可以使用此 API。

预览已有的选择文件

ddc clean --items selection.json --dry-run

clean --items 读取调用者提供的列表,不会询问,也不会验证是否获得了人的批准。clean --json 需要与 --items 一起使用。--yes 也会在其支持范围内跳过交互式询问。

执行前请获得对具体选择的批准。CLI 参考说明了条目格式;此处不提供可直接执行清理的条目列表。

阅读明确选择 API

这些是清理检查机制,并非沙盒,也不保证抵御提示词注入。它们无法阻止已遭入侵的智能体运行其他命令。

同一款产品:应用与 CLI,共用同一个引擎。

DeepDriveCleaner 是应用,ddc 是其命令。通过窗口、终端或编程智能体使用,两种界面共用同一套清理检查机制。

面向开发者与智能体

以智能体为先开发,欢迎你的贡献。

人和智能体通过 ProjectStore 共同开发 DeepDriveCleaner。阅读共享决策、遵循操作指南,并提出范围明确的改进。

贡献条款 ↗ · 源码可用 · PolyForm Noncommercial