前言¶

dsh-model-modes 是一個面向 DeepSeek Harness web composer 的 DSH 插件。它把能力感知的推理選擇保留在 DSH 的官方模型選擇器裏，同時給 composer 增加一個明確的 Fast ON/OFF 開關。

這個插件要解決的是兩個具體問題：不同 provider 的 Fast / Priority 請求參數不一致；以及 Fast 不應悄悄改變模型、降低 reasoning，或切換到另一個 DSH provider。

這是什麼¶

dsh-model-modes 由 DTSFO 維護，許可證爲 MIT，已覈實的包版本是 0.1.3，Node 引擎要求是：

^22.19 || >=24

倉庫地址：

https://github.com/DTSFO/dsh-model-modes

一句話定位：爲 DeepSeek Harness web composer 提供 capability-aware reasoning profiles 和 provider-native Fast mode。

核心功能¶

• 保持 reasoning selection 在 DSH 的官方模型選擇器內。
• 將 reasoningProfiles.provider: '*' 展開到實際包含 exact model id 的 llm-pi-ai provider，不使用 myself 硬編碼。
• 爲 gpt-5.6 暴露獨立的 Max 和 Ultra 選擇。
• 在 composer 中增加明確區分的 Fast ON/OFF 開關。
• 應用當前 provider 的 native fast/priority request parameter，不降低 reasoning、不改變模型、不改變 DSH provider。
• 跟蹤官方 per-session ModelDirectory；不支持的路由可見地不可用，並被 Host 拒絕。
• 支持 Max + Fast 和 Ultra + Fast 組合。

Fast 的注入發生在最終 llm-pi-ai 邊界：

Models.streamSimple()

該注入使用 AsyncLocalStorage 隔離併發 session。

Fast 的邊界¶

Fast 與 reasoning 正交。它不會選擇 cheaper reasoning effort，不會選擇 flash / turbo sibling model，也不會切換到另一個 DSH provider。

能力判斷來自 live llm-pi-ai route 和 selected model 的實際 pi-ai API id。不支持的路由會顯示爲 N/A，不能啓用。

賬號權益、區域容量、部署支持、fallback 和 billing 仍然是 provider 決策。

被拒絕的 built-in provider 不能靠分配 generic OpenAI-style 或 custom strategy 啓用。未知或 self-hosted compatible gateway 默認不支持，需要 exact verified provider/model/API profile。

azure-openai-responses、google-vertex、amazon-bedrock 是 explicit opt-in only。

vercel-ai-gateway 的 Fast mode 配置爲 fast-or-fail：

allowFallbackFromFast: false

它不會靜默 fallback 到 Standard。

fireworks 暴露 request-level Priority，使用：

service_tier: priority

這不是 *-fast router/model switch。

內置 Provider 合同¶

已覈實的內置 provider 合同覆蓋以下 provider：

openai
openai-codex
xai
google
openrouter
minimax / minimax-cn
vercel-ai-gateway
fireworks
azure-openai-responses
google-vertex
amazon-bedrock

這裏表示插件爲這些 provider 定義了已知請求合同；具體可用性仍受模型、路由、部署和 provider 約束。

配置¶

內置合同默認啓用。fastProfiles 是 additive/override 層；later exact provider/model/API matchers win。

如果只想使用顯式 profiles，可以關閉默認：

- id: dsh-model-modes
  config:
    includeDefaultFastProfiles: false

已覈實資料中給出的 Vertex 顯式 profile 字段如下。Vertex 需要顯式配置，因爲 matcher 不能檢查 endpoint location：

fastProfiles:
  - provider: google-vertex
    model: gemini-3.7-flash
    api: google-vertex
    strategy: vertex-priority

可用的 known strategies 是：

openai-fast
openai-codex-fast
service-tier-priority
fireworks-priority
google-priority
vertex-priority
bedrock-priority
openrouter-fast
vercel-gateway-fast
custom

custom 只用於已驗證的 gateway-specific contract。下面是一個已覈實示例中的 body / headers 結構：

fastProfiles:
  - provider: your-gateway
    model: your-model
    api: openai-responses
    strategy: custom
    body:
      acceleration:
        tier: turbo
    headers:
      X-Gateway-Fast: "1"

your-gateway 和 your-model 是佔位名稱；配置必須使用 exact provider/model/API。

安裝與啓用¶

已覈實資料未提供官方安裝命令，因此這裏不拼接安裝命令。使用前請通過倉庫地址審查源碼和 MIT 許可證。

這個插件以當前 dsh 進程權限運行。安裝前應確認你接受該插件在最終 llm-pi-ai 邊界進行請求參數注入。

運行信息：

name: dsh-model-modes
version: 0.1.3
license: MIT
node: ^22.19 || >=24
repository: https://github.com/DTSFO/dsh-model-modes

結尾¶

dsh-model-modes 的價值在於把 reasoning 選擇留在 DSH 的官方模型選擇器中，同時用 provider-native Fast / Priority 參數擴展 composer，並且對沒有精確合同的路由保持拒絕。

倉庫地址：

https://github.com/DTSFO/dsh-model-modes