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 a

SKILL.md

GitHub

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:

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:

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:

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.