泰山识图 v5.0
让 DeepSeek Harness(DSH)的纯文本模型也能看图：智谱 GLM 免费视觉模型识图 + 当前模型推理,无需主模型支持图像输入。
✨ 功能
- 免费识图:
glm-4.6v-flash/glm-4.1v-thinking-flash两个智谱 GLM 视觉模型,完全免费,中文识别质量好，支持自动降级 - 原生卡片面板(v5 新):面板从左侧一级栏挪进 DSH「设置 → 插件 → 插件配置」卡片区,与 DSH 内置卡片(终端 / Agent 循环 / 网页搜索)同款样式,可折叠
- 一键启停(v5 新):卡片内「启用 / 停用」按钮切换整个自动识图流程,不用再翻开关
- API Key 直配:卡片里粘贴智谱 Key 即保存,不回显明文、重启不丢;「保存 / 清除」与输入框同行
- 模型勾选 + 拖拽调序(v5 新):可用视觉模型列表用勾选框控制启停,⠿ 拖动手柄调整调用顺序
- 凭据感知:没配 API Key 的模型默认关闭,配了才启用;无 Key 时面板/路由自动隐藏对应模型,不会反复失败
- 自动补写:新机没配置智谱时自动补写 provider 声明;填了 GLM Key 后立即生效,无需重启 DSH
- 注入防护:视觉模型返回内容带围栏声明,防图片内指令注入
- 诊断工具:
taishan_diag输出凭据/路由/包装全量状态,排障一键查 - 手动检查更新:折叠头「检查更新」按钮主动联网检测,启动不自动检查
📦 安装
前置:PATH 里有 pnpm(npm i -g pnpm);GitHub 安装还需要 git。
dsh plugin --profile web add github:iguanren/taishan-vision#v5.0
升级:
dsh plugin --profile web update taishan-vision
离线安装(taishan-vision-5.0.tgz):
dsh plugin --profile web add file:taishan-vision-5.0.tgz
手动安装:把 taishan-vision 文件夹复制到 ~/.dsh/profiles/web/node_modules/,并在 ~/.dsh/profiles/web/cordis.patch.yml 追加:
- insert:
- id: taishan-vision
name: taishan-vision
重启 DSH 生效。
🔑 配置 API Key
方式一(推荐):打开「设置 → 插件 → 插件配置」,展开 泰山识图 卡片,在「配置智谱 API KEY」行粘贴 Key,点「保存」。
方式二:手动编辑 ~/.dsh/.credentials.yaml:
ZHIPU_GLM_API_KEY: <你的key>
申请 Key:打开 https://open.bigmodel.cn 注册登录并申请 API KEY,粘贴上方保存即可,立即生效,无需重启。
Key 只存于凭据文件,不进日志、面板永不回显。
🛠 使用
- 发送带图片的消息,插件自动注入识图指令
- 当前模型(纯文本也能看)调用
taishan_describe_image工具(参数image_ref传图片附件 ID)拿到图片描述,再基于描述回答你 - 也可直接让模型"描述这张图"
模型管理:「设置 → 插件 → 插件配置 → 泰山识图」卡片内:
- 启用 / 停用 按钮:整个识图自动流程的总开关
- 可用视觉模型 区:勾选框控制单个模型启停,⠿ 拖动调整调用顺序(前一个失败自动尝试下一个)
- 重新扫描:改了模型配置或换了 Key 后点一下刷新列表
⚙️ 默认推荐模型(免费)
| 模型 | 上下文 | 最大输出 |
|---|---|---|
| glm-4.6v-flash | 128K | 32K |
| glm-4.1v-thinking-flash | 64K | 16K |
🔧 常见问题
- pnpm 找不到:
npm i -g pnpm后重启终端 - Git 安装失败:
winget install Git.Git或从 下载 - 卡片没出现在「插件配置」:重启 DSH + 浏览器强刷(Ctrl+Shift+R);仍无则在 DSH 终端找
[泰山识图]日志,或让模型调taishan_diag - 填了 Key 没模型:卡片点「重新扫描」
- 识图失败:DSH 终端看
[泰山识图]日志,或让模型调用taishan_diag输出全量状态
🧹 卸载
dsh plugin --profile web remove taishan-vision
手动安装则删除 ~/.dsh/profiles/web/node_modules/taishan-vision 并从 cordis.patch.yml 移除对应条目。
💬 反馈
报告 Bug 时请附上:DSH 版本(dsh --version)、taishan_diag 输出、复现步骤。
- 🐛 Bug 报告
- 💡 功能建议
📌 更新记录
- v5.0:面板大重构——从左侧一级栏迁入「插件配置」卡片区(原生可折叠卡片,与 DSH 内置卡片同风格);启停改为「启用/停用」按钮;API Key 行标签+输入框+保存/清除同行;模型行勾选框+⠿拖拽调序;修复宿主 ESM 升级端点 require bug、客户端端点路径拼接 bug;全面清理死代码;tgz 加 files 白名单瘦身
- v4.0:面板精简重构——状态总览与 API Key 合并;模型行拖动调序;无 Key 隐藏模型与「自动识图」标签;内置 provider 凭据探测;闪动修复;死代码清理
MIT License
