前言¶
DeepSeek Harness(DSH)會把 provider 的模型列表交給 bundled pi-ai catalog 解析。如果 Zhipu / Z.AI coding-plan 已經支持新一代模型,而 DSH 內置目錄還沒有跟上,模型選擇器裏可能看不到 GLM-5.3。
auuduu/dsh-zai-coding-models 是一個 DSH bridge 插件。它不替代 DSH 的 provider 配置,不改 API key、endpoint 或其他 provider,只在標準 zai-coding-cn provider route 上補充 GLM-5.3,並保留原有六個 bundled 模型。下面介紹它的功能、安裝方式、手動配置和限制。
插件定位¶
- 倉庫:
https://github.com/auuduu/dsh-zai-coding-models - 許可證:MIT
- Node 要求:
package.jsonengines 要求Node >=18 - 適用對象:已配置
ZAI_CODING_CN_API_KEY,但 DSH bundled pi-ai catalog 還沒有暴露GLM-5.3的用戶 - 生態位置:這是 DSH 插件生態中的第三方 bridge 包,不是 DeepSeek / 幻方官方應用商店。
核心功能¶
- 在標準
zai-coding-cnprovider route 上暴露最新的 Zhipu / Z.AI coding-plan 模型,當前爲GLM-5.3。 - 保留六個 bundled
zai-coding-cn模型:glm-4.5-air、glm-4.7、glm-5-turbo、glm-5.1、glm-5.2、glm-5v-turbo。 - 新增
glm-5.3:text-only 能力,1M context,128K max output,thinking levels Low / Medium / High / Max。 - 設置 endpoint 需要的兼容標誌:
thinkingFormat: zai、supportsReasoningEffort: true。 - 不改變 API key、endpoint 或其他 provider。
- 提供不需要安裝插件的手動 recipe,可寫入
~/.dsh/settings.yaml。
安裝與啓用¶
先確認你要修改的 profile。以下命令使用 web profile;實際使用時可以把 web 替換爲 tui、headless 或你自己的 profile。
dsh plugin --profile web add dsh-zai-coding-models # from npm
dsh plugin --profile web add github:auuduu/dsh-zai-coding-models # from GitHub
安裝後重啓 DSH 一次。原因是 plugin bundles 在 boot 時讀取,不是安裝後立即生效。
重啓後,通過 DSH Models 頁面保存的 ZAI_CODING_CN_API_KEY 會被原樣拾取。GLM-5.3 會出現在現有 Z.AI Coding CN provider 的模型選擇器中。
如果確認不需要該插件,移除命令如下:
dsh plugin --profile web remove dsh-zai-coding-models
配置效果¶
插件通過 dsh.bundle.patch 聲明一個 layer,目標是標準 llm-pi-ai composition row,併爲 zai-coding-cn 提供 base provider profile。簡化看,它做的事情是:保留原有模型列表,再補上 glm-5.3 的配置。
- id: llm-pi-ai
config:
providers:
zai-coding-cn:
models:
- id: glm-4.5-air
- id: glm-4.7
- id: glm-5-turbo
- id: glm-5.1
- id: glm-5.2
- id: glm-5v-turbo
- id: glm-5.3
name: GLM-5.3
contextWindow: 1000000
maxTokens: 131072
reasoningEfforts:
low: low
medium: high
high: high
max: max
compat:
thinkingFormat: zai
supportsReasoningEffort: true
其中:
contextWindow: 1000000對應 1M context。maxTokens: 131072對應 128K max output。reasoningEfforts提供 Low / Medium / High / Max 的 thinking levels;GLM-5.3不能關閉 thinking,Low 是最輕設置。supportsReasoningEffort: true是需要的。如果沒有它,effort parameter 會被 silently dropped。
手動 recipe:不安裝插件¶
如果不想安裝插件,也可以把同一段配置直接寫入 ~/.dsh/settings.yaml。
llm-pi-ai:
providers:
zai-coding-cn:
apiKeyEnv: ZAI_CODING_CN_API_KEY # keep whatever you have
models:
- id: glm-4.5-air
- id: glm-4.7
- id: glm-5-turbo
- id: glm-5.1
- id: glm-5.2
- id: glm-5v-turbo
- id: glm-5.3
name: GLM-5.3
contextWindow: 1000000
maxTokens: 131072
reasoningEfforts:
low: low
medium: high
high: high
max: max
compat:
thinkingFormat: zai
supportsReasoningEffort: true
如果你已經在 ~/.dsh/settings.yaml 中給 zai-coding-cn 聲明過 models,用戶層會覆蓋插件層。建議只保留一個來源,避免插件和你自己的配置重複聲明同一組模型。
適用場景與注意¶
適合:
- 已配置
ZAI_CODING_CN_API_KEY,但當前 DSH bundled catalog 看不到GLM-5.3。 - 需要在
zai-coding-cnroute 上使用GLM-5.3的 1M context、128K max output 和 thinking levels。 - 不想爲了一個新模型改動 DSH 主流程,只想用插件 bridge 補齊模型列表。
注意:
- 插件以當前
dsh進程權限運行。安裝前建議檢查 GitHub 源碼、MIT 許可證和依賴,確認行爲符合預期。 modelslist 會替換該 route 的 catalog,這是 DSH semantics。列表按插件 release 固定。- 當 pi-ai 以後發佈
glm-5.4時,這個插件需要發佈新版本才能帶上新模型。 - 插件 patch 替換的是
llm-pi-airow 的整個 config。標準 row 當前沒有 config,但如果未來 DSH 在那裏放了 config,插件可能需要 bump。 GLM-5.3的 thinking 不能關閉;Low是最輕設置。supportsReasoningEffort: true必須存在,否則 effort parameter 會被 silently dropped。package.jsonengines 要求Node >=18。
結尾¶
dsh-zai-coding-models 的價值在於一個短窗口期:在 bundled pi-ai catalog 跟上之前,讓 zai-coding-cn route 先用上 GLM-5.3。如果之後 DSH / pi-ai 內置目錄已經包含目標模型,可以移除插件,回到 catalog。
GitHub:https://github.com/auuduu/dsh-zai-coding-models