dsh-file-bridge
DSH（DeepSeek Harness）文件收发桥：在对话里双向交换文件——📎 附件按钮上传、send_files 工具下发、反引号路径一键调起侧边栏 explorer 打开。
能力
| 方向 | 功能 |
|---|---|
| 📥 用户 → agent | 输入框 📎 附件按钮：手机/浏览器选图或文件；图片压缩后走官方原生预览条（随消息发送），非图片上传为可访问链接 |
| 📤 agent → 用户 | send_files 工具：图片渲染为可点击预览（打开原图/右键另存为），其他文件为 📎 下载链接 |
| 📤 explorer 跳转 | send_files 回复正文用反引号包住源文件绝对路径（` /root/proj/a.md `）→ 前端渲染为可点击按钮 → 点击调起侧边栏 explorer 打开文件 |
| 🗂️ 静态服务 | /dsh-files/* 只读伺服共享目录（防路径穿越、中文文件名 RFC 5987 编码） |
> 图片内容的自动 mmx 识别由配套插件 dsh-image-mmx 提供（原生图片块识别，文本模型也能看图）。
安装
前置：DeepSeek Harness 0.1.0-rc.6+、Node.js 18+。
dsh plugin --profile web add 'github:fengs2021/dsh-file-bridge'
systemctl restart dsh-web # 或重启 dsh web配置（cordis.patch.yml）
- insert:
- id: file-bridge
name: dsh-file-bridge
config:
publicBase: "http://你的公网地址:端口" # 生成文件 URL 的基础地址，必须配置
filesDir: "/root/.dsh/files" # 共享文件目录（默认 ~/.dsh/files）publicBase：send_files/上传生成的 URL 前缀，部署时必须改成你的公网访问地址filesDir：可选，文件落盘目录
使用
用户 → agent（📎 附件按钮）
1. 输入框上方点 📎 附件 → 系统文件选择器 2. 图片：压缩（最长边 1600px）→ 原生预览条 → 随消息发送（agent 可看图，识别交给 dsh-image-mmx） 3. 其他文件：上传 → 输入框插入 📎 [文件名](url) → 发送
agent → 用户（send_files）
agent 调用 send_files 工具后，回复正文应包含：
[](http://host/dsh-files/封面.png) ← 图片可点开
📎 [报告.pdf](http://host/dsh-files/报告.pdf) ← 文件可下载explorer 跳转：同一轮回复里用反引号包住传给 send_files 的源路径（不是复制后的产物路径）：
文件在 `/root/proj/a.md`，点击可在 explorer 打开。架构
浏览器/App ──📎 选文件──▶ 图片:原生预览条(官方 drop 管线) / 文件:RPC POST /files/upload
浏览器/App ◀──GET /dsh-files/*── 静态服务（只读，防穿越）
agent ──send_files(presentCall 声明 locations)──▶ 复制到共享目录 ──▶ markdown + 反引号路径
反引号路径 ──fileMentions──▶ 前端可点击按钮 ──openFile──▶ 侧边栏 explorer- client 模块
immediately: true（boot 即注册附件按钮） - RPC 返回符合 dsh 协议：
{ ok: true, value }/{ ok: false, error } - 上传走
/files通道，nginx 需放宽client_max_body_size（默认 1m 会 413，建议 25m）
常见问题
| 现象 | 原因 / 解决 |
|---|---|
| 附件按钮点击无反应（Android WebView） | App 端需实现 WebChromeClient.onShowFileChooser（标准 WebView 文件选择支持） |
| 上传报 HTTP 413 | nginx client_max_body_size 太小，设为 25m |
dir is not defined / crash loop | 插件目录 node_modules/@deepseek-ai/dsh-tools 缺失——桥接到 dsh 主装包：ln -s /usr/local/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai/dsh-tools <插件目录>/node_modules/@deepseek-ai/dsh-tools |
| 反引号路径不可点击 | 必须是工具调用的源路径 + 与回复同轮（turn 级生效） |
License
MIT