前言¶
在 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 为准。
