DeepSeek Harness 插件：zhangzifei/dsh-model-aliases

前言¶

DeepSeek Harness（DSH）採用插件化架構，允許用戶和開發者擴展功能。zhangzifei/dsh-model-aliases 是一個模型推理類插件，它爲 DeepSeek Harness Web 提供持久化模型別名功能。通過將提供商、模型與推理等級綁定爲易記名稱，用戶可以在輸入框旁通過單一選擇器快速切換，而無需每次重新配置。

核心功能¶

完整配置綁定：一個別名代表完整的模型配置，名稱同時綁定提供商、模型和可選推理等級。
雙向同步：別名選擇器與原生“模型 / 推理等級”控件並存。選擇別名會改寫原生控件內容；在原生控件手動操作會更新別名顯示。
持久化與目錄感知：配置寫入 DSH 的 model-aliases 命名空間，重啓後繼續生效。支持從當前會話目錄下拉選擇，或直接在同一字段輸入自定義 ID。
安全容錯：目錄中暫時不存在的別名不會丟失，但會被禁用並說明原因。鎖定狀態下禁止切換，被尋址的子代理會話不顯示選擇器。
原生校驗：所有選擇最終通過 DSH ModelDirectory.select() 校驗和應用，保證配置的有效性。

安裝與啓用¶

執行安裝命令：

dsh plugin --profile web add github:ZhangZiFei/dsh-model-aliases

重啓 dsh web 進程並刷新頁面。
打開 設置 → 模型別名 進行初始化。

使用流程¶

打開 設置 → 模型別名。
添加別名，可從下拉菜單選擇或直接輸入提供商、模型以及可選推理等級。
調整順序並保存。
回到會話，在輸入框右下角使用別名選擇器切換；旁邊的原生模型選擇器會同步顯示當前模型和推理等級，也可以直接在那裏手動選擇。

配置說明¶

配置保存在 DSH 設置文檔的 model-aliases 分節：

model-aliases:
  aliases:
    - name: 日常
      provider: deepseek
      model: deepseek-chat
    - name: 深度推理
      provider: openai
      model: o3
      reasoningEffort: high

配置規則：
* 名稱、提供商、模型以及存在的推理等級必須是首尾無空白的非空字符串。
* 別名名稱必須唯一。
* 提供商、模型和推理等級組成的完整選擇必須唯一。

兼容性與注意事項¶

兼容目標：當前兼容 DeepSeek Harness Web 0.1.2-rc.1。
自動注入：插件已聲明 DSH Bundle，安裝命令會自動將 Patch 加入 Web Profile，無需手工編輯 cordis.patch.yml。
默認行爲：推理等級選擇“提供商默認”時，插件不會寫入虛構的默認值，而是保留適配器或提供商的原始行爲。
預置邏輯：首次使用會寫入預置別名；如果保存空列表，插件也會自動恢復預置值。預置路由不在當前模型目錄時會保留，但不能被選擇。

總結¶

該插件通過別名機制降低了 DeepSeek Harness Web 中模型配置的切換成本，適合需要頻繁調整模型參數的用戶。更多技術細節請訪問 GitHub。