前言¶
在 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
