DSH 工作区资源管理器

在 DeepSeek Harness 里和 AI 聊到一半，需要找本机资料、确认文件内容，或把文件交给当前会话时，可以直接在右侧栏完成。安装后，从右侧栏的「文件浏览」进入。插件适用于 Windows 桌面端，按当前 Windows 账户权限访问文件。

安装

从 npm 安装（推荐）

dsh plugin --profile web add dsh-workspace-explorer

也可以在 Harness 的「插件 → 添加插件」里直接输入包名 dsh-workspace-explorer，让它自己解析注册表。

安装后从系统托盘完全退出 Harness，再重新打开右侧栏的「文件浏览」。

从 GitHub Release 安装

在 Harness 的「插件 → 添加插件」中粘贴下方安装包链接，也可粘贴已下载的本地 .tgz 路径：

https://github.com/tm5452/dsh-workspace-explorer/releases/download/v1.1.2/dsh-workspace-explorer-1.1.2.tgz

已安装早期预览包的用户，先在插件列表移除旧条目，再重新安装。发布变更见 版本记录。

从源码安装

将插件目录以 link:<绝对路径> 添加。旧的同名插件记录可先从插件列表移除。

界面实拍

大图标视图、收藏夹和视频预览

工作区搜索

工作区模式会在结果中显示文件所在的子目录。

多标签页浏览与管理

在顶部标签栏打开和切换多个文件夹，可拖动标签调整顺序。每个标签页各自保留目录、导航历史和预览。

找到文件，保留浏览位置

浏览本机磁盘。 点首页按钮回到「此电脑」，查看 C、D、E 等可用盘符。双击文件夹进入，页面只显示当前目录下的文件和子文件夹。工具栏可前进、后退、返回上一级和刷新。

用路径直达。 点地址栏中的任一级目录即可返回那里。路径太长时，把鼠标放在地址栏上滚动，可左右查看。点右侧的编辑按钮或按 Ctrl+L，可直接粘贴绝对路径。输入文件夹路径会进入该目录，输入文件路径会定位并预览该文件。

同时打开多个目录。 点顶部「+」再选「文件浏览」，每个标签页各自保留目录、前进后退历史和预览。标签显示当前文件夹名，可拖动排序，放不下时可用滚轮左右查看。同一窗口中的会话共享这组文件浏览标签，切换会话或工作区时会保留当前浏览状态。

每个目录记住自己的视图。 底部可切换列表和大图标。列表显示名称、类型和大小。大图标可直接看到图片和可解码视频的缩略图。下次进入同一目录，会沿用上次的选择。

收藏常用目录。 点地址栏旁的星标收藏当前文件夹。点击收藏项即可直达，也可以上下拖动排序，顺序会自动保存。操作面板外的内容时会自动收起。移除单项或清空只修改收藏记录。

确认文件内容，再决定怎么用

单击预览，双击打开。 图片、音频和纯文本单击即预览。其他格式先显示封面，点击对应按钮后才加载内容。视频封面会尝试显示首帧。双击文件可用 Windows 默认应用打开。

控制下方预览窗。 窗格默认开启，底栏右侧按钮可随时收起或展开。分隔线平时显示为细灰线，悬停或拖动时显示手柄。文件名右侧的「×」可单独关闭当前文件预览。切换文件夹时可继续查看上一次选中的文件。

在侧栏浏览文档并缩放。 PDF 和 Office 文档可上下连续滚动。Office 使用 Harness 本机转换服务，Excel 按打印版式显示。鼠标放在图片或文档内容区时，按住 Ctrl 滚动滚轮可缩放。右上角仍可打开 DSH 文档预览。

类别	支持格式	预览内容
图片	PNG、JPG / JPEG、GIF、WebP、BMP、ICO、AVIF	显示图片
视频	MP4、WebM、M4V、MOV、MKV 等	尝试显示首帧，点击播放。取决于 DSH 内置浏览器能否解码
音频	MP3、WAV、OGG、OGA、M4A、AAC、FLAC、Opus	播放音频，同样取决于解码支持
纯文本与代码	TXT、MD、JSON、CSV、HTML、PY 等	默认按 UTF-8 显示，Python 脚本也可按文件头声明的编码预览。最多读取前 2 MB
字幕	SRT、VTT、ASS、SSA	查看字幕时间和正文，也可切换到原始文本
字体	TTF、OTF、WOFF、WOFF2	查看字体样张
3D 模型	STL、OBJ、PLY、GLB、glTF	旋转、缩放、平移模型，可切换线框。glTF 须内嵌模型数据
压缩包	ZIP、JAR、WAR、APK、TAR、GZ、TAR.GZ / TGZ	点击「解压预览」后浏览包内文件，按需查看条目
配置文件	TOML	按表查看配置键、类型和值
电路设计	KiCad 原理图 .kicad_sch、PCB .kicad_pcb	查看图形，支持缩放和平移
波形与光谱	VCD、JCAMP-DX（.jdx、.dx）	查看信号波形或光谱曲线
固件	Intel HEX（.hex）、DFU（.dfu）	查看数据地址、数据段和校验信息
PDF 与 Office	PDF、DOC / DOCX、XLS / XLSX、PPT / PPTX	点击「查看文档」后连续滚动，支持 Ctrl＋滚轮缩放

侧栏需要完整读取的格式，单文件上限为 32 MB。7Z、RAR 等压缩包可双击用 Windows 默认应用打开。

在会话与文件之间切换

打开会话里的文件。 点击 AI 交付的文件、改动卡片中的具体文件或回复里的本地文件链接，当前文件浏览页会跳到所在目录、选中文件并展开预览。拖到右侧标出的区域后，交付文件和文件链接打开 DSH 文档预览，改动卡片打开该文件的 DSH 差异审阅；按住 Shift 点击改动文件也可直接查看原生红绿对比。

拖入文件就是添加附件。 从列表或大图标视图把文件拖到左侧输入框，文件会加入当前会话的草稿，发送前仍可检查。遇到 DSH 无法接收的文件，可右键「复制文件路径」，再把路径粘贴到对话里。

拖入文件夹就是插入路径。 列表里的文件夹和地址栏里的任一级目录都可以拖。拖到对话输入框，会插入该目录的绝对路径。拖到顶部标签栏，会为它新开一个文件浏览页。

按需切到会话工作区。 「跳转至工作区」只执行一次跳转。「在工作区内工作」会把启用时的工作区设为该标签页的根目录，并显示搜索栏。输入文件名关键词，可搜索各级子目录。结果会标出所在目录，点击后直接定位到文件并打开预览。关闭模式即可回到之前的普通浏览位置。

就地整理文件

单项和批量操作。 右键文件或文件夹，可复制、剪切、粘贴、重命名、复制路径、在 Windows 资源管理器中显示或删除。按住 Shift 可选连续区间，按住 Ctrl 可逐项选中或取消。多选后可批量复制、剪切或删除。

与 Windows 剪贴板配合。 工具栏的粘贴会把文件放进当前目录，右键某个文件夹则可直接粘贴到该文件夹内。同名粘贴会保留两份，删除需确认后移入 Windows 回收站。

权限与限制

本机磁盘访问仅在 Windows 桌面 Host 上启用，按启动 Harness 的 Windows 账户权限访问。粘贴和重命名会修改所选的本机文件或目录，Windows 拒绝访问时会显示提示。盘符首页只列本机磁盘、可移动盘和光驱。内嵌预览最多读取 32 MB，文本预览读取前 2 MB。批量操作每次最多 128 项，工作区搜索结果最多显示 300 条，且不遍历目录联接。

构建

从源码安装时，先运行 npm install 安装 PDF.js，再运行 node scripts/build-client.mjs 生成 lib/client.js。发布包已包含构建产物。

扩展预览实现沿用 dsh-preview-extra，许可证见 LICENSE-preview-extra。