Momojie-S/dsh-workspace-files

dsh-workspace-files

⚠️ 已废弃（2026-09-11）：DSH 0.1.5 起官方内置同等能力——web bundle 直接注册 @deepseek-ai/dsh-api-workspace-files entry（与本插件同 id，无法共存），官方侧栏文件面板（ui-sidebar-files 文件树 + ui-sidebar-documentpreview 预览）覆盖文件浏览主场景。本插件不再维护；0.1.5+ 请直接使用官方内置面板，0.1.2-rc.1 及以下可继续使用本插件最后发布形态。

DeepSeek Harness Web UI 的工作区文件面板：会话标题栏一键开关，右侧可调宽文件树 + 递归文件搜索（跳过 .git / node_modules），Markdown 渲染与多语言语法高亮预览；双击浮窗居中放大，远程可一键下载文件。

一句话作用

在任何会话旁边快速浏览当前工作区的目录结构与文件内容——不用切出浏览器，不用给 agent 发消息；远程（域名/局域网）使用时直接把文件拉回本地。

环境要求

- DeepSeek Harness >= 0.1.0-rc.6（web profile；已验证至 0.1.1-rc.2）
- Node.js >= 20（构建期；运行期无额外依赖）

用法

1. 会话标题栏点「🗂 文件」按钮打开面板
2. 左栏文件树：点击目录展开/折叠；单击文件在右栏预览，双击文件浮窗居中放大（Markdown/高亮同款渲染，Esc 或点遮罩关闭）
3. 下载：预览栏标题行与浮窗标题行都有下载按钮，二进制/超限不可预览的文件在提示语旁也有下载链接——远程使用时把文件拉回本机的正路（本地点击文件名走的是 DSH 原生打开，远程被官方 fence 拒掉）
4. 搜索框输入关键词回车：全工作区递归搜索文件名；Esc 返回文件树
5. 面板左缘拖动调宽（240–900px），左缘中部「›」按钮收起面板
6. .md 文件自动渲染（标题/列表/表格/代码块高亮/链接/图片）；其他文本文件按扩展名语法高亮；二进制与超过 1 MB 的文件提示不预览（但可下载）

安装

dsh plugin --profile web add @momojie-s/dsh-workspace-files
或本地路径
dsh plugin --profile web add ./plugins/dsh-workspace-files
dsh web

首次按 pnpm 提示在 profile 的 pnpm-workspace.yaml 加 allowBuilds 授权构建脚本。

配置

patch config 字段：

| 字段 | 默认值 | 说明 |
| --- | --- | --- |
| maxReadBytes | 1000000 | 单文件预览读取上限（字节），超过则不预览 |
| maxDownloadBytes | 200000000 | 单文件下载上限（字节），超过回答 413 |
| maxSearchNodes | 4000 | 递归搜索访问节点预算（文件+目录） |
| maxSearchMatches | 300 | 搜索结果条数上限 |
| skipDirs | ['.git', 'node_modules'] | 文件树与搜索都不进入的目录名 |
| trustedHosts | [] | 非回环 host[:port] 授权列表；远程域名/局域网访问必须配置，否则所有路由 403 |

远程部署示例（profile patch 层覆盖 bundle 行，认证交给网关层如 nginx basic auth）：

- id: workspace-files
config:
trustedHosts: ['dsh.example.com']

验证

curl -s -H "Host: 127.0.0.1:3080" "http://127.0.0.1:3080/plugins/workspace-files/search?q=README"
期望：{"matches":[...],"truncated":false}（未打开面板时返回 not-a-directory 之外的 JSON 即通）

curl -sI -H "Host: 127.0.0.1:3080" "http://127.0.0.1:3080/plugins/workspace-files/download?path=README.md" | Select-String 'HTTP|content-disposition'
期望：HTTP/1.1 200 且 content-disposition: attachment; filename=...

浏览器端：会话标题栏出现「🗂 文件」按钮即客户端半部加载成功。

安全边界与设计取舍见 docs/design/overview.md。