ModLensliustack/modlens为纯文本模型补上视觉能力直接粘贴图片就能识别输出结构化 JSON 证据OCR、版面、语义。它装在 dsh 里就是一个原生插件安装只要一条命令真正容易翻车的是装完之后——引擎走哪条道、代理管哪类目的地、哪些模型会被接管、版本前提是什么。下面四个坑按踩到的频率排每个都给出现象、原因和能落地的解法。延迟预期先分清快车道和兜底道坑一等太久以为插件卡死了。现象。粘贴图片后对话框迟迟没有结果等十几秒就怀疑进程挂了于是反复重启 harness 或重装插件。原因。视觉引擎不是一条路不钉死 provider 时所有配好的引擎组成一条故障转移链API 快车道先试agent CLI 兜底第一个可用结果胜出。API providergemini-api、openai、anthropic单次识别 5–10 秒而 agent CLI 兜底要 15–45 秒其中claude-cli与kimi-cli是 20–45 秒。你等到的慢往往不是卡死而是这次请求落在了兜底道上。解法。对延迟敏感就配 API key别把 CLI 复用当默认路径——一个免费 Gemini key约三分钟领取、无需信用卡就能把单次识别压回 5–10 秒。想确认真实路径去看结果里的meta.attempts它记录每一次尝试回退永远不是无声的。代理环境一个开关管不了两类目的地坑二代理开着内网端点却全挂。现象。在代理环境里设好HTTPS_PROXY或modlens config set proxy url之后走公网的识别正常了但你自建在内网的 OpenAI 兼容端点反而连不上。原因。API provider 会自动走代理可是一个代理开关管不了两类目的地公网端点需要走代理内网端点需要绕过代理这两件事不是同一个配置项能同时满足的。解法。给内网端点单独改直连公网那侧继续由HTTPS_PROXY或modlens config set proxy url管两者互不干扰。全部配置键的清单在插件的配置手册里。引擎和代理这类配置细节是同一时期一起踩的横向对照一遍同类插件的中文清单与安装形态会更省事完整插件清单与汉化避坑指南。模型接管元数据确认不了的不会被动坑三以为所有模型都会被接管。现象。装完插件、切到带(modlens vision)后缀的变体粘贴图片却发现某个自建模型并没有对应的包装条目或者它照旧读不了图。原因。变体由插件自动发现生成但走哪条通路由 host 依据真实模型元数据逐个裁决只有被元数据确认纯文本的模型才会被接管确认不了的一律不动两家自己的视觉型号含 GLM-5.3-Flash自动排除因此保留原生贴图。解法。别指望它接管一个元数据不清的自建模型。挑一个元数据明确为纯文本的模型来用默认安装下就是DeepSeek-V4-Flash (modlens vision)与DeepSeek-V4-Pro (modlens vision)并回头确认一次该模型的元数据声明。顺带说明装了 opencode-go、zai 等额外路由的机器会各自多出一组包装条目变体列表比你预期长属于设计行为不是异常。版本前提Node 与 dsh 两栏都得自己确认坑四装到过旧环境上全程没有提示。现象。插件装上了但行为异常或者干脆起不来而且自始至终没有一句明确的「版本不兼容」。原因。版本前提有两栏其中一栏是空的Node 引擎要求22.19而dsh CLI 依赖一栏写的是「未声明 dsh 版本约束」——插件没有声明它依赖哪个 dsh 版本所以装到过旧的 dsh 上也不会得到明确的不兼容提示。解法。装之前自己确认两件事Node 版本不低于 22.19dsh 本身是较新的版本。装完先跑一次体检把引擎现状一次看全体检两手空空时再按前文配一个免费引擎即可。总结四个坑的共同点是都不是插件坏了而是配置与前提没对齐——先看meta.attempts再怀疑卡死内网端点单独改直连只挑元数据确认纯文本的模型来接管装前确认 Node 与 dsh 版本想对照同类插件的中文清单与安装形态见 完整插件清单与汉化避坑指南适合与不适合适合主力模型是纯文本 DeepSeek 或 GLM、经常要读截图和图表的人同时在代理环境与内网端点里跑、需要分开配置的机器想把识图结果接进下游工具、需要结构化 JSON 的开发者手上有 Claude Code、Codex、OpenCode、Pi 登录态、想直接复用的用户。不适合本机没有任何可用视觉引擎、又不打算配 key 或登录 CLI 的场景它此时什么也读不了对延迟敏感且不接受 CLI 兜底 15–45 秒的场景需要保证图片不出本机的场景粘贴即等于把图片交给第三方视觉服务以及希望提 PR 改代码的团队本仓库不接受 PR。标签ModLens、DeepSeek Harness、视觉插件避坑、故障排查、dsh 插件本文由 DeepSeek Harness Hub 自动整理数据来源于插件详情页。