dsh-attach-picker:为 DSH Web 输入栏增加系统级图片选择按钮

在 DeepSeek Harness(DSH)的 Web 交互场景中,附件上传通常依赖拖拽文件或粘贴剪贴板。这种方式在桌面端尚可,但在移动端或特定交互场景下不够直观。dsh-attach-picker 插件通过在输入栏工具栏中增加一个图片按钮,允许用户直接通过系统原生的文件对话框选择图片,绕过拖拽或粘贴的操作限制。

插件介绍

该插件由开发者 qwerty-k-de 维护。它是一个零依赖的浏览器端插件,主要作用是在 DSH Web 的对话输入工具栏中增加一个图片按钮。点击后调用操作系统原生的文件选择器,支持多选,并自动过滤出支持的图片格式。

核心功能

  • 工具栏集成:在输入栏工具栏中增加一个图片图标按钮(插槽 conversation.input.left),点击即可触发文件选择。
  • 原生文件选择:使用操作系统原生的文件对话框,支持多选,仅显示支持的图片格式。
  • 限制校验:严格遵守主机的 imageLimits 配置(支持的格式、单条消息最大图片数、单张图片最大字节),超出时会通过内联提示报错(例如提示单张图片不能超过 X MB)。
  • 统一管道:复用 DSH 现有的草稿-附件管道,与拖拽和粘贴的行为一致,无需额外处理。
  • 兼容性:支持 DSH 0.1.x 和 0.2.x,根据运行时的管道版本自动适配。
  • 轻量化:纯浏览器端实现,零运行时依赖。

安装与启用

使用官方安装命令添加插件:

dsh plugin --profile web add dsh-attach-picker

安装后,重启 dsh web 或刷新页面即可生效。

典型用法

  1. 在 DSH Web 中打开一个对话窗口。
  2. 在输入栏工具栏中找到图片按钮并点击。
  3. 操作系统弹出文件选择对话框,选中一张或多张图片。
  4. 图片将出现在下方的草稿附件栏中,发送消息时一同上传。

适用场景与注意

  • 适用场景:当用户习惯通过点击选择文件而非拖拽,或在移动设备上操作时,该插件能显著提升体验。
  • 注意:该插件仅运行在浏览器端。使用前需确保 DSH Web 进程已启动,且加载了标准的会话/插槽客户端服务。当有请求正在处理时,按钮会自动禁用以防止状态冲突。请查阅源码确认许可证符合项目需求。

总结

dsh-attach-picker 通过复用现有的附件管道,提供了一个更符合用户直觉的图片上传入口,减少了不必要的操作步骤。更多细节及源码可查阅其 GitHub 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜