把文件与文件夹直接传进对话——图片以真实图片块加入消息，文本内容写入输入框草稿，文件夹按目录结构落盘。

安装

# GitHub 源码（首次需按提示配置 allowBuilds 构建授权后重试）

dsh plugin --profile web add github:zhousun55-byte/dsh-postman

装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络，工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本。请只安装可信来源，并尽量锁定 commit（github:owner/repo#sha）。

README

把文件与文件夹直接「邮」进对话——不需要再复制进工作区文件夹、不需要报路径。

入口在输入框工具行左侧的 + 命令菜单里：/upload（两个选项：上传文件 / 上传文件夹），工具行本身不额外占按钮。

图片以图片形式加入消息：PNG/JPG/WebP/GIF（≤5 MiB）走 DSH 原生附件管线，输入框缩略图 + 消息图片块，模型侧由视觉桥接（如 modlens）转写——不是只给一个路径； HEIC 等不支持或超限的图片自动退回路径上传。
文件夹上传：webkitdirectory 整目录上传，按目录结构落盘 ~/.dsh/uploads/<时间戳>-<文件夹名>/…，文本文件内容直接写进输入框草稿，模型立即可见。
零依赖、无构建步骤：纯 Node 内置模块 + DSH 原生管线，克隆即用。

上传文件（多选）：
- 图片（PNG/JPG/WebP/GIF，≤5 MiB）→ 以图片形式加入消息：走 DSH 原生附件管线（输入框缩略图 + 消息图片块），模型侧由视觉桥接（如 modlens）自动转写，与粘贴图片完全一致；HEIC 等不支持的图片与超限图片自动退回路径上传。
- 文本文件 → 内容以内联代码块直接写入输入框，模型立即可见；
- 其他二进制 → 注入路径与大小，模型可用 read 工具读取。
上传文件夹（Chrome 的 webkitdirectory）：按目录结构整体落盘到 ~/.dsh/uploads/<时间戳>-<文件夹名>/…，草稿注入文件清单 + 文本文件内容预览（合计约 2.4 万字符封顶）+ 二进制路径；文件夹里的图片（上限 12 张）同样以图片形式加入消息。
图片也可以继续用「粘贴 / 拖入输入框」的原生通道，两者并存。

POST /dsh-postman/upload?name=<文件名>[&dir=<上传根名>][&rel=<相对路径>]

单文件模式（无 dir）：落盘 ~/.dsh/uploads/<时间戳>-<文件名>；
文件夹模式（同批共用 dir）：落盘 ~/.dsh/uploads/<dir>/<rel>，自动建目录，文件名冲突加 -2/-3，永不覆盖；
上限 25 MiB / 文件；dir 禁路径分隔符，rel 逐段净化并丢弃 ..；目录 0700、文件 0600；跨站 Origin 拒绝；
响应信封：{ ok: true, value: { name, path, root, size, kind, preview } }， kind === 'text' 时 preview 为 UTF-8 前 2 万字符。

把本仓库放进 Web profile 的依赖并声明插件行（dsh 会按包名在 /plugins/dsh-postman/client.js 提供浏览器半区）：

~/.dsh/profiles/web/package.json 增加 "dsh-postman": "link:/path/to/dsh-postman"（或发布后改用版本号依赖）；

~/.dsh/profiles/web/cordis.patch.yml 增加：

- insert:
    - id: ui-upload
      name: 'dsh-postman'

node client.test.cjs   # 客户端逻辑无头验证（18 项断言，模拟 react/fetch/commandUi）

MIT