📎 dsh-upload

给 DeepSeek Harness Web 加一个真正的"上传文件"按钮——回答社区 #867("为什么连个上传文件的按钮都没有？")。

• 点 📎 → 选本地文件 → 字节落盘到会话工作区 .uploads/<sessionId>/ → 绝对路径自动追加进输入框
• 路径可见、可编辑：你清楚知道发给 AI 的是什么，发之前随时删改
• AI 用自带的 fs 工具直接读落盘文件；配合 dsh-word-docs 就是完整文档工作流：上传 → 处理 → 产出正式 Word
• 纯浏览器原生 API + 一个 POST 路由，无第三方依赖

演示

点 📎 → 选择本地文件 → 字节落盘到会话工作区，绝对路径自动追加进输入框（可见、可编辑、可删除）→ 发送后 AI 用 fs 工具直接读取。

安装

dsh plugin --profile web add github:Ei-Ayw/dsh-upload
# 重启 dsh Web → composer 工具行左端出现 📎

使用

1. 打开一个会话，点输入框左侧的 📎
2. 选择本地任意文件（PDF / Word / Excel / 图片 / 压缩包…）
3. 输入框自动追加一行 📎 /绝对路径/…，点发送
4. AI 用 fs 工具读取该文件并处理

落盘位置：<工作区>/.uploads/<会话ID>/<原文件名>。上传的文件属于该会话工作区，随时可以在文件管理器里看到、删除。

与同类插件的对比

插件	方式	差异点
dsh-upload（本插件）	真上传字节 → 工作区落盘	路径透明可见、可编辑；文件真正进入工作区，任何 fs 工具可读；实现最简
dsh-file-beam	拖拽后按文件名搜本地路径（零拷贝）	只匹配工作区/下载/桌面/文档目录；不传字节，文件不在工作区
dsh-files	上传 + 会话隔离解析	字节存会话隔离目录，解析成文本给模型
dsh-file-upload	拖放 + MarkItDown 解析	侧重"读"成文本进输入框
dsh-user-addons	拖拽 + 归档管理	附加功能多，体积大

定位：最直接的"上传按钮"，字节真实落盘工作区，路径完全透明，适合和文档生成类插件搭配。

配置（可选，cordis.patch.yml 或插件设置）

- id: dsh-upload
  config:
    maxBytes: 52428800      # 单文件上限，默认 50MB
    subDir: '.uploads'      # 工作区内落盘目录

安全设计

• 路由仅接受同源请求（校验 Origin/Host）
• 文件名净化：只取 basename、剥离路径与控制字符，杜绝路径穿越
• 大小硬限制（默认 50MB，超限 413）
• 原子写入（临时文件 + rename），失败不留残渣
• 会话 ID 净化后才进入路径

测试

node --test

覆盖：文件名/会话净化、原子落盘、大小限制、路由级集成（200/413/403）。

目录结构

dsh-upload/
├── lib/index.js     # Host: 上传路由 + 落盘逻辑
├── lib/client.js    # 浏览器: 📎 按钮 + 草稿注入
├── cordis.patch.yml # bundle 补丁层
├── docs/            # README 素材(演示 GIF)
└── tests/

已知限制

• 单文件上传（v1）；无拖拽、无历史消息文件卡片（可后续加）
• 上传不自动解析内容——"解析/读取"交给 AI 的 fs 工具或配套插件

License

MIT