前言¶
DeepSeek Harness(DSH)採用插件化架構,允許用戶通過插件擴展功能。在使用 PackyCode(PackyAPI)作爲模型提供商時,通常需要額外配置 provider 或修改 YAML 文件。DSH PackyCode API 插件旨在解決這一痛點,它直接在 DSH 中集成了 PackyCode 的 Key 管理、模型路由與餘額查詢功能。
插件簡介¶
這是一個由 BaronCyrus 維護的模型推理插件,開源協議爲 MIT。
它的核心價值在於:利用 PackyCode 的 API Key,在 DSH 裏選模型、輪換 Key、看餘額。
核心功能¶
根據已覈實的事實,該插件具備以下能力:
* 自帶模型路由:安裝後模型選擇器會出現 PackyCode 分組,無需配置 provider 或修改 cordis.patch.yml。
* 多 Key 按順序使用:額度用盡或 Key 被拒絕時自動切換到下一個可用 Key。
* 按分組選 Key:支持根據 Key 所在的 PackyCode 分組來選擇模型。
* 餘額一眼可見:設置頁列出每個 Key 的剩餘、已用、額度及合計。
* 本地憑據管理:Key 僅存儲在 DSH 憑據文件裏,瀏覽器無法獲取明文。
* Claude 本地 CLI:特定 Claude 模型可通過本機官方 CLI 執行。
* 網頁搜索集成:可選將 DSH 的 web_search 接管給 PackyCode。
* 圖片生成與編輯:支持 GPT Image 系列模型的生成與編輯。
安裝與啓用¶
- 準備好 DeepSeek Harness 和 PackyCode 的 API Key。
- 打開桌面應用的插件頁,點擊添加插件。
- 在包名或地址中填入帶版本號的包名:
dsh-packycode-api@1.2.9
- 在安裝源中選擇官方源,然後點擊安裝。
注意:一定要帶版本號。只填
dsh-packycode-api時,DSH 默認 pnpm 可能安裝舊版,且安裝提示無法顯示實際版本差異。安裝後可在 設置 → PackyCode → 插件版本 覈對。
日常使用¶
- 添加 Key:打開 設置 → PackyCode,在「添加 Key」裏粘貼 API Key。點「添加」。
- 選擇模型:在對話的模型選擇器裏選
PackyCode分組下的模型。 - 配置顯示模型:在 設置 → PackyCode → 顯示的模型 中勾選要顯示的模型。
- 切換 Key:點「切到此 Key」指定優先使用的 Key。Key 按添加順序使用。
- 查看餘額:「賬戶與 Key」顯示各 Key 的剩餘與合計額度。「刷新」會跳過約 60 秒的緩存。
注意事項¶
- 本地開發:本地開發需加
link:前綴(如dsh plugin --profile <name> add link:/path/to/dsh-packycode-api),不要直接寫路徑或file:,否則會把整個倉庫複製進 profile。 - 憑據安全:Key 只存在 DSH 憑據文件裏,瀏覽器只能看到備註、狀態和餘額,插件不會讀取環境變量
PACKY_CODE_API_KEY。 - 網絡問題:舊默認值
https://www.packyapi.com在國內網絡下 DNS 被污染,插件會自動嘗試.ai後綴或提示配置接口地址。 - 隱私:不要把 Key 粘貼到公開 Issue、聊天記錄或截圖裏。
結語¶
該插件簡化了在 DSH 中使用 PackyCode 的流程,實現了從 Key 管理到模型路由的無縫集成。適合需要頻繁切換不同模型提供商或管理多 Key 的開發者。更多細節可查閱 GitHub 倉庫。