MensajeríaMAX

Configuración de la CLI de MAX

Configura perfiles, rutas locales, variables de entorno y el servicio en segundo plano de la CLI de MAX.

Guarda ajustes que repetirías en cada comando. Esta guía explica su ubicación y prioridad para cambiar un valor y comprobar cuál se aplica.

Cambiar y comprobar ajustes →

Esta página es necesaria cuando escribe el mismo parámetro una y otra vez o desea que max se comporte de manera diferente para una cuenta. Después de leerlo, sabrá dónde está el archivo de configuración, qué hacen las configuraciones principales, cómo cambiar una de ellas y cómo verificar qué valor está vigente. No necesita un archivo para comenzar: sin uno, cada configuración tiene un valor incorporado.

Palabras que aparecen en la página:

  • Archivo de configuración (config.json): un archivo de texto en el que max almacena sus selecciones guardadas.
  • Perfil es un conjunto de configuraciones con nombre para una cuenta MAX o un bot, por ejemplo work. Su nombre se coloca antes del comando: max work chats list. Ver perfiles y bots.
  • Parámetro (bandera): una palabra agregada a un comando, por ejemplo --limit 5. Sólo cambia este ejecución.
  • Variable de entorno es un valor con nombre que el proceso del terminal o agente pasa a max, por ejemplo MAX_PROFILE=work.

¿Qué se puede configurar?

Estas son las configuraciones que se cambian con más frecuencia. Una descripción exacta de cada tipo y todos los métodos de anulación en referencia de configuración.

Ajustes¿Qué hace?Valor incorporado
limit¿Cuántas líneas muestra la lista si no se especifica --limit?20
sends_per_hourcuántos mensajes puede enviar un perfil en una hora; detiene el ciclo de envío30; el bot no tiene límite hasta que se especifica en la sección bot
requests_per_minute¿Con qué frecuencia accede max a MAX después de una breve serie de solicitudes? 0 apaga el tempo (limitaciones y expectativas)20
permissionsqué puede hacer el perfil: sólo leer, preguntar antes de cambiar o hacer sin preguntar (permisos)todo está permitido excepto: primero se solicita la eliminación y algunos cambios irreversibles más; las respuestas automáticas no se envían
recordregistrar también las ejecuciones correctas, no solo las fallidas (diagnóstico)true
record_inputsi el registro de ejecución guarda la línea de comandos tal como la escribiste; los secretos se ocultan siempre (diagnóstico)true
keep_runs_for_days¿Cuántos días se almacenan los registros de ejecución?30
colorcolor en tablaspor terminal
sender_colorsCada autor tiene un color diferente en la lista de mensajes.false
timeout_mscuánto tiempo esperar una respuesta a una solicitud a MAX, en milisegundos. Para restringir todo el comando, use --timeouten transporte
serveejecute el servidor en segundo plano max personal serve cuando el comando necesite MAX (una entrada para todos los)true
transcribe_modelqué modelo reconocer mensajes de vozgigaam-v3
update_checkuna vez al día para informar que se ha lanzado una nueva versión de maxtrue

No hay ningún secreto en un archivo. No hay lugar en él para un token, un número de teléfono o una identificación de chat: el token se almacena en el llavero del sistema y, donde no está, en un archivo que solo usted puede leer (donde vive token).

Archivo de configuración de ejemplo

El primer comando que lee la configuración crea el archivo inicial; max personal doctor no lo crea. Aquí está, con un perfil agregado:

{
  "defaults": { "limit": 20, "keep_runs_for_days": 30, "sends_per_hour": 30, "update_check": true, "skill_hint": true },
  "profiles": {
    "work": { "limit": 50 }
  }
}
  • defaults es válido para todos los perfiles.
  • profiles.work es válido sólo para el perfil work y es más importante que defaults.

Por lo tanto, max work chats list mostrará 50 líneas y max personal chats list mostrará 20. Agregue --limit 5 para obtener cinco líneas en un comando. Elimine limit del perfil y el valor de defaults volverá a ser válido.

Ejemplo completo con todas las secciones
{
  "defaults": {
    "limit": 20,
    "keep_runs_for_days": 14,
    "sends_per_hour": 30,
    "requests_per_minute": 20,
    "update_check": true,
    "skill_hint": true,
    "transcribe_model": "gigaam-v3"
  },
  "profiles": {
    "personal": {
      "limit": 50,
      "color": true,
      "sender_colors": true,
      "record": true
    },
    "work": {
      "permissions": { "messages": "readonly", "messages.send": "allow" },
      "sends_per_hour": 10,
      "serve": false
    }
  },
  "personal": {
    "defaults": { "search_catch_up": true }
  },
  "bot": {
    "defaults": { "permissions": { "bot": "readonly", "bot.messages.send": "allow" } },
    "profiles": {
      "shop": { "sends_per_hour": 200, "read_other_bots": false }
    }
  }
}

Qué hace cada parte:

  • defaults: cada perfil recibe estos valores si no ha especificado los suyos propios. update_check, skill_hint y transcribe_model sólo son válidos aquí: el programa y los modelos de voz son los mismos para todos los perfiles.
  • profiles.personal: más líneas, colores y grabación de cada ejecución - sólo para personal.
  • profiles.work: se pueden leer mensajes, se pueden enviar mensajes, se prohíben otros cambios en los mensajes. No más de 10 envíos por hora. El servidor en segundo plano no se inicia: cada comando ingresa MAX.
  • personal.defaults: sólo para comandos de cuentas personales, nunca para max … bot. Aquí messages sync también prepara chats descargados para búsqueda.
  • bot.defaults: sólo para comandos de bot (max shop bot …). Los bots pueden leer y enviar, y nada más.
  • bot.profiles.shop: El bot shop puede enviar 200 mensajes por hora y no lee lo que otros bots en esta computadora han guardado. read_other_bots sólo es válido en la sección bot; Allí, por el contrario, no se aceptan serve, sender_colors.

¿Dónde está el archivo?

SistemaCamino
Linux y macOS~/.config/max-cli/config.json
Windows%APPDATA%\max-cli\Config\config.json

max config show imprime la ruta que esta computadora realmente usa y cada configuración con su valor, de dónde salió ese valor, el valor integrado y lo que hace la configuración. En PowerShell, escriba max.cmd en lugar de max. Un archivo existente nunca se reemplaza por el inicial.

max config migrate añade a defaults cada configuración que falta en el archivo, con su valor integrado, para que todas las configuraciones se vean y se editen directamente en el archivo. Sus valores, su orden y las claves desconocidas quedan como están. Cualquier escritura de max en el archivo, por ejemplo config set, hace lo mismo; config unset no vuelve a escribir la configuración eliminada.

Tres formas de establecer un valor

  • En archivo: el valor se guardará para los siguientes comandos. max personal config set limit 50 lo anota.
  • Variable de entorno: el valor es válido en un terminal o en un proceso de agente. Por ejemplo, MAX_PROFILE selecciona el perfil y MAX_TIMEOUT limita el tiempo del comando. No todas las configuraciones tienen una variable.
  • Parámetro: --limit 5 cambia solo este comando.

¿Qué valor tiene prioridad?

El parámetro es más importante que la variable de entorno. Luego viene el valor del perfil en el archivo, luego defaults en el archivo y luego el valor integrado. La configuración está involucrada sólo en los métodos que admite; la referencia de configuración las enumera para cada configuración.

Cambiar valor

El archivo se puede editar en cualquier editor de texto o confiar a max. config set verifica el valor antes de escribir, por lo que nunca guarda un archivo que el siguiente comando descartará.

max personal config set limit 50                 # профилю, с которым вы работаете
max work config set limit 50            # профилю work
max config set sends_per_hour 10 --defaults   # всем профилям
max personal config unset limit                  # вернуть значение по умолчанию
max config show                         # проверить, что действует и откуда взялось каждое значение

Un error tipográfico en el nombre de una configuración es un error, no el valor predeterminado silencioso: cada comando se detiene y nombra la clave incorrecta (errores tipográficos en el archivo).

Perfiles y bots

Un perfil almacena la configuración de una cuenta o un bot. Su nombre se coloca antes del comando, por ejemplo max work config show. Para trabajar como un bot en lugar de una cuenta personal, agregue bot después del nombre. Cómo crear perfiles y cambiar entre ellos se explica en la página perfiles y bots.

Más

  • Permisos: decide qué se permite para el perfil y el agente que trabaja con él.
  • Directorio de configuración: cada configuración, su tipo, dónde es válida y todas las variables de entorno.
  • Modelos externos: proveedores, claves y selección de modelo para reconocimiento de texto en imágenes (OCR).