dsh-file-upload

English | 简体中文

统一上传按钮 + 拖拽文件直进对话 —— DeepSeek Harness（dsh）web 插件。

非官方项目：社区成员独立开发维护，非 DeepSeek 官方产品。

截图

输入框工具行里的上传图标按钮（官方 dsw 风格，跟随深浅色主题）；支持的图片进入官方附件条（自动 file_id 复用），其他文件把路径文本插入输入框。

功能

操作	效果
点上传图标	系统文件选择器（可多选）→ 智能分流 → 附件条和/或路径文本
把文件拖进窗口	图片/任意文件都接管（不再弹"不支持"）→ 智能分流
把文件夹拖进窗口	递归读取整个文件夹 → 在附件库中按原结构重建 → 只插文件夹路径一行（不展开内部文件）
图片（PNG/JPEG/WebP/GIF）	① 留档到附件目录（按天分文件夹）② 进官方草稿附件条 → 发送后自动 DeepSeek Files API file_id（同图复用，7 天过期自动重传）
其他文件	存附件库 files/ 子目录，<前缀> 路径 文本进草稿
模型不支持图片	图片降级为"留档 + 路径文本"（绝不发送图片块，不报 400）

• 文件上限：单文件 64MB（DeepSeek Files API 硬限；主程序附件库默认 20MB，见 大图（20~64MB））
• 所有上传统一进附件库：图片 ~/Documents/DSH/Attachments/images/<YYYY-MM-DD>/，其他文件 .../files/<YYYY-MM-DD>/（设置里可改根目录）
• 上传中按钮变灰，失败有中文提示

设置卡片

• 附件目录（默认 ~/Documents/DSH/Attachments，支持 ~ 前缀）—— 只给图片留档用
• 路径前缀（默认 [上传文件]）—— 插入输入框时加在路径前的文本，清空 = 裸路径
• 图片走官方附件（默认开）—— 关 = 图片走老路径文本逻辑
• 留档图片到附件目录（默认开）—— 关 = 只走官方附件（省磁盘；官方通道不可用时仍强制留档）
• 只读显示：当前图片来源上限（来自宿主配置）

大图（20~64MB）

DeepSeek 单图上限 64 MB；主程序本地附件库默认 20 MB——超过且 ≤64 MB 的图片走"留档 + 路径文本"（模型仍可经 read_image 读，上限同源跟随）。

想让大图也走官方附件路径，在 ~/.dsh/profiles/web/cordis.patch.yml 追加以下配置并重启 dsh web：

- id: attachment-local
  config:
    maxImageBytes: 67108864   # 20 MiB → 64 MiB（DeepSeek 官方硬限）

注意：该行整行替换配置，需要的键都要写明；主程序升级后随版本核对。无论原图多大，模型看到的始终是主程序规范化版本（≤2048px / ≤4 MiB，每张图 ≤384 token）。

安装

官方 bundle 一行安装：

dsh plugin --profile web add "github:a903067276-rgb/dsh-file-upload#main"

装完重启 dsh web（bundle 层在启动时合成）。需要 pnpm（dsh plugin 是 pnpm 转发器）。

手动挂载（兜底）：见 docs/install.md —— 软链到 ~/.dsh/profiles/web/node_modules/ + 在 ~/.dsh/cordis.patch.yml 里加单条 entry（双条会让插件 apply 两次、路由重复注册崩溃），然后重启。

使用

1. 点上传图标选文件（可多选），或把文件/文件夹拖进窗口任意位置。
2. 图片（当前模型支持看图时）：留档附件目录 + 进入官方附件条——发送即模型看图（DeepSeek Files API file_id，自动复用）。
3. 图片但模型不支持（或你关了官方路径）：留档到 images/ 后写入 <前缀> <绝对路径> 行——如 [上传文件] /path/to/Attachments/images/xxx.png——保留已有草稿。
4. 其他文件：存附件库 files/，路径文本进草稿；发送后模型按路径读取。
5. 文件夹：拖入后在附件库按原结构重建，只把文件夹路径（一行）写进草稿。

平台支持

平台	状态
macOS	✅ 完整测试（开发环境）
Linux	✅ 预期可用（纯 Node 实现），未测
Windows	⚠️ 预期可用（纯 Node 实现、Windows 安全文件名清洗、平台分隔符路径），未测

依赖要求

• DSH web >= 0.1.0-rc.7（dsh web 运行）
• 版本对照（尽力兼容——新功能已在本地 0.1.1-rc.2 实测；0.1.0-rc.7/rc.8 上的官方附件条无法完整验证，不保证）：
• 维护策略：本插件将持续跟随 DSH 最新版本演进；对旧版 DSH 的兼容仅是尽力而为、不保证长期有效。

你的 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 — dsh plugin add github:a903067276-rgb/dsh-file-upload#v0.1.4
0.1.0-rc.6 及更早	v0.1.2 — dsh plugin add github:a903067276-rgb/dsh-file-upload#v0.1.2	最后一个无设置卡片的版本（设置卡片用 rc.7+ keyed slot 契约）

• 无需额外 shell：host 半纯 Node（node:fs），任何平台不依赖系统命令。

工作原理

• Host（lib/index.js）：POST /api/file-upload/save——校验会话与大小，用纯 Node 写 base64 到 <附件库>/images/<YYYY-MM-DD>/（mode=image）或 <附件库>/files/<YYYY-MM-DD>/（mode=file）；POST /api/file-upload/save-folder——接收相对路径 + base64 列表，在附件库 files/<日期>/<时间戳>-<文件夹名>/ 下按原结构重建（逐段 sanitize + 拒绝 .. 防目录穿越）；GET/POST /api/file-upload/config——读写设置（官方 settings 服务）+ 暴露宿主图片上限 + 当前会话模型是否收图（llm.resolveModel 的 inputModalities，与适配器同源）。
• Client（lib/client.js）：上传图标挂 conversation.input.left；捕获阶段接管拖拽，webkitGetAsEntry 递归读入文件夹目录树；分流规则：支持图片 + 开关开 + 模型收图 + 不超宿主上限 → 留档 + conversation.createDraftImages + inputActions.addImages（官方 InputBar 同款机制）→ 官方附件条（不写路径文本）；其余降级"留档 + 路径文本"；>64MB 拒绝并提示。
• 错误边界：渲染崩溃降级为"⚠ 上传组件异常"小图标，不卸载整个输入框。

备注

• 附件库只增不减，从不自动清理（我们不删你的文件）——需要时手动清理。
• 改插件后重启 dsh web 生效（client 改动刷新页面即生效；host 改动需重启）。

为什么有这个插件

DSH 原生在模型不支持图片时会直接拒绝拖入的图片。本插件在模型能看图时把图片走官方附件路径（搭 DeepSeek Files API 的 file_id 快车），同时留一份你能自己找到的附件目录副本，其余情况降级为纯路径文本——纯文本消息能过模型的图片检查，任何模型/视觉插件都能用（降级路径上从不提交图片块，绕开 DSH 原生拒绝）。

License

MIT