Manual · 9
El asistente de IA
El asistente es un panel de chat que responde sobre tu código, el TIA, el 6502 y los formatos de cartucho. Es opcional y está desactivado hasta que lo actives. Con un modelo que se ejecuta en tu ordenador, nada sale de tu máquina.
Actívalo en la pregunta del primer arranque o en Ajustes → Asistente. Mientras no configures un modelo, no se envía nada a ningún sitio y no se instala nada.
Elegir un modelo
VCSIDE incluye un ayudante, el llama-server de llama.cpp, que ejecuta un modelo en este ordenador. La lista Modelo incluido recomienda uno que cabe en tu memoria. Confirmas la descarga una sola vez y el archivo se comprueba con una suma de verificación fija. También puedes elegir un archivo .gguf que ya tengas.
- Detectar servidores locales busca llama.cpp (puertos 8080 y 9931), Ollama y LM Studio que ya estén en marcha.
- Con Añadir un servicio... puedes usar cualquier dirección compatible con OpenAI.
- Los servicios remotos (Gemini, Anthropic, OpenAI, OpenRouter o un servidor compatible) funcionan por ahora solo en macOS.
- El desplegable de la cabecera del chat cambia entre los servicios que tengas configurados.
El ayudante es llama.cpp, de Georgi Gerganov y colaboradores.
Preguntar
Pregunta sobre tu código o sobre la 2600. Una pastilla sobre el cuadro de texto muestra lo que acompaña a tu pregunta: el archivo abierto o las líneas seleccionadas, y los errores de compilación. Quita una pastilla con su cruz. @ añade archivos y carpetas.
- Los nombres que VCSIDE conoce en tu pregunta (registros, instrucciones, formatos de cartucho) se buscan en su referencia y se dan al modelo; sus identificadores aparecen después de la respuesta.
- Las partes del proyecto que coinciden con tu pregunta van junto con un mapa de sus archivos, para que pueda responder sobre código que no está abierto. Ver la petición muestra exactamente lo que se envió.
- Los registros y las instrucciones de una respuesta enlazan con el panel de Documentación. Un nombre que no está ni en la referencia ni en tus archivos se marca: puede que el modelo se lo haya inventado.
La búsqueda por significado es opcional: activa Buscar en el proyecto por significado y descarga un modelo pequeño. Sin ella, el proyecto se busca por palabras clave.
Preguntar y Agente
Un interruptor del panel elige el modo.
- Preguntar responde y propone cambios en el chat. Tú revisas cada uno y lo aplicas.
- Agente lee tu proyecto, consulta la referencia, describe archivos de gráficos y de música, y propone los cambios él mismo.
Los modelos locales pequeños trabajan solo en modo Preguntar. Si sabes que un modelo es lo bastante bueno, sus ajustes pueden permitirle Agente. El agente solo ve la carpeta del proyecto, y nunca lee archivos que puedan guardar secretos.
Revisar los cambios
Un cambio muestra primero su lugar y un diff. No se escribe nada hasta que haces clic en Aplicar o Descartar, y un archivo que ha cambiado entretanto nunca se sobrescribe. Un cambio aplicado es un solo paso de deshacer en el editor. Deshacer todo lo que cambió esta conversación restaura todos los archivos que tocó el asistente.
En modo Agente, compilar y ejecutar el juego se pregunta antes: Permitir una vez o Permitir en esta sesión. Los cambios en un Makefile o en un .vcsproj se preguntan cada vez.
Explicar errores
Con Explicar errores activado, el panel muestra Explicar los errores cuando la última compilación ha fallado. Cada fila de Problemas tiene Explicar este error en su menú contextual.
Chats, modelos remotos y claves
- Los chats son pestañas. Se abren de nuevo con su servicio y su modelo. Ellos y el índice de búsqueda del proyecto viven en la carpeta de datos de VCSIDE, no en tu proyecto. Nuevo chat abre otro.
- Un
VCSIDE.mden el proyecto guarda notas que el asistente lee primero. Todas las plantillas llevan uno. - Un servicio remoto se marca como remoto. VCSIDE pregunta antes de enviarle el primer mensaje, y un presupuesto de tokens lo detiene al alcanzarse.
- Las claves de API se guardan en el almacén de secretos del sistema (el Llavero en macOS). Si lo prefieres, un ajuste las guarda en un fichero que solo puedes leer tú, y que el sistema no vigila.