fabrelay 是做什麼的?
通過業務 CLI 操作嘉立創中國站。這是非官方社區項目,沒有嘉立創官方背書。常規流程使用命令;只有命令返回待接管時才操作它保留的 CDP 頁面。
安裝檢查
項目舊名為 jlc-cli,當前命令為 fabrelay;不要把舊命令可用當作新 CLI 已安裝。升級會兼容既有數據目錄和登入狀態,詳見倉庫 README。
執行任何業務命令前,先運行 fabrelay --version,成功後再運行 fabrelay --help。安裝本 Skill 不會自動安裝 CLI。
如果提示找不到命令(command not found / 無法識別),向用戶說明 CLI 尚未安裝或未加入 PATH,並提供項目倉庫與安裝說明。當前未發布到 npm,不要安裝同名的第三方包。準備 Node.js 22.12 或更高版本、npm、Git 和 Google Chrome 後,可從源碼安裝:
git clone https://github.com/TXyy2023/FabRelay.git
cd FabRelay
npm ci
npm run build
npm pack
npm install -g ./fabrelay-1.0.0-dev.2.tgz
fabrelay --version
fabrelay --help
包名對應當前開發版本,版本變化時使用 npm pack 實際生成的文件名;已有源碼目錄時先核實路徑,不覆蓋用戶的目錄。安裝後重新檢查版本與幫助,再繼續原任務。若命令存在但啟動失敗,報告實際錯誤並檢查 Node.js 版本與 PATH,不把啟動失敗當作未安裝而盲目重裝。
開始
完成安裝檢查後,運行 fabrelay browser doctor --json 檢查瀏覽器可用性。fabrelay skill path 返回隨該 CLI 交付的 Skill,優先使用同版本說明。
首次使用先向人類呈現 fabrelay init --json 返回的初始化範圍,取得明確同意後運行 fabrelay init --accept --confirmed-by human;也可由人類互動式運行 init。隨後配置瀏覽器、發起登入並核實 auth status;掃碼時向人類展示命令返回的當前二維碼。登入完成以帳號狀態核實結果為準,不能只憑頁面跳轉或掃碼動作。完成後可用 fabrelay account show --json 做一次查詢。
當前實站流程顯式使用 fabrelay browser configure --clear-endpoint --engine chrome。默認 Obscura 運行時已驗證,但本輪真實客戶中心 SPA 與登入 iframe 仍有兼容問題;不要把運行時可連接當作業務可用,也不要聲稱已自動切換瀏覽器。已有 CLI 自有會話切換引擎前先停止該會話,詳見瀏覽器與登入命令。
業務索引
| 需求 | 命令組與參考 |
|---|---|
| 安裝發現、初始化、瀏覽器、帳號配置、多方式登入、掃碼、成功回調 | 命令與登入 |
| 上傳/解析/預覽、參數、報價、檢查與建單 | PCB 工作流 |
| PCB/FPC 訂單、餘額付款、嘉小智 | 訂單與付款 |
| JSON 狀態、退出碼、任務觀察、CDP 接管、未知結果 | 結果與恢復 |
必須保留的決策邊界
default:用戶未決定的生產參數應詢問。網站預選、上次配置及解析事實不自動變成用戶選擇。auto:先有用戶讓 Agent 幫助選填的意圖,再按其約束建議並填寫;說明依據,衝突時詢問。模式標誌本身不是授權。- 參數設置後讀取實際生效值。網站更改或重置用戶選擇時報告差異,不能以流程能繼續為由接受替換值。
- 上傳、預覽和報價不自動授權建立訂單。用戶已授權建單時先檢查摘要,再明確提交,不把報價當作訂單或付款。
- 每筆餘額付款都須人類確認當前帳號、訂單、金額和支付方式。只有本次摘要確獲人類明確同意後才能傳入
--human-confirmed;不得偽造確認或修改本地確認記錄。CLI 校驗綁定、時效和一次性使用,標誌本身不能證明對話事實。初始化、auto 和接管不能替代付款確認。 - 結果未知時先核實原任務和訂單,不重新提交或付款。保持任務、文件、帳號配置和頁面對應關係;接管不能擴大已有業務授權。
只報告命令實際核實的結果。二維碼交付、登入完成、解析完成、建立訂單、已支付分別是不同狀態。缺失字段不編造;站點脫敏資訊不補全。可用能力與真實驗收邊界以當前 CLI 幫助和項目驗收記錄為準。