AiHummer
Español▾
Iniciar sesiónCuenta
v1.6.x▾
{ }Swagger

Cliente en tiempo de ejecución y conexión IDE ACP

v1.6.x · actualizada 2026-11-15

El cliente Runtime y el adaptador ACP utilizan el mismo Core, conversaciones, agentes y aprobaciones que la interfaz normal. La conexión de un IDE no otorga acceso al sistema de archivos del servidor ni a la terminal y no lo convierte en un administrador confiable. Utilice la conexión válida del usuario original, no una clave de máquina que lleve un identificador de apariencia humana.

Prepara la conexión

Seleccione su origen Core, un espacio de trabajo existente y un agente disponible para usted. El cliente de software primero negocia una versión de protocolo compatible. Resuelva el rechazo de una versión utilizando software compatible, no reintentando con una capacidad inventada.

El cliente Go público proporciona client.NewRuntime, Negotiate, CreateSession, Prompt y Observe. Guarde su ClientMessageID en algún lugar que sobreviva a un reinicio, antes del primer envío. Después de un tiempo de espera o de reiniciar, llame a Observe para recibir la misma conversación y el mismo mensaje. Esto lee la solicitud original en lugar de crear otra generación. No reutilice un identificador con texto diferente.

Crear una conversación es una acción separada. Si se pierde su reconocimiento, verifique la lista de conversaciones antes de crear otra: los reintentos de creación automática pueden agregar una segunda conversación.

Utilice ACP

El adaptador ACP intercambia mensajes a través de entrada y salida estándar. Configure -core, -workspace, -agent, -cwd y un token de usuario válido en AIHUMMER_RUNTIME_TOKEN. Mantenga el token fuera de proyectos y registros compartidos. El valor -cwd etiqueta el proyecto IDE; no monta el directorio de la computadora en el servidor.

Este adaptador admite ACP1 y entrada de texto. No acepta servidores MCP proporcionados por el cliente, nuevos sistemas de archivos o permisos de terminal, imágenes o audio. Las herramientas Core independientes siguen estando limitadas por sus permisos configurados existentes.

Cada conversación permite un mensaje activo. Dos conversaciones independientes pueden desarrollarse de forma independiente. Al cargar una conversación se muestran mensajes persistentes e identidades originales sin volver a enviar el trabajo sin terminar.

Aprobación, cancelación y desconexiones

La aprobación de la herramienta llega al usuario con opciones de permitir una vez o rechazar. Las respuestas faltantes, caducadas o con formato incorrecto nunca significan consentimiento. Core aún valida la decisión.

La cancelación explícita tiene como objetivo una entrada original activa. Cancelar una conversación no debe cancelar otra. Cerrar una conexión no establece en sí misma la cancelación; reconocer una solicitud de cancelación no prueba que todas las operaciones en curso se hayan detenido. La aplicación del cliente distingue entre un resultado final, un trabajo previo aceptado y un efecto externo incierto.

La salida parcial y el transporte EOF no reemplazan un resultado final persistente. Recupera el estado original cuando se desconoce el resultado en lugar de enviar la acción nuevamente. Las operaciones externas de larga duración tienen su propia lectura del identificador original.