jlc-cli

O que jlc-cli faz?

Opere o site da JLC China (嘉立创, jlc.com) via CLI empresarial. Este é um projeto comunitário não oficial, sem endosso da JLC. Use comandos para fluxos regulares; interaja com a página CDP retida apenas quando o comando retornar um indicador de aguardo.

Verificação de Instalação

Antes de executar qualquer comando empresarial, execute primeiro jlc-cli --version e, em caso de sucesso, execute jlc-cli --help. A instalação deste skill não instala automaticamente o CLI.

Se o comando não for encontrado (command not found / não reconhecido), informe ao usuário que o CLI não está instalado ou não está no PATH, e forneça o repositório do projeto e instruções de instalação. Atualmente não publicado no npm; não instale pacotes de terceiros com o mesmo nome. Prepare Node.js 22.12 ou superior, npm, Git e Google Chrome, depois instale a partir do código fonte:

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

O nome do pacote corresponde à versão de desenvolvimento atual; quando a versão mudar, use o nome de arquivo gerado por npm pack; se o diretório de código fonte já existir, verifique o caminho primeiro, não sobrescreva o diretório do usuário. Após a instalação, verifique novamente a versão e a ajuda antes de continuar com a tarefa original. Se o comando existir, mas a inicialização falhar, reporte o erro real e verifique a versão do Node.js e o PATH; não trate falha de inicialização como não instalado para reinstalar cegamente.

Início

Após a verificação de instalação, execute jlc-cli browser doctor --json para verificar a disponibilidade do navegador. jlc-cli skill path retorna o skill entregue com o CLI; use a documentação da mesma versão de preferência.

Na primeira utilização, apresente ao humano o escopo de inicialização retornado por jlc-cli init --json; obtenha consentimento explícito antes de executar jlc-cli init --accept --confirmed-by human; alternativamente, o humano pode executar init interativamente. Em seguida, configure o navegador, inicie o login e verifique auth status; ao escanear QR code, mostre ao humano o QR code atual retornado pelo comando. A conclusão do login deve ser baseada no resultado da verificação do estado da conta, não apenas em redirecionamentos de página ou ações de escaneamento. Após a conclusão, use jlc-cli account show --json para uma consulta.

O fluxo real atual usa explicitamente jlc-cli browser configure --clear-endpoint --engine chrome. O runtime Obscura padrão foi verificado, mas a SPA do centro de clientes real e o iframe de login desta rodada ainda têm problemas de compatibilidade; não considere a conectividade de runtime como disponibilidade empresarial, nem afirme que o navegador foi alternado automaticamente. Se o CLI tiver mecanismo próprio de troca de sessão, pare a sessão primeiro; veja Comandos de Navegador e Login.

Índice Empresarial

Necessidade	Grupo de Comandos e Referência
Descoberta de instalação, inicialização, navegador, configuração de conta, login múltiplo, QR code, callback de sucesso	Comandos e Login
Upload/Análise/Visualização, parâmetros, cotação, verificação e criação de pedido	Fluxo de Trabalho PCB
Pedidos PCB/FPC, pagamento por saldo, Jia Xiaozhi	Pedidos e Pagamento
Status JSON, código de saída, observação de tarefas, tomada de controle CDP, resultados desconhecidos	Resultados e Recuperação

Limites de Decisão Obrigatórios

• default: Parâmetros de produção não decididos pelo usuário devem ser perguntados. Pré-seleções do site, configurações anteriores e fatos de análise não se tornam automaticamente escolhas do usuário. auto: Primeiro o usuário deve ter a intenção de que o Agent ajude a preencher, então sugira e preencha conforme suas restrições; explique a base e pergunte em caso de conflito. A flag de modo não é autorização em si.
• Após definir parâmetros, leia os valores efetivos reais. Se o site alterar ou redefinir a escolha do usuário, reporte a diferença; não aceite valores substitutos sob o pretexto de continuidade do fluxo.
• Upload, visualização e cotação não autorizam automaticamente a criação de pedido. Quando o usuário já autorizou a criação de pedido, verifique primeiro o resumo e depois submeta explicitamente; não trate cotação como pedido ou pagamento.
• Cada pagamento por saldo requer confirmação humana da conta atual, pedido, valor e método de pagamento. Só passe --human-confirmed se o resumo atual for explicitamente consentido pelo humano; não forje confirmação nem modifique registros locais de confirmação. O CLI verifica vinculação, temporalidade e uso único; a flag em si não prova fatos de diálogo. Inicialização, auto e tomada de controle não substituem confirmação de pagamento.
• Quando o resultado é desconhecido, primeiro verifique a tarefa e o pedido originais; não reenvie nem pague. Mantenha o mapeamento entre tarefas, arquivos, configurações de conta e página; tomada de controle não amplia autorização empresarial existente.

Reporte apenas os resultados realmente verificados pelo comando. Entrega de QR code, conclusão de login, conclusão de análise, criação de pedido e pagamento são estados diferentes. Não invente campos ausentes; não preencha informações mascaradas do site. As capacidades disponíveis e os limites reais de aceitação devem ser baseados na ajuda do CLI atual e nos registros de aceitação do projeto.