前言¶
在 DeepSeek Harness（DSH）裏寫對話、調模型時，Composer 底部自帶的模型菜單能完成切換，但推理力度（reasoning effort）若與菜單分離，或檔位與適配器實際宣告不一致，切換時容易多一步確認，也不易掃一眼當前模型與力度。
社區插件 dsh-codex-model-picker（維護者 caidows）用一張疊在模型按鈕上方的小卡片，同時展示當前模型和可拖動的力度滑條，交互上接近 Codex 的模型切換器。本文基於插件 GitHub README 與 package.json 整理功能、安裝方式與使用注意點。
這是什麼¶
dsh-codex-model-picker 是面向 DSH web 端 Composer 的客戶端插件：用 Codex 風格的卡片替換出廠模型菜單——上方是推理力度、中間是當前模型、底部是可拖動檔位滑條。
- 維護者：caidows
- 分類：模型推理
- 許可證：MIT（README）
- 包版本：
1.0.0（package.json） - 源碼與說明：GitHub - caidows/dsh-codex-model-picker
- 社區目錄：SkillHub 插件頁
DSH 生態強調「一切皆插件」；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
以下能力均來自 README 功能列表。
Codex 風格卡片佈局¶
卡片錨定在 Composer 模型按鈕上方；空間不足時翻到按鈕下方。顏色、圓角與陰影使用 DSH 主題 token，支持明暗主題。
可拖動推理力度滑條¶
滑條按模型適配器宣告的 reasoning.efforts 設置檔位，常見包括 off、minimal、low、medium、high、xhigh、max（僅宣告存在的檔位會出現）。拖動時拇指吸附到整檔，帶動畫；力度標籤在拖動過程中更新，而非僅在鬆手後。
不設提供商默認檔位： 檔位來自適配器宣告，不合成額外的 “default” 項。未存儲力度的模型在可用時顯示 medium，否則用宣告的默認值或中間檔。
若模型宣告 Off，選中並確認後會發送 reasoningEffort: "off"；部分提供商（如 Codex）會映射爲關閉推理。
模型列表¶
按提供商分組，展示當前選中、徽章、加載與錯誤狀態，並支持鍵盤導航。界面支持中文與英文。
鍵盤操作¶
方向鍵逐檔移動；Home / End 跳到兩端；Escape 關閉卡片並將焦點歸還。
環境要求¶
- DeepSeek Harness
0.2.2-rc.1或更新（README：conversation.input.model客戶端插槽 API 在該版本線穩定）。 - 使用 web 配置（
dsh web或桌面應用中的 web 配置）。
package.json 中 engines.dsh 爲 >=0.2.2-rc.1。
安裝與啓用¶
在 web 配置下執行官方安裝命令：
dsh plugin --profile web add github:caidows/dsh-codex-model-picker
安裝後刷新頁面。插件在 conversation.input.model 上以優先級 -1 註冊客戶端插槽佔用方，覆蓋出廠模型選擇器；禁用或移除插件後恢復原廠選擇器，且不殘留狀態。
若從本地檢出安裝，將 dsh plugin add 指向插件包目錄即可（README 說明，非 git clone 場景下的路徑由你本地檢出位置決定）。
典型用法¶
安裝並刷新後，無需單獨配置文件：在 Composer 底部點擊模型入口，打開卡片即可：
- 在底部滑條上拖動或點選，設置當前會話的推理力度；檔位範圍取決於當前模型適配器宣告的 efforts。
- 在卡片內的模型列表中切換模型；選擇與力度變更經
session.selectModel等與出廠選擇器相同的會話模型目錄邏輯，與界面其餘部分保持同步。
插件通過 cordis.patch.yml 加載 client.js 客戶端包，並讀取與出廠選擇器一致的按會話模型目錄（ctx.modelDirectories.directoryFor(sessionId)）。
適用場景與注意¶
適合誰： 經常在 DSH web Composer 裏切換模型、且需要與 Codex 類似「模型 + 力度」一體操作的開發者。
運行方式： 插件以當前 DSH 進程權限在瀏覽器端運行；安裝前建議瀏覽 倉庫源碼 與 MIT 許可條款。
僅客戶端 web： package.json 中 dsh.client.platform 爲 web，且 immediately: true；不滿足 0.2.2-rc.1 或沒有 web 配置時，README 中的安裝與覆蓋行爲可能不適用。
結尾¶
dsh-codex-model-picker 把 Composer 模型菜單換成帶可拖動推理力度滑條的 Codex 風格卡片，並按適配器宣告的 efforts 顯示檔位，避免合成默認檔。需要時在 web 配置執行上述 dsh plugin 命令，刷新頁面即可使用。
