ModLens

ModLens 3.26.1 为 DSH 文本模型提供视觉桥接，修复 Lexical 输入框的图片粘贴路径写入，保留 Provider 专属代理与直连设置。

• 无敏感信息测试图片（必需）：用公开截图验证 OCR 和版面，不上传账号、密钥或客户数据。
• 视觉 Provider 或本地 CLI（必需）：选择一种受信任后端并了解计费与数据保留政策。
• DSH 版本组合（必需）：本页选用 DSH 0.1.2-rc.1，Node.js >=22.19；作者未声明完整 DSH peer 矩阵。已核对 Bundle、工具、附件与配置路径，未在本站运行，也不推导 alpha.2 兼容。

本页命令固定使用 DSH 0.1.2-rc.1，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.1.2-rc.1

安装来源

npm 预构建包（锁定版本）

固定目标

@liustack/[email protected]

本页选用 DSH 0.1.2-rc.1，Node.js >=22.19；作者未声明完整 DSH peer 矩阵。已核对 Bundle、工具、附件与配置路径，未在本站运行，也不推导 alpha.2 兼容。

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   npm 预构建包（锁定版本）复制命令

   npx --yes @deepseek-ai/[email protected] plugin --profile web add @liustack/[email protected]

3. 03
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 @liustack/modlens或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

4. 04
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/[email protected] web

npx --yes @deepseek-ai/[email protected] plugin --profile web remove @liustack/modlens

~/.modlens/config.json

保存视觉引擎、Key、代理与复用授权，与其他 harness 共享；属于本机敏感配置。

$DSH_HOME/profiles/<name>/cordis.patch.yml

DSH 插件的 families/discover 等覆盖，不与视觉引擎配置混写。

npx --yes @deepseek-ai/[email protected] plugin --profile web add @liustack/[email protected]
npx --yes @deepseek-ai/[email protected] --profile web --dump-config

1. 先备份共享配置，打开设置 → 插件 → 插件配置，选择一个受信任的视觉引擎。
2. 逐个核对 Provider 的继承、直连或专属代理；确认选定后端与故障转移范围，再用公开小图片验证。

1. 01
   用公开截图请求 OCR，核对引擎与允许的故障转移后端。

   期望结果：返回识别结果或可解释错误；不通过输出文字单独断言实际网络路径。

2. 02
   分别核对继承/直连设置，检查 Host 日志与代理侧记录（脱敏）。

   期望结果：配置符合预期；没有真实网络验证时仅记录配置检查，不声称流量已验证。

3. 03
   在需要 paste-to-path 的文本模型组合中，粘贴公开截图，分别核对上传和输入框路径插入。

   期望结果：路径进入当前输入框，或出现可解释错误；仅图片上传成功不算完整通过，原生视觉模式保留原生附件。

• 识别公开截图中的按钮文字与布局，不推断未显示的账号信息。

读取图片、运行包内 CLI，按配置调用视觉 API 或已有本地 CLI；保存 API Key 和代理凭据，图片及识别结果可能发往外部服务。

数据存储：API Key、代理与引擎配置保存在 ~/.modlens/config.json；POSIX 写入权限为 0600，不是加密凭据库。图片可能发往视觉 API，识别结果再进入 DSH 模型与会话。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

升级后不再经过共享代理

3.26.1 中 providers.<引擎>.proxy 空串表示直连；选择继承或移除该字段，不是将它设为空。

模型没有视觉变体

核对实际 Provider ID、families、discover 与 inputModalities；原生 image 模型无需变体，未知输入能力不会被通配规则自动纳入。

图片上传成功但输入框没有路径

确认 3.26.1 已重启加载；区分原生视觉与路径接管，检查浏览器 paste-to-path 错误并脱敏路径。