前言¶
在 DeepSeek Harness (DSH) 的 Web GUI 环境中，开发者经常需要将本地文件的内容直接传递给智能体。如果通过 API 接口操作，通常需要搭建服务端来处理文件上传；而直接复制粘贴文本又效率低下且容易出错。dsh-paperclip 插件解决了这一痛点，它通过在 Web GUI 输入框中增加文件处理能力，让文件内容可以直接注入到对话上下文中。
插件介绍¶
该插件由用户 zmm863-commits 维护，是一个开源的客户端插件。其核心功能是在 DSH Web GUI 的文本输入框右侧添加一个回形针图标按钮。用户可以通过点击按钮选择文件，或者直接将文件拖拽至输入框区域，文件内容会自动提取并插入到文本框中，方便后续发送给 agent 处理。
核心功能¶
- 操作方式：支持点击输入框右侧的回形针按钮打开文件选择器，也支持直接将文件拖拽进输入框。
- 文件格式：支持常见文本和代码格式，包括 HTML、JS、TS、CSS、JSON、MD、Python 等 30+ 种扩展名。
- 批量上传：支持多文件批量上传，限制为最多 10 个文件，单个文件大小不超过 5MB。
- 技术实现：完全在浏览器端运行，不依赖任何服务端，确保数据隐私安全。
安装与启用¶
安装该插件需要使用 DSH 的命令行工具。请确保你的环境已配置好插件管理工具。
dsh plugin --profile web add dsh-paperclip
安装完成后，刷新 DSH Web GUI 页面即可生效。插件基于 MIT 许可证开源，建议在安装前检查源码与许可证。
典型用法¶
- 刷新页面：在安装插件后，刷新 Web GUI 页面，输入框右侧会出现回形针图标。
- 选择或拖拽：点击回形针按钮选择文件，或者直接将文件拖拽到输入框区域。
- 查看插入结果：文件内容会以代码块格式插入到输入框中，通常显示为
📄 文件名 (大小)的格式。 - 发送消息：插入完成后，直接发送消息，agent 即可读取文件内容进行后续操作。
适用场景¶
该插件适用于需要在 Web GUI 中快速分享代码片段、配置文件或文本内容的场景。由于它是纯前端实现，不需要额外的后端服务，适合对数据隐私有要求的开发环境。使用时需注意批量上传的文件数量与大小限制。
