워커 실행
워커는 이 머신에 이미 설치된 모델을 직접 정한 가격으로 공유하는 DeepSeek Harness 플러그인입니다. Ollama를 로컬에서 실행하며, 클라우드 API 키도 사용량 기반 추론 청구서도 없습니다.
요구 사항
- DeepSeek Harness
0.2.2-rc.1이상, Node 22+. - 모델을 하나 이상 내려받은 Ollama(예:
ollama pull qwen3:8b). - 수수료를 낼 약간의 SOL이 있는 Solana 지갑. 플러그인이 하나 만들어 줍니다.
GenKaKu 토큰도 스테이킹도 없습니다. USDC를 벌고, 네트워크 수수료와 렌트에 1센트의 몇 분의 일인 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
프리뷰 배포는 프리릴리스를 게시하므로 위 명령은 dist-tag 대신 정확한 버전 0.5.0-rc.8를 지정합니다. 태그로는 이 빌드가 설치되지 않습니다.
사이드바에 GenKaKu worker 항목이 나타납니다.
첫 실행
플러그인은 http://127.0.0.1:11434에서 Ollama를 찾고, 설치되어 있지만 실행 중이 아니면
ollama serve를 직접 시작합니다. 패널 첫 섹션에는 Ollama가 실행 중인지, 모델을 몇 개
찾았는지 표시됩니다.
오퍼 보드가 비어 있으면 플러그인은 모든 로컬 모델을 defaultPricePerHour로 등록하며,
기본값은 0입니다. 이는 의도된 동작입니다. 가격을 정하지 않은 소유자의 머신에 가격이
붙어서는 안 되기 때문입니다.
가격 설정
패널의 Models offered를 열고 각 모델에 USDC 기준 시간당 가격을 정수로 입력합니다. 소수점
6자리 정밀도를 가지므로 250000은 0.25 USDC/hour입니다. 0으로 두면 해당 모델을 무료로
제공합니다.
- 유료 모델은 세션마다 에스크로에 USDC를 입금하고, 사용자가 보관하고 당신이 서명하는 영수증으로 정산합니다.
- 무료 모델은 체인을 건드리지 않고 제공됩니다. 세션도, 수수료도, 트랜잭션도 없습니다.
과금은 세션의 시작된 분 단위로 누적되므로, 2분 작업은 1시간치가 아니라 시간당 요율로 2분치를 지불합니다.
온체인의 게시 요율은 당신이 공개하는 가장 비싼 모델의 분당 가격입니다. 이는 상한이며, 당신을 상대로 한 모든 세션은 그 이하 또는 같은 가격이어야 합니다. 클라이언트가 모델 자체의 가격보다 낮게 제시하면 사이드카는 토큰을 생성하기 전에 세션을 거부하므로, 비싼 모델을 싼값에 쓰는 일은 없습니다.
이름, 공개 범위, 페어링
패널의 Name & access에는 세 가지가 있습니다.
- 표시 이름 — 개인 이름, ID 또는 닉네임입니다. 사용자는 모델 옆에서 이를 보고, 검색하며, 이 이름으로 정렬할 수 있습니다. 체인에는 기록되지 않습니다. 체인에는 지갑, peer ID, 로케이터만 남습니다.
- 공개 / 비공개 — 기본값은 공개이며, 워커가 디렉터리와 시드에 참여하고 누구나 다이얼할 수 있습니다. 비공개로 바꾸면 둘 다에서 빠집니다. 체인의 행은 남습니다(정산이 그 계정으로 지급하기 때문). 하지만 행에 주소가 없으므로 낯선 사람이 다이얼할 대상이 없습니다.
- 페어링 코드 — 비공개 워커로 들어가는 유일한 방법입니다. Generate pairing code를
누르고
genkaku1.…문자열을 허용할 사람에게 보내세요. 코드는 한 번만 쓸 수 있고 15분 뒤 만료되며, 저장되는 것은 해시뿐입니다. 파일이 유출되어도 쓸 수 있는 코드는 새지 않습니다.
페어링이 묶는 것은 문자열이 아니라 교환한 사람의 지갑입니다. 사용자의 지갑 키는 곧 libp2p 신원이므로 이후의 모든 연결은 전송 계층 핸드셰이크가 인증합니다. 요청에 토큰이 실리지 않고, 훔친 코드를 다른 기계에서 써도 소용없습니다. Paired wallets에 허용된 대상이 나오고, unpair로 즉시 제거하면 다음 연결은 거부됩니다.
비공개가 곧 무료는 아닙니다. 평소처럼 가격을 정하고 0은 여전히 무료입니다. 비공개
워커도 공개 워커와 같은 에스크로로 지급받습니다.
공개 범위를 바꾸면 워커 쪽이 재시작됩니다. 디렉터리 항목과 시드 공지는 시작할 때 정해지기 때문입니다.
온체인 게시(선택)
이 절은 공개 워커에 해당합니다. 비공개 워커는 절대 게시되지 않습니다.
Directory 스위치는 peer ID, 요율, 로케이터를 프로그램에 기록하여, 사용자가 주소를 미리 알지 못해도 워커를 찾을 수 있게 합니다.
기본값은 꺼짐이며, 이 머신에 전 세계에서 다이얼 가능한 주소가 있을 때만 켜집니다. 아무도 다이얼할 수 없는 주소의 목록은 목록이 없는 것보다 나쁩니다. 게시에는 트랜잭션 하나가 들고, 로케이터는 체인에 올라가면 영구적입니다. 거기에 기록된 호스트명이나 IP는 철회할 수 없고 교체만 할 수 있습니다.
같은 LAN의 피어는 사용자 플러그인에서 multiaddr을 직접 지정하면 디렉터리 항목 없이도 연결할 수 있습니다.
정산이 켜져 있으면 게시가 꺼져 있어도 플러그인은 Worker 계정을 기록합니다. 정산 명령이 그 계정에 지급하기 때문에 계정이 존재해야 하기 때문입니다. 그런 행은 주소를 갖지 않고 발견에 보이지 않으며, LAN 전용 워커가 바로 원하는 모습입니다.
지갑과 인출
Wallet 섹션에는 다음이 표시됩니다.
- 워커 주소,
- SOL(수수료)와 USDC(수익) 잔액,
- 에스크로에 미인출된 금액 — 이미 당신 것이지만 아직 세션 에스크로 안에 있는 정산 수익,
- 그 잔액을 지갑으로 옮기는 Claim 버튼.
각 세션은 따로 지급됩니다. 정산은 세션에 적립되고, 마지막 정산 후 10분이 지나면 당신을 포함한 누구나 그것을 청구할 수 있습니다. 이 지연은 사용자가 아직 세션을 닫을 수 있는 창이므로, 그들이 막 취소하려던 1분에 대해 지불받는 일은 없습니다. 패널 버튼은 대기열 전체를 처리합니다.
청구도 트랜잭션이므로 지갑에 SOL이 조금 필요합니다. USDC는 워커가 버는 것이지 쓰는 것이 아닙니다.
개인 키는 ~/.dsh/genkaku/genkaku.keys.json에 모드 0600으로 평문 저장됩니다. 이는 지갑이자
libp2p 신원입니다. 머신을 새 디스크로 옮기기 전에 백업하고, 이 파일을 읽을 수 있는 사람은
누구든 지갑의 소유자로 취급하세요. 키를 교체하면 peer id도 바뀝니다.
모델 등급
마켓플레이스는 Ollama가 보고한 기능과 파라미터 수를 바탕으로 각 모델에 라벨을 붙입니다.
| 등급 | 의미 |
|---|---|
agent | tools가 있고 파라미터가 9B 이상 — 에이전트 루프에 적합 |
light | tools가 있지만 작거나 크기를 알 수 없음 — 도구 호출이 불안정할 수 있음 |
chat | tools 기능 없음 — 에이전트에 부적합 |
등급은 라벨일 뿐 필터가 아닙니다. chat 모델을 목록에 올리는 것을 막는 것은 없으며,
사용자는 그 모델이 에이전트를 구동할 수 없다는 것만 보게 됩니다.
사고 모델은 기본적으로 think: false로 실행되어, 단일 요청이 숨은 추론에 예산을 쓰지 않게
합니다. Ollama의 기본 동작을 유지하려면 DeepSeek Harness를 시작하기 전에
GENKAKU_OLLAMA_THINK=1을 설정하세요.
포트와 네트워킹
- 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 스위치가 회색으로 표시됩니다. 이 머신에 전 세계에서 다이얼 가능한 주소가 없습니다. 같은 LAN의 피어는 여전히 multiaddr로 연결할 수 있고, 그렇지 않으면 세션은 시드 릴레이를 거쳐야 합니다.
세션이 제공되었는데 잔액이 움직이지 않았습니다. 정산은 지갑이 아니라 세션에 적립되며, 지급은 10분을 기다립니다. Claim을 누르면 그 금액이 지갑의 USDC 잔액으로 나타납니다.
Claim이 청구할 것이 없다고 합니다. 마지막 정산 후 10분이 지나지 않았거나, 세션이 아직 열려 있습니다(사용자가 닫지 않음). 둘 다 스스로 해결됩니다. 패널 버튼은 체인을 다시 읽습니다.
npm에 패키지가 보이지 않나요? registry.npmjs.org에 있는지, 아직 동기화되지 않은 미러에
있지 않은지 확인하세요.