CommunityEscrita e Ediçãogithub.com

fabrelay

FabRelay é uma skill CLI não oficial para o JLC China (嘉立创, jlc.com), que permite upload de PCB/Gerber, visualização, parâmetros de fabricação, orçamentos, pedidos, login e login por QR. Use o fabrelay para fluxos de trabalho empresariais no site, pagamentos confirmados por humanos e Jia Xiaozhi; não serve para edição de esquemáticos, conversão local de Gerber ou JLCPCB internacional.

O que é fabrelay?

O FabRelay é uma ferramenta de interface de linha de comando (CLI) não oficial, desenvolvida pela comunidade, que permite interagir com a plataforma chinesa JLC (嘉立创, jlc.com) para processos de negócios, como upload de arquivos PCB/Gerber, visualização, definição de parâmetros de fabricação, obtenção de orçamentos, gerenciamento de pedidos e login (incluindo login por QR code). Ele foi projetado para ser usado em ambientes de agentes de IA (como Claude Code, Cursor ou Codex), automatizando tarefas repetitivas do site com comandos e, quando necessário, operando páginas CDP abertas pelo usuário para ações que exigem intervenção humana, como confirmação de pagamento. A skill não substitui editores de esquemáticos, não converte arquivos Gerber localmente e não é compatível com o site internacional JLCPCB. Para começar, é necessário instalar o CLI (`fabrelay`) a partir do código-fonte (Node.js 22.12+, npm, Git e Chrome), executar verificações de instalação e inicialização, e então seguir os comandos para configurar navegador, fazer login e executar os fluxos de negócio. A ferramenta impõe limites claros de decisão: parâmetros de produção devem ser confirmados pelo usuário, pagamentos requerem aprovação humana explícita e resultados desconhecidos devem ser verificados antes de novas ações.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TXyy2023/FabRelay/tree/main/skills/fabrelay

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que fabrelay faz?

Opere o JLC China (嘉立创, jlc.com) via CLI de negócios. Este é um projeto comunitário não oficial, sem endosso oficial da JLC. Use comandos para o fluxo normal; opere as páginas CDP retidas apenas quando um comando retornar "aguardando ação manual".

Verificação de Instalação

O nome antigo do projeto era jlc-cli; o comando atual é fabrelay. Não considere que o comando antigo funcione como prova de que o novo CLI está instalado. A atualização manterá compatibilidade com o diretório de dados e estado de login existentes; veja o README do repositório.

Antes de executar qualquer comando de negócios, execute fabrelay --version e, se bem-sucedido, fabrelay --help. Esta Skill não instala o CLI automaticamente.

Se o comando não for encontrado (command not found / comando 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 está 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 e instale a partir do código-fonte:

git clone https://github.com/TXyy2023/FabRelay.git
cd FabRelay
npm ci
npm run build
npm pack
npm install -g ./fabrelay-1.0.0-dev.2.tgz
fabrelay --version
fabrelay --help

O nome do pacote corresponde à versão atual de desenvolvimento; use o nome de arquivo gerado por npm pack quando a versão mudar. Se o diretório de código-fonte já existir, verifique o caminho e 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 a tarefa original. Se o comando existir, mas falhar ao iniciar, reporte o erro real e verifique a versão do Node.js e o PATH; não trate a falha de inicialização como se o CLI não estivesse instalado e reinstale cegamente.

Início

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

Na primeira vez, apresente ao humano o escopo de inicialização retornado por fabrelay init --json. Após obter consentimento explícito, execute fabrelay init --accept --confirmed-by human; o humano também pode executar init interativamente. Em seguida, configure o navegador, inicie o login e verifique o auth status; ao usar QR code, mostre ao humano o QR code atual retornado pelo comando. A conclusão do login é confirmada pelo status da conta, não apenas por redirecionamento de página ou ação de escaneamento. Após login, faça uma consulta com fabrelay account show --json.

O fluxo atual explicitamente usa fabrelay browser configure --clear-endpoint --engine chrome. O runtime Obscura padrão já foi verificado, mas o SPA real do centro de clientes e os iframes de login ainda têm problemas de compatibilidade; não considere que a conectividade do runtime significa disponibilidade de negócios, nem afirme que o navegador foi trocado automaticamente. Se o CLI já tiver um mecanismo próprio de troca de sessão, pare essa sessão primeiro; veja comandos de navegador e login.

Índice de Negócios

NecessidadeGrupo de comandos e referência
Descoberta de instalação, inicialização, navegador, configuração de conta, login múltiplo, escaneamento, callbacks de sucessoComandos e login
Upload/parse/preview, parâmetros, orçamento, verificação e criação de pedidoFluxo de trabalho PCB
Pedidos PCB/FPC, pagamento por saldo, Jia XiaozhiPedidos e pagamento
Estado JSON, códigos de saída, observação de tarefas, CDP takeover, resultados desconhecidosResultados e recuperação

Limites de Decisão que Devem Ser Mantidos

  • 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 parse não se tornam automaticamente escolhas do usuário. auto: Primeiro o usuário deve ter a intenção de permitir que o Agente ajude a selecionar/preencher; em seguida, sugira e preencha conforme suas restrições; explique a justificativa e pergunte em caso de conflito. O sinalizador de modo não é autorização por si só.
  • Após definir os parâmetros, leia os valores reais em vigor. Se o site alterar ou redefinir as escolhas do usuário, reporte a diferença; não aceite valores substitutos só porque o fluxo pode continuar.
  • Upload, preview e orçamento não autorizam automaticamente a criação de pedidos. Quando o usuário já autorizou a criação do pedido, verifique o resumo primeiro, depois submeta explicitamente; não trate orçamento como pedido ou pagamento.
  • Cada pagamento por saldo deve ter confirmação humana do número da conta atual, número do pedido, valor e forma de pagamento. Só passe --human-confirmed se o resumo atual foi explicitamente confirmado pelo humano; não falsifique confirmações nem modifique registros locais de confirmação. O CLI valida vinculação, tempo e uso único; o sinalizador em si não prova o fato da conversa. Inicialização, auto e takeover não substituem a confirmação de pagamento.
  • Quando o resultado for desconhecido, primeiro verifique a tarefa e o pedido original; não reenvie ou pague. Mantenha a correspondência entre tarefas, arquivos, configuração de conta e páginas; takeover não expande autorizações de negócios existentes.

Reporte apenas os resultados que o comando realmente verificou. Entrega de QR code, login concluído, parse concluído, pedido criado e pago são estados diferentes. Não invente campos ausentes; não complete informações ofuscadas pelo site. As capacidades disponíveis e os limites reais de aceitação devem ser baseados na ajuda atual do CLI e nos registros de teste do projeto.

Habilidades Relacionadas