Использовать модели сети
Плагин пользователя добавляет сеть GenKaKu как провайдера моделей внутри DeepSeek Harness. В сессии агента вы выбираете модель пира так же, как локальную. Ни аккаунта, ни почты, ни API-ключа.
Требования
- DeepSeek Harness
0.2.2-rc.1или новее и Node 22+. - Кошелёк Solana. Плагин создаёт его сам, или вы можете импортировать существующий.
- Немного SOL для сетевых комиссий и USDC для оплаты вычислений.
- USDC: SPL USDC от Circle в mainnet, тестовый токен в devnet.
Установка
В DeepSeek Harness откройте Plugins → Add plugin и вставьте:
@genkaku/dsh-user-plugin
Оставьте источник установки на Default registry (registry.npmjs.org), подтвердите и
перезапустите DeepSeek Harness. Из оболочки:
dsh plugin add @genkaku/dsh-user-plugin@0.5.0-rc.8
Предварительное развёртывание публикует пре-релиз, поэтому команда выше указывает точную версию 0.5.0-rc.8, а не тег: тег не приведёт к этой сборке.
Плагины воркера и пользователя могут жить на одной машине. У каждого свой кошелёк и свои настройки.
Кошелёк
Раздел кошелька в панели создаёт пару ключей ed25519 при первом использовании или импортирует
существующую: в base58 (формат, который показывают Phantom и solana-keygen) либо как JSON-массив
байтов, который solana-keygen пишет в файл. Он показывает:
- адрес,
- SOL (комиссии),
- USDC (доступный баланс).
Приватный ключ хранится в открытом виде с правами 0600 в ~/.dsh/genkaku/genkaku.keys.json. Мы
никогда его не держим и не можем восстановить.
В devnet панель может выпустить тестовые USDC, которые не имеют стоимости. В mainnet кнопки выпуска нет: USDC покупают там, где вы обычно это делаете.
Поиск воркера
Панель показывает, что предлагает сеть:
- Models on the network — каждая строка это воркер + модель, с отображаемым именем воркера, ценой за час, уровнем и измеренной задержкой.
- Workers discovered — пиры, найденные через каталог в блокчейне и seed-релей. Счётчик показывает то, что обнаружение видит прямо сейчас, а не общее число в сети.
В списке есть поиск (модель, имя воркера или кошелёк) и меню сортировки: рекомендуемые, низкая цена, низкая задержка, больше всего сессий, имя модели, имя воркера. Порядок общий с выбором модели в чате, поэтому первые десять строк — это те десять, что предлагает новая установка.
Отметка модели и помещает её в выбор модели чата. Единица — воркер и модель, поэтому одна
и та же модель у двух воркеров это две отмечаемые строки, и отметить можно не более десяти.
Отметка указывает на конкретного воркера: именно поэтому выбор показывает worker · модель.
Если воркер пропал, мост скрывает его отметку и возвращает её, когда воркер вернётся.
Метка уровня (agent / light / chat) происходит из возможностей Ollama на стороне воркера.
Только модели agent предназначены для цикла агента с вызовом инструментов; модели chat помечены
как не подходящие для агентов, но ничто не мешает использовать их для обычного чата.
Если вы знаете multiaddr воркера, добавьте его в Manual workers; это работает в одной локальной сети и не требует записи в каталоге.
Приватные воркеры
Приватный воркер намеренно отсутствует в каталоге и в seed. Его владелец присылает вам
одноразовый код сопряжения (genkaku1.…). Вставьте его в Private workers и нажмите
Pair: код гасится один раз и привязывается к вашему кошельку, после чего им не может
воспользоваться никто другой. Строка показывает, в сети ли этот воркер (зелёный), не в сети или
ещё проверяется.
Сопряжённые воркеры — обычные строки списка: те же отметки, та же цена, та же сессия. Forget убирает его локально; списком разрешённых кошельков на стороне воркера управляет владелец.
Запуск сессии
В сессии DeepSeek Harness откройте выбор модели и выберите модель GenKaKu. Плагин:
- подключается к воркеру напрямую или через seed-релей, если прямое соединение невозможно,
- для платной модели депонирует десять минут USDC в эскроу сессии до первого токена,
- передаёт токены по мере их генерации Ollama,
- рассчитывается по завершении сессии и закрывает её, возвращая то, что не покрыл депозит.
Бесплатные модели (цена 0) полностью пропускают шаги 2 и 4: ни сессии, ни комиссии, ни
транзакции.
Сколько стоит сессия
| Статья | Кто платит |
|---|---|
| Инференс | Вы, в USDC, за каждую начатую минуту |
| Сетевая комиссия за открытие | Вы, долю цента в SOL |
| Сетевая комиссия за расчёт | Воркер |
| Комиссия платформы | 1% от расчёта, в казну |
Поэтому платная сессия стоит двух транзакций в блокчейне, по одной с каждой стороны. Если сессия завершилась до того, как набежала хотя бы одна оплачиваемая начатая минута, весь депозит возвращается.
Оплата идёт за начатую минуту: остановка через десять секунд всё равно оплачивает одну минуту по цене воркера за час, делённой на 60.
Лимиты расходов
Кошелёк — это платёжный интерфейс, а не хранилище: агент должен иметь возможность провести сессию, не спрашивая разрешения каждый раз. Но тратить без потолка он не должен. Карточка Budget в панели и есть этот потолок, и устроена она так же, как лимиты, знакомые вам по ключам API.
| Поле | Что делает | По умолчанию |
|---|---|---|
| Name (имя) | Метка, которая появляется в отказе | everyday |
| Credit limit | Максимум USDC, который этот ключ может потратить за период | 10 |
| Reset | never, daily (полночь UTC), weekly (понедельник), monthly (1-е число) | never |
| Expires | Фиксированная дата; после неё платные сессии прекращаются | выключено |
| Enabled | Выключатель платных сессий | включено |
| Per session | Максимум USDC, который одна сессия может предоплатить | 2 |
| Max price per hour | Модели дороже этой цены не попадают в выбор | выключено |
Изменения сохраняются, когда вы уходите из поля, — кнопки «Сохранить», которую можно забыть нажать, нет. Пустая сумма означает без лимита для этого поля, а не ноль.
Карточка также показывает потраченное: всего, сегодня, на этой неделе и в этом
месяце, таблицу по моделям и последние двадцать сессий с подписью транзакции. Четыре окна
считаются по журналу сессий; total — собственный счётчик политики за всё время, поэтому он не
уменьшается, когда старый журнал обрезается.
Как выглядит отказ
Политика проверяется до любой подписи. Платная сессия, которую политика не разрешает,
отклоняется с HTTP 402 и телом JSON, где названа причина:
code | Значение |
|---|---|
budget_exhausted | Лимита периода не хватает на депозит |
session_cap | Одна сессия предоплатила бы больше лимита на сессию |
price_cap | Цена модели выше лимита за час |
policy_disabled | Enabled выключен |
policy_expired | Срок действия истёк |
Отклонённая сессия не оставляет следа в блокчейне — ни депозита, ни комиссии, ни транзакции, — и число подписей кошелька не меняется. Модели дороже ценового лимита отфильтровываются из выбора, чтобы вы не выбрали модель, за которую не можете заплатить.
Бесплатные модели (цена 0) не подпадают под бюджет, а Enabled блокирует только платные сессии:
когда выключатель снят, бесплатные модели продолжают работать.
Где это лежит
Политика — один локальный файл ~/.dsh/genkaku/policy.json с правами 0600, рядом с журналом
расходов spend.jsonl. Это не аккаунт в блокчейне и не то, что видит воркер: это ваше
собственное ПО отказывается собирать транзакцию. Правка файла вручную не может внести
отрицательный лимит, неизвестный период или поддельную резервацию — разбор возвращает
задокументированные значения по умолчанию.
Два правила учёта, которые стоит знать:
- открытие сессии сразу резервирует депозит, поэтому он занимает бюджет, пока сессия идёт; при расчёте фиксируется то, что воркер действительно выставил, а остальное освобождается;
- резервация, оставшаяся открытой дольше 30 минут, считается потраченной. Сбой между открытием и расчётом поэтому может завысить расход, но единственное вредное допущение — что депозит вернулся — никогда не делается.
Delete policy удаляет policy.json и возвращает значения по умолчанию, указанные выше. Кошелёк
и его средства не затрагиваются. Чтобы прекратить расходы, не теряя настройки, используйте
Enabled.
Настройки
- Payments — при включённом расчёте каждая платная сессия открывает настоящий эскроу. Выключите его для бесплатных или отладочных сессий, которые ничего не подписывают в блокчейне; включите обратно, прежде чем работать с реальными воркерами в сети.
- Manual workers — вручную закрепить multiaddr воркера.
- Refresh — заново прочитать каталог в блокчейне и seed. Мост перезапускается по завершении сканирования, а профиль, сменивший кошелёк, тоже требует перезапуска, прежде чем сможет совершать транзакции.
Локальный мост занимает первый свободный порт в диапазоне 47821–47826 и отвечает, только если он представляет половину пользователя; сервер статуса воркера на той же машине за него не примут.
Частые вопросы
Нужно ли доверять GenKaKu Labs?
Доверять нужно программе и коду. Никакой сервер не держит ваши средства или промпты.
Можно ли обойтись без кошелька?
Только для бесплатных моделей с выключенным расчётом. Платные сессии и идентичность — это кошелёк.
Это mainnet?
Да: продакшен рассчитывается в USDC от Circle в Solana mainnet-beta. Панель показывает, в каком
кластере находится сборка. Стейджинговые сборки рассчитываются ничего не стоящим тестовым токеном в
devnet — проверьте, прежде чем вносить средства.
Кто видит мои промпты?
Воркер, который их обслуживает, — всегда. Если сессия идёт через seed-релей, оператор релея видит
метаданные соединения — адреса, время и объём — но не зашифрованное содержимое.
Почему моя модель исчезла из выбора?
Адаптер проверяет порты локального моста и принимает только мост, который сообщает роль user.
Устаревший порт, занятый другим профилем, игнорируется; он вернётся при следующем обновлении.
С меня взяли плату за сессию, которая не удалась.
Расчёт происходит, только когда его подписывает воркер, и оплатить он может лишь те минуты, которые
покрывают квитанции клиента. Если ответ так и не пришёл, клиент закрывает сессию и депозит
возвращается. Сессия, которая выдавала токены две начатые минуты, оплачивает две минуты, даже если
ответ оборвался, — это и значит «начатая минута».