前言¶
在 DSH WebUI 中，拖入圖片通常會作爲 base64 附件發送。若當前會話使用的是純文本模型，圖片附件可能無法進入對話。cesaryike/dsh-image-to-path 是一個 DSH 插件，用於改變這個流程：它接管拖放/粘貼圖片的動作，把圖片保存到當前會話工作區，再把文件路徑作爲文本插入輸入框，讓純文本模型也能拿到可傳給工具的引用。
DSH 插件生態強調可擴展，這個插件由社區成員維護，許可證爲 MIT。
這是什麼¶
該插件面向 DSH Web Profile，解決“純文本模型無法直接處理圖片附件”的使用問題。它不改變多模態模型的原生圖片通道，而是爲純文本模型提供路徑化方案。
維護者爲 cesaryike。README 中還列出了 DeepSeek AI（DSH agent）參與核心工程實現與修復。
核心功能¶
- 支持拖入或粘貼圖片，並將圖片保存到當前會話工作區。
- 以文件路徑文本插入輸入框，模型可以把路徑交給任何工具處理。
- 自動檢測當前模型能力：支持圖片的模型走原生附件通道；純文本模型走路徑方案。
- 內容尋址去重，避免同一張圖片重複落盤；工作區已有的圖片直接原位引用。
- 上傳過程包含圖片魔數校驗、服務端命名、原子寫、10 MiB 上限和同源校驗，無遠程請求。
安裝與啓用¶
從 GitHub 安裝時，使用以下命令：
dsh plugin --profile web add github:cesaryike/dsh-image-to-path
安裝後重啓 Web Profile 生效。
典型用法¶
1、在 DSH WebUI 中拖入或粘貼一張圖片。
2、圖片會保存到當前會話工作區的 dsh-image-to-path-uploads/ 目錄。
3、輸入框出現文件名芯片；發送時，模型收到完整路徑。
4、上傳目錄可隨時手動清理，不影響插件運行。
配置¶
可通過 profile 的 cordis.patch.yml，按行 id image-to-path 覆蓋配置。
| 字段 | 默認 | 說明 |
|---|---|---|
subdir |
dsh-image-to-path-uploads |
保存子目錄 |
maxImageBytes |
10485760 |
單圖上限（10 MiB） |
interceptUnknownModels |
false |
未聲明能力的模型是否按純文本攔截 |
關於 interceptUnknownModels：默認關閉。開啓後，對未聲明能力的模型按純文本攔截；但 provider 未註冊或能力查詢失敗時仍 fail-open 並記錄警告。
適用場景與注意¶
適合在 DSH Web Profile 中使用純文本模型、但仍希望把圖片以路徑形式交給後續工具處理的場景。若當前模型本身支持圖片，插件會走原生附件通道，不影響既有圖片能力。
安裝前建議先檢查源碼與 MIT 許可證。插件安裝後會隨 DSH Web Profile 運行，並以當前 dsh 進程權限處理拖入/粘貼的圖片數據。
鏈接¶
倉庫地址：cesaryike/dsh-image-to-path
目錄頁線索給出的地址爲 skillhub.cn 插件頁，該地址來自插件線索，訪問前以實際站點內容爲準。
