dsh-vision-free-eyes — 免费识图 vision 工具（vision-tool 包）
给 DeepSeek Harness（DSH）的纯文本模型补上免费「眼睛」：一个分析已知本地图片路径的
vision(image, question) 工具，
直连智谱 GLM 免费视觉 API（glm-4v-flash → glm-4.6v-flash → glm-4.1v-thinking-flash 自动降级链），
不依赖任何额外安装的 CLI。完整说明见仓库根目录的
README。
安装（发布后）
dsh plugin --profile web add dsh-vision-free-eyes
或在 profile 的 cordis.patch.yml 中追加：
- insert:
- id: dsh-vision-free-eyes
name: dsh-vision-free-eyes
前提
- DSH
0.1.0-rc.8、0.1.1-rc.1 或 0.1.1-rc.2。
- 必须：智谱 GLM 免费 key，环境变量
GLM_API_KEY 或 ZHIPU_API_KEY
（open.bigmodel.cn 注册即得，格式 id.secret；Windows 也可 setx，插件自动读注册表）。
- 出站 HTTPS 到
open.bigmodel.cn。
插件通过 DSH 注入的 tools 服务注册标准 ToolDefinition，不安装或直接导入
@deepseek-ai/dsh-tools 等官方运行时包。
权限与证据边界
- 只读取调用者明确给出的一个绝对图片路径，并只向固定的智谱 HTTPS 端点发送图片字节。
- 只读取 GLM 环境变量；Windows 环境变量缺失时使用固定参数执行系统自带的只读
reg query，
不使用 shell 字符串，也不记录或持久化 Key。
- 无 npm 运行依赖和安装期生命周期脚本；只新增
dsh-vision-free-eyes Entry ID，不写 DSH Profile
或替换官方组件。完整边界见 SECURITY.md。
- 已验证三个声明版本的一次性 Web Profile 安装、配置合成、冷启动和卸载；rollback、真实用户
Profile、带真实 GLM Key 的端到端结果、Windows 运行和独立安全审计仍未验证。下一验收门槛是
推送固定 Commit 后取得公开 CI 运行记录；这些低层证据不会被表述成真实 Profile 或安全审计通过。
使用
告诉模型单个图片文件的已知绝对路径即可，例如："看一下 D:\xxx\screenshot.png"。默认 image 模式使用
完整 GLM 视觉语言模型理解图片并回答 question；只有用户明确要求逐字提取时才用 mode="ocr"。
no_cache=true 可跳过进程内结果缓存。
工具会在联网前强制检查绝对路径、单文件类型和图片文件魔数；目录、相对路径以及非
png/jpeg/webp/gif/bmp 内容会直接拒绝。模型不应在调用前用 shell 预检路径；目录错误是停止条件，
即使目录里似乎只有一张图片也不会自行遍历，不会把普通本地文件伪装成图片上传。
图片理解会保持用户问题的范围和详细程度，只陈述能够确认的可见事实，并区分总数、当前项与
额外/折叠项等计数语义；简要概述不会逐项转写正文，界面分析也会区分地址栏、搜索框等区域。
单一事实问题只返回所问事实和必要限定，不主动附加未经询问的元素位置或上下文。
该工具不会自动解析 GUI 粘贴/上传附件，也不应遍历 DSH 附件目录猜测图片路径。GUI 贴图请使用
「… + 自动识图」路由；路由已经提供图片描述时，模型应直接使用描述，不要再次调用本工具。
输出为图片内容的纯文字描述，不附加内部耗时标记。
配置
| config | 默认 | 说明 |
|---|
apiKeyEnv | GLM_API_KEY / ZHIPU_API_KEY | GLM key 的环境变量名（可传数组） |
no_cache | false | 跳过进程内结果缓存，强制重新请求 |
限制
- 单图 ≤ 15MB；支持 png/jpg/jpeg/webp/gif/bmp。
- 不支持 PDF（
doc 模式已移除）；图片字节会上传到智谱服务器。
