thread-master/apps/extension/haixun-threads-sync/README.md

巡樓 Threads Session 同步（Chrome 擴充）

從你已登入的 Chrome Threads 帳號，一鍵把 session 傳到巡樓後端，供開發模式（爬蟲）測試海巡使用。

安裝

1. 設定頁 → 開啟「開發模式」→ 下載 ZIP 並解壓
2. Chrome 打開 chrome://extensions → 開發人員模式 → 載入未封裝項目
3. 選解壓後的 haixun-threads-sync 資料夾
4. 擴充選項填入巡樓網址（本機 http://localhost:5173 或遠端 https://…）並儲存
5. 重新整理巡樓分頁（F5）

必要條件

• 後端 gateway 在跑（本機預設 http://127.0.0.1:8888）
• 前端在跑（本機 http://localhost:5173）
• Chrome 已登入 threads.com / threads.net
• 巡樓網頁已登入

使用

A. 設定頁（推薦）
開啟開發模式 → 出現「擴充已偵測」→ 按「從 Chrome 同步 Session」

B. 擴充圖示
先開著巡樓分頁 → 點擴充 →「同步到巡樓」

同步成功後，後端會寫入 POST /api/v1/scout/crawler-session（Playwright storageState）。

常見問題

現象	處理
尚未偵測擴充	擴充重新載入 + F5；選項網址須與分頁一致（localhost ≠ 127.0.0.1）
Cannot access contents of the page…	v1.2.0 起 localStorage 注入失敗會略過，改只靠 cookies；請更新擴充並重新載入
找不到 cookies	先開 threads.com 並登入
找不到登入狀態	在設定頁按同步（會帶 JWT）；或確認已登入巡樓
無法連線 :8888	確認 gateway 有跑；遠端站請用同源 /api

技術

• 網頁 postMessage ↔ content-haixun.js ↔ service worker
• cookies → Playwright storageState → scout/crawler-session
• 新版 JWT key：hb_live_tokens（舊：haixun.access_token）