前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许在 Web Profile 中扩展功能。在会话中查看本地文件结构或内容，通常需要切换浏览器标签页或给 Agent 发送消息。dsh-workspace-files 插件直接在会话界面旁提供文件浏览面板，无需中断当前工作流。
插件介绍¶
该插件由 Momojie-S 维护。它提供右侧可调宽的文件树、递归文件搜索、Markdown 与多语言代码高亮预览，以及远程文件下载能力。插件以 MIT 协议开源。
核心功能¶
- 会话标题栏开关：点击标题栏的按钮即可打开或关闭面板。
- 可调宽文件树：右侧文件树宽度可在 240px 至 900px 之间调整。
- 递归搜索：支持全工作区递归搜索文件名，自动跳过
.git和node_modules目录。 - 内容预览：支持 Markdown 渲染（标题、列表、表格、代码块、链接、图片）和多种文本文件的语法高亮。
- 浮窗放大：双击文件可在浮窗中居中放大预览，Esc 键或点击遮罩关闭。
- 远程下载：支持将远程（域名/局域网）文件直接下载到本地。
安装与启用¶
安装前需确认环境满足要求：DeepSeek Harness >= 0.1.0-rc.6（Web Profile），构建期需 Node.js >= 20。
dsh plugin --profile web add @momojie-s/dsh-workspace-files
首次构建时，需在 Profile 的 pnpm-workspace.yaml 中添加 allowBuilds 授权。
安装完成后，在 DSH 界面的会话标题栏点击「🗂 文件」按钮即可加载面板。
使用方式¶
- 浏览文件：在左侧文件树中，点击目录展开或折叠。单击文件在右侧预览，双击文件在浮窗中居中放大查看。
- 搜索文件：在搜索框输入关键词并回车，进行全工作区递归搜索。按 Esc 键返回文件树。
- 调整面板：拖动面板左缘可调整宽度；点击左缘中部的「›」按钮可收起面板。
- 下载文件：在预览栏标题行或浮窗标题行点击下载按钮。对于二进制文件或超过预览限制的文件，提示语旁也提供下载链接。
配置¶
通过 Patch config 字段可以调整行为，主要配置项如下：
| 字段 | 默认值 | 说明 |
|---|---|---|
maxReadBytes |
1000000 |
单文件预览读取上限（字节），超限不预览。 |
maxDownloadBytes |
200000000 |
单文件下载上限（字节），超限返回 413。 |
maxSearchNodes |
4000 |
递归搜索访问节点预算（文件+目录）。 |
maxSearchMatches |
300 |
搜索结果条数上限。 |
skipDirs |
['.git', 'node_modules'] |
文件树与搜索跳过的目录名。 |
trustedHosts |
[] |
非回环 host[:port] 授权列表。远程域名/局域网访问必须配置此项，否则所有路由返回 403。 |
远程部署配置示例（覆盖 bundle 行）：
- id: workspace-files
config:
trustedHosts: ['dsh.example.com']
状态与建议¶
⚠️ 插件已废弃（2026-09-11）
DSH 0.1.5 及以上版本官方内置了同等能力的文件面板（ID 与本插件冲突，无法共存），官方侧栏文件面板（ui-sidebar-files 文件树 + ui-sidebar-documentpreview 预览）已覆盖主要使用场景。
- DSH 0.1.5+：请直接使用官方内置面板。
- DSH 0.1.2-rc.1 及以下：可继续使用本插件。
插件不再维护，安装前请检查源码与许可证。
