安装一个自己开发的图片识别插件，把dsh搞崩了（ 本轮运行失败Invalid schema for function 'vision_query': schema must be a JSON Schema of 'type: "object"', got 'type: null'.）

[wangyang10]

在测试安装一个自己写的图片识别插件（https://github.com/wangyang10/image-vision）的时候，Agent应该是把~/.dsh/profiles/web/cordis.patch.yml 改出了问题，然后就整个不能工作了，报错如下：

本轮运行失败Invalid schema for function 'vision_query': schema must be a JSON Schema of 'type: "object"', got 'type: null'.

[wangyang10]

自己解决了，解放方法就是手动重置一下 /Users/sea/.dsh/profiles/web/cordis.patch.yml 文件，改回空 [] ,再重启一下就好了

[wangyang10]

补充一下完整的原因分析和修复进展。我上面那条"自己解决了"其实只是绕过了表象——重置配置之所以有效，是因为它让注册了坏 schema 的插件不再被加载；真正的根因另有其处，而且这是个值得 Harness 本身加固的产品缺陷。

根因（两层）

1. 插件侧：dsh-image-vision 注册 vision_query 工具时，parameters 传的是裸属性表（{ images: {...}, prompt: {...} }），而不是 JSON Schema 要求的 object 根（{ type: "object", properties: {...} }）。模型函数调用 API 要求参数 schema 根必须是 type: "object"，于是 DeepSeek API 拒绝了每一个请求：Invalid schema for function 'vision_query': ... got 'type: null'。
2. Harness 侧（产品缺陷）：ctx.tools.register() 只校验了 output.schema，对 parameters 从不校验、原样透传给模型 API。结果任何一个第三方插件注册了不合法的工具 schema，就会让整个会话的每一轮请求全部 400，而且报错既不点名出错的工具、也不说明原因——表现就是"整个不能工作了"。

修复

• Harness（deepseek-ai/deepseek-harness）：register() 现在在注册时校验 parameters 的根契约（必须是 object 根，type: "object"），违规立即抛 JsonSchemaError，在插件加载时响亮失败并点名问题，而不是污染之后所有请求。只校验根契约是有意为之：MCP 服务器（SDK 的 zod 转换会输出 $schema 等关键字）使用强制子集之外的合法 JSON Schema 词汇，完整子集校验会误伤它们。这个修复同时覆盖了 Invalid schema for function 'cmd': {"type":"string" #447 这类问题（Invalid schema for function 'cmd' 是同一根因）。
• 插件（wangyang10/image-vision 的 PR 已开）：parameters 改为 { type: "object", additionalProperties: false, required: ["images"], properties: {...} }，并修掉了 images 属性里放错位置的 required: true，版本升至 0.1.1。本机已安装的副本已同步修复。

PR 状态

Harness 的修复分支已推送到 fork（wangyang10:fix/validate-tool-parameters-root），但按 CONTRIBUTING.md 的说明项目目前不接受外部 PR（创建时被 GitHub 权限拒绝），所以先在此同步。等项目开放外部贡献后，一条 compare 链接即可开 PR：

master...wangyang10:fix/validate-tool-parameters-root

插件侧 PR：wangyang10/image-vision#1

[sala003]

我也写了一个git@github.com:sala003/dsh-tool-describe-image.git，我是接的百炼视觉模型然后转文字的，你的方案是如何进行识别的呢

[wangyang10]

最近一直用codex+ds v4 flash，需要读图，先是试了x上推荐的几个类似的skill，都有点难用，就用codex+ds v4 flash做了一个，简单有用，可以随便接入任意多模态模型或者视觉模型都行，我自己用的是qwen3-vl-32b-instruct，非常的便宜，而且够用。方案很简单，就是提供一个skill，在需要识图的时候，让Agent调用skill里提供的脚本，访问视觉模型的API，得到文字结果。实现的时候需要注意的就是图片的大小，需要处理一下，不同的视觉模型能处理的图片的大小和size有一些限制。

[wangyang10]

https://github.com/wangyang10/image-vision
插件地址，方案可以让AI分析就行，本身也是AI写的，哈哈

[WOW-HQ]

巧乐滋，我也遇到一样的情况

[CastleApollo]

哈哈哈，我也给dsh写崩了，也是由于原始dk模型不能识图，我准备做一个插件，结果重启直接启动失败。