dsh-chatfile

dsh-chatfile

DeepSeek Harness WebUI 插件：在聊天框中拖拽或选择任意文件上传到当前会话工作区的 uploads/ 目录，并在输入框中自动插入路径引用，agent 可直接读取分析。纯图片拖拽仍走内置图片流程，互不干扰。

源码：https://github.com/sooya7/dsh-chatfile

功能

• 🖱️ 拖拽上传：把任意文件拖进聊天框（页面任意位置均可），松开即上传
• 📎 上传按钮：输入框工具行新增「📎」按钮，支持多选
• 🧷 状态条：输入框上方显示每个文件的上传状态（上传中 / 成功 / 失败），成功后可下载、可移除
• ✍️ 路径引用：上传完成自动在输入框追加 [上传文件] uploads/xxx.pdf（名称，大小），发送后 agent 用普通文件工具即可读取
• 🖼️ 图片兼容：纯图片拖拽仍然走内置图片流程（预览条 + 图片附件）；非图片 / 混合拖拽由本插件接管
• 🔒 安全下载：下载走不可猜测的随机 token 路由（无路径输入，无穿越面）；文件名/大小/类型均在 Host 校验，单文件上限 50MB

目录结构

src/
  index.ts          Host 半区：POST /chatfile/upload + GET /chatfile/download/<token>
  client/index.ts   Client 半区：拖拽捕获、📎 按钮、状态条、输入框引用
build.mjs           esbuild 构建（host ESM + client ModuleLoader 单文件包）
cordis.patch.yml    组合补丁（插入 dsh-chatfile 插件行）
.github/            release 自动构建 workflow

构建

pnpm install
pnpm build

产物：lib/index.js（Host ESM 插件）、lib/client.js（浏览器单文件 bundle，由 web server 以 /plugins/dsh-chatfile/client.js 提供）。

安装到 Web profile

本地仓库方式：

dsh plugin --profile web add file:/绝对路径/dsh-chatfile

从 GitHub 安装：

dsh plugin --profile web add "git+https://github.com/sooya7/dsh-chatfile.git"

然后重启 dsh web 服务使组合生效（dsh-chatfile restart，或 sudo systemctl restart dsh-web.service）。重启后插件持久可用（刷新页面、重启进程均不丢失），与动态插件（session 级、进程重启即失效）不同。

工作原理

• Client 半区在 document 捕获阶段监听拖拽事件：非图片文件 stopPropagation 拦截（内置图片流程是冒泡阶段监听，互不干扰）；conversation.input.overlay / left / dock 三个 slot 分别承载拖拽遮罩、📎 按钮、状态条。
• 文件以 base64 JSON POST 到 /chatfile/upload；Host 半区经 sandboxPolicy.resolve({ session }) 解析会话工作区根目录，写入 <workspace>/uploads/（重名自动加 -1 后缀），字节数校验后返回路径与下载 URL。
• 输入框引用通过 slot 标准 prop inputActions.setDraft 写入，占位符 [附件上传中：…] 在上传完成后替换为最终引用，失败则回滚。

License

MIT