前言¶

在 DeepSeek Harness（DSH）裏，有些模型不能直接看圖片。給這類模型發聊天圖片時，需要先在消息發給模型前做一步轉換：把圖片替換爲本地文件路徑。模型隨後調用插件內置的 analyze_image 工具，通過配置的視覺 API 得到文字描述。

dsh-image-pathify 是面向 DSH Web 的插件。它不修改聊天界面裏的縮略圖，也不改變已能看圖模型的行爲。

這是什麼¶

dsh-image-pathify 由 dami9527 維護，許可證爲 MIT。它用於解決一類具體問題：deepseek-v4 這類不能看圖的模型，仍然要處理用戶貼進聊天裏的圖片。

插件的做法是：

• 聊天裏的圖片在界面中照常顯示。
• 消息發給不能看圖的模型前，圖片被替換爲一行本地文件路徑。
• 模型調用 analyze_image，通過視覺 API 得到文字描述。
• 已能看圖的模型圖片原樣發送，analyze_image 不出現在其工具列表和系統提示裏。

核心能力¶

1、支持將聊天圖片轉換爲本地文件路徑後再發給不能看圖的模型。

2、提供 analyze_image 工具，調用配置的 OpenAI 兼容視覺接口。

3、支持多張圖片在同一次視覺請求裏傳入全部路徑。

4、對能看圖的模型保持原行爲，不暴露 analyze_image。

5、在不能看圖的模型上拒絕 read_image，並提示改用 analyze_image。

安裝與啓用¶

先安裝插件：

dsh plugin --profile web add dsh-image-pathify

再啓動 Web 端：

dsh web

進入 設置 → 插件 → 識圖，填寫 API 密鑰、識圖模型、識圖 API 地址和禁用思考後保存。設置頁改動保存後立即生效，不用重啓。

憑據與配置位置：

• API 密鑰寫入 $DSH_HOME/.credentials.yaml，不進入設置文件。
• 識圖字段寫入 $DSH_HOME/settings.yaml 的 image-pathify 段。

典型用法¶

給不能看圖的模型發一張圖時，流程是：

1、聊天界面仍顯示縮略圖。

2、插件把發給模型的消息中的圖片替換爲本地文件路徑。

3、模型調用 analyze_image，而不是 read_image。

4、視覺 API 返回文字描述。

多張圖片時，使用 images 一次傳入全部路徑。同一輪裏有多個圖片路徑時，應把所有路徑放進一次 analyze_image 調用，而不是循環調用。

給能看圖的模型發圖時，圖片原樣發送，模型直接處理；analyze_image 不出現在該模型的工具列表和系統提示裏。

配置項¶

設置頁可配置以下字段：

• apiKeyEnv：API 密鑰的憑據引用名。密鑰本體保存在 $DSH_HOME/.credentials.yaml。
• visionModel：識圖模型 id。默認 deepseek-v4-flash-vision-exp。
• visionBaseUrl：OpenAI 兼容視覺接口基址。默認 https://api.deepseek.com。
• disableThinking：默認 true。取消勾選後會走思考模式；開啓思考時應增大輸出上限。
• maxTokens：輸出上限。默認 2048；0 表示不傳 max_tokens。
• models：控制哪些不能看圖的模型允許發圖。爲空表示全部不能看圖的模型都可以發圖；填寫後只放行名單裏的模型。
• relaxAdmission：允許給不能看圖的模型發圖。關閉後按模型能力拒絕貼圖。

也可以在 settings.yaml 的 image-pathify 段配置這些字段。示例：

image-pathify:
  visionModel: deepseek-v4-flash-vision-exp
  visionBaseUrl: https://api.deepseek.com
  apiKeyEnv: DEEPSEEK_API_KEY

適用場景與注意¶

適合在 DSH Web 中使用不能看圖模型、但希望模型能理解聊天圖片的開發者。插件主要處理“不能看圖模型 + 聊天圖片 + 外部視覺 API”的組合。

注意：

• 插件以當前 dsh 進程權限運行。安裝前應檢查源碼、依賴和許可證。
• 該插件聲明 MIT 許可證。package.json 中 engines.node 要求 >=22；已覈實資料中只看到部分 peerDependencies 信息，完整依賴以倉庫 package.json 爲準。
• visionModel、visionBaseUrl 和密鑰必須與可用的視覺 API 對應。
• 如果取消勾選“禁用思考”，思考內容會佔用輸出額度，必要時調大 maxTokens。

結尾¶

dsh-image-pathify 解決的是“不能看圖的模型也能通過外部視覺 API 理解聊天圖片”的問題。配置完成前，請先檢查源碼、許可證和視覺接口憑據。

GitHub 倉庫：https://github.com/dami9527/dsh-image-pathify