Community寫作與編輯github.com

jlc-cli

非官方的嘉立創中國站(jlc.com)CLI 技能,支援 PCB/Gerber 上傳、預覽、製造參數、報價、訂單、登入與 QR 碼登入。使用 jlc-cli 處理網站業務流程、人類確認的餘額付款與嘉小智;不含原理圖編輯、本地 Gerber 轉換或海外 JLCPCB。

jlc-cli 是什麼?

jlc-cli 是一個非官方社群開發的命令列工具技能,專為操作嘉立創中國站(jlc.com)的業務流程而設計。它允許使用者透過 CLI 執行 PCB/Gerber 檔案上傳、預覽、設定製造參數、獲取報價、建立訂單以及處理登入(包含 QR 碼掃碼登入)等操作。此技能支援多種平台,包括一般終端環境以及 AI 代理(如 Claude Code、Cursor、Codex),並透過明確的步驟確保使用者授權與流程正確性。其核心價值在於將繁瑣的網站手動操作自動化,同時保留關鍵決策(如餘額付款)的人類確認機制,避免未經許可的動作。使用前需確保已安裝 Node.js 22.12+、npm、Git 與 Google Chrome,並從原始碼編譯安裝。技能會先檢查 CLI 可用性、瀏覽器相容性,然後引導使用者完成初始化、登入,再根據業務需求執行上傳、報價或訂單操作。它嚴格區分不同狀態(如 QR 碼交付 vs 登入完成),不編造缺失欄位,並要求每筆付款前獲得人類明確同意。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TXyy2023/jlc-cli/tree/main/skills/jlc-cli

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

jlc-cli 是做什麼的?

通過業務 CLI 操作嘉立創中國站。這是非官方社群專案,沒有嘉立創官方背書。常規流程使用命令;只有命令返回待接管時才操作它保留的 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 碼。登入完成以帳號狀態核實結果為準,不能只憑頁面跳轉或掃碼動作。完成後可用 jlc-cli account show --json 做一次查詢。

當前實站流程明確使用 jlc-cli browser configure --clear-endpoint --engine chrome。預設 Obscura 執行環境已驗證,但本輪真實客戶中心 SPA 與登入 iframe 仍有相容問題;不要把執行環境可連線當作業務可用,也不要聲稱已自動切換瀏覽器。已有 CLI 自有工作階段切換引擎前先停止該工作階段,詳見 瀏覽器與登入命令。

業務索引

需求命令組與參考
安裝發現、初始化、瀏覽器、帳號配置、多方式登入、掃碼、成功回呼命令與登入
上傳/解析/預覽、參數、報價、檢查與建單PCB 工作流程
PCB/FPC 訂單、餘額付款、嘉小智訂單與付款
JSON 狀態、退出碼、任務觀察、CDP 接管、未知結果結果與恢復

必須保留的決策邊界

  • default:使用者未決定的生產參數應詢問。網站預選、上次配置及解析事實不自動變成使用者選擇。auto:先有使用者讓 Agent 協助選填的意圖,再按其約束建議並填寫;說明依據,衝突時詢問。模式標誌本身不是授權。
  • 參數設定後讀取實際生效值。網站更改或重設使用者選擇時報告差異,不能以流程能繼續為由接受替換值。
  • 上傳、預覽和報價不自動授權建立訂單。使用者已授權建單時先檢查摘要,再明確提交,不把報價當作訂單或付款。
  • 每筆餘額付款都須人類確認目前帳號、訂單、金額和支付方式。只有本次摘要確獲人類明確同意後才能傳入 --human-confirmed;不得偽造確認或修改本地確認記錄。CLI 校驗綁定、時效和一次性使用,標誌本身不能證明對話事實。初始化、auto 和接管不能替代付款確認。
  • 結果未知時先核實原任務和訂單,不重新提交或付款。保持任務、檔案、帳號配置和頁面對應關係;接管不能擴大已有業務授權。

只報告命令實際核實的結果。QR 碼交付、登入完成、解析完成、建立訂單、已支付分別是不同狀態。缺失欄位不編造;站點脫敏資訊不補全。可用能力與真實驗收邊界以當前 CLI 幫助和專案驗收記錄為準。

相關技能