本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-drag-and-drop

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-drag-and-drop

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 将文件拖入 Web UI 任意位置即可插入原始绝对路径
• 拖拽过程中显示全页面压暗和模糊提示
• 支持文件和文件夹，也支持一次拖入多个项目，每个路径占一行
• 支持 macOS、Linux 和 Windows 原生路径
• 支持 POSIX 路径、Windows 盘符路径和 UNC 网络路径

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

拖入文件会上传到服务器吗？会复制/移动文件吗？

不会。插件只在浏览器读取拖入项的文件名、大小、修改时间等元数据；只有在多个候选同名同大小时，才会读取少量文件内容计算指纹用于比对。整个过程文件始终留在原目录，不上传、不复制、不移动、不修改、不删除。

安装后为什么没反应？

客户端 bundle 只在全新页面加载时挂载，所以安装或升级后必须先重启 DSH Web 服务，再在浏览器做硬刷新（Cmd/Ctrl+Shift+R）。可以用 dsh --profile web --dump-config | grep drag-and-drop 确认 bundle 已注册到 profile。

大磁盘上拖入后等很久才出结果，怎么加快？

拖入命中速度取决于本机索引。Linux 推荐安装 plocate，Windows 推荐安装 Everything CLI（提供 es.exe），插件会优先调用它们；macOS 自带 Spotlight，无需额外配置。把文件放在 Workspace 或常用目录内也能命中更快的浅层扫描路径。

拖入后插入了错误的同名文件副本，怎么办？

候选先按完整文件名和大小过滤，再用文件开头/中间/结尾三段采样指纹比对；如果大文件采样后仍无法区分，才会计算完整 SHA-256；若仍有字节级相同的副本，插件会弹出候选路径列表让你点选。

拖入后浏览器弹了"不支持的图片格式"提示，正常吗？

这是被插件主动替换过的：拖入文件/文件夹但目标不是图片时，原 toast 会显示为"不支持的图片格式：xxx（已由拖拽插件插入文件路径）"。插件告诉你"已被拖拽插件处理过"，原始绝对路径已经写进会话输入框，不是真的失败。

文件夹能拖吗？一次拖多个会怎样？

文件和文件夹都能拖。一次拖多个项目时，插件按"Workspace 优先 → 系统索引"的策略逐个解析，每个候选路径各占一行写入当前会话输入框的草稿；已经存在的草稿内容不会丢，会换行追加。

怎么升级、怎么卸载？

升级用 dsh plugin --profile web update github:bill9109/dsh-drag-and-drop；卸载用 dsh plugin --profile web remove @omdsh-dev/dsh-drag-and-drop，之后再重启 Web 服务并硬刷新浏览器。如果是本地 checkout 安装，升级时直接对替换后的目录重新执行 add。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: ^20.0.0 || >=22.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则