前言¶

在 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