前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。Command Code 訂閱主要分爲兩類：Provider API 計劃和 Go/GOAT/Pro/Max 計劃。前者原生支持，後者調用標準 OpenAI 兼容端點會返回 403 upgrade_required，只能走私有網關 POST /alpha/generate。
本插件復刻了該私有網關的協議 —— 請求信封、逐行 JSON 流、事件映射 —— 把訂閱變成一個 DSH 原生 Provider。使用者不需要安裝 Command Code CLI，也不需要 Provider API。
核心功能¶
- 實時模型目錄：啓動時拉取，按檔位過濾，默認不隱藏任何模型。
- 模型名標註上下文容量：如
Claude Sonnet 5.5 [1M]、GPT-5.5 [400K]，取自模型列表接口的真實值。 - 逐模型推理等級：只列出該模型真實支持的檔位。
- 可視化配置 API Key：在插件卡片裏粘貼保存即可，不用手改配置文件。
- 底部用量環：顯示 5 小時窗口占用比例與重置倒計時（≥90% 時轉紅），點擊可展開周窗口與餘額。
- 支持圖片輸入、工具調用、流式輸出。
安裝與啓用¶
通過 DSH 的插件管理器安裝：
dsh plugin --profile web add github:freeqin123/dsh-commandcode-plans-provider
如果報 ERR_PNPM_ADDING_TO_ROOT，說明你的 profile 目錄是一個 pnpm 工作區，需加上 -w：
dsh plugin --profile web add -w github:freeqin123/dsh-commandcode-plans-provider
安裝後必須重啓 DSH 才能生效。插件列表裏會出現本插件（bundle id 爲 commandcode-plans-provider）。
配置 API Key¶
在 DSH 裏進入 插件 → 本插件 → 配置：
- API 密鑰：粘貼你的 key 並點擊保存。密鑰寫入 DSH 憑據庫，引用名爲
COMMANDCODE_API_KEY。界面只顯示掩碼指紋以確認身份。 - 測試連接：點擊按鈕可驗證網關可達性，失敗會返回上游原文（如
401）。 - 套餐檔位：點擊檔位按鈕（Go / GOAT / Pro / Max）選擇套餐，配置狀態會顯示爲 ready。
典型用法¶
1. 選模型¶
進入 設置 → 模型 → Command Code，選擇一個模型。名字後面的 [1M] 代表上下文容量。
2. 選檔位¶
在插件卡片裏點檔位按鈕。語義是“顯示該檔位及以下包含的全部模型”：
- Go：所有 Go 模型
- GOAT：所有 Go + GOAT 模型
- Pro：所有 Go + GOAT + Pro 模型
- Max（默認）：全部（凡 catalog 標了已知檔位的模型）
3. 選推理等級¶
模型選擇器裏的“推理等級”由本插件逐模型填充，列出該模型真實支持的檔位（如 Low / Medium / High / Max）。如果模型不支持，選擇器會顯示“當前模型未提供推理等級”。
4. 查看用量¶
底部 composer 那一行會多出一個環，顯示 5 小時窗口的佔用比例。環 ≥90% 時會轉紅，後面跟重置倒計時。點擊環可展開查看 5 小時/周窗口/餘額的詳情。
5. 處理圖片¶
支持視覺的模型可以直接貼圖。注意：
- 純文本模型（如 DeepSeek / GLM / Qwen）會明確拒絕圖片輸入。
- 網關無狀態，長對話中圖片需重複內聯發送。
- 一輪裏內聯的 base64 總量超過 2 MiB 時，會要求丟棄最舊的圖片。
已知限制¶
- 未公開接口：使用的是
/alpha/generate私有網關，官方可能隨時改動或封禁。 - 單賬號：不支持多賬號並行。
- 無自動重試：遇到
RATE_LIMIT不會自動重試，需手動重試。 - 圖片重複開銷：長對話中圖片會重複內聯，增加開銷。
- 純文本限制：部分模型明確拒絕圖片輸入。
生態背景¶
DSH 的插件目錄由社區維護，與 DeepSeek 或幻方無官方從屬關係。本插件代碼託管在 GitHub，遵循 MIT 許可證。
