前言¶

在 DSH web GUI 里处理图片时，常见做法是先把图片作为附件发到会话，或手动保存后再把路径写入消息。对于希望 AI 使用文件工具读取本地图片、再用视觉能力识别的场景，手动保存和路径输入会增加操作步骤。

dsh-quick-attach 做的事情是：在会话输入框粘贴图片时，自动把图片保存到配置目录，并把绝对路径追加到消息草稿。

这是什么¶

ximisi/dsh-quick-attach 是一个面向 DSH web GUI 的插件，维护者为 ximisi，许可证为 MIT。

它解决的是“图片粘贴后如何交给 AI 识别”的问题：不再只依赖附件数据，而是把图片落盘为文件，并把文件绝对路径随消息发给 AI。

核心功能¶

• 在 DSH web GUI 会话输入框粘贴图片时，自动把图片保存到设置中配置的目录。
• 把保存后的图片绝对路径追加到消息草稿。
• 发送消息时，把该绝对路径发给 AI，供其文件工具和视觉能力读取识别图片。
• 在设置栏提供「快捷附图」分区，用于配置保存目录并启用。
• 保存的图片可通过 /quick-attach-files/<文件名> 预览。

从实现侧看，host 提供以下接口：

• /api/quick-attach/save
• /api/quick-attach/config
• /quick-attach-files/*

client 在 document 捕获阶段拦截输入框粘贴，并在设置栏增加「快捷附图」分区。

安装与启用¶

从 GitHub Release 安装：

dsh plugin --profile web add https://github.com/ximisi/dsh-quick-attach/releases/download/v0.1.1/dsh-quick-attach-0.1.1.tgz

安装后重启 web 服务，进入：

设置 → 快捷附图

配置保存目录并启用。

配置保存在：

<DSH_HOME>/quick-attach.json

默认保存目录为：

<DSH_HOME>/quick-attach

典型用法¶

1、打开任意会话。

2、在输入框粘贴（Ctrl+V）一张或多张图片。

3、图片自动保存到配置目录，绝对路径自动追加到输入框。

4、正常输入文字并发送，路径随消息发给 AI。

适用场景与注意¶

适合在 DSH web GUI 中经常需要把图片交给 AI 识别的开发者：比如粘贴截图后，希望 AI 能按路径读取文件，而不是只接收一次性的附件数据。

使用前的几个限制：

• 仅拦截发生在会话输入框内的图片粘贴；其他输入框、设置、终端等不受影响。
• 原生「粘贴图片作为附件」流程被替换：不再以附件形式发送图片数据，改为发送路径。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 许可证为 MIT。

结尾¶

dsh-quick-attach 的价值不在于增加复杂能力，而是把“粘贴图片、保存文件、输入路径、发送给 AI”这条链路收进一个步骤里。对于以 DSH 插件方式扩展 web GUI 工作流的场景，它提供了一个可以直接落地的快捷附图方案。

项目地址：

• GitHub：https://github.com/ximisi/dsh-quick-attach
• 社区目录线索（以目录页实际信息为准）：https://www.skillhub.cn/plugins/ximisi/dsh-quick-attach