前言¶
在 DeepSeek Harness（DSH）裏跑智能體時，同一條模型路由往往只有一套默認傳輸參數。若賬號支持 Codex 或代理側的「優先 / 超快」檔位，開發者通常需要在客戶端外單獨改配置，或在 Web 與終端之間各維護一套習慣。jakehemmerle 維護的 dsh-speed 把 Standard、Fast、Ultrafast 三檔速度收進 DSH 已有的 Model / Effort 菜單，並在終端用 /speed 系列命令切換；變更作用於後續請求，且按會話、Provider、模型分別記憶。
這是什麼¶
dsh-speed（npm 包名 dsh-speed，當前資料版本 0.2.1-alpha.2）是面向 DSH Web、終端命令與 Agent 模型請求的加速檔位插件。託管構建來源見 nix-config/pkgs/dsh-speed。插件在構建期對 pinned DSH 0.2.1-alpha.2 的 Model/Effort 子槽做補丁，運行時傳輸兼容在資料中寫明針對 pi-ai 0.87.1 與 1.1.0 做過審計，其他版本會失敗而不是靜默忽略速度選項。
核心功能¶
Web 與界面反饋¶
打開已有的 Model / Effort 菜單，選擇 Speed 下的 Standard、Fast 或 Ultrafast。啓動頁與底欄會顯示 Speed: Standard、Speed: ⚡（Fast）或 Speed: ⚡⚡（Ultrafast）。流式輸出過程中在 Web 裏改選項不會改變當前進行中的請求；終端側執行 /speed 相關命令則要求 Agent 處於空閒。
終端命令¶
在 dst 中：
/speed：三檔都可用時用方向鍵選擇，Enter 確認，Escape 取消；僅 Standard 與 Fast 可用時在兩者間切換。/speed status：查看當前檔位。/speed standard、/speed fast、/speed ultrafast：直接設定。
協議與檔位映射¶
資料明確：Fast 發送 priority，Ultrafast 發送 ultrafast；本地 Codex 原生請求還會發送 x-codex-routing-hint。顯式選 Standard 後發送 default；未選擇前仍沿用原有傳輸默認值。
| 路由 | 憑據來源 | 速度檔位可用性 |
|---|---|---|
Local openai-codex |
本地 Codex auth.json |
該賬號原生模型目錄 |
Configured providerproxy |
ProviderProxy 客戶端密鑰 | 代理 /v1/models 目錄 |
Official openai API |
已有 DSH API 憑據 | 顯式支持的模型列表 / 配置的 opt-in |
Titles 等輔助請求不繼承對話速度。Teammate 各自從 Standard 起步；父會話的 Fast / Ultrafast 不會靜默泄漏給 Teammate。
認證與憑據邊界¶
託管配置會直接讀 ~/.codex/auth.json 做本地 Codex 請求（含 Agent），不把 refresh token 複製進 DSH 憑據庫；賬號切換後下一次請求即跟隨文件內容。臨近過期時由配置的 Codex 可執行文件通過 account/read 自行刷新，DSH 再重讀文件。憑據缺失或無效會明顯失敗；設備從未登錄時需在該設備執行 codex login。
ProviderProxy 是獨立憑據平面：啓動器從託管 token 文件讀客戶端密鑰，代理自行維護上游 OAuth；本地 Codex token 不會轉發給代理。只有顯式配置且 base URL 在允許列表內的 Provider 才能使用代理側速度選項。
原生模型目錄緩存 5 分鐘，代理目錄 1 分鐘，按憑據鍵控；刷新會強制重新拉目錄。未知模型、憑據不可用或目錄失敗時對外只暴露 Standard。已保存檔位被撤銷時會警告並拒絕生成，直到重新選擇有效速度。
偏好默認寫入 ~/.dsh/dsh-speed.json.d/，每個 session/provider/model 一條原子替換、權限 0600 的記錄，目錄 0700；Web 與終端進程不會互相覆蓋無關記錄。舊版數組格式 dsh-speed.json 只讀遷移；stateFile: false 則僅內存。
加速能否使用取決於所選賬號權益，可能消耗更多額度或更高費用；工作賬號可能只有 Fast 沒有 Ultrafast，插件不能授予 entitlement。README 還說明：即使原生 Codex 客戶端，請求的 tier 與 response.completed 裏報告的 service_tier 也可能不一致；應把「請求是否符合協議」與延遲、計費證據分開看。
安裝與啓用¶
資料未給出 dsh plugin add github:... 一類命令。推薦路徑是使用 Nix 託管 profile 升級插件，不要再裝一條重複的 host 條目。DSH 加載新 host 插件後需要重啓進程。
在 DSH host 配置中註冊插件入口，並按環境填寫 Codex 與可選代理，例如 README 中的示例（路徑需換成你機器上的絕對路徑）：
- id: dsh-speed
name: /absolute/path/to/dsh-speed/index.js
config:
codexAuthFile: /home/you/.codex/auth.json
codexCommand: /absolute/path/to/codex
codexClientVersion: 0.160.1
proxyProviders:
providerproxy:
baseURL: http://gpu.tail47033e.ts.net:4000/v1
apiKeyEnv: PROVIDERPROXY_API_KEY
插件以當前 DSH 進程的權限運行；安裝前請自行審閱 GitHub 倉庫 源碼與 MIT 許可證。
典型用法¶
- 完成 host 配置並重啓 DSH 後，在 Web Model / Effort → Speed 選擇檔位，或對空閒 Agent 在終端執行
/speed fast等命令。 - 用
/speed status確認當前選擇；底欄圖標應與檔位一致。 - 若走本地 Codex，確保
codexAuthFile指向有效auth.json；從未登錄則先codex login。
資料中給出用 Codex CLI 復現原生 Ultrafast 請求的 smoke 命令（需本機已有 CLI 登錄，模型名可按需替換）：
codex --no-daemon --disable apps --disable plugins exec \
--ignore-user-config --ignore-rules --ephemeral --skip-git-repo-check \
-s read-only -m gpt-6.1-sol \
-c 'service_tier="ultrafast"' -c 'model_reasoning_effort="low"' \
'Reply only SPEED_OK. Do not use tools.'
適用場景與注意¶
適合已經在 DSH 中使用 openai-codex、配置好的 providerproxy 或官方 openai 路由，且賬號目錄裏確實 advertised Fast / Ultrafast 的開發者。不適合指望插件「憑空開通」未購買的加速檔位。
運行環境需 Node >= 22.19（見 package.json）。修改 host 插件或升級 Nix 託管包後記得重啓 DSH。社區目錄 skillhub.cn 插件頁 與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係；選型以倉庫 README 與本地審計爲準。
結尾¶
dsh-speed 把 DSH 裏分散的「要不要開加速」收成統一的 Speed 檔位與 /speed 命令，並在多路由、多會話下隔離偏好與憑據。進一步細節與測試說明見 GitHub：jakehemmerle/dsh-speed 與目錄頁 https://www.skillhub.cn/plugins/jakehemmerle/dsh-speed。
