DeepSeek Harness 插件

dsh-chatfile

WebUI 聊天框拖拽/选择上传任意文件到会话工作区 uploads/ 目录(图片拖拽仍走内置流程)(英文原文)

跳到安装方式

来源信息

GitHub 仓库
sooya7/dsh-chatfile
最近更新
2026年8月15日
分类
记忆
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/sooya7/dsh-chatfile
插件名:dsh-chatfile
作者:sooya7

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-chatfile

![GitHub](https://github.com/sooya7/dsh-chatfile) ![Release](https://github.com/sooya7/dsh-chatfile/releases)

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