disk-sentinel

DSH Disk Sentinel / 磁盘哨兵

DeepSeek Harness 的 Windows 磁盘分析与安全清理插件。安装后会在 DSH Web UI 中增加

“磁盘哨兵”入口，提供可视化磁盘扫描、软件占用排名、历史差量、AI 清理建议与开发环境迁移。

> 本项目是社区维护的非官方插件，与 DeepSeek AI 无隶属关系。

磁盘哨兵把磁盘扫描、报告、空间预估、用户确认和清理收敛为稳定工具与可视化面板，避免 AI Agent 临时生成大量 dir、Get-ChildItem 命令逐层扫描。这样既能减少耗时与 token 消耗，也让清理和迁移过程更容易审计。

核心能力

| 能力 | 说明 |

| --- | --- |

| disk_scan | WinDirStat 风格目录扫描，一次返回目录树、Top 大目录、Top 大文件和耗时 |

| clean_disk | 预定义垃圾类别清理，支持 list、estimate、clean 三段式流程 |

| dev_env_migrate | 为最近一次开发环境扫描中的目录生成一次性迁移计划，并在用户确认后执行 |

| 磁盘分析 | 在 DSH Web UI 中选择磁盘、后台扫描、取消任务、查看容量与目录占用 |

| 软件占用排名 | 从真实扫描结果中识别常见安装目录、用户数据和游戏库，展示 Top 10，并按应用跨盘聚合 |

| 扫描报告 | 保存扫描报告并以 @文件 引用发送给当前会话，让 AI 基于真实结果分析 |

| 历史差量 | 对比两次扫描报告，查看新增、消失、增长和缩小的目录 |

| 开发环境分析 | 扫描路径型环境变量与常见开发缓存，识别真实生效路径并提供安全迁移入口 |

界面预览

插件入口

磁盘分析

扫描结果

开发环境分析

安全设计

清理工具遵循固定流程：

list -> estimate -> 用户确认 -> clean

estimate 只预估空间，不删除文件；clean 才会执行不可逆清理。Web 面板的全盘扫描通过 /disk-sentinel RPC 通道直连宿主，不经过 LLM，也不需要在提示词中指定底层扫描命令。

插件会保护磁盘哨兵工作区目录，避免删除扫描报告等 DSH 自身运行数据。

开发环境迁移会重新校验扫描来源、系统保护目录、源目录、目标盘和持久配置状态。目标必须位于其他磁盘，并至少保留源目录体积 105% 的可用空间。空目标目录可以直接使用；目标目录已有内容时必须二次确认，原内容会先整体备份再由迁移内容替换。执行时先复制并校验数据，再切换配置；成功后原目录会改名保留为备份，失败时会尝试恢复配置和源、目标目录。

预定义清理类别

| ID | 名称 | 说明 |

| --- | --- | --- |

| windows_temp | Windows 临时文件 | %TEMP%、%TMP%、C:\Windows\Temp |

| windows_prefetch | Windows 预读取 | C:\Windows\Prefetch |

| windows_update_cache | Windows 更新缓存 | C:\Windows\SoftwareDistribution\Download |

| recycle_bin | 回收站 | 通过 Shell COM 对象清空 |

| npm_cache | npm 缓存 | npm cache clean --force |

| pnpm_store | pnpm store | %LOCALAPPDATA%\pnpm-store |

| yarn_cache | Yarn 缓存 | yarn cache clean |

| pip_cache | pip 缓存 | pip cache purge |

| thumbnail_cache | 缩略图缓存 | thumbcache_.db、iconcache_.db |

| windows_logs | Windows 日志 | C:\Windows\Logs、C:\Windows\Panther |

| memory_dumps | 内存转储 | C:\Windows\Minidump、MEMORY.DMP |

| edge_cache | Edge 浏览器缓存 | Cache、Code Cache |

| chrome_cache | Chrome 浏览器缓存 | Cache、Code Cache |

| delivery_optimization | 传递优化缓存 | Windows P2P 更新分发缓存 |

| dns_cache | DNS 客户端缓存 | ipconfig /flushdns |

安装

从 GitHub 安装（推荐）

前置要求：Windows 系统，并已安装 DeepSeek Harness（dsh）。

dsh plugin --profile web add git+https://github.com/wee-b/disk-sentinel.git
dsh web

仓库已提交构建后的浏览器端文件，从 GitHub 安装不需要另外安装 pnpm 或执行构建。

启动 DSH 后，侧边栏设置区域附近会出现 磁盘哨兵 入口。

更新

使用最新版源码重新安装：

dsh plugin --profile web remove @dsh-plugin/disk-sentinel