DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-drag-out

d

dsh-drag-out

Manifest valid

Drag a delivered file from the chat straight into WeChat, Word or any app — the real file from disk, via the DSH desktop app.

UI (client)hasBundlePatch

dsh-drag-out

把对话末尾的交付物卡片直接拖到别的应用里——微信、Word、资源管理器、剪贴板之外的任何能接收文件的地方。

不复制、不中转、不打开文件夹:拖出去的就是磁盘上那个真实文件。

对话末尾的产物卡片
┌──────────────────────────────────────────────┐
│ 🖼  final.png   final frame      ⠿ 拖出  ↗   │
└──────────────────────────────────────────────┘
                                  按住往左拖 →

安装

dsh plugin add github:RDYRD/dsh-drag-out

装完完全退出 DSH 再启动——插件加载器只热更 cordis.patch.yml,不重载已经加载的 JS。

为什么需要它

DSH 的产物卡片点击后只在侧边栏预览。要给微信发图、往 Word 里插图、拖进别的目录, 原来的唯一路径是「打开文件位置 → 再拖一次」。这个插件在卡片右侧加一个抓手, 按住它往目标应用一拖即可。

使用

  1. 让 DSH 在对话里交付文件(产出的图片、文档、模型等都算)。
  2. 对话末尾的产物卡片右侧会出现 ⠿ 拖出 按钮。
  3. 按住它,移动鼠标(超过 4px 即进入拖拽),拖进微信 / Word / 资源管理器 / 邮件……
  4. 松开,完成。

点一下不会打开预览,也不会误触发——只有真的按住并移动才开始拖。

只做桌面应用

浏览器标签页里看不到这个按钮。原生文件拖拽需要 Electron 的 webContents.startDrag,浏览器没有等价能力(HTML5 拖拽只能拖「下载链接」, 拖进微信会变成一条消息而不是文件)。插件在 window.dshDesktop?.fileDrag 不存在时直接不渲染,所以浏览器里界面完全不变。

原理(三段,没有黑魔法)

  1. 坐标 → 路径:卡片给的 actionUrl 里带着 sessionId / seq / index。 插件的 Host 端路由 GET /api/drag-out.resolve 走 sessionQuery.readEvent + workspaceFiles.stat,把这三个坐标还原成 磁盘绝对路径(和官方「打开方式」按钮同一套鉴权栅栏)。
  2. 路径 → 资源地址:还原出的绝对路径被编成 dsh-resource://file/session/<sessionId>/<逐段编码的路径>。桌面壳只对 Session 范围的地址放行,所以相对路径、跨 Session 的路径都过不去。
  3. 资源地址 → 原生拖拽:浏览器半把地址交给 window.dshDesktop.fileDrag.prepare(),桌面壳校验文件确实是该 Session 里的那个 普通文件、大小与哈希未变,再借 getFileIcon 取图标生成拖拽句柄; 指针一移动就 start(handle) 交给系统,落点应用收到的是真实文件。

如果第 3 步被拒(桌面壳会按 mediaType 重新拼一次拖拽文件名,拼出来的名字与 磁盘上的名字不一致时它会静默拒绝),插件自动改写路径:走 GET /api/drag-out.bytes 把同一份字节取回来,用 kind: 'bytes' 再做一次 prepare。字节拖拽没有路径可比对,因此不会再被文件名规则挡住——代价是一次内存拷贝。 DSH 0.2.2-rc.3+ 自带的 fileDrag 服务若可用,是更上层的同类兜底。

整个过程对文件只读:不复制、不改名、不移动、不进回收站。

边界

  • 文件必须还在。拖出前桌面壳会重新 stat + 校验哈希;文件被删或被改, 卡片会显示「拖出失败」而不是拖出一个旧副本。失败原因会出现在按钮的悬停提示里。
  • 大文件会慢一点。prepare 阶段要读一遍文件算 sha256,几百 MB 的视频 按下时会有可感知的等待(按钮显示「准备中…」)。
  • 走字节兜底的文件上限 128 MB。路径拖拽本身没有这个限制,但一旦被桌面壳 的文件名规则拒绝,插件改为把字节交给它,超过 128 MB 会直接报失败。
  • 跨应用限制来自系统,不来自插件:某些应用(只收文本输入框的聊天窗口) 本来就不接收文件拖放。
  • 只在桌面应用里出现,且需要 DSH ≥ 0.2 的桌面壳(dshDesktop.fileDrag)。 DSH 0.2.2-rc.3 及其后版本的桌面壳会重写拖拽文件名,插件已内置字节兜底; 0.2.2-rc.2 及更早的壳只做字符清洗,快路径直接成功。

升级 / 卸载

dsh plugin update dsh-drag-out    # 或重新执行一次 add
dsh plugin remove dsh-drag-out

也可以走插件管理器(plugin_manager 的 install_bundle / remove_bundle)。改过 lib/*.js 之后同样要完全退出 DSH 再启动才生效——加载器只热更 cordis.patch.yml。

开发

node test\probe-host.mjs     # Host 路由:坐标→地址的解析与错误码
node test\probe-client.mjs   # 客户端 bundle:加载、注册、渲染、一次完整手势

两个探针都只跑假环境,不碰真实文件,也不启动 DSH。真机行为(拖进微信是否 得到图片)必须手动验证。

文件

文件作用
lib/index.jsHost 半:GET /api/drag-out.resolve,坐标 → Session 资源地址
lib/client.js浏览器半:deliverables.file.actions 里的拖出抓手
cordis.patch.ymlbundle 补丁:把 dsh-drag-out 的 Host 行插进 profile
test/probe-*.mjs假环境探针

Comments

Loading…

Similar plugins

dsh-doc-quick

Drag documents into the dsh web chat; the agent reads them directly from the local filesystem and the right sidebar lists the outputs and file paths.

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 0

dsh plugin --profile web add dsh-doc-quick

by QinpanWan

Drag documents into the dsh web chat for direct local-file processing; a right sidebar lists outputs and file paths. 拖拽文档进 Web 对话框快速处理,右侧侧栏展示产出。

Development & InfrastructureManifest valid

★ 1

MIT

JavaScript

Aug 25, 2026

dsh plugin --profile web add dsh-doc-quick

by Zenjibad

Extends the DSH web chat drag-and-drop to accept every file type: non-image files are saved into the active session workspace so the agent can read and use them.

Tools & CapabilitiesUI & ExperienceManifest valid

★ 2

MIT

TypeScript

Sep 10, 2026

dsh plugin --profile web add dsh-drop-any-file

by Arrosam

Adds upload, download, new folder, delete, drag-to-move, drag-to-chat and in-place text editing with auto-save to the workspace Files tab and file previews.

UI & ExperienceManifest valid

★ 3

↓ 451/wk

MIT

JavaScript

Nov 4, 2026

dsh plugin --profile web add dsh-better-workspace-file-manager

by jidekaixin2dian

Right-click any file reference in the chat to open it, open it with an associated application, reveal it in the file manager, copy its path or contents, and save it.

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 8

↓ 793/wk

MIT

JavaScript

Nov 17, 2026

dsh plugin --profile web add @jidekaixin2dian/dsh-file-actions

by thawline

把交付卡片和消息图片拖到 Windows 桌面,并附上「打开所在文件夹 / 复制路径 / 另存为」

Manifest valid

★ 0

MIT

JavaScript

Nov 8, 2026

dsh plugin --profile web add dsh-desk-drop