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 幫助和專案驗收記錄為準。