Перейти к основному содержимому

Использовать модели сети

Плагин пользователя добавляет сеть 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. Плагин:

  1. подключается к воркеру напрямую или через seed-релей, если прямое соединение невозможно,
  2. для платной модели депонирует десять минут USDC в эскроу сессии до первого токена,
  3. передаёт токены по мере их генерации Ollama,
  4. рассчитывается по завершении сессии и закрывает её, возвращая то, что не покрыл депозит.

Бесплатные модели (цена 0) полностью пропускают шаги 2 и 4: ни сессии, ни комиссии, ни транзакции.

Сколько стоит сессия​

СтатьяКто платит
ИнференсВы, в USDC, за каждую начатую минуту
Сетевая комиссия за открытиеВы, долю цента в SOL
Сетевая комиссия за расчётВоркер
Комиссия платформы1% от расчёта, в казну

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

Оплата идёт за начатую минуту: остановка через десять секунд всё равно оплачивает одну минуту по цене воркера за час, делённой на 60.

Лимиты расходов​

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

ПолеЧто делаетПо умолчанию
Name (имя)Метка, которая появляется в отказеeveryday
Credit limitМаксимум USDC, который этот ключ может потратить за период10
Resetnever, 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_disabledEnabled выключен
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. Устаревший порт, занятый другим профилем, игнорируется; он вернётся при следующем обновлении.

С меня взяли плату за сессию, которая не удалась.
Расчёт происходит, только когда его подписывает воркер, и оплатить он может лишь те минуты, которые покрывают квитанции клиента. Если ответ так и не пришёл, клиент закрывает сессию и депозит возвращается. Сессия, которая выдавала токены две начатые минуты, оплачивает две минуты, даже если ответ оборвался, — это и значит «начатая минута».