前言¶
用 DeepSeek Harness(DSH)做智能体开发,绕不开模型清单这件事:想在模型选择器里直接选某个模型,前提是有插件把它的描述、端点和凭据都接好。如果你手上是智谱 GLM Coding Plan 会员或 BigModel 账号,这些模型默认并不在 DSH 可选清单里,尤其缺少 1M 上下文的 glm-5.3。
下面介绍的 opensaozi/dsh-bigmodel-catalog 解决的就是这个问题:把智谱 BigModel / GLM Coding Plan 作为模型清单插件接入 DSH。
这是什么¶
opensaozi/dsh-bigmodel-catalog 是一个 DSH 模型清单插件,由 OpenSaozi 维护,MIT 许可证,npm 包名为 @deepseek-ai/dsh-model-catalog-bigmodel(版本 0.1.0-rc.5,private 包)。
安装后它会解锁 glm-5.3(1,000,000 token 上下文上限、128K 最大输出),同时支持 glm-4.5、glm-4.6、glm-5。它连接的是智谱面向开发者的 Coding PaaS 端点 https://open.bigmodel.cn/api/coding/paas/v4/models。
DSH 的理念是「一切皆插件」,模型清单同样如此。需要说明:这是社区集成,与 Zhipu AI、BigModel、DeepSeek 或 pi-ai 均无关联且未获其背书。
核心功能¶
- 解锁 1M 上下文:模型选择器中可直接选择 glm-5.3,上下文上限 1,000,000 token,最大输出 128K。
- 面向 Coding Plan:连接 Coding PaaS 端点,支持的模型包括 glm-5.3、glm-4.5、glm-4.6、glm-5。
- 实时对账目录(Live Reconciled):结合端点实时发现,同时保留已验证例外,维持对 glm-5.3 的支持。
- 独立 Provider 路由:插件注册自有
zai适配器,仅复用导出的PiAiAdapter做消息与流转换,不依赖 llm-pi-ai 的 provider 配置或目录接缝。zai路由的目录、实时过滤、凭据解析、适配器注册全部由本包承担。 - 凭据安全隔离:每次请求通过 Harness credential service 解析
BIGMODEL_API_KEY,密钥不写入 Cordis 配置或日志。 - 免构建安装:仓库含 dsh.bundle 补丁与预构建运行时产物,安装后无需本地构建步骤。
目录如何对账¶
两点需要知道:
1、Coding Plan Models 端点目前不返回可直接调用的 glm-5.3,这个 id 是明确标注的已验证例外。
2、端点只提供模型 id,不含完整能力元数据。上下文与输出容量来自经审核的描述表,并由包测试锁定。
刷新时机:挂载时运行一次;BIGMODEL_API_KEY 对应的托管凭据变更时再次运行。刷新失败时保留已维护的目录并记录错误。
另外,插件本身不添加任何请求内容——它只控制哪些 BigModel 描述(如 glm-5.3)可供选择,请求转换由导出的 PiAiAdapter 负责。因此对 token 化与 KV Cache 没有直接影响;更换模型可能影响 provider 侧的缓存资格。
安装与启用¶
先在 Harness 凭据服务中准备好名为 BIGMODEL_API_KEY 的凭据,再把经过审核的 revision 安装到指定 profile:
dsh plugin --profile <profile> add github:OpenSaozi/dsh-bigmodel-catalog#<commit-sha>
仓库自带 dsh.bundle 补丁与预构建运行时产物,这一步之后不需要本地构建。
安装后的配置¶
安装后 bundle 会贡献如下 Cordis 配置:
- id: model-catalog-bigmodel
name: '@deepseek-ai/dsh-model-catalog-bigmodel'
config:
apiKeyEnv: BIGMODEL_API_KEY
baseURL: https://open.bigmodel.cn/api/coding/paas/v4
displayName: BigModel
部署时可以按需覆盖两项:
baseURL:指向其他 Coding Plan 端点;apiKeyEnv:指向其他凭据引用。
适用场景与注意¶
适合的场景:持有智谱 GLM Coding Plan 会员或 BigModel 账号,需要分析大型代码库、处理长文档或进行高强度代码生成的开发者。
注意事项:
- 插件以当前 dsh 进程权限运行,安装前应检查源码与许可证(MIT)。
- 刷新失败不会清空目录,会保留已维护的目录并记录错误。
- 插件对 token 化与 KV Cache 无直接影响,但更换模型可能改变 provider 侧的缓存资格。
小结¶
这个插件做的事很集中:把智谱 Coding Plan 的模型接进 DSH 的模型选择器,重点解锁 1M 上下文的 glm-5.3,同时把凭据隔离、目录对账、独立路由处理妥当。如果你已经在用智谱的 Coding Plan,安装后即可在 DSH 里选用这些模型。
仓库地址:https://github.com/OpenSaozi/dsh-bigmodel-catalog
社区目录收录页:https://www.skillhub.cn/plugins/OpenSaozi/dsh-bigmodel-catalog (该地址来自线索,未在仓库资料中直接核实)