Русский | English
Строка баланса для DSH
Полоса внизу веб-интерфейса DeepSeek Harness с двумя живыми показателями:
- Баланс — суммарный доступный остаток аккаунта DeepSeek: пополненные кошельки плюс начисленные бонусы, отдельно по каждой валюте.
- Сессия — израсходованные токены открытой сейчас сессии (запрос, чтение из кеша, запись в кеш, ответ), свёрнутые из её журнала. Если заданы цены, рядом добавляется оценка стоимости.
Ничего не записывается: каждое значение вычисляется по запросу. У плагина нет зависимостей и нет шага сборки.
Установка
Нужен DeepSeek Harness с веб-интерфейсом. Пакет — обычный JavaScript, поэтому подойдёт любой DSH Desktop на Windows, macOS или Linux.
- Скопируй эту папку куда угодно на целевой машине.
- Открой Plugins → Add plugin, вставь абсолютный путь к папке и установи. Bundle выбирается сам, полоса появляется внизу окна; перезапуск не нужен.
Тот же диалог принимает тарболл из npm pack (по пути) или адрес git-репозитория.
Для профиля, которым не управляет десктопное приложение (web, tui, headless):
dsh plugin --profile <профиль> add /путь/к/dsh-balance-strip
Профиль desktop принадлежит приложению Electron, поэтому dsh plugin его
отказывается обслуживать — там только страница Plugins.
Состояние уровня профиля — переключатель включения и любые переопределения
цен — живёт в cordis.patch.yml профиля, а не в этом пакете, поэтому на новой
машине всё начинается со значений по умолчанию (см. ниже).
Где отображается
Клиентская половина занимает слот shell.bottom — полосу во всю ширину под
тремя колонками. Высоту (26 px) задаёт сам occupant, колонки ужимаются ровно на
неё. Полоса остаётся смонтированной при переключении панелей и не зависит от
того, открыта ли правая панель.
Как идут данные
Браузерная половина не имеет доступа к креденшелу платформы, поэтому все чтения делает хост и отдаёт их одним same-origin маршрутом:
GET /_dsh/balance-strip/status?session=<id>&locale=<lang>&tz=<seconds>&version=<build>
| Поле | Значение |
|---|---|
balance.status |
ready, signed-out, failed или unavailable (нет сервиса аккаунта) |
balance.wallets |
по каждой валюте: toppedUp, bonus, total |
usage.status |
ready, none (сессии на экране нет), unavailable или failed |
usage.*Tokens |
счётчики токенов по всем ответам модели в сессии |
usage.cost |
оценка стоимости, только если задана цена |
refreshMs |
интервал опроса из refreshSeconds |
probe |
последние запросы, которые ответил маршрут (status, fetchSite, origin) — для диагностики пустой полосы |
Компактная цифра рядом с Сессией — это свежие токены запроса плюс ответ. Переиспользование кеша считается и показывается отдельно, в подсказке, потому что провайдер тарифицирует четыре класса токенов по-разному.
Маршрут принимает запрос, не несущий признаков другого origin: страница шлёт
Sec-Fetch-Site: same-origin и не шлёт Origin, а десктопная сборка несёт тот
же fetch через IPC-мост, который не шлёт ни того ни другого. Страница с
другого origin себя объявляет и получает 403; CORS-заголовков в ответе тоже
нет, так что прочитать его она бы не смогла.
Баланс берётся из доступного только хосту deepseekAccount.getBalance() и
переиспользуется 60 секунд; зависшее чтение платформы через 8 секунд становится
полем failed, а не держит маршрут. Расход сессии сворачивается инкрементально,
с привязкой к числу событий, и кешируется по сессии — хранятся 64 последние.
Настройка
Все значения живут в строке самого bundle в cordis.patch.yml:
- insert:
- id: balance-strip
name: '@local/dsh-balance-strip'
config:
refreshSeconds: 20 # зажимается в 5…600
pricing:
currency: CNY
inputPerMillion: 0
cacheReadPerMillion: 0
cacheWritePerMillion: 0
outputPerMillion: 0
refreshSeconds задаёт и окно переиспользования холодного чтения на хосте, и
интервал опроса в браузере. Деньги появляются только когда хотя бы одна цена
больше нуля; это оценка по этим ценам, а не данные биллинга.
Чтение из кеша, запись в кеш, токены запроса и ответа у провайдера не
пересекаются, поэтому оценка считается как
(input × input + cacheRead × cacheRead + cacheWrite × cacheWrite + output × output) / 1e6.
Провайдер, который включает чтение из кеша в счётчик запроса, будет здесь
переоценён.
Переопределение в cordis.patch.yml профиля имеет приоритет и применяется без
перезапуска:
- id: balance-strip
name: "@local/dsh-balance-strip"
config:
refreshSeconds: 20
pricing:
currency: CNY
inputPerMillion: 1
cacheReadPerMillion: 0.1
cacheWritePerMillion: 0
outputPerMillion: 2
Замечания и ограничения
- Без входа в аккаунт полоса показывает подсказку «войдите»; при модели на API-ключе баланса платформы просто нет.
- Сессия, которая не живёт в памяти, читается через
sessionQuery.readSession()— один раз за интервал обновления. pricingвлияет только на оценку сессии; баланс всегда в валюте самого аккаунта.- Имя пакета
@local/dsh-balance-strip— это install-имя bundle; имя каталога репозитория ему не обязано совпадать. - Проверено на DSH
0.2.1-rc.2. Плагин используетshell.bottom,ctx.sidebarRight.mounted,webServer.register,deepseekAccount.getBalance,sessions.getиsessionQuery.readSession; если в другой версии Harness что-то из этого переехало, соответствующий вызов нужно поправить.
Лицензия
MIT — см. LICENSE.
No comments yet. Be the first to write one.