dsh-workspace-files
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（构建期；运行期无额外依赖）
用法
- 会话标题栏点「🗂 文件」按钮打开面板
- 左栏文件树：点击目录展开/折叠；单击文件在右栏预览，双击文件浮窗居中放大（Markdown/高亮同款渲染，
Esc 或点遮罩关闭）
- 下载：预览栏标题行与浮窗标题行都有下载按钮，二进制/超限不可预览的文件在提示语旁也有下载链接——远程使用时把文件拉回本机的正路（本地点击文件名走的是 DSH 原生打开，远程被官方 fence 拒掉）
- 搜索框输入关键词回车：全工作区递归搜索文件名；
Esc 返回文件树
- 面板左缘拖动调宽（240–900px），左缘中部「›」按钮收起面板
.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。
