前言¶

在 DeepSeek Harness（DSH）里让模型协助排查「C 盘满了」「不知道空间被谁占掉」，常见做法是临时写脚本或把第三方工具塞进对话。问题在于：一旦脚本具备删除能力，模型误调就可能伤及数据；若只做罗列、没有分级建议，用户仍要自己翻目录。下面介绍的 dsh-disk-space 把「磁盘空间分析 / C 盘瘦身」类能力封装成 DSH 可调用的客户端插件：扫描阶段只读统计，清理建议以文本形式出现在报告里，由人审阅后再决定是否执行。

这是什么¶

dsh-disk-space 由维护者 redkiller79 发布，分类为客户端插件。它将本机磁盘占用扫描、大户排序与带三级清理建议的交互式 HTML 报告，以三个工具的形式挂载到 DSH 宿主（web / desktop Profile）。扫描与报告生成复用包内 Python 脚本，不联网、不读 API Key、不做遥测。

社区目录页：https://www.skillhub.cn/plugins/redkiller79/dsh-disk-space
源码与说明：https://github.com/redkiller79/dsh-disk-space

核心功能¶

插件向模型暴露三个工具，职责划分如下。

只读保证（作者声明）：扫描阶段只做统计与列目录；清理命令只写进报告供人审阅，插件不执行 rm / mv / 删除 / 改权限，也不清空回收站。报告中的清理命令仍是文本建议，用户若在外部 shell 误执行仍可能删掉数据，需逐条人工确认。

当前 npm 包版本为 1.0.0，许可证 MIT；扫描与报告脚本部分来自开源技能 c-drive-slimmer（MIT），本仓库增加 DSH 宿主封装层，详见仓库内 NOTICE.md、LICENSE。

环境与依赖¶

安装前需满足：

• Node.js >= 22
• Python 3（Windows 默认用 python，macOS 默认用 python3；可用环境变量 DSH_DISK_SPACE_PYTHON 指定解释器）
• DeepSeek Harness 0.2.x（package.json 声明兼容范围为 >=0.2.1-rc.1 <0.3.0）

@deepseek-ai/cordis 与 @deepseek-ai/dsh-tools 为 peerDependencies，由 DSH 宿主提供。本包无 dependencies，扫描通过子进程调用包内 scripts/scan.py、scripts/build_report.py，无网络请求。

平台：Windows、macOS；Linux 上扫描脚本会返回 unsupported_platform。

安装与启用¶

在已配置 DSH 且使用 web Profile 的环境中，按仓库 README 安装：

dsh plugin --profile web add dsh-disk-space

也可从 GitHub 源码安装：

dsh plugin --profile web add github:redkiller79/dsh-disk-space

安装后重启 dsh web（或桌面端）。插件以入口 ID dsh-disk-space 挂载。可用下列命令确认已加载：

dsh --profile web --dump-config

卸载：

dsh plugin --profile web remove dsh-disk-space

DeepSeek 官方插件市场截至资料撰写时仍处「宣布将建设」阶段；除 dsh plugin add 安装 npm 包 dsh-disk-space 外，仓库带 dsh-plugin topic 可被 DSH Index / 社区目录收录。安装前建议浏览 GitHub 源码与许可证，插件以当前 DSH 进程权限遍历用户目录、AppData / Library、下载、开发缓存等常见占用路径，并仅在系统临时目录 os.tmpdir()/dsh-disk-space/（或调用方指定的 outputPath）写入 JSON 与 HTML。

典型用法¶

在对话中可用自然语言触发扫描与出报告，README 给出示例：

帮我看看 C 盘为什么满了，出一份带图表的报告，标清哪些能删、哪些碰不得

典型流程是：先调用 diskspace_scan 得到 JSON 路径，必要时用 diskspace_inspect 按分类看明细，再用 diskspace_report 生成交互式 HTML。全盘扫描在目录极多时可能耗时数十秒到数分钟，属作者声明的主要性能风险。

适用场景与注意¶

适合在 DSH web / desktop 环境下，需要把「磁盘为什么满、大户是谁、哪些路径相对安全清理」交给模型编排、但不希望插件自动删文件的 Windows / macOS 用户与智能体开发者。

不适用 Linux 本机扫描（会报 unsupported_platform）。权限与风险以 README 为准：只读扫描仍读取大量路径元数据；写入范围限于临时目录或显式输出路径；子进程仅执行包内两个 Python 脚本，不拼接用户提供的 shell 命令。

结尾¶

dsh-disk-space 把磁盘占用分析与分级清理建议收成 DSH 客户端工具链，强调扫描只读、清理靠人。进一步了解可访问社区目录页与 GitHub 仓库：

• https://www.skillhub.cn/plugins/redkiller79/dsh-disk-space
• https://github.com/redkiller79/dsh-disk-space