dsh-zai-coding-models:在 `zai-coding-cn` 路線上提前接入 `GLM-5.3`

前言

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.json engines 要求 Node >=18
  • 適用對象:已配置 ZAI_CODING_CN_API_KEY,但 DSH bundled pi-ai catalog 還沒有暴露 GLM-5.3 的用戶
  • 生態位置:這是 DSH 插件生態中的第三方 bridge 包,不是 DeepSeek / 幻方官方應用商店。

核心功能

  1. 在標準 zai-coding-cn provider route 上暴露最新的 Zhipu / Z.AI coding-plan 模型,當前爲 GLM-5.3。
  2. 保留六個 bundled zai-coding-cn 模型:glm-4.5-air、glm-4.7、glm-5-turbo、glm-5.1、glm-5.2、glm-5v-turbo。
  3. 新增 glm-5.3:text-only 能力,1M context,128K max output,thinking levels Low / Medium / High / Max。
  4. 設置 endpoint 需要的兼容標誌:thinkingFormat: zai、supportsReasoningEffort: true。
  5. 不改變 API key、endpoint 或其他 provider。
  6. 提供不需要安裝插件的手動 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-cn route 上使用 GLM-5.3 的 1M context、128K max output 和 thinking levels。
  • 不想爲了一個新模型改動 DSH 主流程,只想用插件 bridge 補齊模型列表。

注意:

  • 插件以當前 dsh 進程權限運行。安裝前建議檢查 GitHub 源碼、MIT 許可證和依賴,確認行爲符合預期。
  • models list 會替換該 route 的 catalog,這是 DSH semantics。列表按插件 release 固定。
  • 當 pi-ai 以後發佈 glm-5.4 時,這個插件需要發佈新版本才能帶上新模型。
  • 插件 patch 替換的是 llm-pi-ai row 的整個 config。標準 row 當前沒有 config,但如果未來 DSH 在那裏放了 config,插件可能需要 bump。
  • GLM-5.3 的 thinking 不能關閉;Low 是最輕設置。
  • supportsReasoningEffort: true 必須存在,否則 effort parameter 會被 silently dropped。
  • package.json engines 要求 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜