Баланс и расходы (₽) для DeepSeek Harness
Неофициальный русский форк плагина
@pipilu123566/dsh-balance:
балансы провайдеров и расходы за день в боковой панели DeepSeek Harness, с пересчётом
всех сумм в рубли по курсу ЦБ РФ и русским интерфейсом.
Скриншоты
Обзор: баланс и расходы за сегодня с пересчётом в рубли
Обзор панели: доступный баланс и расходы за сегодня. Строки ≈ … ₽ — приблизительный
пересчёт по курсу ЦБ; суммы и время обновления на скриншоте скрыты.
Цены моделей
«Цены моделей»: свои цены за миллион токенов для пары «поставщик/модель», с валютой
CNY или USD.
Скриншоты сделаны в рабочей установке DeepSeek Harness; суммы и время
обновления скрыты, остальные данные не персональные.
Возможности
- Балансы провайдеров: аккаунт DeepSeek, официальный DeepSeek API, OpenRouter,
SiliconFlow и другие провайдеры с документированным endpoint баланса. Несколько
моделей одного провайдера делят одну строку баланса.
- Рубли: рядом с каждой суммой — приблизительный пересчёт
≈ 295 ₽ по курсу ЦБ РФ
(USD и CNY). Это только отображение: суммы не конвертируются в данные и не
складываются между валютами.
- Расходы за сегодня: сумма, разбивка по моделям и по сессиям, расход за каждый ход
в чате. Оценка строится по записанному расходу токенов и ценам моделей.
- Цены моделей: свои цены за вход, выход, чтение и создание кэша для пары
«поставщик/модель»; сохранение пересчитывает исторические оценки.
- Честные статусы: нет ключа, нет прав на баланс, лимит запросов, неизвестная цена,
неотправленный расход — показываются явно, а не как нулевой баланс.
- Русский интерфейс встроен: плагин добавляет язык «Русский» и свой словарь,
отдельный языковой пакет не нужен.
Требования
- DeepSeek Harness 0.2.2-rc.1 (Desktop); версия проверяется полем
engines.dsh.
- Windows, macOS или Linux — плагин клиентский, работает в Web UI Harness.
- Интернет для курса ЦБ (кэш 6 часов). Без сети суммы показываются как обычно, без ₽.
Установка
-
Полностью закройте DeepSeek Harness (не просто сверните окно).
-
Скачайте dsh-balance-ru-1.2.1.tgz.
-
Если раньше стоял оригинальный @pipilu123566/dsh-balance, удалите его — в профиле
должен остаться только один плагин баланса:
dsh plugin --profile desktop remove @pipilu123566/dsh-balance
-
Установите архив:
dsh plugin --profile desktop add ./dsh-balance-ru-1.2.1.tgz --ignore-scripts
Если dsh не в PATH (macOS):
'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' \
plugin --profile desktop add ./dsh-balance-ru-1.2.1.tgz --ignore-scripts
Windows: "%LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
plugin --profile desktop add .\dsh-balance-ru-1.2.1.tgz --ignore-scripts.
-
Откройте Harness: внизу боковой панели появится кнопка «Баланс». Наведите курсор
или нажмите, чтобы закрепить панель; Esc закрывает.
Для разработки плагин можно поставить из папки (ссылка на checkout вместо копии):
dsh plugin --profile desktop add "/полный/путь/к/dsh-balance-ru" --ignore-scripts
Русский язык
Плагин сам добавляет язык «Русский» (fallback en) и свой словарь на 86 строк.
Переключение: Настройки → Общие → Язык → Русский. Переводится интерфейс этого
плагина; остальной Harness останется на английском, если языковой пакет не установлен.
Недостающие ключи всегда берутся из английского словаря, поэтому интерфейс не ломается.
Как считается рубль
- Источник:
cbr-xml-daily.ru — дневные курсы ЦБ РФ,
CORS разрешён. Резервный источник: https://open.er-api.com/v6/latest/USD.
- Запрос выполняет браузер; кэш — 6 часов. Балансы и расходы по-прежнему приходят только
от штатных сервисов Harness, курс к ним не применяется.
- Значение приблизительное (
≈): до копеек при сумме меньше 100 ₽, до рублей — от 100 ₽.
Подсказка при наведении на ₽ показывает дату курса.
Отличия от @pipilu123566/dsh-balance@1.1.0
| Апстрим 1.1.0 | Этот форк 1.2.1 |
|---|
| Рубли по курсу ЦБ | — | ✅ панель, расходы, модели, сессии, ход |
| Русский словарь | — | ✅ 86 строк, встроен |
Язык ru | — | ✅ регистрируется плагином |
| Поставка | @pipilu123566/dsh-balance | dsh-balance-ru |
| Id слотов | pipilu-balance | dsh-balance-ru, dsh-balance-ru-turn |
| Метаданные RU/EN/ZH | en, zh | ✅ ru, en, zh |
| Тесты | 29 | ✅ 30, включая rub.test.js |
Внутренние имена апстрима сохранены: сервис pipiluBalance, проекция
pipiluTokenUsage, namespace словаря pipilu.balance. Логика балансов, расхода и цен
(index.js, balances.js, usage.js, pricing.js) не изменялась.
Разработка и тесты
npm install
npm test # 30 тестов: балансы, usage, цены, клиент, RUB
npm pack # dsh-balance-ru-1.2.1.tgz
CI (.github/workflows/ci.yml) запускает npm test на Node 22 при каждом push.
Структура:
index.js хост-сервис: балансы, расход, цены (Remote API)
balances.js запросы балансов провайдеров и разбор ответов
usage.js подсчёт расхода токенов и цен
pricing.js валидация цен
client.js клиентская половина: панель, RU-словарь, пересчёт в ₽
cordis.patch.yml вставка плагина в профиль
locale/{ru,en,zh}.json карточка плагина для страницы «Плагины»
rub.test.js тесты словаря и рублёвого пересчёта
Лицензия и авторство
MIT. Оригинал — @pipilu123566/dsh-balance
(pipilu123566), см. LICENSE и NOTICE.md.
Это неофициальный форк, не связанный с DeepSeek и с автором апстрима. Иконка унаследована
от оригинального пакета (MIT).
