前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在开发智能体或调试代码时，开发者经常需要将本地文件、代码片段或日志文件作为上下文传递给模型。DSH Drop 插件通过在 Web 和桌面客户端中增加拖放与预览功能，解决了输入框附件体验有限的问题。
核心功能¶
DSH Drop 主要提供以下能力：
- 拖放与粘贴支持：支持将文件或文件夹直接拖入 DeepSeek Harness 的 Web 页面或桌面应用，也支持粘贴剪贴板中的文件。
- 统一预览栏：图片和文件共享一个预览栏，便于统一管理。
- 按需添加引用：文件路径仅在发送消息时才被附加到输入框，保持草稿整洁。
- 原生附件支持：支持 PNG、JPEG、WebP、GIF 等图片作为原生附件。
- 文件与文件夹引用：支持 PDF、视频、音频、文本文件引用，以及文件夹引用（格式为
@path/to/folder/）。 - 互补 DSH Viewer：该插件补充了 DSH Viewer，后者负责将文件内容从模型端展示给用户。
安装与启用¶
Web 环境¶
Web 环境下，该插件依赖系统 PATH 中的 pnpm，且 Node 版本需为 22 或 24。安装预编译的 tarball 包后需重启 Web 侧：
dsh plugin --profile web add https://github.com/Crosery/dsh-drop/releases/latest/download/dsh-drop.tgz
桌面应用¶
在桌面应用中，无法使用命令行安装，需通过图形界面操作：
- 打开应用菜单，进入 Plugins → Add plugin。
- 粘贴发布版下载 URL：
https://github.com/Crosery/dsh-drop/releases/latest/download/dsh-drop.tgz
- 重启应用以加载插件。
典型用法¶
安装完成后，可以按照以下步骤使用：
- 打开一个会话。
- 将文件或文件夹拖入页面，或在页面空白处粘贴。
- 在预览栏中点击卡片，可以预览内容或移除该文件（拖放同一文件两次只会添加一次）。
- 输入请求文字，按下 Enter 或点击发送按钮。此时文件路径会作为引用（如
@path/to/file）被添加到消息中。
适用场景与注意¶
适用场景：适用于需要频繁在对话中引用本地文件、日志或代码片段的开发者，以及希望保持输入框整洁的用户。
注意事项：
- Web 依赖：Web 环境必须安装
pnpm且 Node 版本符合要求，否则无法安装。 - 模型工具：该插件不会为模型添加新的工具。非图片文件会被转换为路径引用（
@path），模型必须显式调用工具才能读取文件内容。 - 文件夹限制：文件夹引用受限于文件数量、总大小、单个文件大小上限以及嵌套深度。如果超出限制，上传会被整体拒绝并提示。
- 重复安装：如果本地已有对
@crosery/dsh-drop的补丁挂载，不要重复安装。
总结¶
DSH Drop 通过提供统一的拖放体验和预览栏，简化了文件在 DSH 中的输入流程。它不改变模型的能力，而是优化了开发者与文件交互的交互方式。如需查看源码或更多细节，可访问 GitHub 仓库。
