Favio8/dsh-plugin-deepeye
41最近提交 2026年8月14日
dsh-plugin-deepeye DSH 插件
DeepEye Vision 直接注册到 ctx.tools，无 MCP 中间层开销。支持 OpenAI、Gemini 及自定义 OpenAI 兼容端点。还支持剪贴板截图分析和纯文本模型会话中的粘贴图片自动翻译。
如何安装 dsh-plugin-deepeye DSH 插件
dsh plugin --profile web add dsh-plugin-deepeye复制不会执行命令。安装 dsh-plugin-deepeye DSH 插件前请核对仓库和版本。
dsh-plugin-deepeye DSH 插件数据来源
dsh-plugin-deepeye DSH 插件快照日期：2026年8月16日
discovered
dsh-plugin-deepeye DSH 插件能做什么
- 多后端支持：OpenAI、Gemini 和自定义端点
- 智能图片预处理：自动缩放和 JPEG 转换以节省 token
- 结果缓存：LRU 缓存减少重复 API 调用
- 粘贴图片兼容：自动将粘贴的图片翻译成文字，供纯文本模型使用
- 五个视觉工具：描述、OCR、视觉问答、UI 布局分析、剪贴板分析
dsh-plugin-deepeye DSH 插件适合哪些场景
- 详细描述图片内容
- 从图片中提取文字（OCR）
- 根据图片回答问题
- 分析截图中的 UI 布局结构
- 快速分析剪贴板截图，无需保存文件
dsh-plugin-deepeye DSH 插件适合谁
- 使用 DeepSeek Harness 并希望为纯文本模型添加视觉能力的用户
- 在 DSH 应用中集成视觉功能的开发者
dsh-plugin-deepeye DSH 插件的限制
- 需要外部视觉 API 服务（OpenAI、Gemini 等）和 API Key
- 粘贴图片兼容仅适用于纯文本模型，且需要兼容的视觉后端
- 图片处理可能产生额外的 API 费用和延迟
- 仅支持静态图片，不支持视频
dsh-plugin-deepeye DSH 插件的仓库 README 摘录
以下文字摘自 dsh-plugin-deepeye DSH 插件的上游仓库 Favio8/dsh-plugin-deepeye 的 README，版权归原作者，仅作引用。
为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 提供视觉能力的原生 Cordis 插件。 让纯文本模型获得"眼睛"：图片描述、OCR 文字提取、视觉问答、UI 布局分析、剪贴板截图分析，以及**粘贴图片自动翻译**（在纯文本模型会话里直接粘贴图片也能发）。 ## 特性 - **原生集成** — 直接注册到 `ctx.tools`，无 MCP 中间层开销 - **多后端** — 支持 OpenAI (GPT-4o)、Google Gemini、自定义 OpenAI-compatible 端点 - **智能预处理** — 自动缩放过大图片、转换 JPEG 以节省 token - **结果缓存** — LRU 缓存减少重复 API 调用 - **System Prompt** — 自动注入提示段落，让模型知道何时使用视觉能力 - **粘贴图片兼容** — 纯文本模型（如 DeepSeek）会话中直接粘贴图片，自动翻译成文字后交给模型（见下文 pasteCompat） ## 安装 本插件是一个标准 dsh **bundle**（声明了 `dsh.bundle.patch`），通过 dsh 的 profile 插件机制安装： ```bash # 发布后（npm 安装） dsh plugin --profile web add dsh-plugin-deepeye # 本地开发时（从插件源码目录的上一级执行） dsh plugin --profile web add ./dsh-plugin-deepeye ``` 安装时 dsh 会： 1. 首次使用自动初始化 profile（含 `@deepseek-ai/dsh-base`） 2. 用 pnpm 把本包链接进 profile 目录 3. 因本包声明了 `dsh.bundle`，自动追加到 `dsh.profile.bundles` 层叠 验证与启动： ```bash dsh --profile web --dump-config # 确认出现 dsh-plugin-deepeye 层 dsh web # web 是 --profile web 的别名 ``` ## 配置 ### API Key 解析优先级 插件支持多层 API Key 解析，用户可以选择最方便的方式： 1. **cordis.yml 显式配置** — `config.apiKey: !!js process.env.XXX` 2. **自动环境变量回退** — 根据 `provider` 自动匹配对应环境变量 3. **通用变量** — `DEEPEYE_API_KEY`（适
阅读完整 README仓库未声明许可，使用前请先与作者确认。
dsh-plugin-deepeye DSH 插件常见问题
如何安装 DeepEye Vision 插件？
通过 DSH 的 profile 插件机制安装：`dsh plugin --profile web add dsh-plugin-deepeye`。安装后会自动链接包并添加到 profile 的 bundles 中。启动使用 `dsh web`。
需要哪些 API Key 以及如何配置？
需要至少一个支持的视觉 API 服务的 Key。可以在 cordis.yml 的 config.apiKey 中显式设置，或者通过环境变量。对于 OpenAI，设置 OPENAI_API_KEY；对于 Gemini，设置 GEMINI_API_KEY；对于自定义端点，设置 DEEPEYE_API_KEY。插件会自动回退到环境变量。
是否支持免费视觉模型？
支持，通过 custom provider 可以使用智谱的免费模型 glm-4v-flash。配置 provider: custom，baseUrl: https://open.bigmodel.cn/api/paas/v4，model: glm-4v-flash，并将智谱的 API Key 设置为 DEEPEYE_API_KEY。
什么是粘贴图片兼容，它如何工作？
粘贴图片兼容允许在纯文本模型会话中粘贴图片，插件会自动将图片翻译成文字描述。它通过修改模型信息绕过图片支持检查，然后使用视觉后端翻译图片并重放请求。有三种模式：off（关闭）、auto（默认，仅对不支持图片的模型启用）、force（强制翻译）。
插件提供了哪些工具？
提供了五个视觉工具：vision_describe（详细描述图片）、vision_ocr（提取文字）、vision_ask（根据图片回答问题）、vision_layout（UI 布局分析）和 vision_clipboard（分析剪贴板截图）。除了 vision_clipboard 自动读取剪贴板外，其他工具都需要 image_source 参数。