前言¶
DeepSeek Harness (DSH) 采用插件化架构，扩展能力通过插件实现。在 Windows 环境下，C 盘空间管理是常见痛点。传统磁盘清理工具往往只能执行“删除缓存”这一种动作，对于早已废弃的大体积软件、误放错盘的数据（如 Docker WSL）、以及需要通过引导改址迁移的软件配置，缺乏针对性的处理方案。
dsh-disk-manager 是一个 DSH Web UI 插件，旨在通过扫描整 C 盘，将文件/目录分门别类，并针对不同类别给出差异化的操作建议（删除缓存、引导改址、junction 搬家、提示废弃、仅提醒），且对配置与记忆类数据设置安全红线。
插件简介¶
该插件由 wangzhanchao883 维护，属于“联网工具”分类。它不依赖复杂的构建流程，直接在 DSH 的 Web 界面中运行。核心逻辑包括扫描整 C 盘（排除 Windows 系统目录）、基于静态规则和 LLM 兜底进行分类、以及通过进程快照防止对常用软件的误判。
核心功能¶
插件将扫描结果分为六类模型，每类对应不同的处理策略：
- A 类：无忧缓存（Cache/GPUCache/Temp 等）：可再生资源，可执行删除或 junction 搬家。
- B 类：官方可改址（Docker/npm/pip/浏览器 profile）：支持引导改址到其他盘。
- C 类：可 junction 搬（如剪映、Notion 等纯缓存）：支持通过 junction 命令迁移。
- D 类：冷废弃软件（大体积且超过 N 天未使用）：仅提示用户，不执行删除。
- E 类：配置/记忆红线（包含 config/storage/indexeddb/memory/database/.openviking/.qclaw）：只展示，绝不自动执行。
- P 类：个人文件（Downloads/Documents/Desktop）：仅提醒大文件，绝不自动删除或执行。
安全与兜底机制：
* LLM 兜底：未命中的未知目录会使用 DSH 自带的 LLM 进行判断（默认关闭推理，按项目规则路由模型）。
* 进程快照防误判：冷废弃检测逻辑已修正。通过快照当前运行进程并加入 Docker/WSL 等常用白名单，避免常用软件因安装目录 mtime 不更新而被误判为废弃。
* Dry-run 与 Undo：执行前提供预览，且支持生成 undo 日志以便回滚。
安装与启用¶
通过命令行安装该插件：
dsh plugin --profile web add dsh-disk-manager
安装完成后，重启 DeepSeek Harness。在设置页面会出现“C盘空间规划整理大师”标签页；在对话窗口中，可以直接运行 /disk_scan 斜杠命令，或调用 disk_scan 工具。
首次使用时，需在设置页或工具中选择目标盘，配置会写入 ~/.dsh-disk-manager/config.json。
典型用法¶
- 扫描：在设置页点击“开始扫描C盘”，或在对话中运行
/disk_scan。插件会扫描 AppData、用户区、Program Files，排除 Windows 目录。 - 查看结果：扫描完成后，报告会直接渲染在页面中。你可以看到各个分类（A-P）下的具体文件/目录列表。
- 预览与执行：选中需要处理的条目，使用
disk_preview查看将要执行的操作（Dry-run），确认无误后使用disk_execute真正执行。 - 撤销：如果误操作，可使用
disk_undo查看并执行回滚日志。
注意事项¶
- 环境依赖：需要 Windows 系统（依赖 PowerShell 和系统原生 junction 能力）、Node.js ≥ 22，以及 DeepSeek Harness 0.1.7 ~ 0.2.x 版本。
- 安全红线：E 类（配置/记忆）和 P 类（个人文件）具有最高优先级，无论 LLM 判定结果如何，系统都会强制将其设为只读展示，绝不能自动执行任何删除或移动操作。
- 权限：插件以当前 DSH 进程的权限运行，执行删除或 junction 操作前，请务必在预览阶段确认目标路径。
总结¶
dsh-disk-manager 提供了一套结构化的 C 盘管理方案，通过分类模型替代一刀切的清理逻辑，并辅以 LLM 兜底和进程快照机制，降低了误操作风险。对于需要精细管理本地存储空间的 DSH 用户，这是一个务实的工具选择。
