前言¶
DSH 的理念是「一切皆插件」。對於需要在聊天輸入框中快速提供圖片的場景，已有做法可能是先保存本地文件、再外部截圖、最後粘貼，缺少統一入口。
dsh-composer-image-tools 是 ai-yucheng 維護的 DSH 插件，用來在聊天輸入框工具欄增加圖片上傳和自定義區域截圖兩個入口，並把圖片注入 DSH 草稿圖片軌，隨消息發送。
這是什麼¶
dsh-composer-image-tools 是一個面向 DSH 的插件，許可證爲 MIT，自研實現，零依賴。
它解決的核心問題是：在 DSH 聊天輸入框中提供“看圖”的入口，包括本地圖片上傳和自定義區域截圖。
核心功能¶
圖片上傳¶
- 打開系統文件選擇器，支持多選圖片上傳。
- 選中的圖片會注入 DSH 草稿圖片軌。
- 超過 10MB 的文件會被自動攔截；原因是超大圖片會消耗大量 token。
區域截圖¶
- 點擊工具欄截圖按鈕後，進入全屏遮罩。
- 按住鼠標左鍵拖拽框選區域，鬆開後選區自動裁剪成圖片，並進入草稿區。
- 支持使用
Esc取消截圖框選。 - 截圖基於 Electron 主進程
desktopCapturer截取整屏，不依賴微信或外部截圖工具。 - 瀏覽器
getDisplayMedia在 DSH 的 Electron 環境不可用，因此截圖走插件服務端主進程路由。
與剪貼板粘貼並行¶
- 如果已經通過微信
Alt+A完成截圖，可以直接在 DSH 輸入框中使用Ctrl+V粘貼圖片。 - 該路徑不需要點擊插件按鈕，和插件的自定義框選截圖互不干擾。
安裝與啓用¶
在 DSH 的 profile 目錄執行安裝命令：
pnpm add dsh-composer-image-tools
然後在 profile 的 package.json 中，確認 dsh.profile.bundles 已加入：
"dsh-composer-image-tools"
啓用後需要：
1、重啓 DSH Desktop，使服務端截屏路由生效。
2、硬刷新瀏覽器，快捷鍵爲 Ctrl+Shift+R。
3、查看聊天輸入框工具欄，確認出現圖片上傳按鈕和區域截圖按鈕。
注意：已給資料未明確當前包已發佈，實際環境可能需要源碼 link 安裝。插件會以當前 dsh 進程權限運行，安裝前應檢查源碼和許可證。
典型用法¶
上傳本地圖片¶
1、點擊工具欄圖片上傳按鈕。
2、在系統文件選擇器中選擇一張或多張不超過 10MB 的圖片。
3、圖片出現在輸入框上方草稿區。
4、輸入補充文字，可選；然後發送。
自定義區域截圖¶
1、點擊工具欄區域截圖按鈕。
2、屏幕顯示全屏遮罩，進入框選狀態。
3、按住鼠標左鍵拖拽，框選需要截取的區域。
4、鬆開鼠標，選區自動裁剪成圖片並出現在草稿區。
5、如需取消，按 Esc。
從剪貼板粘貼¶
1、使用微信 Alt+A 等外部方式完成截圖。
2、在 DSH 輸入框中按 Ctrl+V。
3、圖片進入輸入框草稿區後可發送。
適用場景與注意¶
適合以下情況：
- 需要給 DSH 聊天輸入框增加圖片入口。
- 希望本地圖片上傳和自定義區域截圖都能在輸入框內完成。
- 不想依賴微信或外部截圖工具完成區域截圖。
- 需要限制上傳體積，避免超大圖片消耗大量 token。
使用時注意：
- 上傳超過 10MB 的圖片會被攔截。
- 使用區域截圖前，需重啓 DSH Desktop，使服務端截屏路由生效。
- 需確認
dsh.profile.bundles已加入dsh-composer-image-tools。 - 截圖基於 Electron 主進程
desktopCapturer截取整屏；瀏覽器getDisplayMedia在 DSH 的 Electron 環境不可用。 - 插件以當前
dsh進程權限運行；安裝前應檢查源碼和 MIT 許可證。
鏈接¶
- GitHub：https://github.com/ai-yucheng/dsh-composer-image-tools
- 插件目錄頁：https://www.skillhub.cn/plugins/ai-yucheng/dsh-composer-image-tools
