跳到主内容

dsh-tool-describe-image 使用指南

为纯文本模型补齐图像理解能力：把图片交给 OpenAI 兼容视觉端点解析，只有文字结果返回会话，图片字节不进入日志。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

deepseek-harness-desktop

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @linxin666/dsh-tool-describe-image

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 可靠 Windows 启动：移除 PowerShell 5.1 -WindowStyle Hidden 与 Electron Node 模式的冲突，隐藏窗口仍由 spawn 的 windowsHide 处理；空旧补丁、状态订阅竞态和 IPC 错误不会再把启动页永久留在 8%。
  • 验证过的 Runtime 组合：内置 @deepseek-ai/dsh 0.1.0-rc.7、dshmarket 1.15.0、Web UI 聚合 0.2.3、兼容 rc.7 的 Codex Connect 与 dsh-live-stats 0.1.20，Stable 继续精确锁定而非追随 latest。
  • 托盘与后台自动化需显式选择：默认关闭仍会退出。选择“最小化到托盘并启用后台自动化”后，关闭主窗口才保留 Runtime 和到期任务；显式退出、更新、安全模式和崩溃路径一律完整停止。
  • Host 持久任务调度：Task Board 保存时区、cron 槽位、租约、misfire/running 策略和确定性运行键；启用后台自动化时通过真实 DSH Session 执行并回写 Task Run，Host 不可用时仍回退浏览器调度。
  • 可审计的扩展边界：扩展坞校验 dsh.compatibility 的版本、Desktop API、能力、Surface 与运行时证据，并在 profile 写入 desktop-plugins.lock.json。browser-safe SDK 不导入 Electron 或私有 DSH 模块；预览的外部打开仅传工作区根和相对路径，Host 验证后才交给系统。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

第一次调用就报错说 baseURL 不对，怎么修？

打开"设置 → 插件配置 → Web UI 插件组 → 图像理解"卡片，把端点根地址（如 https://dashscope.aliyuncs.com/compatible-mode/v1）和模型 id 填进去，保存后立即生效，不用重启。

API key 应该写在哪里比较安全？

不建议把 key 直接写进配置文件。默认会从环境变量 VISION_API_KEY 读取（可通过 apiKeyEnv 改成别的名字），也可以在设置卡里粘贴内联 apiKey 用于本地调试；密钥不会写入日志。

在纯文本会话里拖图片，模型能"看到"吗？

不能直接看到。插件在发送时会自动把图片块改写为引用（形如 图片），图片字节经 attach 路由上传到附件存储、只把引用文本带进会话，模型再通过 describe_image 工具间接"看到"并分析。

协议选 chat-completions 还是 responses？

默认 chat-completions，访问 baseURL/chat/completions；如果端点只提供 OpenAI Responses API，把 apiStyle 设为 responses，会改用 baseURL/responses 和 input/max_output_tokens/output_text 形态。

一张图片不够用，能不能一次给多张？

目前一次只能处理一张图片，不支持多图输入，也不支持追问上一张图或输出坐标框等结构化结果，这是已声明的功能边界。

把插件卸载干净要怎么操作？

在 dsh profile 中移除 describe-image 这个组合条目（cordis.patch.yml 对应的行），并按需清理本地 .npmrc 与符号链接；插件本身不向宿主持久化任何状态。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.7+（devDependencies 声明 @deepseek-ai/dsh-* ^0.1.0-rc.7）
  • Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则