FabRelay は何をしますか？
業務CLIで嘉立創中国サイトを操作します。これは非公式コミュニティプロジェクトであり、嘉立創（JLC）の公式なサポートはありません。通常のフローではコマンドを使用します。コマンドが「待機して引き継ぎが必要」と返した場合にのみ、そのCLIが保持するCDPページを操作します。
インストール確認
プロジェクトの旧名称はjlc-cli、現在のコマンドはfabrelayです。古いコマンドが使えたとしても、新しいCLIがインストールされているとは限りません。アップグレードでは既存のデータディレクトリとログイン状態に互換性があります。詳細はリポジトリのREADMEを参照してください。
業務コマンドを実行する前に、まずfabrelay --versionを実行し、成功したらfabrelay --helpを実行します。このスキルをインストールしても、自動的に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に付属するスキルのパスを返します。同じバージョンの説明を優先して使用してください。
初回使用時は、まずfabrelay init --jsonが返す初期化範囲を人間に提示し、明確な同意を得てからfabrelay init --accept --confirmed-by humanを実行します。または、人間が対話的にinitを実行することもできます。その後、ブラウザを設定し、ログインを開始して、auth statusで状態を確認します。QRコードでログインする場合は、コマンドが返す現在のQRコードを人間に表示します。ログイン完了は、アカウント状態の確認結果を基準とします。ページ遷移やQRコードスキャン操作だけで判断しないでください。完了後、fabrelay account show --jsonで一度クエリを実行できます。
現在の実証フローでは、明示的にfabrelay browser configure --clear-endpoint --engine chromeを使用します。デフォルトのObscuraランタイムは検証済みですが、今回の実際のカスタマーセンターSPAとログインiframeにはまだ互換性の問題があります。ランタイムが接続可能であることを、ビジネスが利用可能であると主張したり、自動的にブラウザを切り替えたと宣言したりしないでください。既存のCLI独自のセッションでエンジンを切り替える前に、そのセッションを停止してください。詳細はブラウザとログインコマンドを参照してください。
業務索引
| 要件 | コマンドグループと参考 |
|---|---|
| インストール発見、初期化、ブラウザ、アカウント設定、複数ログイン方法、QRコード、成功コールバック | コマンドとログイン |
| アップロード/解析/プレビュー、パラメータ、見積もり、チェックと注文作成 | PCB ワークフロー |
| PCB/FPC注文、残高支払い、嘉小智 | 注文と支払い |
| JSON状態、終了コード、タスク監視、CDP引き継ぎ、不明な結果 | 結果と復旧 |
維持すべき決定境界
default：ユーザーが未決定の製造パラメータは尋ねること。サイトのプリセット、前回の設定、解析結果は自動的にユーザーの選択になりません。auto：まずユーザーがAgentに選択入力を支援させる意図があり、その制約に従って提案し入力すること。根拠を説明し、矛盾がある場合は尋ねること。モードフラグ自体は承認ではありません。- パラメータ設定後、実際に有効になった値を読み取ること。サイトがユーザーの選択を変更またはリセットした場合は差異を報告し、フローが続行できることを理由に置き換えられた値を受け入れないこと。
- アップロード、プレビュー、見積もりは注文作成を自動的に許可しません。ユーザーが注文作成を承認している場合は、まずサマリーを確認し、明確に送信します。見積もりを注文や支払いとみなさないこと。
- すべての残高支払いは、人間が現在のアカウント、注文、金額、支払い方法を確認する必要があります。今回のサマリーが人間から明確に同意を得た場合のみ、
--human-confirmedを渡すこと。確認を偽造したり、ローカルの確認記録を改ざんしたりしないでください。CLIはバインディング、有効期限、一回限りの使用を検証します。フラグ自体は対話の事実を証明しません。初期化、auto、引き継ぎは支払い確認の代わりになりません。 - 結果が不明な場合は、まず元のタスクと注文を確認し、再送信や支払いは行わないこと。タスク、ファイル、アカウント設定、ページの対応関係を維持すること。引き継ぎによって既存の業務権限が拡大されることはありません。
コマンドが実際に確認した結果のみを報告すること。QRコード配信、ログイン完了、解析完了、注文作成、支払い済みはそれぞれ異なる状態です。欠落しているフィールドは捏造しないこと。サイトでマスクされている情報は補完しないこと。利用可能な機能と実際の受け入れ境界は、現在のCLIヘルプとプロジェクトの受け入れ記録に従ってください。