modlens 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node >=22.19）；该结论来自程序自动检查，未经人工实机验证。

modlens 兼容性怎么样？

自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node >=22.19）；该结论来自程序自动检查，未经人工实机验证。

modlens 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

modlens 还在维护吗？

GitHub 4,468 星。最近一次上游提交在 2026/10/23。

纯文本模型视觉插件 liustack/modlens

DeepSeek Harnessv3.27.2

liustack10 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

为纯文本模型补上视觉能力，直接粘贴图片就能识别。

69.9/100

综合分

4,468

GitHub 星标

104,446

npm 周下载

—/5

用户评分

数据截至 2026/10/26 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add @liustack/modlens

npm 源 · @liustack/modlens 的发布者账号已校验与本仓库一致

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · vision

装得上吗

本站已在 dsh 0.2.1-rc.2 下真实安装成功

非静态推断

L5 · 运行时冒烟等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 10 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查✓ 自动检查通过

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包@liustack/modlens @ 3.27.2

✓Node 引擎要求 >=22.19 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/29 01:38:41

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件发起外部网络请求

查看扫描证据（共 85 处，展示前 39 条）

读取本地文件
dsh/index.js:22
const OUTPUT_SCHEMA = JSON.parse(readFileSync(new URL('./vision-schema.json', import.meta.url), 'utf8'))
读取本地文件
dsh/index.js:39
const stat = statSync(file, { bigint: true })
读取本地文件
dsh/index.js:2025
raw = readFileSync(modlensConfigPath(), 'utf8')
读取本地文件
dsh/index.js:2201
if (lstatSync(file).isSymbolicLink()) {
写入本地文件
dsh/index.js:2207
mkdirSync(dirname(file), { recursive: true })
写入本地文件
dsh/index.js:2208
writeFileSync(file, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 })
写入本地文件
dsh/index.js:2210
chmodSync(file, 0o600)
读取本地文件
dsh/index.js:2265
lstatSync(file)
写入本地文件
dsh/index.js:2267
mkdirSync(dirname(file), { recursive: true })
写入本地文件
dsh/index.js:2268
writeFileSync(file, '{}\n', { mode: 0o600 })
发起网络请求
dsh/client.js:91
fetch('/modlens/paste', { method: 'POST', body: buffer }).then((res) => {
发起网络请求
dsh/client.js:147
fetch(`/modlens/paste?model=${encodeURIComponent(label)}`)
发起网络请求
dsh/client.js:545
fetch('/modlens/config')
发起网络请求
dsh/client.js:557
return fetch('/modlens/config?discover=1')
发起网络请求
dsh/client.js:937
fetch('/modlens/config', {
发起网络请求
dsh/client.js:998
fetch('/modlens/config', {
读取本地文件
dist/main.js:329
const size = fs.statSync(filePath).size;
读取本地文件
dist/main.js:335
const buffer = fs.readFileSync(filePath);
发起网络请求
dist/main.js:349
const response = await fetch(current, {
发起网络请求
dist/main.js:349
const response = await fetch(current, {
发起网络请求
dist/main.js:398
return new Agent({
发起网络请求
dist/main.js:448
return proxy ? new ProxyAgent(proxy) : void 0;
发起网络请求
dist/main.js:451
return new EnvHttpProxyAgent();
发起网络请求
dist/main.js:478
const dispatcher = apiProxyDispatcher(proxy, env) ?? new Agent();
读取本地文件
dist/main.js:1236
const newest = fs.readdirSync(dir).filter((name) => name.endsWith(".log")).map((name) => {
读取本地文件
dist/main.js:1238
return { full, mtime: fs.statSync(full).mtimeMs };
读取本地文件
dist/main.js:1243
const recent = fs.readFileSync(newest.full, "utf-8").slice(-64e3).split("\n").filter((line) => {
删除本地文件
dist/main.js:1426
fs.rmdirSync(dir);
读取本地文件
dist/main.js:1748
raw = fs.readFileSync(configPath, "utf-8");
写入本地文件
dist/main.js:1900
fs.mkdirSync(path.dirname(configPath), { recursive: true });
写入本地文件
dist/main.js:1901
fs.writeFileSync(configPath, `${JSON.stringify(config2, null, 2)}
写入本地文件
dist/main.js:1904
fs.chmodSync(configPath, 384);
写入本地文件
dist/main.js:2201
fs.mkdirSync(path.dirname(configPath), { recursive: true });
写入本地文件
dist/main.js:2202
fs.writeFileSync(configPath, `${JSON.stringify(CONFIG_TEMPLATE, null, 2)}
写入本地文件
dist/main.js:2205
fs.chmodSync(configPath, 384);
执行外部命令来自配置/变量
dist/main.js:2531
return spawn(command, args, { ...options, windowsHide: true });
执行外部命令来自配置/变量
dist/main.js:2534
return execFileSync(file, args, { ...options, windowsHide: true });
删除本地文件
dist/main.js:3722
fs.rmSync(statePath, { force: true });
执行外部命令来自配置/变量
dsh/spawnHidden.js:19
return spawn(command, args, { ...options, windowsHide: true })

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

界面预览

6 张 · 点击查看大图

功能亮点

粘贴图片识别
输出结构化JSON证据
支持OCR与版面语义

展开完整介绍（160 字）↓

DeepSeek Harness 首个视觉插件，也是每个纯文本编程智能体的视觉桥梁。粘贴图片，得到结构化 JSON 证据（OCR、版面、语义）。| 全网最强 DeepSeek Harness 外挂视觉插件，为 DeepSeek、GLM 等纯文本模型外挂视觉能力，粘贴图片即得结构化 JSON 证据（OCR、版面、语义）。

README

由 DeepSeek 最新模型翻译生成

ModLens 为纯文本模型补上视觉能力，直接粘贴图片就能识别。 🥇 全网最强的 DeepSeek Harness（dsh）视觉插件 🥇 English ·配置 ·故障排查 ·安全 · 🔍 ModSearch（DSH 最强免费联网搜索插件） DeepSeek 的主力对话模型和 GLM-5.3 本体仍是纯文本，无法读图。GLM-5.3-Flash 已是原生多模态。ModLens 借助外挂视觉引擎，为纯文本模型补上视觉能力。ModLens 支持直接粘贴图片识别，无需先保存成文件再提供路径。交流有问题随时提issue。推荐你关注公众号 liustack，也欢迎你来 X 上聊：@liustack。你用它做了什么、在哪个 harness 上跑、接下来该做什么，都会在公众号和 X 同步更新。社群正在筹备中。亮点 🥇 全网最强的 DeepSeek Harness（dsh）外挂视觉识别插件：一条命令即刻安装 npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modlens@3.27.2。更多安装与更新细节参考配置手册。如果用不惯命令行，也想想玩玩 DSH，推荐食用全网最轻量级的 DeepSeek Harness 桌面版封装 AIManager，零代码零配置起手，一键帮你安装所有依赖环境。

展开完整文档（README 剩余 1 节）

ModLens

为纯文本模型补上视觉能力，直接粘贴图片就能识别。

🥇 全网最强的 DeepSeek Harness（dsh）视觉插件 🥇

English ·配置 ·故障排查 ·安全 · 🔍 ModSearch（DSH 最强免费联网搜索插件）

DeepSeek 的主力对话模型和 GLM-5.3 本体仍是纯文本，无法读图。GLM-5.3-Flash 已是原生多模态。ModLens 借助外挂视觉引擎，为纯文本模型补上视觉能力。ModLens 支持直接粘贴图片识别，无需先保存成文件再提供路径。

交流

有问题随时提issue。推荐你关注公众号 liustack，也欢迎你来 X 上聊：@liustack。你用它做了什么、在哪个 harness 上跑、接下来该做什么，都会在公众号和 X 同步更新。社群正在筹备中。

亮点

🥇 全网最强的 DeepSeek Harness（dsh）外挂视觉识别插件：一条命令即刻安装 npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modlens@3.27.2。更多安装与更新细节参考 配置手册 。如果用不惯命令行，也想想玩玩 DSH，推荐食用全网最轻量级的 DeepSeek Harness 桌面版封装 AIManager，零代码零配置起手，一键帮你安装所有依赖环境。

DeepSeek Harness 粘贴识图有两种玩法。

① 直接粘贴 贴进来的图片自主转换成文件路径进输入框（与 OpenCode、Pi 同款交互），modlens_read_image 工具接手读图。

② 切到带 (modlens vision) 后缀的模型变体（选择器有记忆，选一次就行）再粘贴：缩略图直接可见、所见即所得，体验更接近 Codex App。变体由插件自动发现生成：每条承载纯文本 DeepSeek 或 GLM 模型的 provider 路由各得一组包装条目（默认安装下就是 DeepSeek-V4-Flash (modlens vision) 和 DeepSeek-V4-Pro (modlens vision)，装了 opencode-go、zai 等额外路由的机器会各自多出一组），两家自己的视觉型号（含 GLM-5.3-Flash）自动排除。走哪条通路由 host 依据真实模型元数据逐个裁决：只有被元数据确认纯文本的模型才会被接管，确认不了的一律不动，视觉模型因此保留原生贴图（细节）。

所有 Harness 直接粘贴图片识别 无需先保存成文件再提供路径。

需要快捷键把屏幕截进 DeepSeek Harness 时，用独立插件 dsh-screenshot。

- 全网最轻量。 不用 hook，不套壳，不跑本地代理进程，不改任何 harness 配置的一行字：在 skill 类 harness 里它就是一个 skill 文件夹，在 dsh 里就是一个插件。卸载等于删个文件夹，你的 agent 立刻回到原样。
- 零配置起手。 复用 Claude Code、Codex、OpenCode、Pi 已有配置，直接复用你本机的其他多模态模型。如果你本机什么都没安装？Antigravity CLI 是免 key 的免费通道，配一个免费 Gemini key 可将识别耗时降至 5 到 10 秒。也支持所有主流的 OpenAI 兼容格式 API key。
- 多个密钥用英文逗号分隔，鉴权、限流或配额失败时自动轮换。 其他失败会跳过剩余密钥，并继续走现有的 provider 故障转移。
- 基于证据，而非想象。 全文转录、按阅读顺序划分的版面区块、实体与关系列表，模型引用的是具体内容。
- 一次安装，多端可用。 Claude Code、Codex、Pi、OpenCode 均经真机验证。

在其他 Harness 中安装

方式一，通过 skills.sh 一条命令安装：

npx -y skills add liustack/modlens --skill modlens --global

这会把 modlens skill 安装到用户级目录。重启 Harness 后，让 AI 配置 modlens 并运行体检即可。

方式二，把安装交给你的 AI。 把这句话发给它：

按 https://github.com/liustack/modlens 的 INSTALL.md 安装并配置 modlens skill，完成后运行体检并把结果告诉我。

安装会先盘点你机器上已有的东西。Claude Code、Codex、OpenCode 或 Pi 里任何一个已有的登录态都可能就够了：modlens 复用前一定先征得你同意，体检报告会说清现状。

两种方式完成后，只在体检两手空空时，才需要你配一个免费引擎。 推荐免费的 Gemini api key（到 Google AI Studio 领取，约三分钟，无需信用卡），配上后每次识别 5 到 10 秒。其他平台的免费 openai 兼容 key 也行。想完全免注册就装 Antigravity CLI，然后完成登录：

curl -fsSL https://antigravity.google/cli/install.sh | bash
agy # 浏览器完成登录后退出

安装还会盘点本机其他 harness CLI（Codex、OpenCode、Pi）里可触达的视觉能力，并逐个询问是否允许 modlens 复用。获准的登录态与你自己配的引擎平级入池，每次复用都会在结果里标明花的是谁的额度。

DeepSeek Harness（dsh）用户不走 skill 流程，本包就是原生 dsh 插件：

npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modlens@3.27.2

装完即有 modlens_read_image 工具，选「(modlens vision)」模型变体即可直接粘贴识图。引擎配置同样在 ~/.modlens，详见宿主接入。

命令行不是唯一入口。dsh 设置页的「插件 → 插件配置」里有一张 ModLens 卡片（dsh 0.1.7 起改到侧栏的「插件」页，在「已安装」里点开 @liustack/modlens）：切换引擎，勾选 auto 模式可以复用本机哪些 CLI，在网页上点几下保存就生效。

dsh 设置页里的「视觉引擎（ModLens）」配置卡片：切换引擎，勾选 auto 模式复用的本机 CLI

用法

装好之后不需要记任何命令。正常聊天，粘贴图片或给出图片路径，提问即可，skill 自动触发：图片交给视觉引擎，答案基于读到的内容返回。贴一次，后面追问同一张图不用再贴。

视觉引擎：六个内置 provider，四家可复用 CLI，一条故障转移链

ModLens 不绑定任何单一视觉服务。视觉来源一共十个：六个内置 provider（配好任意一个就能用），加四家本机 agent CLI 的登录可以复用。先看内置的：

| Provider | 需要什么 | 单次识别耗时 | 适合谁 |
| gemini-api | 免费 Gemini key（三分钟领取，无需信用卡） | 5-10 秒 | 推荐默认 |
| openai | 任意 OpenAI 兼容端点（key + baseUrl + model） | 5-10 秒 | qwen-vl、GLM、自建网关 |
| anthropic | Anthropic API key | 5-10 秒 | 手上已有 key 的机器 |
| antigravity-cli | 免费的 agy CLI，浏览器登录一次，无需 key | 15-45 秒 | 完全免注册起步 |
| claude-cli | 已登录的 Claude Code | 20-45 秒 | 复用现有 Claude 订阅 |
| kimi-cli | 已登录的 Kimi Code | 20-45 秒 | 复用现有 Kimi 订阅，需显式点名 |

不钉死 provider 时，所有配好的引擎组成一条故障转移链：API 快车道先试，agent CLI 兜底，第一个可用结果胜出，meta.attempts 记录每次尝试，回退永远不是无声的。

openai 是万能接口，不只是 OpenAI

任何讲 OpenAI chat-completions 协议、支持图片输入的端点都能直接插上，这基本覆盖了视觉模型的大半个世界：

modlens config set openai.baseUrl https://dashscope.aliyuncs.com/compatible-mode/v1 # qwen-vl
modlens config set openai.apiKey <key>
modlens config set openai.model qwen3-vl-plus

apiKey（以及对应的环境变量）也接受英文逗号分隔的列表。鉴权、限流或配额失败时会轮换到下一个密钥。网络、5xx 和解析失败会跳过剩余密钥，并继续走现有的 provider 故障转移。

同样三个键，换成 GLM 开放平台、SiliconFlow、OpenRouter、自建 vLLM/Ollama 或你自己的网关都一样。你常用的视觉模型只要有 OpenAI 兼容 API，ModLens 就能驱动它。

复用你机器上已有的东西

还有两处现成的视觉能力，一个新 key 都不用配，每家都在你明确同意后才启用：

- 你正在对话的这个 harness 本身。在登录了订阅的 Claude Code 里用？claude-cli 开箱即可借它读图。装进哪个 harness，安装流程就会问哪个 harness 的授权。
- 机器上其他的 agent CLI。modlens doctor 会逐个发现，你按家授权，它们与你自己的 key 平级入链，不插队。每次复用都在 meta.warnings 里标明花的是谁的额度，绝不无声扣费：

| 复用来源 | 需要什么 | 授权命令 | 走哪条道 |
| Codex | 已登录且有视觉模型的 Codex CLI | config set reuse.codex true | agent 通道，15-45 秒 |
| OpenCode | OpenCode 里配好的视觉模型 | config set reuse.opencode true | agent 通道，15-45 秒 |
| Pi | Pi 持有的模型凭据 | config set reuse.pi true | API key 直接升级到 5-10 秒的快车道，OAuth 驱动 Pi 本体 |
| Grok | 已登录的 Grok CLI（SuperGrok） | config set reuse.grok true | agent 通道，15-45 秒 |

选择与路由

两个旋钮：modlens config set provider <name> 表达偏好（链继续兜底），-p <name> 钉死单个不回退。代理环境设 HTTPS_PROXY 或 modlens config set proxy <url>，API provider 自动走代理。内网端点可用 modlens config set openai.proxy "" 单独改为直连。细节见 CLI 手册（默认模型与参数）、配置手册（全部配置键）、安全说明（远程 URL 由谁抓取）。

实测

以下均为原样记录，驱动的都是纯文本的 DeepSeek-V4-Flash。

最新的一条放最前：在 DeepSeek Harness 里选 DeepSeek-V4-Flash (modlens vision) 变体直接粘贴截图。粘贴保留原生缩略图，轨迹里可见图片抵达时「已由 modlens 视觉桥转写」，回答逐个元素还原了界面。

在 DeepSeek Harness 中直接粘贴图片，经 modlens 视觉插件读取

Codex 桌面 App 中识别一张推文截图。作者、配文、照片内容（连两人的穿着都在内）、发帖时间和全部互动数据（540 万浏览、1.6K 回复、5.7K 转发、11.6 万点赞）逐项读出。

纯文本 DeepSeek 通过 ModLens 读出推文截图的全部细节

一次粘贴三张图。模型逐张读取，认出三张同属一个视觉家族，并分别描述每张插画的内容和风格。

一次粘贴三张图，逐张读取

压力测试：128 个模型的对比散点图。双轴定义、对数刻度、按厂商的配色、高亮区域，以及虚线标注的每一个 DeepSeek 型号全部识别。密集图表是视觉方案最容易出错的场景。

128 个模型的散点图完整读出：双轴、对数刻度与高亮区域

粘贴链路的端到端记录：接入 DeepSeek 的 Claude Code 终端里，粘贴的图片以路径而非像素到达，skill 自动触发，guard 确认当前模型确实没有视觉后才开读，PPT 封面幻灯的标题、版式、背景逐项读出，连文件名被截断这个不确定点都如实说明。

接入 DeepSeek 的 Claude Code 会话中 skill 自动触发并读出粘贴的幻灯片

文档

| 文档 | 适用场景 |
| 安装手册 | 一步步安装 skill（为 agent 编写） |
| CLI 手册 | skill 所驱动的 CLI：参数、配置与体检 |
| 故障排查 | 命令报错，查成因和解法 |
| 配置手册 | 配置 key、切换 provider、排查配置 |
| 输出契约 | 解析 JSON 或构建下游工具 |
| 宿主接入 | 在 Codex、Claude Code、Pi、OpenCode 中配置 |
| 安全说明 | 恢复文件的权限、图片内容作为不可信输入 |
| 更新日志 | 查询版本变更 |

参与方式

本仓库不接受 PR。项目由作者独立维护，所有代码经作者本人审阅，这是它可靠性的前提。两种有效的参与方式：

- 提交 issue。 bug、建议、难以理解的报错或文档都欢迎。issue 会被认真阅读，并影响后续开发方向。
- Fork。 MIT 协议下你的副本完全归你，修改和发布不受限制。

插入一条硬广

ModSearch 是 ModLens 的同门项目，同一套手艺补另一种感官：给不能联网的模型补上网页搜索、X 搜索和单页抓取。免费，免注册，免 API key。模型既然需要 ModLens 当眼睛，多半也需要 ModSearch 联网：

npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@latest

关注微信公众号「liustack」：AI 创业机会、独立开发见解、AI 实战与工具，第一时间推送。微信扫码，或搜一搜「liustack」：

⭐ 如果它对你有用，请给 ModLens 和 ModSearch 一个 star，这是其他开发者找到它们的方式。

重要生态伙伴

DeepSeek Harness 生态里最值得推荐的项目。

- 🛒 dsh-market — DeepSeek Harness 的可视化插件市场。设置页里直接逛社区全部 800+ 插件：分类筛选、截图预览、一键安装与更新、主题即点即换，装完多数免重启。
The plugin market inside DeepSeek Harness. Browse 800+ community plugins with category filters and screenshot previews, one-click install and update, and live theme switching. Most need no restart.
- 🖥️ DeepSeek Harness Desktop — 为 DeepSeek Harness 生态打造的现代化桌面端。不用配置 Node.js，也不用敲命令，就能启动和管理本机的 Harness 服务。后续还会支持插件市场、移动端远程控制和 IM Channels。官网 A desktop front end for DeepSeek Harness. Start and manage the Harness service on your own machine without installing Node.js or running a command. A plugin market, remote control from a phone, and IM channels are on its roadmap. Site

Star History

免责声明

本项目依下方 MIT 协议按现状提供。作者不对任何特定用途（含商业使用）提供保证或背书。上游引擎（Antigravity CLI，Gemini、OpenAI、Anthropic 的 API，以及任何 OpenAI 兼容端点）的使用受各自条款和额度约束，由使用者负责。

License

MIT