前言¶
在 DSH web 会话中，把本地图片、文档或目录交给模型读取时，常见做法是先复制路径，再手动粘贴到输入框。dsh-file-upload 针对这类操作做了简化：它在 DSH web 客户端中增加一个上传按钮，并支持把文件或文件夹拖进窗口。
经过上面的方式，文件会被归档到 DSH 附件库；符合条件的图片还可以走官方附件 rail，其他文件和图片路径会插入为草稿文本。它属于 DSH 插件生态，README 明确说明这是社区成员独立开发和维护的非官方项目，不是 DeepSeek 官方产品。
这是什么¶
dsh-file-upload 是一个 DSH web 客户端插件，核心定位是：在 DSH 会话中提供「上传按钮 + 拖拽文件」入口，并把文件转换为模型可读的本地路径或官方附件。
已核实的仓库信息如下：
- 名称：
dsh-file-upload - 许可证：MIT
- 仓库 owner：
a903067276-rgb - GitHub：
https://github.com/a903067276-rgb/dsh-file-upload
核心功能¶
下面介绍已核实的功能点。
- 在 DSH web 会话中增加一个上传按钮，并支持拖拽文件。
- 点击上传图标会打开系统文件选择器，支持多选，并按规则路由到官方附件 rail 和/或路径文本。
- 拖入文件时，图片与任意文件类型都会被接管，不出现「不支持」提示。
- 拖入文件夹时，插件会递归读取文件夹，并在附件库下按原有目录结构重建。
- 支持 PNG/JPEG/WebP/GIF 图片：可归档到按日期划分的附件目录，并加入官方草稿附件 rail。
- 图片发送时会复用 DeepSeek Files API 的
file_id；7 天过期后自动重新上传。 - 其他文件会归档到
files/下，并在草稿中插入带前缀的路径文本。 - 当当前模型不支持图片时，图片会回退为归档路径文本，而不是作为图片块发送。
- 提供设置卡片，包含附件目录、路径前缀、官方附件路由、图片归档、公共上传、剪贴板监听等选项。
安装与启用¶
安装前先确认环境满足：DSH web >= 0.1.0-rc.7，并且 PATH 中有 pnpm。dsh plugin 需要借助 pnpm 完成安装。
使用一行安装命令：
dsh plugin --profile web add "github:a903067276-rgb/dsh-file-upload#main"
这条命令把插件安装到 web profile。安装完成后，重启 DSH web：
dsh web
经过上面的步骤，插件会在 DSH web 重启后生效。
如果 DSH 版本较旧，已核实资料给出的版本选择是：
0.1.1-rc.1及更新版本：使用main（v0.1.5+）。0.1.0-rc.7到0.1.0-rc.8：可使用main（v0.1.5+），也可以把v0.1.4作为保守回退。0.1.0-rc.6及更早版本：使用v0.1.2。
若采用 manual mount，需要在 ~/.dsh/cordis.patch.yml 中保持单个条目，避免重复注册路由导致崩溃；完成后重启 dsh web。
典型用法¶
1、点击上传图标，选择多个文件；或者把文件、文件夹拖进窗口任意位置。
2、若当前模型支持图片，插件会把支持的图片归档到附件目录，并显示在官方附件 rail 中；发送后模型可以看到图片。
3、若当前模型不支持图片，或者关闭官方附件路径，插件会把图片归档到 images/，并在草稿中插入带前缀的绝对路径行。
4、对其他文件，插件会归档到 files/，并在草稿中插入路径文本；发送后模型可以按路径读取文件。
5、对文件夹，拖入后插件会在附件库下按原有结构重建；草稿中只加入一行文件夹路径。
设置与限制¶
设置卡片提供以下控制项：
- 附件目录：用于图片归档。
- 路径前缀：拼接到草稿中的路径文本前。
- 官方附件路由：开启时图片走官方附件 rail；关闭时图片走路径文本逻辑。
- 图片归档：控制是否把图片归档到附件目录。
- 公共上传：默认关闭；关闭时 same-origin 检查仍允许 localhost；开启后任意 origin 可上传。
- 剪贴板监听：默认关闭；可选
off、images only、all files。
文件限制方面，DeepSeek Files API 的单文件硬限制为 64 MB；DSH 本地附件存储默认是 20 MB。20 MB 以上且不超过 64 MB 的图片，默认会归档并通过路径文本引用；如需走官方附件路径，需要在 ~/.dsh/profiles/web/cordis.patch.yml 中调整 maxImageBytes，然后重启 dsh web。
适用场景与注意¶
这个插件适合希望在 DSH web 会话中快速引入本地图片、文档或目录的用户。它把文件操作收敛为上传按钮、拖拽、路径文本和官方附件 rail，减少手工粘贴路径的步骤。
需要注意：DSH 插件会在当前 dsh 运行环境中执行，并且可能读写 DSH 附件库、调用 DeepSeek Files API 或影响草稿输入。安装前应检查源码、依赖和许可证。该插件许可证为 MIT，且明确为非官方社区项目。
平台支持方面：macOS 已完整测试；Linux 和 Windows 预期可以工作，但尚未测试。
链接¶
- GitHub 仓库：
https://github.com/a903067276-rgb/dsh-file-upload - 目录页：请在 DSH 插件目录中搜索
dsh-file-upload；本篇已核实资料未给出可直接引用的目录页 URL。
