在 DSH(DeepSeek Harness)的智能体开发流程中,文件处理往往涉及复杂的源码侵入或笨重的集成方式。runfali/dsh-paperclip 提供了一个零侵入式的 bundle 插件方案,旨在通过输入框交互、多格式读取和去重存储,简化文件管理流程。
这是一个由 runfali 维护的客户端插件。它通过 bundle 方式集成,不依赖修改 DeepSeek Harness 的核心源码,为智能体开发者提供了一套完整的文件上传、读取与管理工具集。
核心功能¶
- 零侵入式集成:作为一个 bundle 插件,它在运行时挂载功能,无需触碰 DSH 源码。
- 文件上传与交互:提供输入框上传按钮与待发送文件浮层。当前该浮层仅展示文件名,且支持移除。
- 多格式读取工具:内置
read_document工具,支持读取 txt、pdf、docx、xlsx、md、ini、conf 等多种格式,并支持 offset/limit 分页读取。 - 系统设置与适配:在设置 → 通用设置中提供启用开关,支持深浅色主题自适应。
- 存储优化:具备内容寻址落盘去重能力,避免重复文件占用空间。
安装与启用¶
目前无法确认官方安装命令。建议通过社区目录或 GitHub 仓库获取准确的安装指引。启用方式通常涉及在 DSH 的配置文件或设置中引入该 bundle。
典型用法¶
当前无法提供具体用法示例。根据已核实的功能描述,用户通常可以通过设置中的通用开关来启用多格式读取工具,并在对话输入框中利用上传按钮管理待发送文件,利用去重机制管理本地存储。
适用场景与注意¶
- 适用场景:适合需要在 DSH 环境下处理多种格式文档、希望保持源码整洁、且需要文件去重功能的开发者。
- 注意:插件以 dsh 进程权限运行。在安装前,务必检查源码内容与许可证信息,确保符合安全规范。
该插件通过 bundle 方式在不改动核心源码的前提下丰富了 DSH 的文件处理能力,特别是去重机制与主题自适应提升了实际使用体验。更多详情可参考社区目录或 GitHub 仓库。