dsh-folder-drop
DSH Desktop 插件：拖入文件夹时把其原生绝对路径插入 composer 草稿（DSH 原生只收文件）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:chiyu-star499/dsh-folder-drop#897ea318606f84f1b8865277840d9b3f0e45b29aFolder Drop 以 dsh-folder-drop 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把文件夹拖进 DeepSeek Harness，得到它的原生绝对路径。
Drag a folder into the DSH Desktop composer and get its real absolute path in the draft — no copy, no upload.
DSH 的 composer 原生只收文件。拖放链路只读 dataTransfer.files
（@deepseek-ai/dsh-client-ui-attachment 的 ComposerAttachments），文件选择器是没有
webkitdirectory 的 <input type="file" multiple>，粘贴只认 kind === "file" 的项；
而浏览器从不把目录内容当 File 交出来。结果是：拖文件夹要么毫无反应，要么在附件栏里
变成一个 0 字节空壳。
本插件补上这一段：目录拖进来 → 直接把路径写进草稿，交给 agent 自己的文件工具去读。
| 拖放内容 | 结果 |
|---|---|
| 纯文件 / 纯图片 | 一行不碰，完全交回 DSH 原生附件链路 —— 附件栏、上传进度、失败重试、图片预览全部保持原样 |
| 含文件夹（可以与文件混拖） | 本插件独占本次拖放：把每一项的原生绝对路径按换行追加进当前草稿；同时补一个 synthetic dragend，让 DSH 的全屏拖放遮罩正常收起 |
| 含文件夹但取不到路径 | 通过 DSH 自己的 error 提示报出失败项名，绝不静默 |
写入走 DSH 公开的输入门面（不触碰输入框 DOM）：
ctx.conversation.input.for(ctx.sessions.scope(sessionId)).setDraft(text)
按优先级依次尝试：
window.__DSH_DESKTOP_FILE_PATH__.getPathForFile(file) —— DSH Desktop 的 preload.cjs 已用
contextBridge 暴露的 Electron webUtils（拿到真实路径的正规入口）file.path —— 旧版 Electron 的历史属性entry.file() —— 个别 Chromium 版本只在目录项上给这条异步通道text/uri-list / text/plain 里的 file:// URL —— 整批兜底时序约束：Chromium 的 DataTransfer 保护模式让
items[i].webkitGetAsEntry()、items[i].getAsFile()、dataTransfer.getData()只在 drop 事件派发期间有效。 本插件在 drop 处理器的同步段把这些一次性读成快照，异步段只用快照 —— 改代码时别"优化"成惰性读取。
# 从 GitHub 装
dsh plugin --profile desktop add github:chiyu-star499/dsh-folder-drop
# 或从本地目录装
dsh plugin --profile desktop add file:/path/to/dsh-folder-drop
profile 认准
desktop：DSH Desktop（GUI）跑的是desktopprofile；dsh/dsh web默认是web，装进web对 GUI 无效。装完必须重启 DSH Desktop：配置与插件装载改动不依赖
patchReload: live。
add file:<目录>实测是拷贝安装（不是软链）——改源码后需要重新add才会生效。
dsh plugin --profile desktop remove dsh-folder-drop
然后重启 DSH Desktop。插件不写任何状态文件，卸载即彻底还原；profile 的 package.json
与 cordis.patch.yml 由 dsh plugin 自动登记/移除。
| 组件 | 版本 | 状态 |
|---|---|---|
| DSH Desktop | 2.0.13 | ✅ 真机验收通过 |
dsh 核心 | 0.1.5-rc.2 | ✅ |
依赖的是 ctx.sessions.scope() / ctx.conversation.input.for() / .setDraft() / .notify()
这些公开客户端服务面。核心里这几处若在后续版本改名，插件需要跟着改（见下方「开发」）。
node ./scripts/build-client.mjs # src/client.js → lib/client.js（__ModuleLoader__ 外壳）
node ./scripts/smoke.mjs # 38 条断言：清单契约 / 产物形态 / 纯函数 / drop 行为
lib/client.js 是生成物，不要手改：改 src/client.js 后重跑构建，再重新 add。
客户端 bundle 的形态是 DSH 客户端模块系统要求的
window.__ModuleLoader__.load({ id, factory }) + 惰性 CJS factory；宿主按
package.json 的 exports["./client"] 解析入口，缺失 lib/client.js 会让插件激活直接失败。
dsh-drag-and-drop、
dsh-drop-to-path 功能重叠，不要同时安装。MIT © 2026 chiyu-star499
API 用法参考了 dsh-drag-and-drop
（BSD-3-Clause）对 DSH 客户端服务面的用法；本插件为独立实现，且不需要它那套 host 侧定位引擎
（DSH Desktop 直接给真实路径）。