前言¶
DeepSeek Harness (DSH) 提供了插件化架构，允许扩展工作台功能。在开发或调试过程中，开发者往往需要在查看 AI 对话上下文的同时，检查工作区内的源代码、配置文件或日志。官方 DSH 界面本身没有侧边栏文件浏览功能，这需要频繁切换窗口或使用外部工具。relay-dsh-plugin-files 通过插件系统为官方 DSH Web UI 增加了右侧的文件浏览面板，使开发者可以在不离开当前对话的情况下查看和预览文件。
这是什么¶
relay-dsh-plugin-files 是一个为 DeepSeek Harness Workbench 提供工作区文件浏览视图的插件。该插件由 yangbobo2021 维护，采用 MIT 许可证。
它的核心作用是：
1. 在 Workbench 侧边栏增加一个 Files 视图。
2. 通过 DSH Agent 身份加载当前会话工作区的文件树。
3. 对文件内容进行限制的 UTF-8 文本预览。
4. 提供过滤框以快速筛选可见文件。
核心功能¶
该插件提供以下具体能力：
- 文件树展示：在 Workbench 侧边栏加载并展示当前工作区的文件结构。
- 身份鉴权：利用 DSH Agent 身份进行工作区文件加载，确保安全性。
- 路径校验：执行工作区包含检查，确保预览内容严格限制在活跃的工作区路径内。
- 文本预览：支持对源代码、Markdown、JSON、日志等 UTF-8 文本文件进行预览。
- 快速过滤：提供过滤框，允许用户快速缩小可见文件范围。
- 非二进制处理：不将二进制文件、超大文件或工作区外的路径作为纯文本预览。
安装与启用¶
安装该插件需要同时安装 relay-dsh-plugin-workbench 作为宿主面板。安装命令如下：
npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@0.2.3-rc.1 relay-dsh-plugin-files@0.2.3-rc.1
安装完成后，启动或重启 DSH Web 进程：
npx @deepseek-ai/dsh@0.1.2-rc.1 web
重启进程是确保插件加载生效的关键步骤。
典型用法¶
在 DSH Web 界面中，典型的工作流如下：
- 打开 DSH Web 终端输出的 URL，进入官方界面。
- 完成首次启动引导（如有）。
- 创建或选择一个已关联了本地工作区目录的对话。
- 在左侧或右侧面板打开 Workbench 侧边栏。
- 在 Workbench 面板中选择
Files视图。 - 点击列表中的文件，即可在面板内查看其 UTF-8 文本内容。
适用场景与注意¶
适用场景：
- 需要在浏览器中浏览当前对话关联工作区文件的 DSH 用户。
- 需要预览 Markdown、JSON、日志等 UTF-8 文本的开发者。
- 想要在保持使用官方 DSH 的同时，通过插件系统扩展文件浏览能力的用户。
注意：
- 该插件仅拥有 Files 视图，不依赖 Codex、Claude、Relay Events 或任何私有 Relay 运行时。它通过公共插件契约与共享的 Workbench shell 通信。
- 插件不支持二进制文件、超大文件以及工作区外的路径作为纯文本预览。
- 插件遵循 MIT 许可证。
总结¶
relay-dsh-plugin-files 是一个轻量级的 DSH 插件，它在不改变官方 DSH 核心逻辑的前提下，通过插件机制补全了文件浏览能力。它适合需要在工作区上下文中频繁查阅文本文件的开发者，有助于保持开发流程的连贯性。
- 插件仓库: https://github.com/yangbobo2021/relay-dsh-plugin-files
- 插件目录: https://www.skillhub.cn/plugins/yangbobo2021/relay-dsh-plugin-files
