前言¶
如果你在 DeepSeek Harness（DSH）裏接入過自定義 API 模型，大概率遇到過兩個問題：一是官方設置裏沒有針對自定義模型的思考等級配置入口，想開 high 或 max 檔位只能手動改配置；二是每次切換渠道或新建會話，模型和思考強度都會回退到默認值，之前的偏好記不住。渠道級重試策略同理，默認行爲不一定符合自己的網絡環境。
下面介紹的 dsh-model-memory 就是爲解決這幾個問題而寫的 DSH 插件。它在 DSH 官方「設置 -> 模型」中爲自定義 API 模型掛載思考等級配置欄，同時跨會話記住每個渠道最後選用的模型與思考強度，並提供渠道級重試策略配置。
這是什麼¶
dsh-model-memory 是一款 DSH 插件，定位是「自定義 API 模型思考等級管理、渠道重試策略與偏好持久記憶」，由 Mutx163 維護，基於 TypeScript 編寫，採用 MIT 協議開源，當前版本爲 0.1.12，要求 Node.js >= 20，客戶端平臺爲 web。
DSH 的理念是「一切皆插件」，這款插件就是按這個思路做的：不改主界面結構，功能嵌入到官方設置項裏。它基於獨立本地工程與 DSH Profile 軟鏈接機制掛載，升級 DSH 全局腳手架不會丟失插件與配置。
核心功能¶
自定義模型思考等級配置¶
- 在 DSH 官方「設置 -> 模型」中，展開自定義 API 模型時，自動掛載思考等級配置欄。
- 支持爲模型一鍵開啓
supportsReasoningEffort，並勾選思考檔位：low/medium/high/max。 - 點擊保存後原子化寫入
~/.dsh/settings.yaml，即時熱重載，無需重啓。
配置寫入路徑有一個容錯設計：優先走宿主的 settings 服務，宿主服務缺失時回退到原子文件直寫，保證配置一定能落盤。
跨會話偏好記憶¶
- 按渠道精準記錄：跨會話記錄每個渠道最後選用的模型及其配置的思考強度。
- 自動回填：切換渠道或新建會話時，自動恢復該渠道的歷史模型與思考強度偏好，不再回退到默認基本強度。
持久化存儲由獨立存儲引擎負責，磁盤路徑爲 ~/.dsh/model-memory.json。
渠道級請求重試策略¶
三種模式可選：
- 渠道默認：失敗後最多重試 5 次。
- 無限重試：失敗後一直重試，直到成功或手動取消。
- 自定義次數：自行指定次數，
0表示不重試。
retryPolicy 按渠道配置，渠道內所有模型共享。更新時會保留該渠道已有的 backoff 退避參數，寫入路徑與思考等級配置一致（宿主 settings 服務優先，缺失時回退原子文件直寫）。
界面與升級¶
- 插件不添加多餘按鈕，主界面保持原生樣式。
- 基於獨立本地工程與 DSH Profile 軟鏈接機制，升級 DSH 全局腳手架後插件與配置不丟失。
安裝與啓用¶
推薦從 NPM 安裝，執行下面的命令把插件掛載到 DSH 的 Web Profile：
dsh plugin --profile web add dsh-model-memory
安裝後思考等級配置欄會出現在 DSH 官方「設置 -> 模型」中，展開自定義 API 模型即可看到。
本地開發與調試¶
如果你想在本地改代碼或做二次開發，可以走軟鏈接方式掛載。先克隆倉庫、安裝依賴並完成一次完整驗證：
git clone https://github.com/Mutx163/dsh-model-memory.git
cd dsh-model-memory
pnpm install
pnpm run verify
pnpm run verify 會依次執行類型檢查、單元測試和打包構建，產物輸出至 lib/。之後把本地目錄以軟鏈接形式掛載到 DSH Web Profile：
dsh plugin --profile web add link:/path/to/dsh-model-memory
日常開發中常用的幾個命令：
# TypeScript 類型檢查
pnpm run typecheck
# 運行全套 Vitest 單元測試
pnpm run test
# 完整驗證與打包構建
pnpm run verify
項目還依賴 js-yaml ^5.3.0，peer 依賴包括 @deepseek-ai/cordis（>=4.0.1 <4.1.0）與 @deepseek-ai/dsh-agent（>=0.1.1-rc.1 <0.2.0）。
適用場景與注意事項¶
適合這幾類用戶：
- 在 DSH 中接入自定義 API 模型，需要手動指定思考檔位（如
max）的人。 - 多渠道使用者，希望每個渠道各自記住上次選用的模型和思考強度，而不是每次新會話都從頭設置。
- 對請求重試行爲有明確要求的場景，比如不穩定網絡下想要無限重試，或計費敏感場景想設爲不重試。
安裝前有幾點需要確認：
- 插件以當前 dsh 進程的權限運行，會讀寫
~/.dsh/settings.yaml與~/.dsh/model-memory.json等本機文件，安裝前應檢查源碼與許可證，確認行爲符合預期。 - 該插件客戶端平臺爲 web，需要掛載到 Web Profile 使用。
- 項目採用 MIT 協議開源，協議信息在 README 徽章、LICENSE 文件與 package.json 中均有一致聲明。
結尾¶
dsh-model-memory 做的事情不復雜：把 DSH 自定義模型缺的思考等級配置補上，把渠道與思考強度偏好跨會話記住，把重試策略開放到渠道級。三件事都落在官方設置界面內，配置寫入走原子操作，升級腳手架也不丟數據。
項目地址：https://github.com/Mutx163/dsh-model-memory
社區目錄頁：https://www.skillhub.cn/plugins/Mutx163/dsh-model-memory（社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。）
