lachlanchen/lazyskills

jlcpcb-ordering

Use when preparing, checking, submitting, documenting, or troubleshooting JLCPCB/JiaLiChuang PCB orders from Gerber ZIPs, including China/global site workflows, desktop assistant handoff, Chrome CDP automation, private config, OSP/surface-finish limits, qua…

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/lachlanchen/lazyskills --skill jlcpcb-ordering

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

JLCPCB Ordering

Overview

Use this skill to turn a checked Gerber ZIP into a guarded JLC order workflow. Keep public repos clean: never commit recipient names, phone numbers, addresses, cookies, OTP/SMS codes, screenshots with private fields, wallet/payment data, or ~/.config/jlcpcb-order/private.json.

Safety Rules

  • Treat submit/payment controls as real-world actions. Do not click final submit without explicit user intent, and never click recharge, wallet, or payment buttons unless the user explicitly asks.
  • Stop if the order-check drawer shows 检测到您的订单还有, 去填写, 系统未检测到, 余额不足, 充值, an OSP-size warning, or a paid 品质赔付费.
  • Submit only from a visible, clean order-check drawer. Do not use the whole page body as proof, because stale tabs and unselected option labels can create false positives.
  • For bare PCBs, use 按标准合同常规处理; do not select 元器件移植全额赔付.
  • Default China courier is 顺丰电商标快; default shipping mode is 不同交期订单不一起发货.

AgenticApp Tooling

When working in AgenticApp, prefer the maintained CDP tool:

bash
python3 agentic_tools/order_assistant.py --provider jlc --site china status
python3 agentic_tools/order_assistant.py --provider jlc --site china --allow-submit place path/to/gerber.zip
agentic_tools/jlcpcb_order_agent/scripts/launch_shared_chrome.sh
python3 -u agentic_tools/jlcpcb_order_agent/scripts/submit_board_order.py --config path/to/jlcpcb_order/order-settings.json --site china place
agentic_tools/jlcpcb_order_agent/scripts/quick_order_china.sh path/to/gerber.zip
agentic_tools/jlcpcb_order_agent/scripts/quick_order_global.sh path/to/gerber.zip
agentic_tools/jlcpcb_order_agent/scripts/quick_order_assistant.sh path/to/gerber.zip

Use JLCPCB_ALLOW_SUBMIT=1 only after the check drawer is clean. Private state lives under ~/.config/jlcpcb-order/: config, DOM snapshots, SQLite order database, and completion logs. The unified wrapper writes blocker handoff packets to ~/.config/manufacturing-order-assistant/packets/.

For AgenticApp's paired manufacturing-order tools, also check agentic_tools/ORDER_AUTOMATION.md; Wenext 3D printing uses agentic_tools/wenext_3d_order_agent/.

For the official Linux desktop assistant, prefer the local installer:

bash
agentic_tools/jlcpcb_order_agent/scripts/install_assistant_local.sh \
  ~/Downloads/JLCPcAssit-linux-x64-5.0.69.zip

It creates ~/.local/bin/jlc-assistant; do not commit ~/.config/jlc-assistant.

Start it through the detached, health-checked launcher rather than a foreground terminal:

bash
agentic_tools/jlcpcb_order_agent/scripts/launch_assistant_local.sh --restart

Workflow

  1. Validate the board package first: KiCad DRC/ERC, Gerber ZIP, drill files, board size, and preview. Prefer submit_board_order.py when the repo has a public jlcpcb_order/order-settings.json.
  2. Launch the shared logged-in Chrome profile through CDP; do not create throwaway browser profiles for ordering.
  3. Upload Gerbers and fill conservative bare-PCB defaults: FR-4, correct layer count, explicit board size in centimeters when JLC misses it, low quantity, no SMT, no stencil, manual confirmation, standard compensation.
  4. If OSP is rejected because any side is under 7 cm, choose a supported finish such as lead-free HASL or stop for review.
  5. If a matching legacy uploaded row already exists, use that row's 立即下单/pcbFileId instead of uploading another copy. Avoid duplicate uploads unless the existing row is absent or invalid.
  6. Run 检查订单. If JLC opens 请选择本单是否需要SMT贴片, choose 确定,不需要SMT, then run 检查订单 again.
  7. Clear all missing fields including board mark/customer-code fields. Select 确认订单方式 and 发货方式 by their field labels, not generic button text.
  8. Record a private snapshot, then submit only to review/payment boundary when authorized.
  9. After submit, prefer the pcbPlaceSuccess tab for database/log snapshots; stale order tabs can remain open.

Read references/jlcpcb-ordering-runbook.md for live DOM selectors, terms, and the China/global/assistant submission paths.