dsh-disk-cleaner：Windows 磁盘空间分析与安全清理插件

前言¶

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在 Windows 环境下进行磁盘管理，通常面临操作风险高、误删系统文件后果严重的问题。dsh-disk-cleaner 旨在解决这一痛点，为开发者与用户提供一套安全的磁盘空间分析与清理方案。

插件定位¶

名称：dsh-disk-cleaner
维护者：L3n3L
分类：客户端
许可证：MIT

插件围绕“先看清，再决定”的原则设计，通过扫描、解释、确认、清理和结果复核建立完整流程。它默认保护系统目录、应用目录和用户重要文件。

核心功能¶

插件提供以下能力：

1. 空间总览与分析：对 C 盘进行空间总览，按分类（如临时文件、缓存、日志等）展示占用情况。
2. 智能识别：识别临时文件、缓存、日志和大文件。
3. 建议说明：提供清理建议的原因、大小和风险说明。
4. 安全预览：清理前提供预览功能，用户需确认后方可执行。
5. 白名单校验：通过白名单路径校验，优先使用回收站或隔离区。
6. 结果反馈：展示清理进度、跳过原因及最终结果报告。
7. 历史记录：提供可撤销的清理历史，防止误操作。

当前状态与安全原则¶

目前该插件仓库已创建，正在搭建扫描器、规则引擎和 Web 工作台。删除能力将在安全边界和测试完善后开放。

安全设计遵循以下原则：

• 确定性规则：AI 负责解释和推荐，但确定哪些文件可以处理的必须是确定性的规则和白名单。
• 默认保护：不默认删除任意路径。
• 隐私安全：不会把用户文件上传到外部服务。

安装与启用¶

该插件作为 DSH 的一个模块存在，依赖于 @deepseek-ai/cordis。安装时需确保满足 peer dependencies 要求（Node.js >= 22, @deepseek-ai/cordis ^4.0.1）。

DSH 通过配置文件引入插件。根据 package.json 中的配置，插件通过 dsh.bundle.patch 字段进行集成。具体启用方式需参考 DSH 的标准插件加载机制。

典型用法¶

使用流程主要包含以下步骤：

1. 启动扫描：插件启动扫描器，分析 C 盘空间占用。
2. 查看分类：通过 Web 工作台查看各分类的占用详情。
3. 预览与确认：查看具体的文件列表、大小及风险说明，确认清理项。
4. 执行清理：在确认后，插件利用确定性规则执行清理，并优先移至回收站或隔离区。
5. 查看报告：清理完成后，查看进度、结果及可撤销的历史记录。

适用场景与注意¶

• 适用场景：C 盘空间不足，需要安全地清理临时文件、缓存或日志；需要了解磁盘占用结构的开发者或用户。
• 注意事项：
  • 插件以 DSH 进程权限运行，请确保信任源码。
  • 目前删除能力尚未完全开放，部分清理操作可能处于测试阶段。
  • 安装前请检查源码与许可证（MIT）。

总结¶

dsh-disk-cleaner 提供了一套安全、可控的 Windows 磁盘管理方案。它通过白名单机制和可撤销历史，降低了误删风险，适合需要在 DSH 环境中集成磁盘清理功能的开发者使用。

查看插件详情
访问 GitHub 仓库