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

Запустить воркер

Воркер — это плагин DeepSeek Harness, который отдаёт модели, уже установленные на этой машине, по цене, которую вы назначаете. Он запускает Ollama локально; облачного API-ключа и счёта за инференс нет.

Требования​

  • DeepSeek Harness 0.2.2-rc.1 или новее и Node 22+.
  • Ollama хотя бы с одной загруженной моделью (например, ollama pull qwen3:8b).
  • Кошелёк Solana с небольшим количеством SOL для комиссий. Плагин создаёт его сам.

Токена GenKaKu и стейкинга нет. Вы зарабатываете USDC и тратите доли цента SOL на сетевые комиссии и ренту.

Установка​

В DeepSeek Harness откройте Plugins → Add plugin и вставьте:

@genkaku/dsh-worker-plugin

Оставьте источник установки на Default registry (registry.npmjs.org), подтвердите и перезапустите DeepSeek Harness. То же самое из оболочки:

dsh plugin add @genkaku/dsh-worker-plugin@0.5.0-rc.8

Предварительное развёртывание публикует пре-релиз, поэтому команда выше указывает точную версию 0.5.0-rc.8, а не тег: тег не приведёт к этой сборке.

В боковой панели появится пункт GenKaKu worker.

Первый запуск​

Плагин ищет Ollama по адресу http://127.0.0.1:11434 и сам запускает ollama serve, если Ollama установлена, но не работает. Первый раздел панели показывает, работает ли Ollama и сколько моделей она нашла.

Когда доска офферов пуста, плагин публикует каждую локальную модель по цене defaultPricePerHour, которая по умолчанию равна 0. Это сделано намеренно: если владелец машины не назначил цену, плагин не должен назначать её за него.

Назначение цены​

Откройте Models offered в панели и задайте каждой модели цену за час в USDC — целое число с 6 знаками точности (так, 250000 — это 0.25 USDC/hour). Оставьте 0, чтобы отдавать модель бесплатно.

  • Платная модель депонирует USDC в эскроу каждой сессии и рассчитывается по квитанции, которую пользователь хранит, а вы подписываете.
  • Бесплатная модель обслуживается без обращения к блокчейну: ни сессии, ни комиссии, ни транзакции.

Оплата начисляется за начатую минуту сессии, поэтому двухминутная задача оплачивает две минуты по часовой ставке, а не полный час.

Ваша ставка в листинге в блокчейне — это самая дорогая публикуемая модель, в пересчёте на минуту. Это потолок: каждая сессия с вами должна быть оценена не выше. Если клиент называет цену ниже собственной цены модели, ваш сайдкар отклоняет сессию ещё до генерации токена, так что никто не прокатится на дорогой модели дёшево.

Имя, видимость и сопряжение​

Раздел Name & access в панели содержит три вещи:

  • Отображаемое имя — личное имя, ID или никнейм. Пользователи видят его рядом с вашими моделями, могут искать по нему и сортировать список по нему. Оно не записывается в блокчейн: там только ваш кошелёк, peer ID и локатор.
  • Публичный / приватный — публичный по умолчанию: воркер входит в каталог и в seed, и любой может к нему подключиться. Приватный убирает его из обоих. Строка в блокчейне остаётся, потому что расчёт платит на этот счёт, но в строке нет адреса, так что постороннему некуда подключаться.
  • Коды сопряжения — единственный вход к приватному воркеру. Нажмите Generate pairing code и отправьте строку genkaku1.… тому, кому хотите разрешить доступ. Код одноразовый, истекает через 15 минут и хранится только как хеш: утечка файла не выдаст рабочий код.

Сопряжение привязывает кошелёк того, кто погасил код, а не саму строку. Ключ кошелька пользователя — это и его идентичность libp2p, поэтому каждое следующее соединение аутентифицируется самим рукопожатием транспорта: токен в запросе не передаётся, а украденный код бесполезен с другой машины. Paired wallets показывает, кому разрешено; unpair убирает кошелёк сразу, и следующее соединение отклоняется.

Приватный не значит бесплатный: задайте цену как обычно, 0 по-прежнему значит «бесплатно». Приватный воркер получает оплату через тот же эскроу, что и публичный.

Переключение видимости перезапускает воркерскую половину: запись в каталоге и объявление в seed определяются при старте.

Публикация в блокчейне (необязательно)​

Этот раздел относится к публичным воркерам; приватный никогда не публикуется.

Переключатель Directory записывает ваш peer ID, ставку и локатор в программу, чтобы пользователи могли вас найти, не зная адрес заранее.

Он выключен по умолчанию и включается, только если у машины есть глобально доступный адрес. Запись в каталоге, адрес которой никто не может набрать, хуже, чем отсутствие записи. Публикация стоит одной транзакции, а локатор после попадания в блокчейн постоянен: имя хоста или IP, записанные там, нельзя отозвать, только заменить.

Пиры в одной локальной сети могут подключаться без записи в каталоге, вручную указав multiaddr в плагине пользователя.

При включённом расчёте плагин записывает аккаунт Worker даже тогда, когда публикация выключена: инструкция расчёта платит этому аккаунту, поэтому он должен существовать. Такая строка не несёт адреса и невидима для обнаружения — именно это и нужно воркеру, работающему только в локальной сети.

Кошелёк и выплаты​

Раздел Wallet показывает:

  • адрес воркера,
  • балансы SOL (комиссии) и USDC (заработок),
  • unclaimed in escrow — рассчитанный доход, который уже ваш, но пока лежит в эскроу сессии,
  • кнопку Claim, которая переносит этот баланс в кошелёк.

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

Вывод средств — это транзакция, поэтому кошельку нужно немного SOL. USDC — это то, что воркер зарабатывает, а не то, что он тратит.

Приватный ключ хранится в открытом виде с правами 0600 в ~/.dsh/genkaku/genkaku.keys.json. Это и кошелёк, И идентичность libp2p: сделайте резервную копию перед переносом машины на новый диск и считайте любого, кто может прочитать этот файл, владельцем кошелька. Ротация ключа меняет и ваш peer id.

Уровни моделей​

Маркетплейс помечает каждую модель по возможностям, которые сообщает Ollama, и числу параметров:

УровеньЗначение
agentЕсть tools и не менее 9B параметров — подходит для цикла агента
lightЕсть tools, но модель маленькая или её размер неизвестен — вызовы инструментов могут быть ненадёжными
chatНет возможности tools — не подходит для агентов

Уровень — это метка, а не фильтр. Ничто не мешает вам опубликовать модель chat; пользователь просто увидит, что она не может управлять агентом.

Thinking-модели по умолчанию работают с think: false, чтобы один запрос не тратил свой бюджет на скрытые рассуждения. Задайте GENKAKU_OLLAMA_THINK=1 перед запуском DeepSeek Harness, чтобы сохранить поведение Ollama по умолчанию.

Порты и сеть​

  • libp2p по умолчанию слушает /ip4/0.0.0.0/tcp/4001 и /ip6/::/tcp/4002. Откройте настроенные TCP-порты, если хотите прямые соединения.
  • Локальный сервер статуса занимает первый свободный порт в диапазоне 47821–47826. Двум профилям DSH на одной машине нужны собственные порты; если вы бесконечно видите «Loading worker status…», вероятно, диапазон занят другим профилем.
  • В Windows разрешите Node в брандмауэре при первом запуске воркера.

Устранение неполадок​

Ollama не обнаружена. Запустите ollama serve один раз или нажмите Start Ollama в панели. Если Ollama находится в другом месте, измените ollamaHost в настройках плагина.

Переключатель Directory неактивен. У машины нет глобально доступного адреса. Пиры в одной локальной сети всё ещё могут подключиться по multiaddr; иначе сессии придётся идти через seed-релей.

Сессия обслужена, но баланс не изменился. Расчёт зачисляет средства сессии, а не кошелька, и выплата ждёт десять минут. Нажмите Claim; после этого сумма появится как баланс USDC кошелька.

Claim сообщает, что забирать нечего. Либо с последнего расчёта не прошло десяти минут, либо сессия ещё открыта (пользователь её не закрыл). И то и другое разрешается само; кнопка в панели заново читает блокчейн.

Ничего нет на npm? Проверьте, что вы на registry.npmjs.org, а не на зеркале, которое ещё не синхронизировалось.