# 人にログインさせるブラウザ自動化を「1回で済む」作りにする（Playwright persistent context） API の無いサービス（個人 SNS のメッセージ等）を Playwright の永続プロファイルで読む時、最初の1回だけ人にログインしてもらう。 この「人ログイン画面」で、ツールがログイン途中に勝手に閉じる事故が起きやすい（2段階認証・確認画面の途中 URL を「ログイン済み」と誤判定）。 同梱 Chromium と playwright-core の revision ずれで、ログイン後の遷移でブラウザごと落ちることもある。結果、人が何度もログインをやり直す。 ## ルール（4つ） 1. **ツール側から閉じない。** URL や画面で「ログイン済み」を推定しない。人が × で閉じる（全ページが閉じる / context の close イベント）まで待つだけ。 2. **正規版 Google Chrome を優先する**（`%PROGRAMFILES%\Google\Chrome\Application\chrome.exe` → `(x86)` → `%LOCALAPPDATA%` → mac の `/Applications/Google Chrome.app/...`）。無い時だけ同梱 Chromium。 3. **閉じた後に Cookie で成否判定**し、その場で `OK` / `ERROR: 不足 ` を出す。同じ profile を headless で開き直して `context.cookies()` を見る（例: Facebook は `c_user`/`xs`、Google は `SID`）。 4. **人に渡す前に、AI 側で「起動→ログイン画面表示」まで実機で確認**してから渡す。 ## 共通関数の形 - `resolveBrowserExecutable({env, exists, findChromium})` - `waitForHumanLogin(context, {timeoutMs=20分, sleep, now})` → `{closedByUser}`。close は絶対に呼ばない。タイムアウトでも閉じない - `missingLoginCookies(cookies, required, domain)`（サブドメインも親ドメイン要求に一致させる） - `runHumanLogin({chromium, profileDir, url, requiredCookies, cookieDomain})` → code 0（OK）/ 3（Cookie 不足）/ 4（ブラウザ・playwright 無し）/ 5（閉じられずタイムアウト） - playwright-core は動的 import にして、テストはブラウザ無しで回す（fake context の `close` が呼ばれたら fail、等） ## CI で強制する `tools/**/*.mjs` を走査し、`headless: false` を含むのに `runHumanLogin` を import していないファイルがあれば fail する静的テストを置く。新しいツールが同じ事故を再発させない。 ## 運用の注意 - 人ログイン中は profile がロックされる（Chrome は exit 21）。定期読み取りタスクと同じ profile を使うなら、ログイン・一括取得の間はタスクを一時停止し、終わったら必ず再開（try/finally）。 - Cookie ファイル（`Default/Network/Cookies`）はブラウザ起動中は読めない。閉じてから判定する。 ---