본문으로 건너뛰기

네트워크 모델 사용

사용자 플러그인은 DeepSeek Harness 안에 GenKaKu 네트워크를 모델 제공자로 추가합니다. 에이전트 세션에서 로컬 모델을 고르는 것과 같은 방식으로 피어의 모델을 고릅니다. 계정도, 이메일도, API 키도 없습니다.

요구 사항​

  • DeepSeek Harness 0.2.2-rc.1 이상, Node 22+.
  • Solana 지갑. 플러그인이 하나 만들어 주거나, 기존 지갑을 가져올 수 있습니다.
  • 네트워크 수수료를 낼 약간의 SOL과 컴퓨트 비용을 낼 USDC.
  • USDC: mainnet에서는 Circle의 SPL USDC, 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

프리뷰 배포는 프리릴리스를 게시하므로 위 명령은 dist-tag 대신 정확한 버전 0.5.0-rc.8를 지정합니다. 태그로는 이 빌드가 설치되지 않습니다.

워커 플러그인과 사용자 플러그인은 같은 머신에 둘 수 있습니다. 각자 자신의 지갑과 설정을 유지합니다.

지갑​

패널의 지갑 섹션은 처음 사용할 때 ed25519 키 쌍을 생성하거나, 기존 키를 가져옵니다. base58 형식(Phantom과 solana-keygen이 보여 주는 형식) 또는 solana-keygen이 파일에 쓰는 JSON 바이트 배열 모두 가능합니다. 다음을 표시합니다.

  • 주소,
  • SOL(수수료),
  • USDC(사용 가능 잔액).

개인 키는 ~/.dsh/genkaku/genkaku.keys.json에 모드 0600으로 평문 저장됩니다. 우리는 키를 보관하지 않으며 복구할 수도 없습니다.

devnet에서는 패널에서 가치 없는 테스트 USDC를 발행할 수 있습니다. mainnet에는 발행 버튼이 없습니다. USDC는 평소 사는 곳에서 사면 됩니다.

워커 찾기​

패널은 네트워크가 제공하는 것을 나열합니다.

  • Models on the network — 각 행은 워커 + 모델이며, 워커의 표시 이름, 시간당 견적, 등급, 측정된 지연이 표시됩니다.
  • Workers discovered — 온체인 디렉터리와 시드 릴레이를 통해 찾은 피어. 이 수는 발견이 지금 볼 수 있는 것이며 전 세계 총계가 아닙니다.

목록에는 검색 상자(모델, 워커 이름, 지갑)와 정렬 메뉴가 있습니다. 추천, 최저 가격, 최저 지연, 가장 많은 세션 제공, 모델 이름, 워커 이름 순입니다. 정렬은 채팅 모델 선택기와 공유되므로, 처음 10행이 새로 설치했을 때 제공되는 10개입니다.

모델을 체크해야 채팅 모델 선택기에 나타납니다. 단위는 워커 와 모델이므로, 두 워커가 같은 모델을 내놓으면 체크할 수 있는 행이 두 개이고, 최대 10개까지 체크할 수 있습니다. 체크는 특정 워커를 가리키므로 선택기에 worker · model이 표시됩니다. 워커가 사라지면 브리지가 그 체크를 숨기고, 돌아오면 다시 보여 줍니다.

등급 라벨(agent / light / chat)은 워커의 Ollama 기능에서 나옵니다. agent 모델만이 도구 호출 에이전트 루프를 구동하도록 만들어졌고, chat 모델은 에이전트에 부적합으로 표시되지만 단순 채팅에 쓰는 것을 막는 것은 없습니다.

워커의 multiaddr을 안다면 Manual workers에 추가하세요. 같은 LAN에서 동작하며 디렉터리 항목이 필요 없습니다.

비공개 워커​

비공개 워커는 디렉터리와 시드에 의도적으로 나오지 않습니다. 소유자가 일회용 페어링 코드(genkaku1.…)를 보내 줍니다. Private workers에 붙여 넣고 Pair를 누르면 코드가 한 번 교환되어 당신의 지갑에 묶이고, 이후 다른 사람은 쓸 수 없습니다. 그 행에는 상대가 온라인(초록), 오프라인, 확인 중 중 어느 상태인지 표시됩니다.

페어링한 워커는 목록의 평범한 행입니다. 체크도 가격도 세션도 같습니다. Forget은 이 기계에서만 제거하며, 워커 쪽 허용 목록은 소유자가 관리합니다.

세션 실행​

DeepSeek Harness 세션에서 모델 선택기를 열고 GenKaKu 모델을 고르세요. 플러그인은:

  1. 워커에 직접 다이얼하고, 직접 연결이 불가능하면 시드 릴레이를 통해 연결합니다,
  2. 유료 모델이면 첫 토큰 전에 10분치 USDC를 세션의 에스크로에 입금합니다,
  3. Ollama가 생성하는 대로 토큰을 스트리밍합니다,
  4. 세션이 끝나면 정산하고 세션을 닫아, 보증금이 감당하지 못한 부분을 돌려받습니다.

무료 모델(견적 0)은 2번과 4번 단계를 완전히 건너뜁니다. 세션도, 수수료도, 트랜잭션도 없습니다.

세션 비용​

항목지불 주체
추론당신. USDC로 시작된 분마다
개설 네트워크 수수료당신. SOL로 1센트의 몇 분의 일
정산 네트워크 수수료워커
플랫폼 수수료정산액의 1%, 재무로

따라서 유료 세션은 두 개의 체인 트랜잭션이 들며, 하나씩 양쪽이 냅니다. 시작된 분이 하나도 청구되기 전에 세션이 끝나면 보증금 전액이 돌아옵니다.

과금은 시작된 분 기준입니다. 10초 만에 멈춰도 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이 가격을 넘는 모델은 선택 목록에 오르지 않음꺼짐

수정은 입력란에서 벗어나는 순간 저장됩니다. 잊고 누르지 않아도 되는 저장 버튼은 없습니다. 금액을 비우면 그 항목은 상한 없음이며 0이 아닙니다.

카드는 쓴 금액도 보여 줍니다. 합계, 오늘, 이번 주, 이번 달, 모델별 표, 그리고 최근 20개 세션과 그 트랜잭션 서명입니다. 네 구간은 세션 기록에서 계산하고, 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 — 온체인 디렉터리와 시드를 다시 읽습니다. 스캔이 끝나면 브리지가 재시작되며, 지갑을 바꾼 프로필도 트랜잭션을 보내려면 재시작이 필요합니다.

로컬 브리지는 47821–47826 범위에서 첫 번째 빈 포트에 바인딩되고, 자신이 사용자 쪽일 때만 응답합니다. 같은 머신의 워커 상태 서버가 브리지로 오인되지 않습니다.

자주 묻는 질문​

GenKaKu Labs를 신뢰해야 하나요?
신뢰할 것은 프로그램과 코드입니다. 자금이나 프롬프트를 보관하는 서버는 없습니다.

지갑 없이 쓸 수 있나요?
정산을 끈 무료 모델에서만 가능합니다. 유료 세션과 신원은 지갑입니다.

메인넷인가요?
예. 프로덕션은 Solana mainnet-beta에서 Circle의 USDC를 정산합니다. 패널은 이 빌드가 어느 클러스터에 있는지 보여 줍니다. 스테이징 빌드는 devnet에서 가치 없는 테스트 토큰을 정산합니다. 무엇이든 자금을 넣기 전에 확인하세요.

내 프롬프트를 누가 볼 수 있나요?
항상 그것을 제공하는 워커가 봅니다. 세션이 시드 릴레이를 거치면 릴레이 운영자는 연결 메타데이터(주소, 시각, 양)를 보지만 암호화된 내용은 보지 못합니다.

모델이 선택기에서 왜 사라졌나요?
어댑터는 로컬 브리지 포트를 탐색하고 user 역할을 보고하는 브리지만 받아들입니다. 다른 프로필이 소유한 오래된 포트는 무시되며, 다음 새로 고침에서 다시 나타납니다.

실패한 세션에 대해 청구되었습니다.
정산은 워커가 서명할 때만 일어나며, 청구할 수 있는 것은 클라이언트의 영수증이 대상으로 하는 분뿐입니다. 응답이 끝내 도착하지 않으면 클라이언트가 세션을 닫고 보증금은 돌아옵니다. 시작된 2분 동안 토큰을 생성한 세션은 응답이 중간에 끊겨도 2분치가 청구됩니다. 그것이 "시작된 분"의 의미입니다.