DeepSeek Harness (DSH) Web 提供了一个插件化界面，但原生文件处理通常需要截图保存或手动复制文件路径。dsh-file-upload 插件通过提供直观的上传按钮和拖放支持，简化了这一过程。
这是一个由 666emmm 维护的插件，旨在为 DSH Web 添加文件上传和剪贴板路径管理功能。
核心功能¶
插件支持以下操作：
- 上传方式：通过界面图标点击或直接拖拽文件、图片或文件夹到 DSH 窗口。支持多选文件。
- 智能路由：根据当前模型是否支持图片，自动决定将文件发送到官方附件 rail 或作为路径文本插入。
- 图片处理：支持的图片格式（PNG/JPEG/WebP/GIF）会被归档到附件目录并添加到官方附件 rail。系统会自动生成
file_id，支持同一图片的复用。 - 文件管理：在设置卡片的“文件上传”区域，可以浏览附件库（支持图片/文件/文件夹标签），查看原始名称、大小、修改时间，并支持一键复制
@path引用或删除文件。 - 剪贴板路径读取（零拷贝）：在操作系统文件管理器中复制文件或文件夹后，点击界面上的剪贴板按钮，插件会直接读取系统剪贴板中的真实路径并插入
@path引用。这避免了文件内容的实际传输和磁盘占用。 - 文件夹支持：支持拖拽文件夹，插件会递归读取内容并在附件库中重建文件夹结构。
安装与启用¶
使用官方 bundle 安装命令即可完成安装。此命令要求 dsh web 正在运行。
dsh plugin --profile web add "github:666emmm/dsh-file-upload#main"
安装后，重启 dsh web 以加载插件。
典型用法¶
- 上传文件：点击输入框旁的上传图标，在系统文件选择器中多选文件或文件夹。
- 拖拽操作：直接将文件或文件夹拖拽到 DSH 窗口的任意位置。
- 路径引用：在文件管理器中复制文件路径，点击剪贴板按钮，将
@path引用插入到光标处。
注意事项与限制¶
- 文件大小限制：
- 单文件上传限制为 64 MB，这是 DeepSeek Files API 的硬性限制。
- 本地附件存储默认限制为 20 MB。超过 20 MB 的图片会通过路径文本发送，模型仍可通过
read_image读取。
- 存储位置：上传的文件默认归档至
~/Documents/DSH/Attachments/images/<YYYY-MM-DD>/（图片）或.../files/<YYYY-MM-DD>/（其他文件）。该路径可在设置中配置。 - 加载器 ID：该插件的加载器注册 ID 为
file-upup，而非file-upload。DSH 内置的file-upload占用了file-uploadID，因此必须使用file-upup以避免启动时出现重复 ID 冲突。 - 公共上传：默认情况下，插件只允许同源访问（CSRF 安全）。如需通过端口转发或公网访问，需在设置中开启“允许公共上传”选项。
该插件通过提供零拷贝路径读取和直观的上传界面，降低了 DSH Web 中文件交互的门槛。更多详情可查看插件目录或源码仓库。
