DeepSeek Harness(DSH)的聊天编辑器原生没有附件功能。如果不使用插件,常见的做法是把文件路径写进消息里,让模型去读。这种做法有三个问题:容易失败、污染你的原文、且模型未必真能读取。dsh-upload-plugin 插件直接在编辑器里增加了“附件”能力,让模型能直接看到图片或读取文件内容,同时保持你的文本原样。
这是一个 DeepSeek Harness 插件,由开发者 danhcng3822f 维护,采用 MIT 许可证。它解决了 DSH 原生编辑器缺乏附件交互的问题,通过两种方式将内容传递给模型:图片作为原生草稿图像,文件通过上下文注入块。
核心功能¶
图片与文件处理¶
插件提供了两种主要的附件方式:
* 添加图片:支持使用 /photos 命令或工具栏上的 [📷] 按钮。图片会作为原生草稿图像传递给模型,模型能直接看到图片内容,不会在文本框里生成额外的指令。
* 添加文件:支持使用 /files 命令或工具栏上的 [📄] 按钮。文件会上传到工作区,并在你的草稿中生成一个引用芯片,模型会通过上下文注入块读取文件内容。
会话历史与工具栏¶
- 浏览历史:使用
/uploads可以浏览当前会话中已上传的文件列表,点击即可重新引用。 - 快捷工具栏:[📷] 和 [📄] 按钮直接出现在编辑器工具栏上,位于发送按钮左侧,方便快速操作。
模型配置支持¶
- Vision 设置:在 Settings 的 Vision 页面中,可以为每个模型勾选或取消“图片输入”能力。这会修改模型配置中的
input字段。 - 推理努力级别:插件支持模型推理强度的选择,允许通过自定义选项扩展推理级别列表。
安装与启用¶
安装¶
该插件需要运行在带有 web profile 的 DeepSeek Harness 环境中。
dsh plugin --profile web add github:danhcng3822f/dsh-upload-plugin
安装完成后,重启 DSH 或重新加载 http://127.0.0.1:3080 即可生效。
使用方法¶
1. 附加图片¶
点击工具栏的 [📷] 或输入 /photos,从本地选择图片文件(支持 .png, .jpg, .jpeg, .webp, .gif)。图片会直接进入草稿区,模型在生成回复时会将图片作为内容的一部分进行处理。
2. 附加文件¶
点击工具栏的 [📄] 或输入 /files,选择文档文件(支持 .txt, .pdf, .json, .csv 等)。文件会通过上下文注入块传递给模型,模型会根据指令读取文件内容。
3. 查看历史¶
输入 /uploads,系统会列出当前会话中已上传的文件列表,点击文件名即可将其重新引用到当前对话中。
4. 配置 Vision¶
进入 Settings -> Vision 页面。为需要读取图片的模型勾选 Vision 选项。这会更新模型配置,允许模型处理图片输入。
注意事项¶
- 内容注入机制:文件通过上下文注入块传输,你的原始文本保持不变,不会被粘贴进去。图片是 DSH 原生的草稿图像。
- 单次发送:附件在每次发送时一次性注入,没有待处理队列。发送后,下一次消息除非重新附加,否则不会携带上次的指令。
- 环境要求:插件依赖 DSH 的
webprofile,并需要 Node.js 和 pnpm(用于源码安装)。
总结¶
该插件通过原生图片处理和上下文注入,填补了 DSH 在文件附件上的空白。安装与配置遵循标准 DSH 插件流程,适合需要在对话中频繁交互文档或图片的场景。更多细节可查阅 GitHub 仓库 或 社区目录。