Fast Extension for VS Code

Fast es una extensión para Visual Studio Code diseñada para agilizar la creación, modificación y gestión de archivos en proyectos de desarrollo mediante comandos en JSON y una estructura de automatización. Incluye herramientas de generación de archivos y comandos de modificación directa, lo que permite una integración fluida con IA para la ejecución de cambios.

Características

• Automatización de Archivos: Genera, modifica o elimina archivos automáticamente en función de comandos JSON.
• Comandos Directos de Modificación: Ejecuta comandos específicos como createOrUpdateFile y deleteFile en archivos definidos.
• Interfaz en el Explorador: Agrega una sección dedicada en la barra de actividad de VS Code para acceder a los comandos de Fast de forma directa:
  • Abrir Editor JSON para Plantilla: Acceso directo para abrir el archivo fast_template.json.
  • Generar Archivos desde JSON: Ejecuta la plantilla JSON y genera archivos de acuerdo con la estructura.
  • Ejecutar Comando Fast: Ejecuta comandos directos en el archivo fast_template.json.

Instalación

1. Instalar la extensión: Si tienes el archivo .vsix, instálalo en VS Code mediante Extensiones > ... > Instalar desde VSIX.
2. Configura el archivo de plantilla: La extensión utiliza el archivo fast_template.json, que se guarda en la carpeta .vscode del proyecto. Este archivo debe contener la estructura de archivos y comandos a ejecutar.

Estructura de Comandos JSON

Para realizar cambios a través de IA o manualmente, utiliza la siguiente estructura JSON para enviar y recibir comandos que la extensión puede interpretar:

Estructura JSON de Fast

{
  "commands": [
    {
      "action": "createOrUpdateFile",
      "path": "src/components/Home.js",
      "content": [
        "import React from 'react';",
        "",
        "function Home() {",
        "  return <div>Welcome to the Home Page</div>;",
        "}",
        "",
        "export default Home;"
      ]
    }
  ]
}

Acciones Disponibles

• createOrUpdateFile: Crea o actualiza el archivo especificado en "path", con el contenido detallado en "content".
• deleteFile: Elimina el archivo especificado en "path" del proyecto.

Cómo Interactuar con la IA Usando Fast

Para optimizar el uso de la extensión con inteligencia artificial, recomendamos usar prompts específicos que sigan esta estructura y permitan a la IA entender el contexto:

1. Usa la Estructura JSON de Comandos: Solicita a la IA que proporcione los cambios en un JSON estructurado, incluyendo solo los comandos necesarios. Esto permite copiar y ejecutar los cambios directamente en Fast sin perder el contexto.

   • Ejemplo de prompt:
     "Por favor, añade una función calculateSum en src/utils/helper.js que reciba dos números y devuelva su suma. Proporcióname el comando en formato JSON para Fast, sin incluir archivos que no tengan cambios."

2. Recomendación de Respuesta para IA: La IA debe responder únicamente con los comandos JSON necesarios, respetando la estructura de "commands". La extensión Fast interpretará y aplicará estos cambios automáticamente.

3. Ejemplo de Respuesta de la IA:

   {
     "commands": [
       {
         "action": "createOrUpdateFile",
         "path": "src/utils/helper.js",
         "content": [
           "export function calculateSum(a, b) {",
           "  return a + b;",
           "}"
         ]
       }
     ]
   }
   

Uso Básico de Fast

1. Abrir el Editor JSON: Selecciona Abrir Editor JSON para Plantilla para ver o modificar el archivo fast_template.json.
2. Ejecutar el JSON: Una vez configurado el archivo, utiliza Generar Archivos desde JSON para crear los archivos según la plantilla.
3. Ejecutar Comandos Específicos: Usa Ejecutar Comando Fast para aplicar comandos individuales definidos en el archivo de comandos, modificando o eliminando archivos según sea necesario.

Recomendaciones para la Estructura de Prompts y Uso de la IA

Para obtener respuestas adecuadas de la IA:

• Solicita comandos específicos en formato JSON para Fast.
• Asegúrate de que cada comando JSON incluya solo los archivos y cambios necesarios.
• Explica claramente el tipo de cambio: creación, actualización o eliminación de archivos.
• Menciona que la respuesta de la IA debe estar en la estructura "commands" para que Fast interprete y ejecute automáticamente.

Contribuciones de Configuración

La extensión agrega las siguientes configuraciones:

• fast.enableLogging: Activa el modo de registro para ver mensajes de desarrollo en la consola.
• fast.templatePath: Permite especificar la ubicación del archivo de plantilla JSON (fast_template.json) en el proyecto.

Notas de Lanzamiento

Nuevas Características (v0.0.5)

Sistema de Contextos

• Guardado de Contextos: Guarda conjuntos de archivos como contextos reutilizables
• Carga de Contextos: Recupera fácilmente grupos de archivos relacionados
• Gestión de Múltiples Contextos: Organiza y administra diferentes conjuntos de archivos

Vista de Diferencias

• Comparación Visual: Ve las diferencias entre archivos locales y template
• Sincronización Bidireccional: Actualiza archivos en ambas direcciones
• Resaltado de Cambios: Identificación clara de modificaciones

Mejoras en la Interfaz

• Nueva Vista de Árbol: Organización mejorada de archivos marcados
• Iconos Informativos: Mejor feedback visual sobre el estado de los archivos
• Tooltips Detallados: Información contextual sobre acciones disponibles

Comandos Avanzados

• Marcado de carpetas completas
• Generación individual de archivos desde template
• Limpieza de contenido del template
• Actualización directa desde archivos locales

Gestión Mejorada

• Persistencia de Archivos: Mantiene el estado de archivos marcados
• Sincronización Automática: Actualización automática entre local y template
• Sistema de Logging: Mejor seguimiento y depuración

Uso Avanzado

Versión 0.0.4 - Mejoras y Depuración

• Exportación Arbol de Archivos: Se agrega la funcionalidad para exportar el arbol de archivos

Versión 0.0.3 - Mejoras y Depuración

• Exportación Arbol de Archivos: Se agrega la funcionalidad para exportar el arbol de archivos

Versión 0.0.2 - Mejoras y Depuración

• corrección bugs: Se arreglo el comando que genera la estructura de todo el proyecto

Versión 0.1.0 - Prelanzamiento

• Funcionalidad Básica: Incluye generación de archivos, comandos de creación y modificación.
• Interfaz Integrada: Acceso directo a los comandos desde la barra lateral.
• Documentación y Estructura de Prompts para IA: Guía para maximizar el uso de la extensión con IA en VS Code.

Disfruta usando Fast para simplificar y agilizar tu flujo de trabajo en Visual Studio Code!