Instala Yenpo y abre tu primer repositorio

No necesitas una cuenta de modelos para empezar a leer código en Yenpo. La exploración, la búsqueda y la navegación mediante servidores de lenguaje funcionan localmente. Conecta un proveedor más adelante, cuando quieras preguntar a AI Reader sobre el código. La interfaz de la aplicación está disponible en inglés y chino simplificado; esta guía conserva los nombres de los controles en inglés.

Comprueba tu Mac

La versión preliminar actual funciona en Mac con Apple silicon e Intel y macOS 14 o posterior; la misma descarga sirve para ambos. Puedes consultar tu versión de macOS en About This Mac.

Cada compilación preliminar caduca en una fecha fija indicada junto al botón de descarga. La fecha se establece al crear la compilación; descargarla o reinstalarla después no la retrasa. Instala una versión más reciente antes de esa fecha.

Instala la aplicación

1. Descarga el .dmg desde la página de inicio.
2. Ábrelo y arrastra Yenpo a Applications.
3. Inicia Yenpo desde Applications y expulsa la imagen de disco.

Comprueba la versión instalada

Selecciona Yenpo → About Yenpo en la barra de menús. Compara la versión con la indicada junto al botón de descarga. La ventana About también muestra la caducidad de EAP en la zona horaria de tu Mac; el sitio muestra la fecha en UTC.

Si instalaste una actualización pero sigues viendo la versión anterior, cierra Yenpo y vuelve a abrir la copia de Applications. Consulta Actualiza antes de que caduque la versión preliminar para ver los pasos de sustitución.

Abre un proyecto

Abre la carpeta del proyecto que quieres leer. Elige la raíz del repositorio, donde están README, el archivo de compilación y .git. Si abres una subcarpeta, las pruebas y la configuración situadas en otras partes del repositorio quedarán fuera del proyecto.

Pulsa Command-P (Go to File…), escribe parte del nombre o la ruta y abre un archivo conocido. Mantén README o una prueba relacionada en otra pestaña. Para leer otro proyecto, ábrelo en su propia ventana.

¿No encuentras un archivo que sabes que existe? Confirma que está dentro de la carpeta abierta y revisa si se están ocultando archivos ocultos o ignorados por Git. Consulta Busca archivos y sigue símbolos.

Prueba una tarea pequeña

Elige algo cuya respuesta puedas comprobar, como dónde se lee un ajuste:

1. Usa Search All Files para buscar el nombre exacto del ajuste o un mensaje distintivo.
2. Abre la función correspondiente y averigua de dónde obtiene su entrada.
3. Usa Go to Definition o Find References si hay un servidor de lenguaje. Si no, busca el símbolo como texto.
4. Lee el código que llama a la función o la prueba que proporciona la entrada.

Con eso basta para empezar: una entrada, un valor que seguir y una llamada o prueba que muestre cómo se usa. No necesitas comprender antes toda la arquitectura.

Pregunta a AI Reader (opcional)

Configura un proveedor siguiendo Conecta un proveedor de modelos, abre AI Reader y pregunta por el código que acabas de leer. Puedes añadir un archivo, carpeta o selección como punto de partida, o describir el comportamiento y dejar que encuentre el código en tu espacio de trabajo.

Por ejemplo:

Sigue este ajuste desde su valor por defecto hasta el manejador de la solicitud. ¿Qué valores pueden reemplazarlo? Indica las ramas que debo comprobar.

Pulsa una referencia en la respuesta para previsualizar el código en Quick Look y Open File para mantenerlo en una pestaña. Comprueba una afirmación antes de formular una pregunta más amplia.

AI Reader solo lee por defecto. Puedes permitirle editar archivos durante una ejecución; Qué se envía y qué se puede editar explica el funcionamiento y los datos enviados al modelo.

Actualiza antes de que caduque la versión preliminar

1. Comprueba la versión y caducidad junto al botón de descarga de inicio. Descarga el .dmg más reciente cuando esté disponible.
2. Guarda los archivos pendientes y cierra Yenpo. Abre la nueva imagen de disco y arrastra Yenpo a Applications, reemplazando la copia existente cuando Finder lo solicite.
3. Inicia Yenpo desde Applications, vuelve a comprobar Yenpo → About Yenpo y expulsa la imagen de disco.

Descargar o reinstalar la misma compilación no amplía su validez. Si ha caducado y la página de inicio aún ofrece esa versión, vuelve más adelante para comprobar si hay una nueva.

Si algo no funciona

Problema	Qué comprobar primero
No se encuentra un archivo	Raíz del proyecto, ruta y ajustes de archivos ocultos e ignorados por Git
Go to Definition no hace nada	Si el servidor de lenguaje está instalado y entiende el proyecto
AI Reader no responde	Proveedor activo, tipo de API, endpoint, identificador del modelo y clave de API
El código no es el esperado	Si la pestaña muestra una versión histórica de Git o el archivo actual

Al documentar un error, anota las versiones de Yenpo y macOS, el resultado esperado y real, y los pasos de reproducción. No incluyas código privado ni claves de API en lo que compartas públicamente.

Elige el siguiente paso

Continúa con Busca archivos, sigue símbolos y comprueba referencias. Empieza por la búsqueda de archivos y usa la navegación por símbolos cuando haya un servidor de lenguaje. También puedes comparar commits y ramas sin una cuenta de modelos.

Si quieres preguntar a AI Reader sobre el código, conecta un proveedor. Antes de enviar una pregunta, revisa qué código se envía al proveedor y sus tarifas.