视觉分析助手 huashenglian/dsh-her-eyes

dsh-her-eyes

用于 DeepSeek Harness的视觉语言模型(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 里再加 - insert: - id: her-eyes 一行——bundle 已自带。重复 insert 会导致启动时报 duplicate loader entry id: her-eyes。

配置

所有配置集中在一个 JSON 文件:$DSH_HOME/vlm-vision.json(默认 ~/.dsh/vlm-vision.json)。

{
"retryCount": 5,
"api": {
"primary": { "endpoint": "https://api.openai.com/v1", "apiKey": "sk-...", "model": "gpt-4o" },
"backup": { "endpoint": "", "apiKey": "", "model": "" }
}
}

- endpoint:OpenAI 兼容 base(如 https://api.openai.com/v1)或完整 …/chat/completions 地址。
- apiKey:文件中可留空;通过设置面板保存,存储时打码。
- retryCount:单个 API 连续失败超过该次数后,切换当前使用的主/备 API。

可直接编辑文件,也可用设置面板(所有修改自动保存)。

工作原理

本包是双面插件:

- 宿主半(lib/index.js):cordis 插件,在全局工具注册表注册 analyze_image 工具,在 web server 注册 /vlm/config|models|reset 路由,读写 vlm-vision.json。
- 浏览器半(lib/client.js):浏览器模块,因包声明了 dsh.client 由 __ModuleLoader__ 加载。注册 设置 → 视觉模型 (VLM) 分区(list 槽 settings.section,id vlm-vision,order 40)与 locale 命名空间 settings.her-eyes。

bundle 的 cordis.patch.yml 插入的 her-eyes 条目同时激活两半。

与其他插件共存

本插件面向"其他也会影响前端设置窗口的插件"做了兼容设计:

| 资源 | 取值 | 说明 |
| loader 条目 id | her-eyes | 全 harness 唯一 |
| 设置槽 id | vlm-vision | settings.section 是 list 槽——多个分区可共存;仅相同 id 才会冲突 |
| locale 命名空间 | settings.her-eyes | 按插件命名空间隔离 |
| 工具名 | analyze_image | 唯一 |
| Web 路由 | /vlm/ | 唯一路径前缀 |
| CSS 类 | vlm- | 全局样式,加前缀避免撞名 |

harness 本身会对唯一性做强制校验(重复的 loader id、槽 id、工具名或路由会直接抛错),因此两个插件绝不会互相静默覆盖。

卸载

dsh plugin --profile web remove dsh-her-eyes

会移除依赖与 bundle 条目;你的 vlm-vision.json 配置文件会保留。

License

MIT