Saltar al contenido principal

Usar modelos de la red

El plugin de usuario añade la red GenKaKu como proveedor de modelos dentro de DeepSeek Harness. Desde una sesión de agente eliges el modelo de un par igual que eliges uno local. No hay cuenta, ni correo, ni clave de API.

Requisitos​

  • DeepSeek Harness 0.2.2-rc.1 o posterior, y Node 22+.
  • Una billetera de Solana. El plugin genera una, o puedes importar una existente.
  • Un poco de SOL para las comisiones de red y USDC para pagar el cómputo.
  • USDC: el USDC SPL de Circle en mainnet, un token de prueba en devnet.

Instalación​

En DeepSeek Harness abre Plugins → Añadir plugin y pega:

@genkaku/dsh-user-plugin

Deja la fuente de instalación en Registro predeterminado (registry.npmjs.org), confirma y reinicia DeepSeek Harness. Desde una shell:

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

Esta implementación de vista previa publica una versión preliminar, así que el comando anterior indica la versión exacta 0.5.0-rc.8 en lugar de una etiqueta: una etiqueta no resuelve a esta compilación.

Los plugins de worker y de usuario pueden convivir en la misma máquina. Cada uno mantiene su propia billetera y su propia configuración.

Billetera​

La sección de billetera del panel genera un par de claves ed25519 en el primer uso, o importa uno como base58 —el formato que te muestran Phantom y solana-keygen— o como el arreglo de bytes JSON que solana-keygen escribe en un archivo. Muestra:

  • la dirección,
  • SOL (comisiones),
  • USDC (saldo disponible para gastar).

La clave privada se guarda en texto plano, con permisos 0600, en ~/.dsh/genkaku/genkaku.keys.json. Nosotros nunca la tenemos y no podemos recuperarla.

En devnet el panel puede acuñar USDC de prueba, que no tienen ningún valor. En mainnet no hay botón de acuñación: compras USDC donde lo compras normalmente.

Encontrar un worker​

El panel lista lo que ofrece la red:

  • Modelos en la red: cada fila es un worker + modelo, con el nombre visible del worker, la cotización por hora, el nivel y la latencia medida.
  • Workers descubiertos: pares encontrados a través del directorio en la cadena y del relay semilla. La cifra es lo que el descubrimiento ve en este momento, no un total global.

La lista tiene un buscador (modelo, nombre del worker o billetera) y un menú de orden: recomendado, precio más bajo, latencia más baja, más sesiones servidas, nombre del modelo o nombre del worker. El orden es el mismo que usa el selector de modelos del chat, así que las diez primeras filas son las diez que ofrece una instalación nueva.

Marcar un modelo es lo que lo pone en el selector del chat. La unidad es el worker y el modelo, así que el mismo modelo de dos workers son dos filas marcables, y como mucho se pueden marcar diez. Una marca señala a un worker concreto: por eso el selector muestra worker · modelo. El puente oculta una marca cuyo worker se ha ido y la devuelve cuando vuelve.

La etiqueta de nivel (agent / light / chat) procede de las capacidades de Ollama del worker. Solo los modelos agent están pensados para mover un bucle de agente con llamadas a herramientas; los modelos chat se marcan como no aptos para agentes, pero nada te impide usar uno para un chat normal.

Si conoces la multiaddr de un worker, añádela en Workers manuales; funciona en la misma LAN y no necesita entrada en el directorio.

Workers privados​

Un worker privado está deliberadamente ausente del directorio y de la semilla. Su dueño te envía un código de emparejamiento de un solo uso (genkaku1.…). Pégalo en Workers privados y pulsa Emparejar: el código se canjea una vez y queda vinculado a tu billetera, y después nadie más puede usarlo. La fila muestra si ese worker está en línea (verde), fuera de línea, o aún comprobándose.

Los workers emparejados son filas normales de la lista: mismas marcas, mismo precio, misma sesión. Olvidar quita uno en local; la lista de billeteras emparejadas del worker la gestiona su dueño.

Ejecutar una sesión​

En una sesión de DeepSeek Harness, abre el selector de modelos y elige un modelo GenKaKu. El plugin:

  1. marca el worker directamente, o a través del relay semilla si una conexión directa es imposible,
  2. para un modelo de pago, deposita diez minutos de USDC en el escrow de la sesión antes del primer token,
  3. transmite los tokens a medida que Ollama los genera,
  4. liquida cuando termina la sesión y la cierra, lo que devuelve lo que el depósito no cubrió.

Los modelos gratuitos (cotización 0) se saltan los pasos 2 y 4 por completo: sin sesión, sin comisión, sin transacción.

Cuánto cuesta una sesión​

ConceptoQuién paga
InferenciaTú, en USDC, por minuto iniciado
Comisión de red al abrirTú, una fracción de céntimo en SOL
Comisión de red al liquidarEl worker
Comisión de plataforma1% de la liquidación, a la tesorería

Por tanto, una sesión de pago cuesta dos transacciones en la cadena, una de cada lado. Si la sesión termina antes de que haya un solo minuto iniciado facturable, vuelve todo el depósito.

La facturación es por minuto iniciado: parar a los diez segundos sigue facturando un minuto, a la cotización por hora del worker dividida entre 60.

Límites de gasto​

La billetera es una pasarela de pago, no una caja fuerte: el agente debe poder ejecutar una sesión sin pedirte permiso cada vez. Lo que no debe poder hacer es gastar sin techo. La tarjeta Budget del panel es ese techo, y sigue la forma de los límites de crédito que ya conoces de las claves de API.

CampoQué hacePor defecto
Name (nombre)La etiqueta que aparece en un rechazoeveryday
Credit limitMáximo de USDC que esta clave puede gastar en un periodo10
Resetnever, daily (medianoche UTC), weekly (lunes), monthly (día 1)never
ExpiresUna fecha fija; después, las sesiones de pago se detienendesactivado
EnabledEl interruptor de las sesiones de pagoactivado
Per sessionMáximo de USDC que una sesión puede prepagar2
Max price per hourLos modelos por encima de este precio no llegan al selectordesactivado

Los cambios se guardan al salir del campo: no hay botón Guardar que se pueda olvidar. Un importe vacío significa sin límite para ese campo, no cero.

La tarjeta también informa de lo gastado: total, hoy, esta semana y este mes, una tabla por modelo y las últimas veinte sesiones con su firma de transacción. Las cuatro ventanas se calculan a partir del registro; total es el contador de por vida de la propia política, así que nunca baja cuando se recorta el registro antiguo.

Cómo se ve un rechazo​

La política se comprueba antes de firmar nada. Una sesión de pago que la política no permite se rechaza con HTTP 402 y un cuerpo JSON que indica el motivo:

codeSignificado
budget_exhaustedEl límite del periodo no cubre el depósito
session_capUna sesión prepagaría más que el tope por sesión
price_capLa cotización del modelo supera el tope por hora
policy_disabledEnabled está desactivado
policy_expiredLa fecha de caducidad ya pasó

Una sesión rechazada no deja rastro en la cadena — sin depósito, sin comisión, sin transacción — y el número de firmas de la billetera no cambia. Los modelos por encima del tope de precio se filtran del selector para que nunca elijas un modelo que no puedes pagar.

Los modelos gratuitos (cotización 0) están exentos del presupuesto, y Enabled solo bloquea las sesiones de pago: con el interruptor apagado, los modelos gratuitos siguen funcionando.

Dónde vive​

La política es un único archivo local, ~/.dsh/genkaku/policy.json, con permisos 0600, junto al registro de gasto spend.jsonl. No es una cuenta en la cadena ni algo que el worker pueda ver: es tu propio software negándose a construir una transacción. Un archivo editado a mano no puede inyectar un límite negativo, una cadencia desconocida ni una reserva falsa: el analizador vuelve a los valores por defecto documentados.

Dos reglas de contabilidad conviene conocerlas:

  • abrir una sesión reserva el depósito de inmediato, así que cuenta contra el presupuesto mientras la sesión corre; al liquidar se compromete lo que el worker facturó de verdad y se libera el resto;
  • una reserva que sigue abierta después de 30 minutos se trata como gastada. Un fallo entre la apertura y la liquidación puede por tanto contar de más, pero la única suposición que importa —dar por devuelto un depósito— nunca se hace.

Delete policy elimina policy.json y vuelve a los valores por defecto de arriba. No toca la billetera ni sus fondos. Para dejar de gastar sin perder la configuración, usa Enabled.

Configuración​

  • Pagos: con la liquidación activada, cada sesión de pago abre un escrow real. Desactívala para sesiones gratuitas o de desarrollo que no firman nada en la cadena; vuelve a activarla antes de usar la red contra workers reales.
  • Workers manuales: fija a mano la multiaddr de un worker.
  • Actualizar: vuelve a leer el directorio en la cadena y la semilla. El puente se reinicia cuando termina el escaneo, y un perfil que haya cambiado su billetera también necesita reiniciarse antes de poder operar.

El puente local se enlaza al primer puerto libre en 47821–47826 y solo responde si es la mitad de usuario; un servidor de estado de worker en la misma máquina no se confundirá con él.

Preguntas frecuentes​

¿Tengo que confiar en GenKaKu Labs?
Tienes que confiar en el programa y en el código. Ningún servidor guarda tus fondos ni tus prompts.

¿Puedo usarlo sin billetera?
Solo para modelos gratuitos con la liquidación desactivada. Las sesiones de pago y la identidad son la billetera.

¿Esto es mainnet?
Sí: producción liquida el USDC de Circle en Solana mainnet-beta. El panel muestra en qué clúster está la compilación. Las compilaciones de staging liquidan un token de prueba sin valor en devnet: compruébalo antes de financiar nada.

¿Quién puede ver mis prompts?
El worker que los sirve, siempre. Si la sesión pasa por el relay semilla, el operador del relay ve metadatos de conexión —direcciones, tiempos y volumen—, pero no el contenido cifrado.

¿Por qué desapareció mi modelo del selector?
El adaptador sondea los puertos del puente local y solo acepta un puente que informe del rol user. Un puerto obsoleto en manos de otro perfil se ignora y vuelve a aparecer en la siguiente actualización.

Me cobraron por una sesión que falló.
La liquidación solo ocurre cuando el worker la firma, y solo puede facturar los minutos que cubren los recibos del cliente. Si la respuesta nunca llegó, el cliente cierra la sesión y el depósito vuelve. Una sesión que produjo tokens durante dos minutos iniciados se factura por dos minutos aunque la respuesta se cortara: eso es lo que significa "minuto iniciado".