Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Configuración

El engranaje de la esquina superior derecha del panel Commands la abre — es la propia página de configuración del editor, acotada a esta extensión, y es la única superficie de configuración que existe. Todo lo que sigue también es accesible desde el editor Settings habitual y desde tu archivo de configuración.

La página de configuración del propio editor, limitada a las opciones de la extensión de Aggrega, cada una bajo su propio encabezado.

Cada una de estas opciones es tuya, no del proyecto. Cada una describe tu propio entorno o tus propios hábitos de lectura — dónde está tu binario, cuánto esperar antes de volver a validar, cuántos reinicios tolerar, si mostrar valores que podrían leerse por encima de tu hombro, cómo quieres que se dibuje un panel —, así que cada una se limita a tu configuración de usuario, y a tu configuración remota cuando trabajas en un host remoto o en contenedor. Esto último importa en especial para la ruta del binario: el compilador se ejecuta en el mismo host que la extensión, así que la ruta puede diferir entre tu portátil y un contenedor, y cada host conserva su propio valor.

La consecuencia es deliberada: un repositorio no puede fijar ninguna de estas opciones para quien lo abra. Escribir una en un .vscode/settings.json del workspace no tiene efecto — el editor la marca como no aplicable allí y sigue usando tu valor. Si quieres que una elección quede registrada en el propio workspace, los dos comandos de Release de Seleccionar una Release son los que lo hacen, y escriben .aggrega/active-release o .aggrega-config.yaml en lugar de una configuración del editor.

OpciónPredeterminadoPropósito
aggrega.getStarted.showtrueSi la página de bienvenida se abre al iniciar. Tres superficies cambian esta única opción y se mantienen sincronizadas: la casilla al pie de la propia página, Aggrega: Stop opening the welcome page on startup y Aggrega: Get started. Desactivarla impide que la página se abra en lugar de eliminarla; volver a activarla con Aggrega: Get started también la abre.
aggrega.server.binaryPathaggregaRuta al binario aggrega. Un nombre simple se busca en PATH; una ruta que empieza por ~/ (~\ en Windows) o ${userHome} se lee desde tu carpeta personal en el host donde se ejecuta la extensión; cualquier otra ruta se usa tal como está escrita.
aggrega.server.debounceMs300Ventana de debounce para la validación proactiva al cambiar.
aggrega.server.respawnAttempts5Cuántas veces, dentro de la ventana indicada abajo, se vuelve a iniciar el servidor de lenguaje después de que se detenga sin que se le pida, antes de que la extensión lo deje detenido y genere la notificación de que ha dejado de responder. Un servidor reiniciado que se detiene antes de haber respondido cuenta igual que uno que se detiene mientras se ejecuta. Consulta Ciclo de vida.
aggrega.server.respawnWindowSeconds180Ventana deslizante, en segundos, en la que se cuentan esos reinicios.
aggrega.server.restartGraceSeconds5Ventana de gracia antes de que la extensión reinicie automáticamente el servidor de lenguaje tras un cambio de binaryPath. La barra de estado muestra una cuenta atrás; el menú de acciones rápidas ofrece Restart now y Cancel restart.
aggrega.server.buildOnInspectfalseEjecuta la etapa de renderizado de artefactos al inspeccionar un grafo, para que los avisos que aggrega build emite durante el renderizado aparezcan también como problemas del editor. No añade ninguna de las comprobaciones en las que un build se detiene. Inspeccionar cuesta más cuando se ejecuta; no se escribe nada en disco.
aggrega.graph.showSensitiveValuesfalseMuestra en el grafo de topología los valores que una Feature declara sensibles, mostrando en claro una credencial pasada por valor; mientras está activada, la solicitud del grafo se los pide al servidor de lenguaje. Si se deja desactivada, el servidor de lenguaje los retiene del grafo que envía, y se eliminan de nuevo antes de dibujar el grafo.
aggrega.operations.layoutbuttonsCómo dibuja el panel Commands sus grupos — buttons pone todas las operaciones en un único flujo de botones que se ajusta, sin nada dibujado entre un grupo y el siguiente, sections convierte cada grupo en una sección que abres bajo su propio título. Mismos grupos, mismas operaciones, mismo orden en ambos casos.
aggrega.notifications.toastDebounceModetimeCon qué frecuencia se vuelve a mostrar el aviso de que una Release no tiene lockfile para trabajo que no pediste, como un grafo abierto que se vuelve a dibujar tras guardar: time lo vuelve a mostrar una vez transcurridos toastThrottleSeconds desde que se cerró el último, session lo muestra una vez hasta que se reinicia el servidor de lenguaje. Un Build, una Preview o un grafo que abres y que se rechaza por falta de lockfile siempre muestra el aviso.
aggrega.notifications.toastThrottleSeconds300Segundos tras cerrarse el aviso de lockfile ausente antes de que vuelva a mostrarse para trabajo que no pediste. Solo se lee cuando toastDebounceMode es time.