前言¶
在 DeepSeek Harness（DSH）里做智能体或日常对话时，经常要在本地找文件、看体积、打开预览，或核对某次会话产出的文档。切到资源管理器再切回 DSH，路径和上下文容易断。社区插件 dsh-disk-manager（维护者 Ananpng123，分类：客户端）把卷概览、目录浏览、按需统计文件夹大小、桌面快捷方式布局以及悬停预览放进 DSH 右侧边栏，交互思路对齐 Windows「磁盘管理 / 文件资源管理器」：能浏览，写操作仅保留「删除（一律进回收站）」和「新建文件夹」，不提供分区扩展、收缩、格式化等操作。
这是什么¶
一句话：面向 Windows 10 / 11 的 DSH 侧边栏磁盘与文件管理插件；卷列表、文件夹树、地址栏跳转、工作区按会话分组的文档列表，以及部分类型的内置预览。
插件由 GitHub 仓库 Ananpng123/dsh-disk-manager 维护，当前 package 版本 0.4.2，许可证 MIT。DSH 要求 >=0.2.1-rc.5（README 标注的 tested version）；主机端依赖 Windows API 与 Windows PowerShell 5.1，无额外 npm 运行时依赖。
架构上分为两半：index.js 在 DSH 宿主进程注册 HTTP 路由（如 /api/dsh-disk）；client.js 在浏览器里渲染侧边栏。改 index.js 需 重启 DSH；仅刷新页面只会重载 client.js。
核心功能¶
下面介绍 README 中已列出的能力（均为 Windows 本地实现）。
卷与桌面
- 卷概览：各驱动器以「此电脑」式卡片展示（盘符图标、
Label (X:)、已用空间条、X free of Y）。 - 桌面停靠：桌面内容 inline 列在卷列表下方；快捷方式显示真实应用图标。
浏览与导航
- 文件夹浏览：进入任意目录；可按名称 / 大小 / 修改时间 / 类型排序，分组，紧凑或详细密度。
- 地址栏：点击变为输入框，输入路径后按 Enter 跳转。
- 多窗格：「在新标签页中打开」可为每个面板记住各自的盘符与路径。
- 悬停预览（Hover peek）：指针停在文件夹上时，浮层展示其内容（最多三层，可继续下钻）。
打开与预览
- 按类型打开：文本、代码、图片、PDF、Office 等走 DSH 内置侧边栏预览；视频、音频、压缩包用系统默认程序。
- 右键菜单：内置预览、系统打开、在资源管理器中显示、复制路径、删除（仅回收站）。
空间与写入
- 按需统计文件夹大小：右键文件夹触发测量，带 deadline 保护，避免 UI 长时间卡住。
- 新建文件夹：在目录空白处右键，输入名称就地创建；重名会提示，不会覆盖。
- 删除：右键文件或文件夹，确认一次后进入回收站（无永久删除）。
工作区文档
- 会话标题栏新增 堆叠文件夹 按钮：按 会话 分组展示当前工作区各对话产生的文档（新在上），可折叠分组；搜索框按文件名过滤；点击可在内置预览中打开。
主机端暴露的 endpoint 名称包括：volumes、ls、size、open、reveal、terminal、mkdir、info、cleanup、clipboard、icons、trash、settings（详见仓库 Layout 说明）。
安装与启用¶
先做索引或本地包安装，再重启 DSH 一次。未重启时主机路由未就绪，操作会报 backend not ready。
从插件市场（自建索引）¶
在 DSH Settings → Plugin Market 增加索引源：
https://ananpng123.github.io/dsh-disk-manager/index.json
然后在 Discover 页搜索 disk 并安装。
README 说明该插件已提交 awesome-dsh-plugin 与 Open Plugin Market 等社区索引，审核通过前也可通过上述自建 index 立即看到 listing；若需按 tag 安装，资料中的 install spec 为：
git+https://github.com/Ananpng123/dsh-disk-manager.git#v0.4.2
（具体在 DSH 插件管理器中的添加方式以你当前 DSH 版本的市场 UI 为准。）
从本地目录¶
在 DSH 内通过插件管理器：
plugin_manager install_bundle <path-to>dsh-disk-manager
经过上面的步骤并 重启 DSH 后，会话标题栏（输入框上方那一排小图标）会出现两个新按钮（见下一节）。
典型用法¶
新按钮在哪里¶
| 图标 | 提示 | 作用 |
|---|---|---|
| 显示器 | Desktop files | 以右侧边栏标签打开桌面文件夹，可就地展开树 |
| 堆叠文件夹 | Workspace files | 当前工作区各会话产生的文档，按会话分组 |
二者均以右侧边栏 标签页 打开，可同时保留多个。
磁盘面板¶
- 点击显示器图标，或在已打开的磁盘标签里点卷，进入卷列表。
- 点击某卷进入，或在地址栏输入路径后 Enter。
- 单击文件夹就地展开；双击作为独立页面打开。
- 右键文件/文件夹：预览、系统打开、在 Explorer 中显示、复制路径、删除（回收站）。
- 右键卷卡片：打开、新标签打开、磁盘检查、属性。
工作区文件面板¶
- 点击堆叠文件夹图标。
- 列表按会话分组，最新在上；点组标题折叠/展开。
- 点击文档用 DSH 内置预览打开；右键可系统打开 / 显示 / 复制路径 / 删除。
- 搜索框按文件名跨组过滤。
适用场景与注意¶
适合谁：主要在 Windows 上使用 DSH、希望在同一界面里看盘符占用、浏览目录、偶尔删文件或建文件夹、并快速打开本会话/workspaces 产出文档的开发者或日常用户。
权限与安全：插件主机半运行在 当前 DSH 进程权限 下，能访问该用户可见的本地路径并执行上述写操作。安装前应阅读 源码与 LICENSE，确认可接受 MIT 条款与行为范围。
已知限制（README）
- 仅 Windows；无分区操作；删除必进回收站；无重命名与撤销；磁盘变更需 手动刷新。
- PowerShell 被禁用时图标可能退化为文件类型图标，其余功能仍可用。
- 图标经
SHGetFileInfo解析，极少数 AppX 注册异常可能显示通用图标。
社区目录页（SkillHub 等）与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，索引源由社区或个人托管。
结尾¶
dsh-disk-manager 把 Windows 卷概览、Explorer 式浏览、文件夹体积统计、桌面与工作区文档入口收进 DSH 右侧边栏，写操作刻意收窄为回收站删除与新建文件夹，适合在对话旁做轻量本地文件操作。
