Solicitar a ChatGPT Codex código de IronBarcode que compila
IronBarcode proporciona dos enumeraciones de codificación cuyo uso de mayúsculas difiere, BarcodeEncoding.Databar y BarcodeWriterEncoding.DataBar, y un modelo que recurre a su memoria las confunde. Un compilador detecta eso inmediatamente, lo que justifica usar un agente que compile el código que escribe. ChatGPT Codex trabaja dentro del repositorio, por lo que ejecuta dotnet build y lee el error por sí mismo. Las fallas más silenciosas cuestan más, como un lector configurado para buscar en todas las simbologías cuando cada etiqueta en el lote es Code 128.
Esa diferencia decide qué nivel ejecutar. Codex abarca la familia GPT-5.6, y /model alterna entre Sol, Terra y Luna dentro de una sesión interactiva. Un bucle de compilación y reescaneo en un conjunto de pruebas fijo es trabajo barato que Luna maneja a 5 créditos por cada millón de tokens de entrada, frente a 100 para Sol. Terra es el nivel medio con 50 créditos por millón de entrada y 300 por millón de salida, y es una opción predeterminada razonable una vez que un proyecto tiene más que un conjunto de pruebas. Reserve Sol, el buque insignia de la familia, para trabajos de diagnóstico más difíciles, como un lote de fotos de almacén que no se decodifica sin informar una causa.
IronBarcode lee y escribe tanto símbolos 1D como 2D a través de una API comercial de .NET. Codex resuelve algunas de estas tareas mejor que otras. Es bueno fijando la versión del paquete, creando un escritor de etiquetas y un escáner, leyendo códigos de barras de PDFs, corrigiendo imágenes que un lector rechaza, y migrando de otra biblioteca de códigos de barras, y cada una de esas tareas comienza con una solicitud.
Inicio rápidoInicie Codex desde un árbol de trabajo limpio en un proyecto de consola. Declare claramente el resultado deseado, cualquier restricción y la información que quiere que se informe.
$ironbarcode Add the BarCode package, then update Program.cs to read a scanned
multi-page TIFF and report every barcode it finds, page by page. Each line of output
should give the page number, the decoded value and the format. Use the license
key from IRONBARCODE_LICENSE_KEY.
Constraints: Use only documented IronBarcode APIs. Do not modify or use any
other packages.
Build the project, resolve any errors, and provide the diff alongside the
output from a sample file.
Una solución correcta es breve, porque BarcodeReader.Read recorre los fotogramas de un TIFF multipágina o GIF animado por sí solo, sin separación manual de fotogramas. Configurar ExpectMultipleBarcodes ayuda cuando un solo fotograma contiene varios símbolos, pero el lector alcanza cada fotograma de cualquier manera. La indicación es más larga que el código resultante, y solicitar la diferencia desde el principio le permite revisar los cambios reales en lugar de una descripción. Cada resultado lleva un PageNumber basado en 1, que proporciona la salida página por página que solicita la indicación, y la guía de GIF y TIFF multipágina cubre la lectura.
Flujo de trabajo mínimo en 5 pasos
- Descargue la biblioteca de códigos de barras C# desde NuGet
- Registre en el repositorio un archivo
AGENTS.mdespecificando IronBarcode como la biblioteca de códigos de barras del proyecto - Inicie Codex desde un árbol de trabajo limpio e incluya la simbología, los archivos y el resultado esperado de la lectura de verificación en la indicación
- Permita que Codex edite archivos y ejecute
dotnet build, luego revise la diferencia antes de aceptar cualquier cambio - Complete el ciclo de escritura y lectura y verifique cada nombre de API de IronBarcode contra la referencia de API
¿Cómo se ajusta Codex a un proyecto de códigos de barras .NET?
Dentro de los permisos que usted le otorgue, Codex lee y escribe archivos, ejecuta comandos de shell y muestra lo que hizo. OpenAI ofrece el mismo agente a través de varios puntos de entrada que comparten su cuenta e historial. La documentación de CLI de Codex y de la extensión del IDE explica cómo difieren.
| Superficie | Dónde se ejecuta | Utilícelo cuando |
|---|---|---|
| CLI | Terminal | El agente debe estar al lado de dotnet build |
| Extensión de IDE | VS Code, JetBrains, Xcode | Desea ver los cambios y la imagen del código de barras uno junto al otro |
| Aplicación de escritorio | macOS, Windows | Una tarea más larga, fuera del terminal |
| Nube | Navegador | Desea delegar y obtener los cambios más tarde |
Un AGENTS.md cubre los cuatro, porque se registra en el repositorio en lugar de vincularse a una interfaz.
Para instalar la CLI, ejecute npm install -g @openai/codex o, en macOS, brew install --cask codex. Para macOS y Linux, hay un instalador independiente disponible que no requiere Node.js: curl -fsSL https://chatgpt.com/codex/install.sh | sh. El repositorio de la CLI de Codex contiene el código fuente y las notas de la versión.
@openai/ al instalar. El paquete npm llamado codex es un generador de sitios estáticos no relacionado, publicado por primera vez en 2011 y actualizado por última vez en 2012. IronBarcode tiene la trampa opuesta, porque su paquete NuGet es BarCode, no IronBarcode. Los nombres exactos de los paquetes importan cuando un agente es quien escribe el comando.Codex no conoce de manera confiable la API actual de IronBarcode. Trabaja basado en sus datos de entrenamiento y en la documentación que le proporciona, y llamar a un método que una versión posterior eliminó es un error común con las bibliotecas de terceros. OpenAI construye Codex para ejecutar comandos y verificar su salida, aunque todavía aconseja revisar el trabajo antes de su publicación. La guía principal enumera la documentación a entregar a cualquiera de estas herramientas desde el principio. Cambie el nombre del archivo de contexto y el mismo proceso se aplica a Claude Code, GitHub Copilot, Cursor o Google Antigravity.
El nivel cambia tanto la forma del código como la factura. Una indicación ejecutada en dos niveles produce resultados estructurados de dos maneras diferentes, ambas defendibles. La codificación de códigos de barras tiene que ser lo opuesto, porque un valor entra y un símbolo sale que cada escáner lee de manera idéntica. Entonces, indique la simbología, el tamaño y la condición de aprobación, y deje que lo demás varíe.
Cuatro cosas se deducen de eso, y todas abogan por una biblioteca con mantenimiento en lugar de una creada por el agente:
- La validación se ejecuta en ambos lados: un valor no válido se rechaza en el momento de la escritura con una excepción nombrada como
IronBarCodeFormatOnlyAcceptsNumericValuesEncodingException, mientras queConfidenceThresholdyRemoveFalsePositivedescartan decodificaciones no confiables al regresar. - Los escaneos reales son la parte difícil: fotos de teléfonos, etiquetas inclinadas y PDFs multipágina necesitan regiones de recorte, preajustes de velocidad y filtros de imagen, todos disponibles en
BarcodeReaderOptions. - Una API cubre los formatos: Code 128, GS1-128, EAN, UPC, QR, DataMatrix, PDF417, Aztec, MaxiCode y más comparten las mismas llamadas de lectura y escritura, listadas en su totalidad bajo Formatos de código de barras soportados.
- Alguien la está parcheando: los proyectos populares de códigos de barras gratuitos no se mantienen, mientras que una biblioteca comercial tiene a alguien responsable, con correcciones publicadas en una página CVE de seguridad.
Un codificador casero dibujará alegremente un valor que su formato no puede contener según las reglas del formato, y cualquier biblioteca decodificará una imagen generada limpia. Verify es lo que distingue ambos casos: decodifica una imagen generada y la compara con el valor que escribió.
¿Qué hace efectiva una indicación de IronBarcode?
Respuestas específicas a seis preguntas. Las indicaciones vagas generan código genérico dirigido a una biblioteca que no existe, y las indicaciones específicas generan código que puede revisar en medio minuto.
| Componente | Débil | Fuerte |
|---|---|---|
| Framework | Hacer un código de barras | C#, .NET 9 |
| Ubicación | No declarada | Services/LabelService.cs |
| Versión | No declarada | La versión de BarCode en el .csproj |
| Simbología | Un código de barras | Code 128, el número de seguimiento |
| Salida | Un buen código de barras | PNG 400x120, valor abajo, se lee de manera idéntica |
| Límites | Ninguno | No hay nuevos paquetes. Lecturas asíncronas. Pregunte si no está seguro. |
Los modelos de lenguaje tienden a producir una respuesta en lugar de admitir incertidumbre. Dígale al agente que informar incertidumbre es un resultado aceptable, e inventará menos APIs. Dele permiso explícito para detenerse en lugar de adivinar.
Un AGENTS.md registrado en el repositorio rinde beneficios en todo el proyecto, porque Codex lo carga como instrucciones permanentes al inicio de cada sesión. El archivo raíz se lee primero y los archivos anidados después, y el archivo más cercano gana, por lo que un segundo AGENTS.md dentro de una carpeta de códigos de barras ajusta las reglas para esa carpeta sin tocar el resto del repositorio. /init genera un archivo de inicio si no tiene ninguno.
Incluya una referencia a la documentación legible por máquina de IronBarcode en el archivo. El archivo llms.txt enumera cada página de documentación con un resumen, y skill.md incluye los paquetes por plataforma, las reglas de licencia, los ejemplos desarrollados y los nombres de excepciones que esperar cuando algo falla.
Codex escanea .agents/skills en cada directorio desde su directorio de trabajo hasta la raíz del repositorio, por lo que skill.md tiene un hogar propio como .agents/skills/ironbarcode/SKILL.md. Codex compara una tarea con el campo description del frontmatter, y puede forzarlo con $ironbarcode cuando desee tener los ejemplos en contexto desde el primer turno. La misma carpeta funciona en Antigravity, que también lee esa ruta. Solicite ambos archivos y también el archivo anidado:
Run /init if AGENTS.md does not exist yet. Then add a Barcodes section to the
root AGENTS.md: IronBarcode (NuGet package BarCode, namespace IronBarCode) is
the only barcode library in this repository, and no competing package may be
added. https://ironsoftware.com/barcode/csharp/llms.txt gets read before any
barcode code gets written, and a member that does not appear there does not get
called. https://ironsoftware.com/barcode/csharp/skill.md belongs in
.agents/skills/ironbarcode/SKILL.md. The license key is read from the
IRONBARCODE_LICENSE_KEY environment variable and is never inlined.
Then add a second AGENTS.md under Services/ that narrows this to the reader
options this folder relies on, so the nested file wins there. Show me both files
as a diff before you commit anything.
¿Cómo pide a Codex que agregue IronBarcode y escriba un primer código de barras?
Deje que el agente maneje la configuración primero. Los errores de versión y nombre de paquete comienzan allí.
This project needs IronBarcode. Pull in the BarCode package, then show me the
resulting PackageReference line from the .csproj and tell me which version was
installed. Do not change any other package references.
Espere una diferencia de una línea y la versión que instaló. Conviene citar ese número en indicaciones posteriores, y permite detectar a un agente que agregó un paquete diferente con código de barras en su nombre. Para fijar una versión específica en su lugar, consulte el registro de cambios de IronBarcode.
IronBarcode no tiene modo de marca de agua. Pasado el periodo de gracia de desarrollo, una llamada no licenciada falla directamente con LicensingException. Establezca la clave al inicio, antes de cualquier otra llamada de IronBarcode, y deje que Codex lo agregue.
Wire up licensing. Nothing else in IronBarcode may run ahead of it, so it goes
wherever this project does its startup work, pulling the value out of
IRONBARCODE_LICENSE_KEY rather than carrying a key in source.
Prove it took by checking IronBarCode.License.IsLicensed, and tell me which file
you put the call in.
La documentación Claves de licencia de IronBarcode cubre las claves de prueba y todas las demás opciones de licencia, incluidas Web.config y appsettings.json.
A continuación, construya un servicio de etiquetas y un escáner. En sistemas reales, los códigos de barras se crean en un lugar y se leen en otro.
Two files, one job. Shipping labels go out as Code 128 PNGs at 400 by 120
with the tracking number printed under the bars, and something on the receiving
end has to turn that image back into the tracking number.
Put the writer in Services/ShippingLabelBarcode.cs and the reader in
Services/TrackingScanner.cs. The read is async and returns null rather than
throwing when the image holds nothing.
Compile, clear the errors, and report back with the changed files and whichever
BarCode version the restore resolved to.
Compruebe cada miembro en la diferencia con respecto a la referencia de API antes de aceptarla. Un escritor correcto se basa en BarcodeWriter.CreateBarcode, ResizeTo, AddBarcodeValueTextBelowBarcode, SetMargins y ToPngBinaryData, y un lector correcto en BarcodeReaderOptions y BarcodeReader.ReadAsync, con ExpectBarcodeTypes nombrando la simbología para que el lector deje de buscar en todos los formatos. Para imágenes de cámaras o escáneres en lugar de este servicio, la guía de corrección de imágenes explica los filtros que rescatan escaneos débiles.
¿Cómo se migra una implementación de código de barras existente a IronBarcode?
El trabajo de migración es repetitivo y mecánico, que es lo que los agentes hacen bien. Dirija la indicación al código real en lugar de resumirlo.
Hand this to the explorer agent, because nothing here should be written yet.
Labels/LegacyBarcodeService.cs currently writes and reads barcodes with another
library.
1. List every symbology it writes and reads, with the options it sets
(size, margins, text, check digits, error correction).
2. Map each call to its IronBarcode equivalent, citing the documentation page.
3. Do not write any code yet. Wait for my approval on the plan.
Una implementación de 400 líneas requiere una revisión línea por línea, mientras que un error en una tabla de correspondencias cuesta una corrección única y ningún código descartado.
Una vez que apruebe el plan, la siguiente indicación mantiene un alcance acotado.
Put the worker agent on the approved plan. Rewrite LegacyBarcodeService.cs to
use IronBarcode, keeping the existing public method signatures so callers do
not change.
Before removing the old library, generate every symbology the service
supports with both implementations and confirm IronBarcode reads back the
same values. Leave the old library in Git history only. Build and report the diff.
Indique en la indicación que las firmas de los métodos públicos no deben cambiar. Sin esa instrucción, un agente a menudo rediseñará cómo los consumidores usan el servicio, lo que convierte una migración en una refactorización. Generar cada simbología con ambas implementaciones y comparar los valores decodificados le da una prueba de regresión, y cuesta un ciclo de compilación y ejecución adicional.
¿Cómo se arreglan los escaneos que no se leen mediante indicaciones?
Una lectura fallida es un problema visual, y el agente no tiene vista de la cámara. Su indicación debe describir el problema, o mejor, incluir las imágenes.
TrackingScanner finds nothing in TestData/warehouse/, yet a warehouse operator
can point a handheld at the same printed label and get a read. The photos are
shot at an angle and a few are soft. I have attached one of the failing photos
with `codex -i`, so look at it rather than reasoning from the file names.
Read TrackingScanner.cs and a sample of the images. Explain the likely cause
before changing anything, then adjust BarcodeReaderOptions only (speed, crop
area, image filters). Do not change ShippingLabelBarcode.cs. Report how many
images read before and after.
Indicar el síntoma y nombrar el único archivo a editar mantiene la solución contenida. Un recuento antes y después reemplaza una vaga sensación de mejora con un número. La solución suele ser una de tres: Speed elevada a Detailed, un CropArea dibujado alrededor de la etiqueta, o un solo filtro de imagen elegido para el defecto real. Apilar filtros empeora la precisión, no la mejora. Los detalles están en las páginas de velocidad de lectura y región de recorte.
Los falsos positivos son el problema inverso. Manéjelos de la misma manera.
ScanService occasionally returns a value from product photos that contain no
barcode. Set RemoveFalsePositive and a ConfidenceThreshold on the reader options,
then link me to the documentation page you used.
El enlace de documentación también sirve de verificación. Un agente que no puede citar una página real para la API que eligió le ha advertido antes de que la compilación lo haga. Las opciones de lectura son fáciles de inventar, así que mantenga cerca la guía de falsos positivos.
¿Cómo se depura una falla de código de barras de extremo a extremo?
Cada indicación anterior cubre una tarea. Codex hace más cuando le entrega un síntoma y lo deja inspeccionar, diagnosticar, solucionar y probar por su cuenta.
Switch to Sol with /model before you start, because this one has resisted the
cheaper tiers. DataMatrix labels with non-English product names are refused by
some of our older handheld scanners, while labels with plain ASCII names read
fine on the same devices, and every label reads correctly with IronBarcode
itself.
Investigate:
1. Read LabelService.cs and find how the DataMatrix codes are created.
2. Identify why the non-English labels fail on those scanners only.
3. Explain the cause before changing anything.
4. Then propose the minimal fix, and what it costs, before applying it.
Preguntar por la causa primero le da un diagnóstico para juzgar, en lugar de un cambio que tenga que interpretar después. Aquí la causa probable es el encabezado UTF-8 ECI. IronBarcode escribe ese encabezado solo cuando el texto lleva caracteres no ASCII, y los escáneres construidos antes de que existiera ECI rechazan un símbolo que lo tiene. Desactivar el encabezado rompe el texto UTF-8 en los escáneres que sí admiten ECI, por lo que hay un compromiso real entre ambas opciones. La versión 2026.9.2 agregó EciMode para controlarlo, como describe la guía de codificación ECI.
Trate los mensajes de error de la misma manera. Un rastreo de pila completo es la entrada más útil que puede darle a un agente.
TrackingScanner.ReadTrackingNumberAsync throws inside our Linux container. The
identical call succeeds on a Windows developer machine.
[PASTE FULL EXCEPTION AND STACK TRACE HERE]
Send the explorer subagent over the .csproj and the Dockerfile before changing
anything, and tell me which BarCode package we actually reference and what the
image is missing, quoting the line from each file that shows it.
Then give me the fix as a diff limited to those two files. Application code is
out of scope for this one.
Las fallas dentro de contenedores generalmente provienen del paquete de plataforma o de una dependencia nativa faltante. Esas correcciones pertenecen al archivo del proyecto y al Dockerfile, no al código C#. Deje que Codex lea Ejecutar IronBarcode en Docker en Linux para obtener orientación actualizada de implementación antes de que cambie nada.
¿Cómo convierte el código creado para una tarea puntual en componentes reutilizables y probados?
Cuando el ciclo de escritura y lectura funciona, generalícelo a continuación. Los agentes manejan esto bien porque el patrón ya existe en el archivo.
Refactor ShippingLabelBarcode and TrackingScanner into a BarcodeService
registered with dependency injection. It should write any of Code 128, QR,
and DataMatrix, and read with options narrowed to the formats requested.
Reuse one BarcodeReaderOptions instance per format set rather than building
one per call. Add XML doc comments. Keep it under 80 lines.
La instrucción para reutilizar opciones pertenece a AGENTS.md. En un servicio de escaneo con mucha actividad, construir un objeto de opciones nuevo por solicitud supone una asignación de memoria en cada escaneo.
Las pruebas vienen a continuación. Un código de barras o bien se decodifica de vuelta al valor que escribió o no, lo que mantiene las aserciones simples.
This is a rebuild-and-rerun loop rather than a reasoning problem, so drop to
Luna with /model first. Cover BarcodeService with xUnit tests, then run them and
tell me the pass count.
Four behaviors need covering. A sample value survives a write and a read on
every format the service supports. EAN-13 rejects a value containing letters.
An image holding no barcode comes back empty instead of throwing. A path that
does not exist throws something a caller can read.
Never assert on image bytes. Decoded value and format are the only outputs
worth pinning.
Evitar comparaciones de bytes desde el principio previene pruebas poco fiables. Los codificadores pueden producir bytes de imagen ligeramente diferentes a través de versiones y plataformas, incluso si el código de barras permanece sin cambios. En su lugar, pruebe el valor y formato decodificado.
Codex también es útil para leer la documentación por sí misma. Cuando nombre una clase desconocida, localice la parte relevante de la referencia de API en lugar de dejarlo desplazarse a través de la página completa.
$ironbarcode Read the IronBarcode API reference for BarcodeReaderOptions and
list every option that affects reading speed or accuracy, then show which ones
this project already sets.
¿Qué patrón de indicación se ajusta a qué tarea?
Cada indicación anterior nombra algo concreto y pide algo verificable a cambio.
| Tarea | Qué especificar en la indicación | Qué solicitar como resultado |
|---|---|---|
| Paquete | BarCode, la versión, nada más | La línea PackageReference |
| Clave de licencia | IRONBARCODE_LICENSE_KEY, ruta de inicio | License.IsLicensed verdadero |
| Escritor y lector | Simbología, ambas rutas, tamaño de imagen | Dos archivos que compilan |
| Migración | Archivo heredado, firmas para mantener | Una tabla de asignación, antes del código |
| Escaneos fallidos | Carpeta de imágenes, solo opciones de lector | Recuento de lectura antes y después |
| Falsos positivos | RemoveFalsePositive, ConfidenceThreshold | La página que citó |
| Fallo de contenedor | Rastreo de pila, plataforma, dos archivos | Una diferencia, .csproj y Dockerfile |
| Refactorizar | Formatos, estructura de inyección de dependencias, límite de líneas | Una instancia de opciones por formato |
| Pruebas | Cuatro comportamientos, sin aserciones sobre bytes | El recuento de pruebas aprobadas |
¿Cómo reutiliza estas indicaciones en el próximo proyecto?
Cada patrón se traslada a un nuevo proyecto con solo los nombres de archivo cambiados, por lo que las reglas pertenecen al control de versiones y no a un historial de chat.
Para medir una sesión en lugar de confiar en ella, la guía de asistentes y agentes de codificación AI asigna una tarea a un agente y califica lo que regresa.
Solución de problemas
- Aplicar una clave de licencia en IronBarcode cuando una diferencia se ve correcta y la ejecución aún falla.
- Código de barras no reconocido cuando el escáner que Codex escribió no devuelve nada para las imágenes que deberían leerse.
- Evitar falsos positivos en el escaneo de códigos de barras cuando los valores regresan de fotos que no contienen ningún código de barras.
- Ejecutar IronBarcode en Docker en Linux cuando el mismo código pasa en Windows y falla en el contenedor.
¿Preguntas?
Si tiene alguna pregunta, contacte a support@ironsoftware.com
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.