dsh-host-paths

把文件拖进 DSH Desktop，输入框里得到的是 @路径 引用，而不是一份被上传的副本。

dsh-host-paths 是一个只做一件事的小插件：把桌面壳 preload 里的文件路径桥 （window.__DSH_DESKTOP_FILE_PATH__）接到 DSH 输入框本来就有的宿主路径接缝 （globalThis.__DSH_HOST_PATHS__）上。接上之后，官方 composer 自己就会把拖入的文件转成 @路径 chip——不需要插件抢事件，也不需要它替你读文件。

问题

DSH 的输入框里有两条互斥的落地路径（dsh-client-ui-conversation 的 addFiles）：

path = 宿主路径桥?.pathFor(file) ?? ""
path === "" || 图片        → 上传（file draft，物化到会话附件目录）
否则                      → @路径 引用 chip（零上传）

而 __DSH_HOST_PATHS__ 这个名字在 DSH Desktop 里没有任何代码写入：壳只暴露 __DSH_DESKTOP_FILE_PATH__（Electron webUtils.getPathForFile）。于是第二条分支永远不走， 拖什么都是上传——哪怕 Electron 明明知道那个文件的真实路径。

本插件就是把这两个名字接起来的那一行。

装上之后

你做的事	结果
拖入非图片文件（docx / xlsx / pdf / zip…）	输入框出现 @绝对路径 chip，零上传、零复制；文件在工作区内时自动写成相对路径
拖入文件夹	出现 @路径/ 文件夹 chip
拖入图片	仍走原生图片通道上传（官方设计：缩略图、尺寸探测、多图限额都在这条路上）
路径含空格	自动用 @"带 空格 的 路径.docx" 引号语法
壳拿不到真路径（OneDrive 占位符、压缩包内拖出、纯浏览器打开）	自动回落成官方原有的上传行为，不会报错

不做的事：不读文件内容、不复制、不搬移、不删改、不联网、不注册任何 host 服务， 也不覆盖别人已经装好的同名前接缝（未来的 DSH 如果自己接了，本插件自动让位）。

安装

# 从 GitHub（建议钉住 commit）
dsh plugin --profile desktop add github:384124694/dsh-host-paths#<sha>

# 从本地检出
git clone https://github.com/384124694/dsh-host-paths.git
dsh plugin --profile desktop add link:$HOME/dsh-host-paths

--profile 填你实际在用的那个（DSH Desktop 通常是 desktop，纯 dsh web 是 web）。 重启 DSH Desktop（或重跑 dsh web）并刷新页面后生效——客户端半是启动时编进 __DSH_BOOT__ 的。包内已带构建产物（lib/），无需构建步骤。

验证

F12 打开 Console：

window.__DSH_HOST_PATHS__                        // 装好后应为 { pathFor: ƒ }
typeof window.__DSH_DESKTOP_FILE_PATH__?.getPathForFile   // 应为 "function"
window.__DSH_HOST_PATHS__.pathFor($0)            // 在 Elements 里选中一个 file input 的 File 再试

然后拖一个非图片文件：输入框应出现 @路径 chip，输入框上方不该出现文件卡片（那就是上传）。

卸载

dsh plugin --profile desktop remove dsh-host-paths

重启后接缝消失，拖拽回到官方默认行为。

开发

npm test        # node --test：7 项行为测试，不需要 DSH 服务器

lib/client.js 是手写的经典脚本（window.__ModuleLoader__.load({ id, factory })）， 没有构建步骤：改完直接重启 profile 即可。lib/index.js 是空的 host 半，只为了让这个 bundle 在 Loader 里有一个条目、客户端产物才会进 __DSH_BOOT__。

已知边界

• 只在 DSH Desktop（Electron）里有意义。 普通浏览器没有路径桥，本插件静默不装接缝， 拖拽保持官方行为（上传）——它不会假装成功。
• 图片仍然上传，这是官方 composer 的既定分支，本插件不改变它。
• 引用 chip 里的路径：文件在工作区内时是相对 cwd 的路径，否则是绝对路径。
• 若某个未来 DSH 版本自己写了 __DSH_HOST_PATHS__，本插件检测到已有值就不覆盖。

License

MIT