dsh-her-eyes

English | 中文

用于 DeepSeek Harness(dsh)的视觉语言模型(VLM)分析器插件。为 AI 提供 analyze_image 工具,底层接入主/备两个 OpenAI 兼容视觉端点并支持自动切换;同时在 Web 设置中新增**设置 → 视觉模型 (VLM)**面板(自动保存,支持中/英文)。

插件名取自刘慈欣科幻短篇《带上她的眼睛》。

功能

• analyze_image 工具:注册在全局工具注册表,所有会话可用。
• 主 / 备 VLM API:OpenAI 兼容的 endpoint + apiKey + model;主 API 连续失败超过重试次数后自动回退到备选 API。
• 自动保存的设置面板:每次修改即时保存、立即生效,无需"保存"按钮;支持从端点拉取可用模型列表。
• Web 路由:宿主半提供 /vlm/config、/vlm/models、/vlm/reset。
• i18n:设置面板跟随界面语言(中文 / English)。

环境要求

• dsh CLI(DeepSeek Harness)且已安装 web profile;PATH 中有 pnpm(或用 npx --yes pnpm@ 代替)。

安装

本插件是 bundle:自带 cordis.patch.yml 并自我激活。安装只需一条命令,无需手动修改 profile 的 patch 文件。

# 本地目录安装
dsh plugin --profile web add ./dsh-her-eyes

# GitHub 安装
dsh plugin --profile web add github:huashenglian/dsh-her-eyes

# tarball 安装(pnpm pack / npm pack 打包后)
dsh plugin --profile web add ./dsh-her-eyes-1.2.0.tgz

dsh plugin add 会自动安装依赖,并把该 bundle 追加到 dsh.profile.bundles。

若 pnpm 不在 PATH,可手动等价执行:

# 在 profile 目录下(约 ~/.dsh/profiles/web)
npx --yes pnpm@11.7.0 add file:./plugins/dsh-her-eyes

然后在 package.json 的 dsh.profile.bundles 数组中加入 "dsh-her-eyes"。

手动放置(备选)

1. 把插件包放到 $DSH_HOME/profiles/web/plugins/dsh-her-eyes/。
2. 在 profile 的 package.json dependencies 加 "dsh-her-eyes": "file:./plugins/dsh-her-eyes"。
3. 在 profile 的 dsh.profile.bundles 数组加入 "dsh-her-eyes"。
4. 运行 pnpm install(或 npx --yes pnpm@11.7.0 install),重启 dsh web。

不要在 profile 的 cordis.patch.yml 里再加 一行——bundle 已自带。重复 insert 会导致启动时报 。