Pageferry
FAQ

Respuestas de depuración de Bash: códigos de salida, argumentos y linters

05

Conceptos básicos de Bash

¿Cómo ayuda el modo de depuración de Bash cuando falla un script?

La opción -x hace que Bash imprima cada comando, con sus argumentos expandidos, justo antes de ejecutarlo, para que veas exactamente dónde falla el script. Lo inicias con bash -x script.sh en WSL o en un sistema Linux que poseas, y -eu detiene la ejecución en el primer error o variable no definida. En Pageferry, la tarjeta Shell agrupa este seguimiento con el código de salida real.

¿Qué es un linter de Bash y cuándo debo ejecutarlo?

Un linter de Bash es un programa independiente que lee tu script sin ejecutarlo y señala errores probables, como una variable sin comillas. Eliges tu propio linter, lo instalas en WSL o en tu sistema Linux y le pides al agente que lo ejecute con Shell. La tarjeta muestra sus mensajes y su código de salida. Un linter no reemplaza una ejecución de prueba.

¿Cómo paso argumentos a un script de Bash?

Los argumentos son los valores después del nombre del script, por ejemplo bash script.sh uno dos, y el script los lee como $1, $2 y así sucesivamente. $# contiene el recuento, y "$@" contiene todos ellos como palabras separadas. Para agregar indicadores y argumentos requeridos, prueba $# al inicio, imprime una línea de uso en el error estándar y sal con exit 2. Deja de pasar secretos como argumentos de línea de comandos: otros usuarios los ven en la lista de procesos.

¿Qué significa el código de salida 127 en Bash?

Un código de salida de 127 significa que no se encontró el comando, generalmente por un error tipográfico, un programa no instalado o un PATH que no lo incluye. El shell imprime un mensaje, y Pageferry muestra el mismo mensaje y el número en la tarjeta Shell. Un script de Bash que ejecuta aplicaciones con indicadores debe verificar el código de salida de cada aplicación que inicia.

¿Qué significa el código de salida 126 en Bash?

Un código de 126 significa que se encontró el archivo pero no se puede ejecutar, generalmente porque le falta el permiso de ejecución o no es un programa. En tu propio script, chmod +x script.sh añade el permiso, después de lo cual ./script.sh puede iniciarlo a través de la línea shebang. Si no estás seguro, ejecuta bash script.sh primero y lee el código de salida en la tarjeta.

Uso de Pageferry

¿Es codedguru.com el sitio web oficial de Pageferry?

Sí, codedguru.com es el sitio web oficial de Pageferry. El botón de descarga proporciona el programa de instalación original de aproximadamente 34 MB, y puedes comparar su suma de verificación SHA-256 con el manifiesto publicado antes de ejecutarlo. Windows SmartScreen puede advertir porque el instalador aún no está firmado digitalmente. Las preguntas sobre la aplicación se envían a través del botón Send feedback dentro de ella.

¿Puede el agente trabajar con scripts de Bash en un sistema Linux?

Sí, a través de WSL en tu propia PC o por SSH a un sistema Linux que poseas. Pageferry es una aplicación para Windows 10 y 11, así que chateas en Windows, las herramientas de archivos funcionan en la carpeta de trabajo del chat, y Shell ejecuta comandos en el entorno que elijas. Usa solo máquinas que tengas permitido administrar y prueba primero en una copia.

¿Son siempre correctos los resultados?

No. El agente ejecuta los comandos y muestra la salida real, pero un script aún puede estar equivocado, y un modelo puede malinterpretar el problema. Lee cada diff, ejecuta el script con valores de prueba y verifica el código de salida tú mismo. Pageferry pone los hechos en una tarjeta; la decisión de aceptar un cambio te corresponde a ti, y una edición rechazada no cambia nada.

¿Cuál es la diferencia entre Ask first y Plan only?

Ask first es un modo en el que el agente puede actuar pero se detiene antes de cada acción que cambia algo, como escribir un archivo, y para una edición ves el diff y lo aceptas o rechazas. Plan only escribe un plan y no ejecuta nada: ni comandos ni cambios de archivos. Cambias el modo para ejecutar el plan. Auto-run actúa de inmediato.

¿Puedo ejecutar varios trabajos en paralelo?

Sí, la herramienta de tarea inicia sub-agentes en paralelo, y dentro de un script de Bash puedes iniciar trabajos concurrentes en segundo plano con & y usar wait. La agregación de códigos de salida es entonces tu responsabilidad: espera a cada id de proceso y recopila su estado tú mismo, porque $? contiene solo el estado del último comando. Prueba tal script en tu propia máquina.

Modelos, privacidad y descarga

¿Mis archivos salen de la PC cuando uso un modelo en la nube?

Sí, con un modelo en la nube la solicitud, incluido el texto de los archivos que lee el agente, se envía a ese proveedor. Con un modelo local nada sale de la máquina. En ambos casos, los chats, las carpetas de trabajo y las claves API permanecen en la PC, y los secretos en la salida de la herramienta se enmascaran antes de llegar al modelo. Tú eliges el punto de conexión, así que elígelo teniendo tu script en mente.

¿El instalador está firmado digitalmente?

No, el instalador aún no está firmado digitalmente, por lo que Windows SmartScreen puede advertir cuando lo ejecutas. Compara la suma de verificación SHA-256 del archivo descargado con el manifiesto publicado, y solo entonces elige Ejecutar de todos modos en Más información. En Windows, certutil -hashfile con la ruta del archivo y SHA256 imprime el valor para comparar.

¿Qué tamaño tiene el programa de instalación?

34 MB es el tamaño del programa de instalación que proporciona el botón de descarga. También existe un .exe portátil único de aproximadamente 25 MB, pero el botón no lo proporciona. Ambos están construidos para Windows 10 y 11, y la versión actual es 2.9.26. Después de instalar, la aplicación muestra un botón Actualizar cuando una nueva versión está lista.

¿Pageferry necesita una cuenta o una conexión a Internet?

No se necesita una cuenta para ejecutar la aplicación. Si necesitas una conexión a Internet depende del modelo: un proveedor de IA en la nube lo necesita, un modelo local no, y web search, las comprobaciones de actualización y el control de chats desde un navegador de teléfono son funciones de red opcionales. El control telefónico usa una conexión saliente y se puede desactivar.

Pageferry para Windows

Depura tu próximo script de Bash con un código de salida visible

Descargar Pageferry ↗