jlc-cli은(는) 무엇을 하나요?
비즈니스 CLI를 통해 JLCPCB 중국 사이트를 조작합니다. 이는 비공식 커뮤니티 프로젝트이며 JLCPCB의 공식적인 보증이 없습니다. 일반적인 흐름은 명령어를 사용합니다. 명령어가 대기 상태를 반환하는 경우에만 해당 CDP 페이지를 조작합니다.
설치 확인
비즈니스 명령어를 실행하기 전에 먼저 jlc-cli --version을 실행하고, 성공하면 jlc-cli --help를 실행합니다. 이 Skill을 설치한다고 CLI가 자동으로 설치되지는 않습니다.
명령어를 찾을 수 없다는 메시지(command not found / 인식 불가)가 표시되면 사용자에게 CLI가 아직 설치되지 않았거나 PATH에 추가되지 않았음을 설명하고, 프로젝트 저장소 및 설치 설명을 제공합니다. 현재 npm에 게시되지 않았으므로 동일한 이름의 타사 패키지를 설치하지 마십시오. Node.js 22.12 이상, npm, Git 및 Google Chrome을 준비한 후 소스에서 설치할 수 있습니다:
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
패키지 이름은 현재 개발 버전에 해당합니다. 버전이 변경되면 npm pack으로 실제 생성된 파일 이름을 사용합니다. 이미 소스 디렉토리가 있는 경우 경로를 확인하고 사용자의 디렉토리를 덮어쓰지 마십시오. 설치 후 버전과 도움말을 다시 확인하고 원래 작업을 계속합니다. 명령어가 존재하지만 시작에 실패하면 실제 오류를 보고하고 Node.js 버전과 PATH를 확인합니다. 시작 실패를 설치되지 않은 것으로 간주하여 무턱대고 재설치하지 마십시오.
시작하기
설치 확인이 완료되면 jlc-cli browser doctor --json을 실행하여 브라우저 가용성을 확인합니다. jlc-cli skill path는 해당 CLI와 함께 제공되는 Skill을 반환하며, 동일한 버전 설명을 우선 사용합니다.
처음 사용 시 먼저 사용자에게 jlc-cli init --json이 반환하는 초기화 범위를 표시하고 명시적 동의를 얻은 후 jlc-cli init --accept --confirmed-by human을 실행합니다. 또는 사용자가 대화식으로 init을 실행할 수도 있습니다. 그런 다음 브라우저를 구성하고 로그인을 시작한 후 auth status를 확인합니다. QR 코드를 스캔해야 하는 경우 명령어가 반환한 현재 QR 코드를 사용자에게 표시합니다. 로그인 완료 여부는 계정 상태 확인 결과를 기준으로 하며, 페이지 이동이나 QR 코드 스캔 동작만으로 판단하지 않습니다. 완료 후 jlc-cli account show --json을 사용하여 한 번 조회할 수 있습니다.
현재 실제 워크플로우는 명시적으로 jlc-cli browser configure --clear-endpoint --engine chrome을 사용합니다. 기본 Obscura 런타임은 이미 검증되었지만, 현재 실제 고객 센터 SPA 및 로그인 iframe에는 여전히 호환성 문제가 있습니다. 런타임 연결 가능성을 비즈니스 사용 가능으로 간주하지 말고, 브라우저가 자동으로 전환되었다고 주장하지 마십시오. 기존 CLI 자체 세션의 엔진을 전환하기 전에 먼저 해당 세션을 중지하십시오. 자세한 내용은 브라우저 및 로그인 명령어를 참조하십시오.
비즈니스 인덱스
| 요구 사항 | 명령어 그룹 및 참조 |
|---|---|
| 설치 발견, 초기화, 브라우저, 계정 구성, 다중 로그인 방식, QR 코드 스캔, 성공 콜백 | 명령어 및 로그인 |
| 업로드/파싱/미리보기, 매개변수, 견적, 검사 및 주문 생성 | PCB 워크플로우 |
| PCB/FPC 주문, 잔액 결제, Jiaxiaozhi | 주문 및 결제 |
| JSON 상태, 종료 코드, 작업 모니터링, CDP 인수, 알 수 없는 결과 | 결과 및 복구 |
반드시 유지해야 할 결정 경계
default: 사용자가 결정하지 않은 생산 매개변수는 질문해야 합니다. 사이트 사전 선택, 이전 구성 및 파싱된 사실은 자동으로 사용자 선택이 되지 않습니다.auto: 먼저 사용자가 Agent가 선택 작성을 도와주기를 원하는 의도가 있어야 하며, 그런 다음 해당 제약 조건에 따라 제안하고 작성합니다. 근거를 설명하고 충돌이 있을 경우 질문합니다. 모드 플래그 자체는 권한이 아닙니다.- 매개변수 설정 후 실제 적용된 값을 읽습니다. 사이트가 사용자 선택을 변경하거나 재설정하는 경우 차이를 보고하며, 프로세스를 계속할 수 있다는 이유로 대체 값을 수락하지 않습니다.
- 업로드, 미리보기 및 견적은 자동으로 주문 생성을 승인하지 않습니다. 사용자가 이미 주문 생성을 승인한 경우 먼저 요약을 확인한 후 명시적으로 제출하며, 견적을 주문이나 결제로 간주하지 않습니다.
- 각 잔액 결제 시 현재 계정, 주문, 금액 및 지불 방식을 사용자가 확인해야 합니다. 현재 요약이 사용자의 명시적 동의를 얻은 경우에만
--human-confirmed를 전달할 수 있습니다. 확인을 위조하거나 로컬 확인 기록을 수정하지 마십시오. CLI는 바인딩, 유효 기간 및 일회성 사용을 검증하며, 플래그 자체가 대화 사실을 증명할 수 없습니다. 초기화, auto 및 인수는 결제 확인을 대체할 수 없습니다. - 결과를 알 수 없는 경우 먼저 원래 작업과 주문을 확인하고, 재제출하거나 결제하지 마십시오. 작업, 파일, 계정 구성 및 페이지 간의 대응 관계를 유지합니다. 인수는 기존 비즈니스 권한을 확장할 수 없습니다.
명령어가 실제로 확인한 결과만 보고합니다. QR 코드 전달, 로그인 완료, 파싱 완료, 주문 생성, 결제 완료는 각각 다른 상태입니다. 누락된 필드는 조작하지 않으며, 사이트에서 마스킹된 정보는 보완하지 않습니다. 사용 가능한 기능과 실제 수용 경계는 현재 CLI 도움말 및 프로젝트 수용 기록을 기준으로 합니다.