前言¶
在 DeepSeek Harness (DSH) 的开发或使用场景中，工作区通常包含大量文件。为了查看目录结构或文件内容，开发者往往需要在 DSH Web 界面与本地文件管理器（Finder / File Explorer）之间切换，这会打断工作流。dsh-file-explorer-kit 旨在解决这一痛点，它允许用户直接在 DSH 的聊天 GUI 中浏览工作区目录并预览文件。
这是什么¶
dsh-file-explorer-kit 是一个 DeepSeek Harness (DSH) 的客户端插件，以 Cordis bundle 形式发布。它通过注册只读的 /dsh-files 路由和一个专用的“Files”会话选项卡，将文件浏览与预览功能集成到对话界面中。插件本身仅提供浏览能力，不涉及任何文件修改操作。
核心功能¶
-
集成浏览选项卡
插件会在会话界面注册第三个选项卡“Files”（显示为“文件”或“Files”），与“对话”和“轨迹”并列。该选项卡通过conversation.view环注册，自动显示在选项卡栏中。 -
目录与文件预览
用户可以单击目录行进入下一级目录，单击文件行查看预览。支持通过顶部栏的面包屑导航、隐藏文件切换、刷新按钮以及绝对路径跳转框快速定位文件。 -
自动刷新
“Files”选项卡在保持打开状态时会自动刷新，以便实时捕获智能体在后台写入的文件内容。 -
双语与多格式预览
界面支持中/英双语自动切换（也可手动切换）。预览区域位于右侧，支持 Markdown、图片、纯文本以及嵌入式 PDF 的渲染。对于二进制文件，系统提供“Copy path（复制路径）”和“Open in file manager（在文件管理器中打开）”的操作。
安装与启用¶
安装前请确保环境满足要求：DSH 版本 ≥ 0.1.1-rc.2，且安装了 Node.js 20+。
dsh plugin --profile web add dsh-file-explorer-kit
安装完成后，无需重启 DSH 进程，直接在 Web 界面打开任意会话即可看到新增的“文件”选项卡。
典型用法¶
- 打开任意一个 DSH 会话，界面顶部应显示三个选项卡：对话 | 轨迹 | 文件。
- 点击“文件”选项卡，页面主体区域将显示当前会话工作区的目录结构。
- 使用鼠标单击目录以进入子目录，或单击文件以在右侧查看预览。
- 若需跳转到特定路径，可在顶部栏的输入框中输入绝对路径并确认。
- 预览 Markdown 或文本文件时，可切换“预览”与“Raw”模式；查看二进制文件时，可使用右侧操作栏复制路径或打开文件管理器。
适用场景与注意¶
- 适用场景：需要频繁查看项目结构、检查智能体生成的代码或文档，希望避免在 IDE 和浏览器之间来回切换的开发者。
- 安全与权限：该插件完全基于只读路由，不会修改任何文件。其基于主机信任门控机制运行：回环地址请求直通，非回环地址请求需要同源标记。这符合 DSH 官方 Web 服务器的默认绑定行为。
- 兼容性：该插件与
dsh-workspace-kit兼容，两者可以同时启用。
结尾¶
dsh-file-explorer-kit 通过集成文件浏览能力，优化了 DSH 的本地开发体验。对于习惯在 DSH 中处理工作流的人来说，这是一个提升效率的实用工具。更多细节可参考插件仓库或目录页。
