Emigo: un asistente para tareas complejas de programación que utiliza IA en Emacs

Introducción general

Emigo es un asistente de programación de IA de código abierto para Emacs, desarrollado por MatthewZMD en GitHub, que ayuda a los programadores a realizar tareas como el análisis de código en Emacs mediante la integración de un modelo de lenguaje a gran escala (LLM). Emigo es un asistente de programación de IA de código abierto para Emacs, desarrollado por MatthewZMD en GitHub, que ayuda a los programadores a analizar, generar y modificar código en Emacs mediante la integración de un modelo de lenguaje a gran escala (LLM).La característica principal de Emigo es una "IA Agentic", que no sólo genera texto, sino que también interactúa con el proyecto a través de herramientas, como la lectura de archivos, la escritura de código o la ejecución de comandos. o ejecutar comandos. Ha sido desarrollado por Aider y Cline Emigo es el sucesor de Aidermacs, inspirado en herramientas como Aidermacs. En la actualidad, Emigo está en fase de pruebas beta y aún se están perfeccionando funciones para que los desarrolladores puedan probarlas y dar su opinión.

Lista de funciones

• Uso de herramientas basadas en agentesLa IA selecciona y ejecuta herramientas en función de los requisitos de la tarea, como leer o escribir archivos o ejecutar comandos.
• Integración perfecta con EmacsLa interfaz y los atajos son coherentes con la experiencia nativa de Emacs.
• Compatibilidad con varios modelos de IA: Se conecta a modelos como OpenRouter, Deepseek, etc. a través de LiteLLM, que está a libre disposición del usuario.
• gestión del contexto (informática): Registra automáticamente el historial de diálogos y los archivos de proyectos para garantizar una conversación coherente.
• Archivo Contexto Añadir: Añade rápidamente archivos al análisis de IA mediante el símbolo "@".
• Generación y visualización de parches de código: Los cambios de código devueltos por AI aparecen resaltados para facilitar su visualización.

Utilizar la ayuda

Emigo es un asistente de IA para usuarios de Emacs. Aquí tienes instrucciones detalladas sobre cómo instalarlo y usarlo para que puedas empezar a utilizarlo rápidamente.

Proceso de instalación

1. Inspección de los requisitos medioambientales
   • Requiere Emacs versión 28 o superior. Puede descargarse e instalarse en https://www.gnu.org/software/emacs/.
   • Requiere Python 3.x, que puede omitirse para quienes lo tengan instalado y obtenerse de https://www.python.org/ para quienes no lo tengan.
2. Descargar Emigo
   Clona Emigo en el directorio de configuración de Emacs ejecutando el siguiente comando en un terminal:

git clone https://github.com/MatthewZMD/emigo.git ~/.emacs.d/emigo

3. Instalación de las dependencias de Python
   Vaya al directorio Emigo y ejecútelo:

cd ~/.emacs.d/emigo
pip install -r requirements.txt

Esto instala las librerías Python necesarias, como LiteLLM.

4. Configuración de Emacs
   Abra el archivo de configuración de Emacs (normalmente ~/.emacs.d/init.el), añada el siguiente código:

(use-package emigo
:straight (:host github :repo "MatthewZMD/emigo")
:config
(emigo-enable) ;; 自动启动后台进程
:custom
(emigo-model "openrouter/deepseek/deepseek-chat-v3-0324") ;; 设置默认模型
(emigo-base-url "https://openrouter.ai/api/v1") ;; 设置 API 地址
(emigo-api-key (emigo-read-file-content "~/.config/openrouter/key.txt"))) ;; 加载 API 密钥

• Configuración::
  • emigo-modelSelección de modelos de IA: recomendaciones OpenRouter de Deepseek.
  • emigo-base-urlIntroduzca la dirección del servicio API.
  • emigo-api-key: Obtiene la clave de OpenRouter (https://openrouter.ai) y la guarda en la ruta especificada.

5. Verificar la instalación
   Después de guardar la configuración, reinicia Emacs. introduce M-x emigoSi aparece un nuevo búfer, la instalación se ha realizado correctamente.

Cómo utilizarlo

Las operaciones de Emigo se realizan principalmente en Emacs, combinando accesos directos y ventanas interactivas.

Lanzar Emigo

• En el directorio del proyecto, escriba M-x emigoEl búfer dedicado se abre después del retorno de carro.
• Si estás en un repositorio Git, Emigo utiliza el directorio raíz del repositorio como ruta de sesión. Para utilizar el directorio actual, escriba C-u M-x emigo.

pregunta de entrada

• Introduzca sus requisitos en el búfer, por ejemplo:

请优化 @src/main.py 中的排序函数

• Emigo encontrará automáticamente src/main.py y se envía a la IA para su procesamiento.

Añadir archivos al contexto

• Haga referencia al archivo con el símbolo "@", por ejemplo @src/utils.pySi no lo está, Emigo lo añadirá al contexto.
• Para ver el archivo contextual: pulse C-c C-l(corriendo) emigo-list-context-files).
• Para borrar un archivo: Pulse C-c C-f(corriendo) emigo-remove-file-from-context).

Interactuar con la IA

• Una vez introducida la tarea, la IA la analiza y devuelve los resultados. Por ejemplo:

请帮我调试 @src/main.c 中的内存泄漏

• Los parches devueltos por la IA aparecen resaltados, por ejemplo:

- free(ptr);
+ if (ptr) free(ptr);

Proceso de uso de herramientas

• La funcionalidad basada en agentes de Emigo se implementa a través de herramientas. la IA seleccionará herramientas en función de tareas como:
• read_file: Lee el contenido del archivo.
• write_to_fileEscribe a un archivo.
• execute_commandEjecutar comando.
• La IA puede avisar:

我需要运行 gcc -o test main.c，同意吗？

• pulse y Confirme que los resultados se introducen en el diálogo tras la ejecución de la herramienta.

Gestión de sesiones

• Compruebe el contexto: utilice C-c C-l Ver una lista de los archivos actuales.
• Reiniciar la sesión: cerrar la memoria intermedia y volver a ejecutarla M-x emigo.

Alertas sobre el estado del desarrollo

• Emigo está actualmente en Beta y puede tener cambios en la API, funcionalidad inestable o documentación incompleta. Se recomienda utilizarla únicamente con fines de prueba y enviar las incidencias a través de GitHub.

escenario de aplicación

1. depuración de código
   Cuando encuentres un fallo en un proyecto C, escribe "check @main.c for errors" y la IA lo analizará y sugerirá una solución.
2. Reconstrucción de documentos
   Escriba "Refactorizar funciones en @src/utils.py" y Emigo generará el código optimizado y mostrará el parche.
3. ejecución de comandos
   Escribe "compile @src/main.c" en el proyecto y la IA elegirá execute_command Funcionamiento de la herramienta gcc.

CONTROL DE CALIDAD

1. ¿Qué modelos admite Emigo?
   LiteLLM admite múltiples modelos, como Deepseek de OpenRouter, Anthropic de Claude etc., basta con especificar el nombre del modelo y la API en la configuración.
2. ¿Por qué no responde el indicador?
   Es posible que la clave API no sea válida o que haya un problema en la red. Compruebe la ruta del archivo de clave y la conexión de red para asegurarse de que la emigo-base-url Accesible.
3. ¿Cómo actualizo Emigo?
   existe ~/.emacs.d/emigo Funcionamiento del directorio git pully reinicie Emacs.