文件拖入引用 lbl61/dsh-drop-in

dsh-drop-in

🌐 English: README.md

把系统文件管理器里的文件直接拖进 DeepSeek Harness Web 界面。文件会显示在输入框上方的文件栏里，或在输入框有焦点时以原生引用气泡（文件胶囊）内嵌插入到正在输入的文字中间；发送消息时随消息一起发出（含 绝对路径），并在气泡中渲染成文件卡片。助手读取的是真实路径——不上传、不复制内容（浏览器兜底时小文件会复制到工作区）。

文件栏与消息卡片消息气泡中的文件卡片

特性

- 📎 拖入任意文件/文件夹（图片也按文件处理——官方"拖图片"遮罩不再抢占拖拽）
- 🫧 输入框内嵌文件气泡：拖入/粘贴文件会在光标处插入原生引用气泡（文件胶囊，可插在文字中间）；气泡显示 类型 文件名（如 LNK 坚果云.lnk，长名截断时类型仍可见，悬停看全名）
- 📤 发送即路径：发送时气泡自动展开为含绝对路径的引用（@文件名），聊天气泡中渲染为文件卡片（带类型徽章），助手可直接按路径读取
- 🔀 agent 运行中发送（不打断） 的消息同样渲染文件卡片
- 🖼️ 剪贴板粘贴：在输入框粘贴图片/文件走同一管道（文件气泡或文件栏），不再落入官方原生图片附件轨；粘贴的二进制以 base64 落盘到工作区 .dsh-drops//
- 🚀 输入框上方文件栏：图标 + 名称 + 大小 + 路径状态，可单独移除（×），自动去重（同路径不重复添加）
- ✔️ 回车 / Ctrl+Enter / 发送按钮三条路径全覆盖；chips 随消息发送后自动清空
- 🔍 提供 dropped_files 工具，助手可随时读取尚未发送的拖入文件
- 🖥️ DSH Desktop（Electron）下绝对路径来自 preload 小桥（webUtils.getPathForFile，新版 Electron 唯一取路径方式）
- 🌐 兜底：普通浏览器（无 preload 桥）下，文本文件会复制到工作区 .dsh-drops/

安装

dsh plugin --profile web add https://github.com/lbl61/dsh-drop-in/archive/refs/tags/v1.4.0.tar.gz

或手动安装（bundle 形态）：
1. 解压 dsh-drop-in 到 ~/.dsh/profiles/web/node_modules/dsh-drop-in/
2. 在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组加入 "dsh-drop-in"
3. 重启 dsh web（DSH Desktop：完全退出再打开，或在 DevTools 控制台执行 window.dshDesktop.restartService()）

DSH Desktop：启用绝对路径（路径相关功能必做）

绝对路径来自 DSH Desktop 外壳的 preload 桥，不属于插件包本身。新版 DSH Desktop 把 preload 打包进 resources/app.asar，直接改文件的老办法已失效，而且每次 DSH Desktop 更新都会覆盖它。请运行插件自带的注入器：

node scripts/install-preload-bridge.mjs # 自动定位 DSH Desktop
node scripts/install-preload-bridge.mjs --dry-run # 只检查
node scripts/install-preload-bridge.mjs --restore # 还原（逐字节一致）

执行后完全退出并重启 DSH Desktop。若未注入：文件栏仍会出现，但状态显示「无法读取路径」，助手拿不到真实路径。详见 preload-bridge.md。

普通浏览器（无 Electron 外壳）下没有此桥：文本文件会走复制到工作区 .dsh-drops// 的兜底路径。

使用

1. 从资源管理器把文件拖进聊天页（或直接在输入框粘贴图片/文件）
2. 输入框有焦点 → 文件以原生引用气泡（文件胶囊）插入到光标处，可插在文字中间；否则出现在输入框上方的文件栏
3. 输入消息并发送（回车 / Ctrl+Enter / 发送按钮均支持；agent 运行中也可"不打断"发送）
4. 消息气泡中显示文件卡片——助手在消息里直接拿到绝对路径（@文件名 或 📎 拖入文件 块），可用自己的工具读取文件

工作原理

- 客户端半在捕获阶段拦截文件拖拽（官方图片上传流程不会抢走事件），维护按会话隔离的文件栏（conversation.input.dock），用文件卡片渲染用户消息气泡（conversation.chat.node 的 user/steering key），并在提交前把 📎 拖入文件 块拼进 draft（回车、Ctrl+Enter 和发送按钮三条路径都覆盖）；输入框有焦点时通过 slash/input-insert-reference scoped 事件插入原生引用气泡（U+FFFC occurrence，合成器 backdrop 渲染文件胶囊），提交时由注册的 inputTriggers codec 序列化为 @文件名
- 宿主半维护按会话的文件登记表，通过 dropped_files 工具提供给助手；文本文件写入 .dsh-drops//，粘贴的二进制经 file-copy 路由以 base64 落盘到同一目录（显式 workspace-write sandbox 策略，根 = 会话 cwd）
- DSH Desktop 下绝对路径依赖 preload 桥（见 preload-bridge.md）：Electron ≥ 32 已移除 File.path

配置

| 设置项 | 说明 |
| enabled | 总开关（设置 → 文件拖入）。关闭后拖拽/粘贴行为回落到内置逻辑。 |

卸载

1. 从 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 移除 dsh-drop-in
2. 删除 ~/.dsh/profiles/web/node_modules/dsh-drop-in/
3. 重启 dsh web

许可

MIT