dsh-postman

Readme

# dsh-postman（邮差）· DeepSeek Harness 会话内上传插件

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

入口在输入框工具行左侧的 **+ 命令菜单**里：`/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` 提供浏览器半区）：

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

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

3. `pnpm --dir ~/.dsh/profiles/web install`，重启 `dsh web`（客户端改动仅需刷新页面）。

## 自检

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

## 许可证

MIT