Баланс Arckép прямо в DeepSeek Harness: плагин за пять минут

Агент в сессии работает, а вы открываете соседнюю вкладку, чтобы проверить, сколько осталось на счёте. Потом ещё раз. И ещё. Мы устали от этих переключений и сделали плагин: баланс Arckép теперь висит прямо в окне DeepSeek Harness.

DeepSeek Harness, или DSH, это открытая среда от DeepSeek: вы работаете с ИИ-агентом в сессиях, а почти всё остальное в ней устроено как плагины. Пока это превью для разработчиков, и интерфейсы плагинов ещё меняются.

Наш плагин неофициальный: DeepSeek к нему отношения не имеет. Он подключается к Arckép, нашему сервису с API для чата, картинок, видео, озвучки и 3D, и показывает данные вашего аккаунта. Исходники открыты, лицензия MIT.

Что вы увидите

Значок с суммой, например «1 234,50 ₽», живёт в двух местах: внизу боковой панели, над кнопкой Settings, и в шапке открытой сессии. Боковой виден всегда, даже на пустом стартовом экране, а шапочный появляется, когда вы откроете сессию. Он меняет цвет, когда баланс ниже порога (по умолчанию 100 ₽) или когда денег по прогнозу хватит меньше чем на три дня.

Клик по значку открывает панель: баланс, расход за сегодня, за 7 и за 30 дней, пять самых дорогих моделей и прогноз «хватит примерно на столько-то дней». Данные обновляются раз в пять минут. Интервал можно поменять, но чаще раза в минуту плагин не спрашивает.

Значок с балансом и панель расхода в DeepSeek Harness. Цифры на снимке демонстрационные.

Если DSH сворачивает боковую панель в узкую рейку, в ней остаётся одна иконка рубля, а сумма появляется в подсказке. Боковой значок можно выключить в настройках плагина, шапочный от этого не пропадёт.

Если Arckép не отвечает, на экране остаются последние цифры с пометкой «данные устарели».

Что понадобится

• аккаунт Arckép и API-ключ;
• DSH 0.2.0-rc.2 или новее с веб-интерфейсом, то есть запуск командой dsh web.

Плагин мы проверяли на DSH 0.2.0-rc.2 и 0.2.1-alpha.2. Раз DSH ещё в превью, на новых версиях что-то может сломаться, а список проверенных версий лежит в README плагина.

1. Создайте ключ только для баланса

На arckep.ru откройте Настройки → API и создайте ключ. Плагину нужно одно право: «баланс» (balance:read). У новых ключей оно есть по умолчанию, но мы советуем завести отдельный ключ и дать ему только это право.

Причина простая. DSH хранит ключи в файле на вашем компьютере, а программы, которые запускает агент, работают от того же пользователя и могут этот файл прочитать. Ключ, которым нельзя ничего потратить, надёжнее ключа от всего.

2. Поставьте плагин

В терминале:

dsh plugin --profile web add github:gmen1057/dsh-arckep
dsh web

Здесь web — имя профиля, подставьте свой, если он у вас другой. Чтобы зафиксировать версию, добавьте метку: github:gmen1057/dsh-arckep#v0.1.1. Сборки и скриптов установки у плагина нет, поэтому ничего дополнительно разрешать не нужно. Проверить, что плагин подключился, можно командой dsh --profile web --dump-config: в ответе будет блок # == dsh-arckep.

Пользуетесь настольным приложением DSH? Запустите его один раз, закройте полностью, выполните ту же команду с профилем desktop и откройте приложение снова. В настольной версии автор плагина его пока не проверял.

3. Вставьте ключ

В DSH откройте Settings → Arckep, вставьте ключ и нажмите Save. Поле очистится, а под ним появится «Key is set». Если удобнее, задайте ключ переменной окружения ARCKEP_API_KEY до запуска DSH.

Раздел Arckep в настройках DeepSeek Harness: ключ задан, поле ввода пустое. Данные на снимке демонстрационные.

Интерфейс плагина по умолчанию английский: сам DSH знает только английский и китайский. Русский включается в том же разделе, в поле Interface language.

Значок с балансом появится внизу боковой панели сразу, а в шапке сессии: когда вы её откроете.

Что плагин считает, а что нет

Расход берётся из того, что сделано по API-ключам: чат, «Решения», расшифровка речи, картинки, видео и 3D. Озвучка (/audio/speech) и пакетный чат в него не попадают, как и всё, что вы делаете на сайте в студии или в чате на chat.arckep.ru.

Поэтому баланс может падать быстрее, чем показывает расход. Баланс плагин берёт напрямую у Arckép, он общий для сайта и API. А расход считается только по тому, что прошло через ключи, и прогноз «на сколько хватит» строится по среднему за последние семь дней.

Безопасность

• Запросы к Arckép делает сервер DSH, а не браузер, и только на https://arckep.ru. Редиректы плагин не выполняет.
• Ни телеметрии, ни запросов к сторонним сайтам в нём нет.
• Ключ не показывается в браузере и не попадает в журналы. Он живёт в хранилище ключей DSH.

Если установка не удалась

Два случая мы уже видели у себя.

DSH пишет «git-hosted plugins build on install via their prepare script». Эта подсказка появляется при любой неудачной установке с адресом github:. У нашего плагина скриптов установки нет, так что разрешать сборку не нужно. Ищите настоящую ошибку выше подсказки.

Установка падает из-за minimumReleaseAge и в сообщении названы другие плагины. Менеджер пакетов pnpm 11 не берёт пакеты, вышедшие меньше суток назад, и проверяет все пакеты профиля, а не только новый. Подождите и повторите.

А если нужен баланс самого DeepSeek?

Наш плагин показывает баланс Arckép. Баланс аккаунта DeepSeek показывают плагины других авторов, например dsh-cost-meter: он считает расход за сессию и умеет показывать официальный баланс.

Где исходники

Код и описание лежат на GitHub: gmen1057/dsh-arckep. Нашли ошибку или хотите другую настройку, напишите в issues. А если у вас ещё нет аккаунта Arckép, он ждёт на arckep.ru.