Reconstrucción y Dibujo de Figuras Científicas
Una habilidad independiente y neutral respecto al proveedor. El host anfitrión decide qué dibujar; el motor ejecuta la geometría, pinturas, capas, ediciones y exportación declarados. Entregar SVG más un PNG renderizado a partir de ese SVG. Usar el entorno de Anaconda ScientificFigure_skill y la CLI instalada figure-cli.
Guía 0.10: dos tareas, un host y una Escena
El motor actual 0.10.0 añade control de calidad de diseño determinista (layout-audit), reparaciones de diseño acotadas (--fix) y una verificación previa del perfil de fuentes sobre la base de la versión 0.9. FigurePlan 0.1 y Scene 0.3 no han cambiado, y la base de ejecución, edición y renderizado 0.8 se mantiene. El host anfitrión ya es el modelo que realiza la interpretación y revisión visual; no añadir un segundo modelo o Agente. Ver el plan 0.10 y el contrato QA; el plan 0.9, las capacidades 0.8 y el workflow de planificación semántica / nueva CLI siguen vigentes para todo lo que sigue. La página del workflow define los puntos de entrada implementados y los contratos de archivo exactos; las notas de entrega registran la verificación real y las limitaciones.
Elegir la guía de tarea antes de construir una figura compleja:
- Reconstrucción a partir de referencia: leer reconstrucción-desde-referencia. Establecer la estructura de información y el orden de lectura, las partes esenciales, las relaciones y las incógnitas específicas antes de la geometría. Separar entidades, flechas de proceso, guías de anotación, vistas ampliadas, leyendas y decoración. No rellenar regiones ilegibles con conocimiento del tema.
- Diseño a partir de lenguaje natural: leer diseño-desde-texto. Separar el contenido explícito del usuario, las decisiones de diseño y las suposiciones científicas. Diseñar la jerarquía en torno al mecanismo solicitado; no inventar condiciones de preparación, administración o experimentales.
- Ambas tareas: usar selección-de-construcción cuando el método sea incierto. Elegir según la forma requerida, las partes, la repetición, los agujeros, la oclusión y el estilo, luego comparar los recursos reales disponibles. Un objeto plano simple puede pasar directamente de una nota breve de intención/incógnita a la geometría y la vista previa; no se requiere búsqueda obligatoria ni múltiples archivos de planificación.
Trabajar de forma autónoma por defecto; pausar solo cuando se solicite
| Modo | Cuándo empezar | Comportamiento del host |
|---|---|---|
autónomo (por defecto) | el usuario pide la figura o dice que la termine | dibujar, inspeccionar, corregir y entregar; no pausar para aprobación en cada paso |
interactivo | el usuario pide ver una muestra, confirmar cada página o participar | publicar el punto de control acordado y esperar comentarios o aprobación |
- Abrir una página de revisión no fuerza una pausa. En modo autónomo, leer los nuevos comentarios en el siguiente punto de control seguro; si el usuario pide detenerse, dejar de publicar candidatos y procesar sus ediciones primero.
- En modo interactivo, terminar y publicar la primera página acordada, esperar, luego continuar. Para trabajo de varias páginas, la primera página aprobada fija la tipografía, el espaciado, el estilo de tarjeta y la paleta comunes; las páginas posteriores comparten esas reglas, no un diseño idéntico forzado.
- Un host que no pueda leer imágenes puede usar comprobaciones geométricas y estructurales, pero debe dejar la revisión visual como
no_ejecutada. - Aprobar una versión de SVG no es una revisión científica y no aprueba una versión posterior.
Por defecto: entender, seleccionar, construir, inspeccionar, corregir
- Declarar el propósito, el tamaño de visualización previsto, los módulos y el orden de lectura. Listar objetos, partes internas indispensables, unidades editables, etiquetas, significados de colores y relaciones. Mantener el contenido no resuelto explícito. Para una figura compleja, hacer este borrador inspeccionable antes de escribir geometría extensa. Usar los módulos/objetos/relaciones de FigurePlan existentes cuando sea útil; las construcciones no seleccionadas pueden permanecer como
no_resueltas. Estas son etapas de una entrada de planificación, no otro árbol de Escena. - Hacer solo las preguntas locales que afecten una decisión: por ejemplo, si un área pálida es una abertura o una superficie, o dónde termina una guía. Inspeccionar el original y los recortes relevantes; usar solo evidencia vinculada a la fuente según sea necesario. Preservar el ROI y las asignaciones de coordenadas. Las mediciones y las puntuaciones de similitud son observaciones, no identidades de objetos ni confianza científica; no hay OCR implícito.
- Elegir receta/activo/directo/programa según la estructura y el estilo. Verificar los parámetros reales de la Receta y las claves de partes editables, o los derechos del activo y los límites de importación. El catálogo tiene 15 familias de Recetas, dos entradas de metadatos de familias de símbolos y un activo de limón Twemoji; no inventar recetas de ratón/matraz/avatar. Si una Receta omite partes requeridas, rechazar esa construcción y recurrir a un programa libre, combinando opcionalmente subpartes adecuadas. Usar coordenadas locales, curvas, transformaciones, funciones de dibujo existentes y bibliotecas maduras. Scene directo, Plan semántico heredado 0.3 y
SceneBuildersiguen siendo válidos; no requerir un JSON grande escrito a mano antes de dibujar. - Construir primero la estructura principal y los componentes internos requeridos, luego los conectores y las etiquetas. Preservar IDs de objetos/partes estables. Usar superficies rellenas, trazos, agujeros reales, máscaras/oclusión acotadas, repetición y degradados según corresponda; no añadir iluminación volumétrica a arte plano. El host ejecuta explícitamente los programas a través de herramientas ordinarias y suministra fragmentos de Escena generados; la verificación/compilación y la carga de proyectos no ejecutan código fuente guardado. Mantener los nuevos candidatos separados de un proyecto editado y usar fusión B/U/C antes de la aceptación.
- Leer el
preview.pngreal en el tamaño de visualización previsto e inspeccionar las regiones ampliadas clave. Verificar módulos y conexiones → silueta/proporciones/agujeros → estructura interna necesaria → colores/capas → texto. Comparar la referencia a la misma escala; al reemplazar un dibujo anterior, comparar referencia/antiguo/nuevo juntos. Un plan válido, una ruta con nombre o una prueba que pase no establecen que la estructura prevista se haya dibujado correctamente. - Vincular cada hallazgo a un ID y una acción concreta: cambiar el método de construcción, reemplazar un candidato, ajustar geometría/parámetros, obtener evidencia local o retener la incertidumbre. Parchear contra la revisión actual o regenerar un candidato y fusionar; renderizar e inspeccionar de nuevo. Por defecto, un máximo de tres rondas de corrección dirigida. Preservar los objetos aceptados y las ediciones del usuario. Vincular la evaluación visual a la Escena/vista previa actual; la geometría, los recursos o el renderizado cambiados invalidan las evaluaciones anteriores. Reportar omisiones y revisiones no ejecutadas. La revisión científica sigue siendo separada y no se ejecuta si no se solicita.
El éxito significa una figura bien dibujada, estructuralmente clara y con partes principales editables de forma independiente. Las pruebas establecen el comportamiento de la ingeniería, no la calidad del dibujo. Las ablaciones de host independiente, las campañas de benchmark retenidas, los paneles humanos, la certificación del dominio, la integración en tiempo de ejecución, la migración de plantillas entre versiones y el desarrollo experimental de desplazamiento/ancho variable están fuera del alcance del trabajo actual. No convertirlos en requisitos previos o tareas siguientes no solicitadas. Reportar la reutilización real por separado como arte externo, reutilización de código de dibujo y reutilización de bibliotecas de geometría/renderizado; tener un activo en el Registro no significa que este dibujo lo haya usado.
El host puede escribir programas de dibujo en Python o JavaScript. Usar variables ordinarias, funciones, coordenadas locales, transformaciones, repetición y bibliotecas de geometría maduras para calcular formas; usar ayudantes de motor estables cuando estén disponibles. Un programa de dibujo específico para la figura está permitido; no convertir unas pocas figuras de referencia en algoritmos de motor específicos del tema ni tratar los planes de ejemplo como una biblioteca de plantillas científicas. Enviar candidatos de Escena/Plan generados a través de la validación del motor, el renderizado y las transacciones del proyecto. Al volver a ejecutar contra un proyecto editado, comparar la última línea base generada, la Escena actual y el nuevo candidato antes de aceptar los cambios; preservar las ediciones del usuario y reportar conflictos. Usar los ayudantes de construcción y el protocolo de generación disponibles: generation diff PROJECT --candidate SOURCE --output DIFF, inspeccionar la vista previa propuesta y los conflictos, luego generation accept PROJECT --candidate DIFF --base-revision N. El código fuente guardado es inerte; aceptar recalcula la fusión y verifica la revisión/contenido/recibo actual. Nunca sobrescribir un proyecto editado con la salida pura de un script. No incrustar imágenes rasterizadas, trazar cada textura en pequeños caminos, ni reemplazar la estructura faltante con un relleno atractivo.
Elegir entre la reconstrucción a partir de la referencia suministrada y la reutilización de recursos permitida antes de dibujar. Divulgar por separado: arte externo (fuente, licencia, versión/hash y modificaciones); código de dibujo reutilizado, incluyendo sus propias funciones (archivo/versión, partes reutilizadas y cambios); y bibliotecas de geometría/renderizado (biblioteca/versión real y función). Una función escrita localmente no es un activo externo, y una llamada a biblioteca no es arte prestado. Registrar la inspiración del método por separado del código copiado; el código externo copiado necesita su revisión de fuente fija, archivos, licencia y avisos. Para una comparación rasterizada explícitamente congelada, nunca sustituir un SVG fuente oficial. Inspeccionar la estructura principal, geometría/agujeros/oclusión, luego estilo/texto en las vistas previas reales dentro del mismo presupuesto de corrección. Los parches de cobertura de color de fondo no establecen agujeros reales o entrelazado editable. Las fuentes del programa son entradas de reproducibilidad; la Escena aceptada es la única autoridad editable actual. Abrir un proyecto o paquete no debe ejecutar un programa de dibujo.
Ejecutar con archivos, sin un servicio de modelo
conda run -n ScientificFigure_skill figure-cli doctor --json
Usar inspect reference.png para tamaño/hash de la fuente. Los planes vinculados a la fuente declaran SHA-256, tamaño y ROI. La ejecución semántica del Plan heredado 0.3 no ejecuta implícitamente segmentación de color, búsqueda de píxeles candidatos ni análisis de esqueleto. Las entradas antiguas del Plan 0.1/0.2 conservan su comportamiento.
conda run -n ScientificFigure_skill figure-cli reconstruct reference.png --plan plan.json --output work/figure
Bucle de vista previa del borrador y tiempos de etapa
draw y reconstruct aceptan --preview: escribe solo figure.svg, preview.png y preview.json, renderiza a escala 1 a menos que --scale indique lo contrario, y puede reemplazar su propia vista previa anterior. No es un proyecto ni un entregable (sin recibo, manifiesto de objetos, registro de QA, vinculación de revisión ni comparación de referencia), así que usarlo para la primera inspección y para cada ronda de corrección, luego ejecutar el mismo comando sin --preview una vez que la estructura sea correcta.
conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview
Ambas rutas devuelven timings en segundos: validate, to_svg, render, inventory, qa, publish, total; una vista previa omite las etapas de entrega y el recibo registra las mismas etapas previas a la publicación. En este host, una Escena de 501 objetos toma aproximadamente 0.33 s como vista previa y 1.16 s como proyecto completo, siendo la mayor parte de la diferencia el renderizado PNG a escala 1 versus 3. El motor no puede ver el tiempo del lado del modelo: al medir una reconstrucción, registrar la primera inferencia del host, los tokens de salida y las rondas de corrección junto a estos números, y nunca atribuir segundos del motor a la latencia del modelo o viceversa.
Verificar texto y fuentes antes de la construcción compleja
Recopilar todas las cadenas que dibujará la figura (etiquetas, fórmulas, unidades, texto de ejes, leyendas) en una sola solicitud y ejecutar esto antes de la geometría:
{"schema_version": "0.1", "texts": ["Membrana celular", "H₂O → O₂", "细胞膜"]}
conda run -n ScientificFigure_skill figure-cli font-probe texts.json --output work/fonts
status: ok selecciona una fuente local real y escribe font-probe.json más font-probe-sample.png; needs_input lista los caracteres faltantes y la cobertura por tipo de letra. --font PATH añade un archivo específico. --profile (nombre por defecto scientific-default) además resuelve la recomendación empaquetada (Times New Roman / Microsoft YaHei / Cambria Math) contra las fuentes instaladas e informa la ruta, tipo de letra, digest y caracteres de muestra faltantes de cada función; una familia ausente se informa como faltante, nunca se sustituye. El motor renderiza una familia, por lo que no se debe afirmar un reemplazo de fuentes mixto: establecer SCIENTIFIC_FIGURE_FONT a la ruta seleccionada manualmente, o simplificar el texto. Para varias páginas, sondear la unión de todas las páginas una vez, antes de la página 1. Un glifo faltante es una decisión de construcción, no un error de exportación de último momento.
Mostrar la figura mientras se dibuja
conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview
conda run -n ScientificFigure_skill figure-cli review-serve work/quick --open
conda run -n ScientificFigure_skill figure-cli review-status work/quick-review
review-serve sirve el figure.svg más reciente publicado correctamente en 127.0.0.1 con un token aleatorio e imprime la URL antes de bloquear. La página mantiene el zoom, el desplazamiento y los pines no enviados entre recargas, y permite al usuario fijar un comentario en un ID de objeto o espacio vacío. review-status lee el registro de comentarios. Añadir --wait --timeout N para bloquear hasta que llegue una nueva ronda; sin él, detener con Ctrl-C. El servidor solo lee la figura y escribe comentarios; nunca edita el proyecto.
Los comentarios se almacenan en <preview>-review/feedback.json, fuera del directorio de vista previa reemplazable, y cada envío está vinculado al SHA256 y la revisión del SVG que se mostraron. Un envío de una versión anterior se rechaza con HTTP 409, nunca se aplica en silencio. Aplicar los comentarios aceptados mediante un parche normal o una fusión de generación, luego publicar una nueva vista previa. La página local es un recurso de respaldo del navegador; no crea una barra lateral de VS Code, y un host integrado debe tratar los comentarios como este archivo versionado.
Entregar SVGs solo gráficos y finales
conda run -n ScientificFigure_skill figure-cli export-variants work/figure --output deliverables/figure
Esto lee un proyecto validado y escribe figure.final.svg más figure.graphics.svg (sin texto) y variants.json. Ambos provienen de la misma Escena, por lo que los IDs compartidos mantienen geometría y estilo idénticos; nada se redibuja. Texto