前言¶

在 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