本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

modlens

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @liustack/modlens

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 全网最轻量。 不用 hook，不套壳，不跑本地代理进程，不改任何 harness 配置的一行字：在 skill 类 harness 里它就是一个 skill 文件夹，在 dsh 里就是一个插件。卸载等于删个文件夹，你的 agent 立刻回到原样。
• 零配置起手。 复用 Claude Code、Codex、OpenCode、Pi 已配置，直接复用你本机的其他多模态模型。什么都没有？Antigravity CLI 是免 key 的免费通道，配一个免费 Gemini key 可将识别耗时降至 5 到 10 秒。
• 基于证据而非想象。 全文转录、按阅读顺序划分的版面区块、实体与关系列表，模型引用的是具体内容。
• 一次安装，多端可用。 Claude Code、Codex、Pi、OpenCode 均经真机验证。
• **你正在对话的这个 harness 本身。**在登录了订阅的 Claude Code 里用？claude-cli 开箱即可借它读图。装进哪个 harness，安装流程就会问哪个 harness 的授权。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

modlens 是给谁用的？为什么普通 DeepSeek/GLM 模型也需要它？

dsh 默认宿主下的 DeepSeek-V4、GLM 等主力对话模型是纯文本的，无法直接读取粘贴的图片。modlens 通过一个外部视觉引擎帮你把这些图片转成结构化的文字证据再喂回文本模型，让"截图 + 提问"变成一次完整的对话。

安装后默认能用吗，还需要自己配 API key 吗？

默认走 Antigravity CLI（免 key、浏览器登录一次即可），零配置就能用。若想更快，配一个免费 Gemini key 通常 5-10 秒一次；其他 OpenAI 兼容端点（DashScope、SiliconFlow、OpenRouter、自建 vLLM/Ollama 等）也可直接对接。

安装后会看到什么变化？需要选哪个模型？

模型选择器会多出若干 "(modlens vision)" 后缀的条目，比如 DeepSeek-V4-Flash (modlens vision)、DeepSeek-V4-Pro (modlens vision)。切到这些条目粘贴图片即可，缩略图直接可见，体验接近 Codex App；不切也能用，图片会作为路径进输入框。

一张图片会被哪个引擎处理？会扣哪个账号的额度？

未指定时，所有已配引擎组成一条故障转移链：API 类快车道先试，agent CLI 兜底；每次结果里 meta.attempts 列出尝试顺序，meta.warnings 标明复用了哪个 harness 的登录、扣的是谁的额度，永远不会无声扣费。

modlens recover-paste 是做什么的？

Claude Code、Pi、OpenCode 这些终端默认把粘贴的图片直接存进会话存储而不会落到普通临时文件。recover-paste 会从这些 harness 的本地存储里把粘贴的字节读出来另存到安全目录（0700）。从 OpenCode 恢复需要 Node 22.13+ 提供 node:sqlite。

出错了怎么排查？

跑 modlens doctor，它会汇报 Node 版本、哪个 provider 已就绪、当前会选哪个、检测到了哪个 harness，全在本地查，不消耗额度也不联网。报错信息通常会自带修复命令，例如缺 key 时直接告诉你 modlens config set <provider>.apiKey。

卸载会留下什么？

删除本插件包即可卸载。会留在机器上的只有 ~/.modlens/config.json（你显式配置过的 key、端点、复用授权等）和 ~/.modlens/ 下的回收目录；不放进 dsh 的 hook 也不动任何 harness 配置，宿主本身可以无痕回退到原状。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（依赖宿主 dsh 的 cordis 框架与 web profile，package.json 未声明 peerDependencies；install via dsh plugin add，按 dsh release-age 规则点名版本）
• Node: >=22.19（OpenCode paste 恢复依赖 node:sqlite，需要 Node 22.13+）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则