用途:统计 SOIA 受管配置、状态、缓存和临时目录的空间占用,生成可清理清单并提醒删除风险;只有客户看过最新清单并明确授权后才执行删除,随后复核实际释放空间。触发语包括「检查 SOIA 占用」「统计缓存大小」「清理临时文件」「清理过期状态」「释放磁盘空间」;不用于未经授权的全盘清理。
主要能力:只读扫描各类别大小、文件数和可清理大小;按时效、容量、安全标记和活动状态分类为可清理、需授权、禁止清理;生成带 30 分钟有效期和 plan_digest 的清理计划;授权后按计划删除并复核删除数量、字节数、失败/跳过项和磁盘空闲变化。
使用方式:客户用自然语言提出目标,无需操作终端。扫描运行 python3 scripts/storage_cleanup.py scan --json;生成计划运行 python3 scripts/storage_cleanup.py plan --json;授权后运行 clean 命令并带 --plan、--plan-digest、--confirmed-plan-id、--authorization-id、--authorized-at、--acknowledge-risk CUSTOMER_APPROVED_IRREVERSIBLE_DELETE、--execute --json;复核运行 verify --receipt <managed-receipt-path> --json。安装可用 claude plugin install soia-env@soia,或 npx skills add soia-team/soia-open-env-skills -g -a '*' -s soia-env-storage-cleanup -y。依赖 Python 3.10+。
适用场景:SOIA 受管目录空间占用排查与过期缓存、临时文件、审计状态清理。
限制:只清理 SOIA 标准受管目录,不扫描整个磁盘,不删除普通下载、项目、照片、文档或其他应用数据;配置永不自动清理;拒绝受管根目录外路径、符号链接、设备、socket、非普通文件、活动目录、安全标记本身、无有效标记的 state 文件、计划后变化的候选以及配置、凭据和客户交付物。模糊的「继续」「随便处理」不构成授权;计划超 30 分钟、摘要不匹配、候选或策略变化、范围修改时须重新扫描并重新授权。不读取文件正文,不保存账号或凭据。WorkBuddy 需单独安装。