jlc-cli

¿Qué hace jlc-cli?

Opera el sitio chino de JLC (嘉立创, jlc.com) a través de una CLI de negocio. Este es un proyecto comunitario no oficial, sin respaldo de JLC. Los flujos normales se ejecutan mediante comandos; solo cuando el comando devuelve un estado de "pendiente de intervención" se debe operar la página CDP que mantiene.

Verificación de instalación

Antes de ejecutar cualquier comando de negocio, primero ejecuta jlc-cli --version y, si tiene éxito, luego jlc-cli --help. La instalación de este Skill no instala automáticamente la CLI.

Si aparece un error de "comando no encontrado" (command not found / no reconocido), informa al usuario de que la CLI no está instalada o no está en el PATH, y proporciona el repositorio del proyecto e instrucciones de instalación. Actualmente no está publicado en npm; no instales paquetes de terceros con el mismo nombre. Prepara Node.js 22.12 o superior, npm, Git y Google Chrome, luego instala desde el código fuente:

git clone https://github.com/TXyy2023/jlc-cli.git
cd jlc-cli
npm ci
npm run build
npm pack
npm install -g ./jlc-com-cli-1.0.0-dev.1.tgz
jlc-cli --version
jlc-cli --help

El nombre del paquete corresponde a la versión de desarrollo actual; cuando cambie la versión, usa el nombre de archivo real generado por npm pack. Si ya existe un directorio de código fuente, verifica la ruta primero y no sobrescribas el directorio del usuario. Después de la instalación, vuelve a verificar la versión y la ayuda, y luego continúa con la tarea original. Si el comando existe pero falla al iniciar, reporta el error real y verifica la versión de Node.js y el PATH; no trates un fallo de inicio como si no estuviera instalado y no reinstales ciegamente.

Comenzar

Después de completar la verificación de instalación, ejecuta jlc-cli browser doctor --json para comprobar la disponibilidad del navegador. jlc-cli skill path devuelve el Skill incluido con esta CLI; prioriza el uso de la documentación de la misma versión.

En el primer uso, presenta al humano el alcance de inicialización devuelto por jlc-cli init --json, y solo después de obtener un consentimiento explícito ejecuta jlc-cli init --accept --confirmed-by human; también puede ser ejecutado de forma interactiva por el humano. Luego configura el navegador, inicia sesión y verifica auth status; al escanear el QR, muestra al humano el código QR actual devuelto por el comando. La finalización del inicio de sesión se determina por el resultado de la verificación del estado de la cuenta, no solo por la redirección de página o la acción de escaneo. Después de completar, puedes usar jlc-cli account show --json para una consulta.

El flujo actual utiliza explícitamente jlc-cli browser configure --clear-endpoint --engine chrome. El tiempo de ejecución de Obscura por defecto ha sido verificado, pero el SPA del centro de cliente real y el iframe de inicio de sesión aún tienen problemas de compatibilidad; no trates la conectividad del tiempo de ejecución como disponibilidad de negocio, ni afirmes que el navegador se ha cambiado automáticamente. Si la CLI ya tiene su propia sesión de cambio de motor, detén esa sesión primero; consulta Comandos de navegador e inicio de sesión.

Índice de negocio

Necesidad	Grupo de comandos y referencia
Descubrimiento de instalación, inicialización, navegador, configuración de cuenta, inicio de sesión múltiple, escaneo QR, callback de éxito	Comandos e inicio de sesión
Subida/análisis/previsualización, parámetros, cotización, verificación y creación de pedidos	Flujo de trabajo PCB
Pedidos PCB/FPC, pago con saldo, Jia Xiaozhi	Pedidos y pagos
Estado JSON, código de salida, observación de tareas, toma de control CDP, resultados desconocidos	Resultados y recuperación

Límites de decisión que deben mantenerse

• default: Los parámetros de producción que el usuario no ha decidido deben preguntarse. La preselección del sitio, la configuración anterior y los hechos de análisis no se convierten automáticamente en elección del usuario. auto: Primero debe existir la intención del usuario de que el Agente ayude a seleccionar y rellenar, luego sugiere y rellena según sus restricciones; explica la base y, en caso de conflicto, pregunta. La bandera del modo no es una autorización.
• Después de establecer los parámetros, lee el valor efectivo real. Si el sitio cambia o restablece la selección del usuario, reporta la diferencia; no aceptes valores sustitutivos porque el flujo pueda continuar.
• La subida, previsualización y cotización no autorizan automáticamente la creación de pedidos. Cuando el usuario ya ha autorizado la creación de un pedido, primero verifica el resumen y luego envía explícitamente; no trates la cotización como un pedido o pago.
• Cada pago con saldo requiere confirmación humana del número de cuenta actual, pedido, importe y método de pago. Solo se puede pasar --human-confirmed después de que el humano haya confirmado explícitamente el resumen actual; no se debe falsificar la confirmación ni modificar los registros locales de confirmación. La CLI verifica el enlace, la vigencia y el uso único; la bandera por sí sola no puede probar el hecho de la conversación. La inicialización, el modo auto y la toma de control no pueden reemplazar la confirmación de pago.
• Cuando el resultado es desconocido, primero verifica la tarea original y el pedido; no reenvíes ni pagues. Mantén la correspondencia entre tareas, archivos, configuración de cuenta y páginas; la toma de control no puede ampliar la autorización comercial existente.

Solo reporta los resultados verificados realmente por el comando. La entrega del código QR, la finalización del inicio de sesión, la finalización del análisis, la creación del pedido y el pago son estados diferentes. No inventes campos faltantes; no completes información ofuscada del sitio. Las capacidades disponibles y los límites de verificación reales dependen de la ayuda actual de la CLI y de los registros de aceptación del proyecto.