dsh-text-drop
DSH Web GUI 文本文件拖拽导入插件:把 md / txt / log / 代码等文本文件拖进页面, 按内容长度自动处理 —— 短内容直接进输入框,长内容复制到工作区并粘贴可读路径。
About
DeepSeek Harness(DSH)Web GUI 的文本文件拖拽导入插件。默认的 Web 输入框只接受图片拖拽, 拖入文本文件会被当作"不支持的图片类型"丢弃;本插件补齐了这一环,并把处理方式按内容长度 自动分流:
- 短文本(<= 1000 字):内容直接插入当前会话输入框,发送前可检查、可编辑。
- 长文本(> 1000 字):由 Host 端复制到会话工作区的
.dsh/drops/目录,输入框粘贴
反引号包裹的绝对路径 —— 文件落在工作区内,模型可直接读取,无需额外授权步骤。
- 图片拖拽:完全放行原生图片附件通道,行为与默认一致。
- 拖拽体验:捕获阶段拦截文本拖入,抑制原生"拖拽图片"全屏遮罩,改为轻量中性提示,
松手立即消失、无残留。
技术要点:纯官方 NPM SDK(@deepseek-ai/*)开发,零 DSH 源码改动;Host/Client 双半区 通过 /api/dsh-text-drop/save 路由协作(loopback 信任围栏);文本识别覆盖 70+ 常见 扩展名与 MIME;文件落盘路径由会话工作区决定,重名自动去重,10MB 内容上限保护传输。
行为
| 拖入内容 | 处理方式 |
|---|---|
| 文本文件,内容 <= 1000 字 | 内容直接插入当前会话输入框(可检查后发送) |
| 文本文件,内容 > 1000 字 | Host 复制到 <会话工作区>/.dsh/drops/ 目录,输入框粘贴反引号包裹的绝对路径;文件落在工作区内,模型可直接读取(workspace-write 策略,无需额外审批) |
| 图片 | 完全放行给原生图片附件通道,行为不变 |
| 混合拖入 | 仅导入文本文件,toast 提示图片请单独拖入 |
其他细节:
- 文本识别:70+ 常见文本扩展名(md/txt/log/json/yaml/py/ts/...)+
text/*MIME + Makefile/README 等无扩展名惯例名。 - 拖拽过程中抑制原生"拖拽图片"全屏遮罩(其 dragenter/dragover 被捕获阶段掐断),改为轻量中性提示;松手立即消失,不残留。
- 大文件路径带重名去重(
name.md、name-1.md、name-2.md...)。 - 内容上限 10MB(超出提示不导入)。
- 落盘目录
.dsh/drops/位于会话工作区内,由会话的 cwd 决定(内存会话 -> 持久化 meta -> sandbox 工作区根,逐级兜底)。
组成
| 半区 | 入口 | 职责 |
|---|---|---|
| Host | src/index.ts + src/routes.ts | 注册 /api/dsh-text-drop/save 路由(loopback 信任围栏),把大文件写入工作区 .dsh/drops/ |
| Client | src/client/index.ts | document 级捕获阶段拖拽监听、文本识别、输入框写入、遮罩与 toast(经 shell.overlay / conversation.input.left 插槽) |
纯官方 NPM SDK(@deepseek-ai/*)开发,不修改 DSH 源码。
构建
pnpm install
pnpm build # tsc 类型声明 + tsdown(node 半区 lib/index.js + 浏览器半区 lib/client.js)安装到 dsh web profile
dsh plugin --profile web add link:D:/developing/DSH-plugin/dsh-text-drop或手动等价步骤(junction + patch 行):
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\@icelily\dsh-text-drop" -Target "D:\developing\DSH-plugin\dsh-text-drop"
# 在 ~/.dsh/profiles/web/cordis.patch.yml 的 insert 列表追加:
# - id: text-drop
# name: '@icelily/dsh-text-drop'然后重启 dsh web(client 端刷新页面即生效;host 端路由重启后加载最新代码)。
卸载
Remove-Item "$env:USERPROFILE\.dsh\profiles\web\node_modules\@icelily\dsh-text-drop"
# 移除 cordis.patch.yml 中的 text-drop 行,重启 dsh web验证
- 拖短 md:内容出现在输入框,toast「已将 1 个文本文件内容插入输入框」。
- 拖长 md:toast「文件较大(...字),已复制到工作区并粘贴路径」,输入框出现反引号路径;文件在
<工作区>/.dsh/drops/下。 - 拖图片:正常进入附件栏,原生图片通道不受影响。
- 拖拽悬停:中央虚线提示,松手即消失,无残留遮罩。