ネットワークのモデルを使う
利用者プラグインは、GenKaKu ネットワークを DeepSeek Harness 内のモデルプロバイダーとして追加します。エージェントセッションから、ローカルのモデルを選ぶのと同じようにピアのモデルを選べます。アカウントもメールも 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
プレビュー環境はプレリリースを公開しているため、上のコマンドはタグではなく正確なバージョン 0.5.0-rc.8 を指定します。タグではこのビルドに解決されません。
ワーカープラグインと利用者プラグインは同じマシンに置けます。それぞれが独自のウォレットと設定を保持します。
ウォレット
パネルのウォレットセクションは、初回利用時に ed25519 の鍵ペアを生成するか、既存のものをインポートします。base58(Phantom や solana-keygen が表示する形式)でも、solana-keygen がファイルに書き出す JSON バイト配列でもかまいません。表示されるのは:
- アドレス、
- SOL(手数料)、
- USDC(使用可能残高)。
秘密鍵は平文で、モード 0600、~/.dsh/genkaku/genkaku.keys.json に保存されます。当社が保持することはなく、復元もできません。
devnet ではパネルがテスト USDC をミントできますが、価値はありません。mainnet にはミントボタンがありません。USDC はふだん買う場所で買ってください。
ワーカーを見つける
パネルには、ネットワークが提供しているものが並びます。
- Models on the network — 各行は ワーカー + モデル の組で、ワーカーの表示名、時間単価、ティア、実測レイテンシが表示されます。
- Workers discovered — オンチェーンディレクトリとシードリレーで見つかったピア。この数は発見が今見えているものであり、全体の合計ではありません。
一覧には検索ボックス(モデル、ワーカー名、ウォレット)と並べ替えメニューがあります。おすすめ、価格が安い順、レイテンシが低い順、提供セッション数が多い順、モデル名、ワーカー名です。並び順はチャットのモデルピッカーと共通なので、先頭 10 行が新しいインストールで提供される 10 個になります。
モデルにチェックを入れると、そのモデルがチャットのモデルピッカーに並びます。単位はワーカー と モデルなので、2 人のワーカーが同じモデルを出していればチェックできる行は 2 つあり、チェックできるのは最大 10 個です。チェックは特定のワーカーを指すため、ピッカーは worker · model と表示します。ワーカーが消えるとブリッジはそのチェックを隠し、戻ってくると再び表示します。
ティアのラベル(agent / light / chat)はワーカーの Ollama ケイパビリティに由来します。ツール呼び出しを行うエージェントループを動かすのは agent モデルのみを想定しています。chat モデルはエージェントには適さないと表示されますが、単純なチャットに使うことを妨げるものはありません。
ワーカーの multiaddr がわかっている場合は、Manual workers に追加してください。同じ LAN で動作し、ディレクトリのエントリは不要です。
非公開ワーカー
非公開ワーカーはディレクトリにもシードにも意図的に現れません。所有者から1 回限りのペアリングコード(genkaku1.…)を受け取ります。Private workers に貼り付けて Pair を押すと、コードは 1 回だけ引き換えられてあなたのウォレットに結び付き、以後ほかの人は使えません。その行には、相手がオンライン(緑)、オフライン、確認中かのいずれかが表示されます。
ペアリング済みのワーカーは一覧の通常の行です。チェックも価格もセッションも同じです。Forget はローカルで外すだけで、ワーカー側の許可リストは所有者が管理します。
セッションを実行する
DeepSeek Harness のセッションでモデルピッカーを開き、GenKaKu モデルを選びます。プラグインは:
- ワーカーへ直接、直接接続が不可能ならシードリレー経由でダイヤルし、
- 有料モデルなら、最初のトークンの前に 10 分分の USDC をセッションのエスクローへ入金し、
- Ollama が生成するそばからトークンをストリームで返し、
- セッション終了時に決済してセッションを閉じ、デポジットで賄えなかった分を戻します。
無料モデル(提示価格 0)は手順 2 と 4 を完全に飛ばします。セッションも手数料も取引もありません。
セッションの費用
| 項目 | 支払う人 |
|---|---|
| 推論 | あなた。USDC で、開始済みの分ごと |
| 開始時のネットワーク手数料 | あなた。SOL で 1 セントの何分の一か |
| 決済時のネットワーク手数料 | ワーカー |
| プラットフォーム手数料 | 決済額の 1%、財務へ |
したがって有料セッションは 2 つのチェーン取引を要し、1 つずつが両側から出ます。開始済みの分が 1 分も課金されないうちにセッションが終われば、デポジットは全額戻ります。
課金は開始済みの分単位です。10 秒で止めても 1 分分が課金され、ワーカーの時間単価を 60 で割った額になります。
支出上限
ウォレットは決済のフロントエンドであり、金庫ではありません。エージェントは毎回許可を求めずにセッションを走らせられるべきです。ただし、上限なしで使ってよいわけではありません。パネルの Budget カードがその上限で、API キーでおなじみの利用上限と同じ形をしています。
| 項目 | 内容 | 既定値 |
|---|---|---|
| Name(名前) | 拒否メッセージに出るラベル | everyday |
| Credit limit | このキーが 1 期間に使える USDC の上限 | 10 |
| Reset | never、daily(UTC 0 時)、weekly(月曜)、monthly(1 日) | never |
| Expires | 固定の日付。過ぎると有料セッションは止まる | オフ |
| Enabled | 有料セッションのオン・オフ | オン |
| Per session | 1 セッションが前払いできる USDC の上限 | 2 |
| Max price per hour | これを超える価格のモデルは選択肢に出ない | オフ |
編集はフィールドから離れた時点で保存されます。押し忘れる保存ボタンはありません。金額を空欄にすると、その項目は上限なしであり、ゼロではありません。
カードは使った額も表示します。合計、今日、今週、今月、モデル別の表、そして直近 20 セッションとその取引署名です。4 つの期間はセッション記録から計算し、total はポリシー自身の累計なので、古い記録を切り詰めても減りません。
拒否されるとどうなるか
ポリシーは何かに署名する前に確認されます。ポリシーが許さない有料セッションは HTTP 402 と、理由を書いた JSON で拒否されます。
code | 意味 |
|---|---|
budget_exhausted | その期間の上限がデポジットに足りない |
session_cap | 1 セッションの前払いが単価上限を超える |
price_cap | モデルの時間単価が上限を超えている |
policy_disabled | Enabled がオフ |
policy_expired | 有効期限を過ぎている |
拒否されたセッションはチェーンに何も残しません。デポジットも手数料も取引もなく、ウォレットの署名数も増えません。単価上限を超えるモデルは選択肢から除かれるので、払えないモデルを選んでしまうことはありません。
無料モデル(見積り 0)は予算の対象外で、Enabled は有料セッションだけを止めます。オフにしても無料モデルはそのまま使えます。
保存場所
ポリシーはローカルの 1 ファイル ~/.dsh/genkaku/policy.json(権限 0600)で、利用ログ spend.jsonl の隣にあります。チェーン上のアカウントではなく、ワーカーからも見えません。あなたのソフトウェアが取引の組み立てを拒否しているだけです。手で書き換えたファイルで負の上限や未知の周期、偽の予約を紛れ込ませることはできません。解析できない値は記述された既定値に戻ります。
知っておきたい会計ルールが 2 つあります。
- セッションを開くとデポジットが即座に予約され、実行中も予算を占めます。決済時にワーカーが実際に請求した額を確定し、残りを解放します。
- 30 分を過ぎても開いたままの予約は使われたものとして扱います。開始と決済の間に落ちると利用額が多めに数えられることがありますが、唯一まずい推測、つまり「デポジットは戻ってきた」とみなすことは決してしません。
Delete policy は policy.json を削除し、上の既定値に戻します。ウォレットや資金には触れません。設定を残したまま支出を止めたいときは Enabled を使ってください。
設定
- Payments — 決済をオンにすると、有料セッションごとに実際のエスクローが開きます。オンチェーンで何も署名しない無料・開発用セッションではオフにし、実際のワーカーに対してネットワークを使う前にオンへ戻してください。
- Manual workers — ワーカーの multiaddr を手動で固定します。
- Refresh — オンチェーンディレクトリとシードを読み直します。スキャンが終わるとブリッジが再起動し、ウォレットを変更したプロファイルも、取引できるようになる前に再起動が必要です。
ローカルブリッジは 47821〜47826 の最初の空きポートを束縛し、利用者側である場合にのみ応答します。同じマシン上のワーカーのステータスサーバーと取り違えることはありません。
よくある質問
GenKaKu Labs を信頼する必要はありますか?
信頼するのはプログラムとコードです。資金やプロンプトを保持するサーバーはありません。
ウォレットなしで使えますか?
決済をオフにした無料モデルのみです。有料セッションと身元はウォレットです。
これはメインネットですか?
はい。本番は Solana mainnet-beta 上で Circle の USDC を決済します。パネルにはそのビルドがどのクラスターにいるかが表示されます。ステージングのビルドは devnet で価値のないテストトークンを決済します。資金を入れる前に確認してください。
プロンプトを見られるのは誰ですか?
それを提供するワーカーには、常に見えます。セッションがシードリレー経由なら、リレーの運営者は接続メタデータ — アドレス、タイミング、量 — を見ますが、暗号化された内容は見えません。
モデルがピッカーから消えたのはなぜですか?
アダプターはローカルブリッジのポートを調べ、user ロールを報告するブリッジだけを受け入れます。別のプロファイルが握っている古いポートは無視され、次のリフレッシュで戻ります。
失敗したセッションに対して請求されました。
決済はワーカーが署名したときにだけ行われ、請求できるのはクライアントのレシートが対象とする分だけです。応答が届かなければ、クライアントがセッションを閉じ、デポジットは戻ります。開始済みの 2 分間トークンを生成したセッションは、応答が途中で切れても 2 分分が請求されます。それが「開始済みの分」の意味です。