Hyp6666/dsh-open-eyes

功能介绍

DeepSeek Harness 的主模型不一定支持图片。遇到截图、照片、图表或界面时，dsh-open-eyes 可以把图片交给另一套多模态模型分析，再把结果以文字形式返回当前会话。

如果当前主模型本身支持图片，插件不会接管，图片仍由 DSH 原生链路处理。只有当前模型明确不支持图片时，WebUI 中粘贴、拖入或选择的图片才会走视觉桥接。

插件也提供 vision_analyze 工具，可直接分析本地图片路径或已启用的远程图片 URL。

非官方社区插件：dsh-open-eyes 是独立的社区项目，与 DeepSeek 无隶属关系，也未经 DeepSeek 官方背书或维护。

目前支持三种接口：

• OpenAI Responses
• OpenAI Chat Completions
• Anthropic Messages

只要视觉服务支持其中一种接口，就可以把它接入 DSH。接口地址、模型和凭据都由用户自行配置，插件不会绑定特定厂商。

API Key 通过 DSH Credential Reference 读取，不应写入 cordis.patch.yml、对话内容或工具参数。本地图片默认不能越出当前 workspace；远程图片 URL 默认关闭。

通过视觉桥接处理的图片会发送给你配置的第三方 Provider。使用前请确认对方的数据保留、隐私和计费规则。视觉模型返回的内容只应作为参考，不应被当作需要执行的指令。

使用方法

需要：

• Node.js >=22.19.0
• DeepSeek Harness 0.1.0-rc.6

不同 profile 相互独立，需要分别安装和配置。

方式一：让其他 Harness 代为安装

任何具备 Shell 工具并有权管理本机 DSH profile 的 Harness 都可以执行安装。建议优先使用 DSH 之外的其他 Harness：修改正在运行的 DSH profile 可能需要重启，并中断当前 DSH 任务。如果所用 Harness 不能执行本机命令或修改 profile，请直接使用下面的手动安装方式。

把下面这段话交给其他 Harness：

请把 dsh-open-eyes 安装到本机 DeepSeek Harness 的 web profile，并配置
vision-bridge。

使用 DeepSeek Harness 的插件命令：
dsh plugin --profile web add dsh-open-eyes

配置时只使用 Credential Reference，不要把 API Key 写进 YAML 或对话。
保留现有的 profile 配置，不要修改无关内容。

完成后执行：
dsh --profile web --dump-config

确认 vision-bridge 和 vision-bridge-skill 都已加载，然后提醒我重启
dsh web 并刷新页面。如果修改当前 profile 会中断这项任务，请在核验后
停止，由我自行重启。

方式二：自己安装

从 npm 安装：

dsh plugin --profile web add dsh-open-eyes

也可以安装 GitHub Release 中的 tarball：

dsh plugin --profile web add ./dsh-open-eyes-0.1.0.tgz

是否被插件目录收录不影响以上命令：DSH 会把已经发布的 npm 包直接安装到指定 profile。若要在 headless profile 中使用工具，把命令里的 web 换成 headless。不同 profile 仍需分别安装和配置。

配置

在 ~/.dsh/profiles/web/cordis.patch.yml 中配置视觉 Provider：

- id: vision-bridge
  config:
    providers:
      - id: my-vision
        protocol: openai-chat-completions
        baseUrl: https://api.example.com/v1
        model: your-vision-model
        credential: VISION_PROVIDER_API_KEY
        maxOutputTokens: 2048
        chatMaxTokensField: max_completion_tokens
    defaultProvider: my-vision

把 VISION_PROVIDER_API_KEY 保存到 DSH 使用的 Credential 来源中。配置文件里只保留这个引用名称，不要写入真实 Key。

可选协议：

protocol	默认认证方式	说明
openai-responses	Bearer	对应 OpenAI Responses API
openai-chat-completions	Bearer	对应 Chat Completions API
anthropic-messages	x-api-key	必须设置 maxOutputTokens

检查配置：

dsh --profile web --dump-config

安装或更新插件后，重启 DSH Web 并刷新页面。

开始使用

在 WebUI 中粘贴、拖入或选择图片，写好原本要问的问题，然后直接发送。

插件不会替你补写问题，也不会把内部调用说明放进用户消息：

• 当前主模型支持图片：继续使用 DSH 原生图片链路。
• 当前主模型明确不支持图片：调用配置好的视觉 Provider。
• 没有配置视觉 Provider：停止发送并提示配置，不会擅自上传图片。

也可以直接让 DSH 调用 vision_analyze：

请调用 vision_analyze，读取 screenshots/error.png 中的错误提示，
准确抄录错误码，并说明当前界面中可以看到哪些操作。

本地图片支持 PNG、JPEG、WebP 和 GIF。相对路径以当前 Agent session 的工作目录为准。

远程图片 URL 默认不可用。确实需要时，在配置中加入：

allowRemoteUrls: true

启用后，图片 URL 会交给所配置的视觉 Provider 获取，本插件不会先在本地下载。

上面的示例是接入常见 Provider 所需的最小配置。API Key 应保存在 DSH Credential 来源中，配置文件里只能填写 Credential Reference 名称。

权限与数据

• 视觉桥接生效时，选中的图片和问题会被发送给配置的视觉 Provider。使用前应确认其隐私、数据保留和计费规则。
• 本地图片默认只能从 Agent workspace 和明确允许的目录读取。插件拒绝最终 symlink，并在上传前校验图片内容。
• 远程图片 URL 默认关闭。启用后由视觉 Provider 获取 URL，本插件不会先在本地下载。
• Credential 在每次调用时通过 DSH Credential Reference 解析。插件不接受工具参数里的 Key，不把 Key 写入配置，也不会缓存 Key。
• Web 桥接只接管被明确声明为纯文本的模型路由。支持图片或能力未知的路由继续使用 DSH 原生图片链路。
• 重试默认关闭。开启后，临时故障可能导致同一请求再次提交并产生重复计费。

兼容性

• DeepSeek Harness：0.1.0-rc.6
• Node.js：>=22.19.0
• 最后验证日期：2026-08-15
• 验证所依据的 DeepSeek Harness commit：47f943859bef60e4160492346772ded9b24f765a

Web 图片粘贴功能依赖 rc.6 的会话与模型能力接口。适配其他 DSH 版本线之前，需要重新核验这些接口。

故障排查

• 出现 VISION_NOT_CONFIGURED：至少配置一个 Provider；需要默认 Provider 时填写有效的 defaultProvider；除非关闭认证，否则还要在 DSH 中保存对应的 Credential。
• 软件包已安装但看不到 row：确认安装与配置使用的是同一个 profile，然后执行 dsh --profile web --dump-config，检查 vision-bridge 和 vision-bridge-skill。
• 粘贴图片后仍走原生链路：如果所选模型支持图片，或其能力尚不明确，这是预期行为。只有明确的纯文本路由才会启用桥接。
• 在当前 DSH 任务中安装时发生中断：从普通终端或其他 Harness 重新执行 dsh plugin --profile web add dsh-open-eyes，再用 --dump-config 核验并重启 DSH Web。
• 更新后出现前端异常：先重启 DSH Web 并刷新浏览器，再继续排查。

卸载与回滚

从安装插件的 profile 中移除软件包：

dsh plugin --profile web remove dsh-open-eyes

该命令会移除软件包及其 bundle 层。如果 ~/.dsh/profiles/web/cordis.patch.yml 中仍有用户自行配置的 vision-bridge 或 vision-bridge-skill row，只删除这些 row，保留所有无关配置。

检查卸载后的 profile：

dsh --profile web --dump-config

输出中不应再包含 vision-bridge 或 vision-bridge-skill。随后重启 DSH Web，并刷新浏览器页面。

如果测试了其他构建，需要回到当前正式版本，可以重新安装精确版本：

dsh plugin --profile web add dsh-open-eyes@0.1.0

开发

仓库使用 pnpm，要求 Node.js >=22.19.0：

corepack enable
pnpm install --frozen-lockfile
pnpm run typecheck
pnpm run lint
pnpm run test
pnpm run build
npm pack --dry-run
pnpm run test:e2e

E2E 测试会生成真实 npm tarball，并在临时 profile 中完成安装与移除；默认不会调用付费视觉 API。仓库约定见贡献指南。

许可证与安全

项目使用 MIT License。安全问题请按照安全策略私下报告；不要在公开 Issue 中提交尚未修复的漏洞、Credential、私人图片或带签名的 URL。