前言¶
在 DeepSeek Harness（DSH）里接 OpenAI 兼容的 GPT 或 Codex 类模型时，若给智能体开 Full access（完整工具权限），有时会在工具调用链路上出现参数 schema 与宿主预期不一致的情况，表现为工具定义冲突或调用失败。这类问题往往不在业务代码里，而在 DSH 与模型侧对 tool schema 的拼接方式上。
下面介绍社区插件 dsh-gpt-tool-schema-compatibility（维护者 vb2250158，分类：模型推理）。它通过向 DSH profile 注入配置层，针对上述场景做兼容处理。插件当前在 GitHub 上星标为 0，属于较新的开源条目；安装前建议自行阅读仓库源码与 MIT 许可证。
这是什么¶
dsh-gpt-tool-schema-compatibility 是面向 DSH 0.2 系的开源插件，npm 包名同为 dsh-gpt-tool-schema-compatibility，当前 README 对应版本为 0.1.4。
插件在列表中的展示名随 DSH 界面语言切换：英文为 GPT tool compatibility，中文为 GPT 工具兼容（见仓库 locale/en.json、locale/zh.json）。
一句话定位：在 DSH 0.2.1-alpha.1 或兼容的 0.2 发行版上，修复 GPT/Codex 在 Full access 下的工具参数冲突。
本发行版对 DSH 版本有明确要求，详见仓库 compatibility details。
核心功能¶
根据仓库 README，插件目前对外声明的能力如下：
- 版本约束：需要 DSH 0.2.1-alpha.1 或与之一致的 0.2 兼容发行版。
- 兼容目标：缓解或修复 GPT/Codex 在 Full access 模式下出现的 工具参数（tool schema）冲突。
- 配置注入：包内声明
dsh.bundle，安装后会把插件自带的cordis.patch.yml作为 patch 合并进当前 profile 的配置层，无需把本仓库源码放进多机同步用的仓库。
README 未展开 patch 内具体字段；若你要审计行为，应在安装前打开仓库中的 cordis.patch.yml 与 lib/ 实现自行核对。
安装与启用¶
官方 README 要求先锁定公开仓库的某一提交，再通过 DSH 官方入口安装（将 <commit> 换成实际 commit SHA）：
pnpm dsh plugin --profile web add github:vb2250158/dsh-gpt-tool-schema-compatibility#<commit>
说明：
--profile web表示安装到名为web的 DSH profile；若你使用其他 profile，需按自己的环境替换该参数。#<commit>用于固定插件来源版本，避免后续上游变更未经验证就进入你的环境。
安装完成后，插件配置会写入该 profile 下的 cordis.patch.yml。README 说明：多电脑同步用的仓库通常只保存仓库地址、固定提交、启停状态和配置，不会保存插件源码树。
验证与开发侧检查¶
仓库提供的自检步骤（在插件源码目录内执行）：
npm test
npm pack --dry-run
npm test对应package.json中的node --test tests/*.test.mjs。npm pack --dry-run用于确认发布文件列表是否包含lib、cordis.patch.yml、locale、icon.svg等声明项。
上述命令面向维护者与二次开发者；日常使用者以 DSH 侧安装与 profile 生效为准。
适用场景与注意¶
适合谁
- 已在 DSH 0.2 系上跑 GPT/Codex 类模型，并启用 Full access，且遇到工具参数/schema 相关冲突的开发者。
- 希望通过官方
pnpm dsh plugin ... add github:...路径安装社区插件、用 profile patch 统一管理配置的人。
务必注意
- 权限模型：与其它 DSH 插件一样，本插件随 当前 dsh 进程权限 运行；安装前请阅读 GitHub 仓库源码与 MIT 许可证，确认 patch 内容符合你的安全与合规要求。
- 版本对齐：未满足 0.2.1-alpha.1 / 0.2 兼容要求时，不应假设插件可用；以 README 与 compatibility 文档为准。
- 生态定位：DSH 社区插件目录（如 SkillHub 条目页）为独立站点，与 DeepSeek / 幻方无官方从属关系；本文介绍的是社区维护的
vb2250158/dsh-gpt-tool-schema-compatibility，不是官方内置能力。
结尾¶
若你的痛点是「Full access + GPT/Codex 工具链路上的参数冲突」，可以在固定 commit 的前提下，用 README 给出的命令把该插件加入 profile，并在 cordis.patch.yml 中确认配置已合并。进一步细节与 issue 跟踪见 GitHub 仓库。
- 目录页：https://www.skillhub.cn/plugins/vb2250158/dsh-gpt-tool-schema-compatibility
- GitHub：https://github.com/vb2250158/dsh-gpt-tool-schema-compatibility
