私のPCで ORBIT AI Bridge をセットアップしてください。 目的: - Cloudflare Pages で配信されている公式 bundle を取得する。 - 同じPC上で Bridge を `127.0.0.1:8788` に起動する。 - ORBIT Pages から接続できることを確認する。 対象: - Windows 10/11 PowerShell、または macOS 13+ のターミナル。 - Codex CLI を使う場合は、Bridge と Codex CLI を同じOS側で実行してください。 - モバイル、タブレット、WSLだけの起動は初回一般ユーザー体験の対象外です。 公式配布: - Bundle URL: `https://sfc-waste-management-orbit-bridge.pages.dev/setup/orbit-ai-bridge-bundle.zip` - Checksum URL: `https://sfc-waste-management-orbit-bridge.pages.dev/setup/orbit-ai-bridge-bundle.zip.sha256` 安全ルール: - install、download、PATH変更、security settings変更、プロセス停止の前に必ず確認してください。 - `~/.codex/auth.json`、token、cookie、SSH key、認証ファイルの内容は読まない・表示しない・共有を求めないでください。 - Bridge は必ず `127.0.0.1` のみに bind してください。`0.0.0.0` やLANには公開しないでください。 - URL、checksum、展開先、実行するコマンドを説明してから進めてください。 手順: 1. OS と現在の作業ディレクトリを確認してください。 2. `node --version` と `npm --version` を確認し、Node.js 20+ がなければインストール前に確認してください。 3. `codex --version` と `codex login status` を確認してください。認証ファイルは読まないでください。 4. Bundle URL から zip をダウンロードし、Checksum URL の SHA-256 と照合してください。 5. 通常のユーザーフォルダへ展開し、展開した `orbit-ai-bridge` フォルダへ移動してください。 6. 初回だけ `npm install` を実行してください。 7. `npm start` の前に bind 事前確認を行ってください。次の最小 Node サーバーで `127.0.0.1:8788` に bind できるかを確認し、`bind-ok` が出力された場合のみ次に進んでください: - Windows PowerShell / macOS ターミナル 共通: `node -e "const net=require('node:net'); const s=net.createServer(); s.once('error', e => { console.error(e.code); process.exit(1); }); s.listen(8788, '127.0.0.1', () => { console.log('bind-ok'); s.close(); });"` - `EADDRINUSE` その他のエラーが返った場合は `127.0.0.1:8788` を bind できない状態です。`Test-NetConnection` や `/health` への接続が失敗しても、Windows の除外ポート範囲や別プロセスにより bind が阻害されることがあります。下記「止まる条件」に従って停止してください。 8. `npm start` で Bridge を起動し、ターミナルを開いたままにしてください。`[Bridge] ORBIT AI Bridge ... listening on http://127.0.0.1:8788` が出ることを確認してください。 9. 別のターミナルまたはブラウザで smoke test として次を確認してください: - `http://127.0.0.1:8788/health` - `http://127.0.0.1:8788/api/status` 10. `https://sfc-waste-management-orbit-bridge.pages.dev/` を開き、ブラウザがこのPC上のサービスへのアクセス許可を求めたら、`127.0.0.1:8788` の Bridge 確認のためだと説明して許可を依頼してください。 11. ORBIT の接続状態が `Connected: Codex CLI` になることを確認してください。 止まる条件: - 手順 7 の bind 事前確認で `127.0.0.1:8788` に bind できない(`Test-NetConnection` や `/health` 応答が無くても、bind が失敗する状態は使用中とみなす)。 - `npm start` が npm script header だけを表示してすぐ終了し、`[Bridge] ... listening` が出ない。 - Bridge が `127.0.0.1` 以外に bind しようとしている。 - Windows側ブラウザから `127.0.0.1:8788` に到達できない。 - token、cookie、認証ファイル、秘密鍵を表示しそうな操作が必要になる。 最後に、OS、展開先、Bridge起動結果、`/health`、`/api/status`、ORBIT接続状態を短く報告してください。