跳到正文

Terry12138qy/dsh-vision

30最近提交 2026年8月14日

dsh-vision DSH 插件

dsh-vision 是 DeepSeek Harness 的 bundle 插件，让不具备原生识图能力的模型能够理解图片。它接受本地文件路径或网络 URL，发送给主多模态模型（阿里云百炼 qwen3.5-omni-plus），在主模型失败（额度用尽、欠费、限流）时自动切换备用模型（智谱 glm-4.6v-flash）。该工具注册为 `vision`，可在 Code Mode 中调用。

visionskills-workflows

如何安装 dsh-vision DSH 插件

dsh plugin --profile web add github:Terry12138qy/dsh-vision

复制不会执行命令。安装 dsh-vision DSH 插件前请核对仓库和版本。

dsh-vision DSH 插件数据来源

dsh-vision DSH 插件快照日期：2026年8月16日

discovered

dsh-vision DSH 插件能做什么

  • 支持本地图片路径和网络 URL 作为输入。
  • 主模型调用失败时自动切换到备用模型重试。
  • 与 DeepSeek Harness Code Mode 无缝集成，通过 `await tools.vision(...)` 调用。
  • 支持 `exec.signal` 取消机制，符合 DSH 工具契约。

dsh-vision DSH 插件适合哪些场景

  • 让不具备识图能力的 DSH 模型用中文描述图片内容。
  • 在 DSH 对话中分析用户上传的截图或照片。
  • 从图片中提取文字信息（如路牌、文档）并在 DSH 工作流中使用。
  • 作为基础模型缺少多模态支持时的备用识图工具。

dsh-vision DSH 插件适合谁

  • 需要图片理解能力的 DeepSeek Harness 用户。
  • 希望在 DSH 插件中集成视觉功能的开发者。

dsh-vision DSH 插件的限制

  • 依赖外部 API 服务（百炼和智谱），需要自备有效的 API Key。
  • 图片描述仅支持中文输出。
  • 备用模型切换可能在主模型失败时引入额外延迟。
  • 插件处于早期开发阶段，未明确限制支持的图片格式。

dsh-vision DSH 插件的仓库 README 摘录

以下文字摘自 dsh-vision DSH 插件的上游仓库 Terry12138qy/dsh-vision 的 README，版权归原作者，仅作引用。

> 给不具备原生识图能力的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 模型装上「眼睛」。 把图片（本地路径或网络 URL）发送给多模态大模型，返回中文文字描述。主模型为阿里云百炼（DashScope）`qwen3.5-omni-plus`，调用失败（额度用尽 / 欠费 / 限流）时自动切换智谱 `glm-4.6v-flash` 备用模型。 ## 原始来源与适配说明 - **原始项目**：[asuojun/claude-vision-skill](https://github.com/asuojun/claude-vision-skill) —— 面向 Claude Code 的识图 skill，核心是 `vision.js`（读图 → base64 → 调 OpenAI 兼容接口 → 返回文字描述，主模型失败自动切备用模型）。 - **本项目**：专门为 **DeepSeek Harness** 做了适配，把原来的 Claude skill 重写为 DSH 的 **bundle 插件**，注册一个 `vision` 工具。识图主流程（读图 → base64 → 调 API → 返回文字、主/备模型自动切换）**原样保留**。 相较原版的主要改动： - 打包成 DSH bundle（`dsh.bundle.patch`），可通过 `dsh plugin` 安装； - 注册为 DSH 的 `vision` 工具（Code Mode 里 `await tools.vision(...)` 可直接调用）； - CJS → ESM；配置改为「环境变量 > cordis.patch.yml config > 默认值」（原 `.env` 语义不变）； - 增加 `exec.signal` 取消支持（DSH 工具契约要求）。 ## 安装 ```sh dsh plugin --profile web add github:Terry12138qy/dsh-vision ``` 或本地路径： ```sh dsh plugin --profile web add file:/绝对/路径/dsh-vision ``` 安装后**重启** `dsh web` 生效。发布到 GitHub 后，记得给仓库添加 [`dsh-plugin`](https://github.com/topics/dsh-plugin) 主题，方便被 DeepSeek Harness 生态发现。 ## 配置 密钥通过**环境变量**（推荐，避免密钥进仓库）或编辑 `cordis.patch.yml` 的 `config`： | 用途 | 环境变量 | config 字段 | | ---- |

阅读完整 README仓库许可: MIT

dsh-vision DSH 插件常见问题

如何安装 dsh-vision？

运行 `dsh plugin --profile web add github:Terry12138qy/dsh-vision`，然后重启 `dsh web`。你也可以使用本地路径安装：`dsh plugin --profile web add file:/绝对路径/dsh-vision`。

需要配置哪些 API Key？

至少需要配置主模型的 DashScope API Key（设置环境变量 `DASHSCOPE_API_KEY`）。可选配置备用模型（智谱）的 API Key（`FALLBACK_API_KEY`）以实现自动降级。所有配置项详见 README。

能换用其他模型作为主模型吗？

可以。通过环境变量 `VISION_MODEL` 或 config 中的 `model` 字段指定任意 DashScope 兼容接口的模型。默认是 `qwen3.5-omni-plus`。

主模型调用失败会怎样？

插件会自动切换到备用模型（默认智谱 glm-4.6v-flash）并重试请求。需要提前配置好 `FALLBACK_API_KEY` 等相关变量。

支持网络图片 URL 吗？

支持。直接传入网络 URL 即可，插件会获取图片并转为 base64 发送给 API。本地文件路径也支持。