前言¶

用 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 （該地址來自線索，未在倉庫資料中直接覈實）