前言¶
在 DeepSeek Harness（DSH）裏，「思考強度」不是全局開關，而是寫在每個模型元數據裏的聲明式能力。只有 provider/model 路由解析出的模型帶 reasoning 檔位表時，模型選擇器纔會出現「思考強度」一行；手工在 models: 里加的自定義模型默認按非推理模型處理，必須逐條聲明 reasoningEfforts，還要對齊 wire 值與 thinkingFormat。手改 YAML 容易拼錯檔位名或網關參數字符串。下面介紹社區插件 dsh-reasoning-setup（維護者 Ayelsh），它把掃描、勾選檔位和寫入校驗放到設置頁，寫入目標與 llm-pi-ai 插件、dsh-zhipu-plan 使用的是同一份設置文檔。
這是什麼¶
dsh-reasoning-setup 是一個 out-of-tree profile bundle（DSH 插件），分類屬於模型推理。它掃描已註冊的 Provider 與模型，找出沒有聲明思考能力的模型，並提供設置頁，爲可編輯路由直接聲明 reasoningEfforts 與 thinkingFormat。檔位與格式詞表、校驗規則鏡像自 harness 中 packages/llm/llm-pi-ai/src/catalog.ts 的 resolveModelReasoning 同一套邏輯；寫入前按 pi-ai 解析器規則校驗，避免無效配置落盤。
爲什麼需要它¶
DSH 裏思考強度的可見性取決於模型元數據是否帶檔位表。目錄路由上的模型若未在設置文檔裏聲明 reasoningEfforts，選擇器裏不會出現「思考強度」。自定義 Provider 常見形態是路由帶 models: 列表，這類條目更適合在頁面上勾選 off / minimal / low / medium / high / xhigh / max，並逐檔填寫發給網關的 wire 值（off 可留空，表示選該檔時不發送思考參數），而不是反覆編輯 YAML。
核心功能¶
掃描¶
列出全部已註冊 Provider 及其模型，標記每個模型當前是否提供思考檔位、有哪些檔、默認檔是什麼。不可經 llm-pi-ai 設置文檔編輯的 Provider（例如 README 中提到的 deepseek-official）以只讀方式展示。
聲明與修改¶
對可編輯模型：
- 勾選要提供的檔位：off、minimal、low、medium、high、xhigh、max。
- 逐檔填寫 wire 發送值（請求裏發給網關的字符串）。
- 可選設置
thinkingFormat（README 列舉 openai、deepseek、qwen、zai 等 11 種）。
移除聲明¶
可刪除本頁寫入的聲明，讓模型回到目錄繼承或默認行爲。注意：「移除聲明」只移除本頁寫入的 reasoningEfforts / compat.thinkingFormat，不會把目錄模型改成 reasoningEfforts: false。
寫入位置與併發¶
- 路由帶
models:列表 →providers.<route>.models.<i>.reasoningEfforts（及同條目的compat.thinkingFormat）。 - 目錄路由（如 zai、zai-coding-cn）→
providers.<route>.modelOverrides.<model>.reasoningEfforts。
寫入帶 revision 樂觀鎖；掃描後若文檔被其它頁面改動，會拒絕寫入（reasoning-setup/conflict），而不是靜默覆蓋。
保存後重新打開模型選擇器即可看到「思考強度」一行。
安裝與啓用¶
宿主需要 0.1.7-rc.2 及以上；README 註明在 0.2.0-rc.1 上實測過安裝（依賴 dsh-base 掛載 llm/settings/Typert seam）。插件當前 package 版本爲 0.1.3，以 MIT 許可證發佈。
任選一種方式安裝後重啓 DSH：
插件市場（dshmarket）
在 DSH 插件市場中搜索 dsh-reasoning-setup，點擊安裝並重啓。市場條目指向含構建產物的 tarball，安裝時不需要本地工具鏈。
預構建 tarball（離線或手動）
在應用內 設置 → 插件 中選擇 release 包安裝並重啓。地址始終指向最新 release，lib/ 已構建好：
https://github.com/Ayelsh/reasoning-setup/releases/latest/download/dsh-reasoning-setup.tgz
源碼安裝
倉庫已提交構建產物 lib/，源碼安裝不需要本地構建，也不會在安裝時跑 prepare / esbuild：
dsh plugin --profile <profile> add github:Ayelsh/reasoning-setup
將 <profile> 換成你實際使用的 profile 名。
profile bundle
把 dsh.profile.bundles 追加 dsh-reasoning-setup（包內已提供 lib/）。
插件本身不聲明運行時依賴，運行時通過 profile 的模塊回退鏈接複用宿主已加載的 harness 包。
典型用法¶
- 安裝並重啓 DSH，確保自定義 Provider 或目錄路由已在 llm-pi-ai 設置文檔中配置好。
- 打開本插件提供的設置頁，等待掃描完成，查看各模型是否已有思考檔位。
- 對標記爲可編輯、且尚未聲明檔位的模型，勾選需要的檔位並填寫 wire 值；若網關要求特定思考參數格式，設置
thinkingFormat。 - 保存；若出現
reasoning-setup/conflict，說明掃描後設置文檔已被其它頁面修改，需刷新頁面重新掃描後再提交。 - 回到對話或任務界面，重新打開模型選擇器，確認出現「思考強度」並切換檔位驗證請求行爲。
開發者若從源碼改動 UI 或 host 邏輯，README 建議本地執行：
pnpm install
pnpm run build
pnpm run verify
verify 會對照 deepseek-harness 校驗導入、loader 清單、檔位/格式詞表與 scan 規則夾具。
適用場景與注意¶
適合誰
- 使用自定義 Provider、在
models:裏手工登記模型，但選擇器裏沒有「思考強度」的 DSH 用戶。 - 需要爲目錄路由上的單個模型做
modelOverrides推理聲明、又不想反覆手改 YAML 的配置維護者。
邊界與權限
- 只能編輯經 llm-pi-ai 設置文檔配置的路由；其它適配器的模型僅只讀展示。
- 檔位與格式詞表隨 harness 的
catalog.ts演進；升級 harness 後若行爲異常，維護者應在插件倉庫重跑pnpm run verify並與上游門表比對。 - 插件在當前 DSH 進程權限下運行，會讀寫 LLM 相關設置文檔。安裝前應查看 GitHub 倉庫 源碼與 LICENSE、NOTICE；本項目與 DeepSeek 無從屬、背書或贊助關係。
結尾¶
dsh-reasoning-setup 把「哪些模型缺思考檔位、該寫進設置文檔的哪條路徑」做成可掃描、可表單編輯的流程，並與 llm-pi-ai 共用同一份配置與校驗規則。需要頁面化補全 reasoningEfforts 時，可從社區目錄或 GitHub 安裝試用。
