kongbai-shike/dsh-drop-path

dsh-drop-path

拖入本地文件时，自动把文件的电脑绝对路径填入输入框，并复制到剪贴板。
Drop a local file into DSH and its absolute filesystem path lands in the composer.

DSH 的输入框只接受图片附件，拖其它文件（.txt / .pdf / .zip / 代码……）通常会被拒绝，什么也不会发生。
本插件接管这类被拒绝的拖放：提取文件在磁盘上的真实路径，写进输入框，顺手复制到剪贴板 ——
于是可以直接把路径发给模型去读。

原理

DSH 桌面端 preload 暴露了 window.__DSH_DESKTOP_FILE_PATH__.getPathForFile(file)（一个
contextBridge 桥，内部是 Electron 的 webUtils.getPathForFile），本插件用它把操作系统拖拽的
File 对象解析成真实路径，例如 C:\work\report.pdf、/home/you/report.pdf。

插件本体是一个 DSH 服务端 bundle 插件（cordis 风格 name / inject / apply）：

- ctx.webServer.register 注册 /dsh-drop-path/script.js；
- ctx.webServer.tapIndex 把  注入网页 index；
- 注入的脚本在 window 捕获阶段监听拖放，把路径写进当前输入框
（兼容 textarea 与 contenteditable，对 React 受控输入走原生 setter + input 事件）。

行为模式

左下角有一个小的「路径拖放」开关，点按钮循环切换或下拉选择，状态存在浏览器 localStorage：

| 模式 | 说明 |
| --- | --- |
| 自动（默认） | 非图片文件（含未知类型）→ 填入路径；纯图片拖放 → 交回 DSH 当附件处理。 |
| 总是 | 所有文件的拖放都填入路径（包括图片）。 |
| 关闭 | 不拦截，恢复 DSH 原行为。 |

控制台排障：

window.__dshDropPath.reset()                        // 强制清掉可能残留的拖拽浮层
window.__dshDropPath.setMode('off'|'auto'|'always') // 直接切模式
window.__dshDropPath.mode()                         // 读当前模式

实现要点：不要和 DSH 自带的拖放浮层打架

DSH 的 ComposerAttachments（@deepseek-ai/dsh-client-ui-attachment）在 document 上以冒泡方式监听
dragenter / dragover / dragleave / drop，dragenter 时就 setDragActive(true) 弹出「拖入图片」浮层，
而浮层只有它自己的 drop 处理或 window 的 dragend 才会关掉：

const onDragEnter = (event) => { /* 有 Files 就 / event.preventDefault(); dragDepth.current += 1; setDragActive(true) }
const onDrop      = (event) => { ...; event.preventDefault(); reset(); if (canAcceptDrop) onAddImages([...dataTransfer.files]) }
window.addEventListener('dragend', reset)

又因为它的 canAcceptDrop 只判断「编辑器是否空闲、是否支持图片」而不看文件类型，
所以拖任何文件都会弹浮层。于是有一个很容易踩的坑：如果在 document 的捕获阶段监听 drop
并 stopPropagation()，DSH 的 onDrop 就永远不会执行 → reset() 不被调用 → 浮层永久卡在屏幕上。

本插件的做法：

- 监听挂在 window 的捕获阶段（早于 document 上的任何监听）。要接管的拖放直接 stopPropagation()，
DSH 完全看不到这次拖拽 → 浮层根本不会出现，也就无从卡住。
- 开始接管时向 window 派发一次 dragend，强制 DSH 的 reset() 跑一遍，清掉可能残留的浮层；
用 syntheticDragEnd 标记避免这个自派事件误清自身状态。
- drop 阶段用真实的 File.type 再确认一次：若最终是纯图片，不吞事件，交回 DSH 正常当附件收下
（DSH 的 onDrop 不依赖 dragActive，所以浮层没出现也能收下图片）。
- 1.2s 看门狗：拖拽被 Esc 取消、dragleave 丢失时，提示条自己消失，绝不留残影。

安装

已发布到 npm 后：

dsh plugin --profile  add dsh-drop-path

本地开发（把本仓库目录 link 进 profile）：

dsh plugin --profile  add link:
等价于在 profile 目录执行：pnpm add link:

手动方式：把包装进 profile 的 node_modules，并把 dsh-drop-path 加进
/profiles//package.json 的 dsh.profile.bundles 数组：

"dsh": {
"profile": {
"bundles": [
/ ...原有 bundle... */
"dsh-drop-path"
]
}
}

生效

bundle 层是 profile 启动时读取的。新增 bundle 需重启 DSH（或让该 profile 重新加载），
之后刷新网页即可看到左下角的「路径拖放」开关。

注意：仅改动 client/drop-path.js（客户端脚本）时不需要重启 —— 服务端路由每次请求都重新读文件
并带 Cache-Control: no-store，刷新页面即可。

测试

node test/logic.test.mjs

用最小 DOM 桩在 Node 里加载 client/drop-path.js 并驱动事件，无需浏览器。覆盖 19 条断言：
非图片 / 图片 / 混合 / 关闭 / 无 preload 桥 的接管判定、提示条显隐、剪贴板内容，
以及「拖拽被 Esc 取消时提示条必须自动消失」的看门狗行为。改客户端逻辑后请先跑它。

兼容性

- 仅桌面端有意义：依赖 DSH Desktop 的 preload 桥。拿不到桥时会自动完全不接管，不影响 DSH 原行为。
- 仅桌面端路径：普通浏览器出于安全不暴露本地路径，本插件在这种情况下自动降级。

文件结构

dsh-drop-path/
package.json          # 声明 dsh.bundle.patch -> ./cordis.patch.yml
cordis.patch.yml      # 把 dsh-drop-path 插入 profile 层栈
lib/index.js          # 服务端：注册路由 + tapIndex 注入脚本
client/drop-path.js   # 注入到页面的客户端逻辑
test/dom-harness.mjs  # 最小 DOM 桩
test/logic.test.mjs   # 回归测试

License

MIT