前言¶
在 DeepSeek Harness 里与 AI 对话时，经常需要在本机找资料、确认文件内容，或把文件交给当前会话。若只依赖系统资源管理器和对话窗口来回切换，路径粘贴、附件添加和预览都会打断节奏。下面介绍由维护者 tm5452 发布的客户端插件 dsh-workspace-explorer（GitHub：tm5452/dsh-workspace-explorer），它在 Windows 桌面端 Harness 右侧栏提供带标签页的文件浏览、预览、工作区搜索和批量文件操作，按当前 Windows 账户权限访问磁盘。
DSH 生态强调「一切皆插件」；插件目录站 skillhub.cn 为社区汇总，与 DeepSeek / 幻方无官方从属关系。本文事实均来自该插件 GitHub README 与 package.json（当前发布版本 1.1.1）。
这是什么¶
dsh-workspace-explorer 定位为 Windows 上的 Harness 文件资源管理器：安装后从右侧栏的「文件浏览」进入，在同一界面完成浏览、预览、与会话联动及就地整理文件。插件 dsh.client.platform 为 web，向右侧栏、会话等客户端模块注入能力；扩展预览部分沿用 dsh-preview-extra，许可证见仓库内 LICENSE-preview-extra。
核心功能¶
浏览与导航¶
- 首页回到「此电脑」，列出 C、D、E 等本机盘符、可移动盘和光驱；双击进入目录，工具栏支持前进、后退、上一级和刷新。
- 地址栏可点任一级目录跳转；路径过长时可在地址栏上滚动查看；点编辑或按 Ctrl+L 粘贴绝对路径——文件夹路径进入目录，文件路径则定位并预览。
- 顶部 + 可再开「文件浏览」标签；各标签独立保留目录、导航历史和预览，可拖动排序；同一窗口内会话共享这组标签，切换会话或工作区时保留浏览状态。
- 列表 / 大图标视图可按目录记忆；大图标支持图片与可解码视频缩略图。
- 地址栏旁星标可收藏目录，支持拖动排序并自动保存。
预览¶
单击多数媒体与文本即预览，双击用 Windows 默认应用打开。底部预览窗可收起；分隔线可拖动调整高度；切换文件夹时可继续查看上次选中的文件。
| 类别 | 支持格式（节选） | 说明 |
|---|---|---|
| 图片 | PNG、JPG/JPEG、GIF、WebP 等 | 直接显示 |
| 视频 / 音频 | MP4、WebM、MP3、WAV 等 | 解码取决于 DSH 内置浏览器 |
| 纯文本与代码 | UTF-8 的 TXT、MD、JSON、脚本等 | 最多读取前 2 MB |
| PDF 与 Office | PDF、DOC/DOCX、XLS/XLSX、PPT/PPTX | 连续滚动；Office 经 Harness 本机转换；Ctrl+滚轮 缩放 |
| 压缩包 | ZIP、JAR、TAR、GZ 等 | 「解压预览」后浏览包内条目 |
| 3D / KiCad / 固件等 | STL、OBJ、.kicad_sch、.hex 等 | 见 README 格式表 |
侧栏需完整读取的格式单文件上限 32 MB。7Z、RAR 等可双击用系统默认程序打开。
与会话、工作区联动¶
- 点击 AI 交付的文件卡片或回复中的本地文件链接，文件浏览页会跳到所在文件夹并选中预览；拖到右侧指定区域可在新标签预览。
- 从列表或大图标把文件拖到左侧输入框，加入当前会话草稿；文件夹或地址栏各级目录拖到输入框会插入绝对路径，拖到标签栏可新开浏览页。
- 跳转至工作区 为一次性跳转；在工作区内工作 将启用时的工作区设为标签根目录并显示搜索栏，按文件名搜索子目录（结果标出路径，最多 300 条，不遍历目录联接）。
就地文件操作¶
右键支持复制、剪切、粘贴、重命名、复制路径、在资源管理器中显示、删除；Shift 连选、Ctrl 多选，批量操作每次最多 128 项。粘贴同名文件会保留两份；删除经确认后进入回收站。
安装与启用¶
推荐从 npm 注册表安装。在终端执行：
dsh plugin --profile web add dsh-workspace-explorer
也可在 Harness「插件 → 添加插件」中输入包名 dsh-workspace-explorer，由注册表解析。
安装后需从系统托盘完全退出 Harness，再重新打开右侧栏「文件浏览」。
从 GitHub Release 安装时，可在「插件 → 添加插件」粘贴发布包链接或本地 .tgz 路径：
https://github.com/tm5452/dsh-workspace-explorer/releases/download/v1.1.1/dsh-workspace-explorer-1.1.1.tgz
曾装早期预览包的用户，宜先在插件列表移除旧条目再重装。源码调试可用 link:<绝对路径> 添加插件目录；发布包已含构建产物，自行构建需先 npm install，再执行 node scripts/build-client.mjs 生成 lib/client.js。
典型用法¶
- 安装并重启 Harness 后，打开右侧「文件浏览」，从「此电脑」进入项目目录。
- 用 Ctrl+L 粘贴已知绝对路径，或开第二个标签对照两个文件夹。
- 单击文本或图片确认内容；PDF/Office 点「查看文档」后在侧栏滚动查阅。
- 将需要的文件拖到对话输入框作为附件，或将文件夹路径拖入对话说明工作区位置。
- 对当前 Harness 工作区启用「在工作区内工作」，用搜索栏按文件名定位资料，点击结果直达预览。
- 多选文件后右键批量复制或剪切到目标目录（注意权限与 128 项上限）。
适用场景与注意¶
适合在 Windows 桌面 Host 上使用 Harness、且需要在本机磁盘与 AI 会话之间频繁切换的开发者或使用者。插件仅以启动 Harness 的 Windows 账户权限访问磁盘；粘贴、重命名等会修改本机文件，拒绝访问时界面会提示。
安装前宜浏览仓库源码与许可证（含 LICENSE-preview-extra）。本插件分类为客户端，不替代系统级安全策略；内嵌预览与搜索均有上述大小、条数与编码限制。
结尾¶
dsh-workspace-explorer 把 Windows 磁盘浏览、多格式预览、工作区搜索和剪贴板级文件操作收拢到 Harness 右侧栏，减少在对话与资源管理器之间的上下文切换。
