前言¶
在 DeepSeek Harness（DSH）裏做智能體開發，常見做法是各自配置多家廠商的 API Key，在模型選擇器裏手工維護列表，賬單也往往分散在各平臺後臺。若你使用或評估 Polza.ai 這類聚合服務——統一賬號、盧布結算、並在界面內查看餘額與消耗——更適合用官方插件把 Harness 直接接到 Polza，而不是在 Harness 裏重複拼多條 OpenAI 兼容端點。
下面介紹維護者 polza-ai 發佈的 @polza-ai/dsh-plugin-polza（分類：模型推理）：在 DSH 0.2.x 中註冊 Polza 爲模型提供方，並在設置頁、側欄與聊天區展示賬號、餘額、會話花費和模型目錄。
這是什麼¶
@polza-ai/dsh-plugin-polza 將俄羅斯 LLM 聚合平臺 Polza.ai 接入 DeepSeek Harness。README 寫明可訪問 290+ 模型，覆蓋 Anthropic、OpenAI、Google、DeepSeek、Qwen、Moonshot、Z.ai 等供應商；計費與展示以 盧布（₽） 爲主，通過 Polza 賬號登錄後即可在 Harness 內選模型、看餘額與消耗。
npm 包當前版本爲 0.2.1，許可證 MIT；package.json 中 engines.dsh 要求 >=0.2.2-rc.1 <0.3.0。README 標註與 DeepSeek Harness 0.2.x 兼容，且說明插件在 CI 中每日針對新版本 harness 做兼容性檢查。
核心功能¶
模型選擇與目錄¶
- 模型選擇器中出現 Polza 分組，帶各廠商圖標。
- 可在設置中自行勾選模型，或一鍵應用預設：«Популярные»（熱門）、«Для кода»（偏代碼）、«Дёшево»（低價），README 稱預設依據 Polza 側真實統計。
- 設置內提供約 290 款模型的目錄：₽/百萬 token 標價、搜索、按廠商篩選；對不適合 agent 工具調用的模型有 «без инструментов» 標記。
- 符合俄羅斯 152-ФЗ 在境內處理數據的模型帶專用徽章，並支持 «Только ФЗ-152» 篩選。
賬號、餘額與消耗¶
- 設置 → Польза（Polza）：組織餘額、API Key 剩餘額度、消耗統計。
- 聊天輸入框下方顯示本會話盧布花費；懸停可查看最近一次調用、緩存命中、token 及按模型（含出圖）拆分。
- 側欄頁腳常顯可用餘額；餘額不足或觸及 Key 限額時插件會提示充值，而非只拋出晦澀錯誤。
媒體生成與本地目錄¶
- Agent 可通過 Polza Media API 生成圖片與視頻；README 列舉 Nano Banana、GPT Image、Seedream、FLUX、Seedance、Kling、Veo 等。
- 結果出現在聊天中，文件寫入工作區下的
polza-media/目錄。
輔助模型與語音¶
- 會話標題生成、上下文壓縮等「內務」默認可走較便宜模型（README 默認示例爲 DeepSeek V4.1 Flash），主模型主要用於用戶任務。
- 若另裝「語音輸入」插件，可將識別服務選爲 «Польза · GigaAM»，使用雲端俄語識別，無需本地裝模型。
安裝與啓用¶
安裝命令須與 README 原文一致，任選其一：
- 在 DSH 客戶端：插件 → 添加插件，輸入包名
@polza-ai/dsh-plugin-polza。 - 在終端執行：
dsh plugin --profile desktop add @polza-ai/dsh-plugin-polza
安裝後重啓應用，打開 設置 → Polza，點擊 通過 Polza 登錄（Войти через Пользу） 完成授權。
注意： DSH 插件以當前 dsh 進程權限運行。安裝前建議在 GitHub 倉庫 查閱源碼與 MIT 許可證，確認符合你的合規與安全要求。
典型用法¶
設置頁登錄¶
按上文安裝並重啓後，在 設置 → Polza 完成瀏覽器登錄或 Key 配置（亦可用下文命令）。
聊天命令 /polza¶
README 提供與同功能等價的斜槓命令：
| 命令 | 作用 |
|---|---|
/polza login |
在瀏覽器中通過 polza.ai 登錄 |
/polza key pza_… |
保存 API Key |
/polza logout |
刪除已保存 Key |
/polza balance |
查看組織餘額與 Key 限額 |
/polza models |
列出已加入選擇器的模型及價格 |
/polza catalog <搜索詞> |
在 Polza 全目錄中搜索 |
示例：查看餘額與在目錄中檢索模型：
/polza balance
/polza catalog gpt
選模型與會話花費¶
在模型選擇器的 Polza 分組中切換模型；會話過程中留意輸入框下方的盧布消耗提示，便於控制成本。
適用場景與注意¶
適合： 已有 Polza.ai 賬號、希望用盧布統一結算，並在一個 Harness 界面裏使用多廠商 LLM、出圖/出視頻及（配合語音插件）GigaAM 俄語識別的開發者。
侷限與前提：
- 產品側能力（模型列表、價格、FZ-152 標記、Media API）以 Polza 平臺爲準；插件負責在 DSH 內集成與展示。
- 依賴 DSH 0.2.x 與 README/
engines所列版本範圍；大版本升級 harness 前請對照倉庫 compatibility 說明。 - 社區插件目錄 skillhub.cn 上的條目 與 GitHub 爲公開資料來源，與 DeepSeek / 幻方無官方從屬關係，DSH 生態奉行「一切皆插件」。
結尾¶
@polza-ai/dsh-plugin-polza 把 Polza.ai 的賬號體系、模型目錄和盧布計費嵌進 Harness 的模型選擇、設置與聊天 UI，並覆蓋媒體生成與（可選）GigaAM 語音路徑。需要功能細節與截圖時，以倉庫 README 爲準。
