適合本地執行環境接入者
當你的本地自動化執行環境正在驅動瀏覽器、編輯器、終端機、上傳工具或其他 App，而你希望靈汐把它視為「正在使用中」而不是普通閒置背景時，這頁會更有幫助。
自動化整合實務
本地自動化執行環境整合
這頁整理了一組通用接入建議，用來在本地自動化執行環境仍在主動驅動某個 App 時，讓靈汐不要把它當成普通閒置 App 過早關閉。
實作設定建議適用於本地自動化工具保持活躍 App 開啟
什麼時候看這頁
這是基礎接入頁旁邊的一頁實務說明
請先把主接入頁當作基線。這頁適合在你已經理解基礎流程之後，再進一步處理「工具工作時如何讓真實 App 保持受保護」這個問題。
讓基礎接入頁保持清晰
穩定的 socket 接入說明仍以主接入頁為準。本頁只補充真實本地執行環境的設定建議和 App 啟動細節。
典型症狀
這些現象通常說明設定還缺一層保護
App 啟動後很快退出
App 在自動化執行中可以被拉起，但還沒進入穩定任務階段就提前退出。
手動使用正常，自動化執行異常
同一個 App 和任務，在使用者手動操作時正常，只有在本地執行環境接管後才出現異常。
長任務中途中斷
長時間的匯入、同步、上傳或 App 驅動流程起步正常，但保護狀態沒有持續到任務完成。
建議做法
先開啟真實 App，再申請保護
- 優先讓一個執行環境會話擁有一條明確的 App 會話。
- 在向靈汐申請 lease 之前，先把真實 App 表面拉起來。
- 為目標 App 實例選擇盡可能具體、且有效的 app key。
- 如果識別缺口只是暫時的，先短暫重試 `lease.begin`，不要立刻調整接入實作。
- 只要真實任務還在進行，就在背景繼續續租。
- 收到 close-check 後，要根據執行環境是否仍在使用該 App 來回應。
- 任務真正完成後，再明確結束 lease。
App 識別
如何理解 `appKey`
- 對許多 App 來說，基礎 `appKey` 就是 bundle identifier。
- 如果 App 帶有 profile 或變體區分，可能需要更具體的後綴 key。
- 優先使用最具體、已知有效的 key，只有必要時再回退。
邊界
哪些內容保持穩定
- socket 路徑、握手流程與 lease 動作，仍以主接入頁為準。
- 本頁補充的是執行環境接入建議，不是另一套公開介面。
- 不同 App 表面可能需要不同的啟動、識別與「任務仍在進行中」的判斷方式，但 lease 流程本身不需要變化。
最小實作形態
先保證時序，再考慮封裝形式
關鍵不在語法，而在順序：先有真實 App 表面，再申請 lease，最後明確清理。
resource = launch_or_attach_to_real_app(...)
liveSurface = create_real_surface(resource)
with aion_lease(appKey):
# do the owned app work here
...
示例
已經驗證過的具體例子
Playwright + Chrome
一個已經驗證過的具體例子，是 Playwright 在 macOS 上驅動 Chrome。在這個場景裡，更穩妥的做法是：先建立真實頁面，優先使用基於 profile 推導出的 Chrome key，並在瀏覽器仍持有真實任務時持續續租。
其他 App 表面
如果你的執行環境驅動的是其他 App 表面，請保持公開 lease 流程不變，只替換 App 啟動、App 識別與「任務仍在進行中」的判斷層。
排查
先檢查這些，再考慮調整接入實作
`lease.begin` 回傳 `unknown_app`
先核對 app key。最穩妥的 key 通常是剛剛拉起的真實 App 實例所對應的、最具體且有效的識別，而不是最寬泛的兜底值。
靈汐識別前 App 已退出
優先檢查順序：先有真實 App 表面，再進入 lease 流程。在很多接入裡，這個順序比後續重試更關鍵。
長任務中途中斷
確認背景續租仍在執行，並且在 App 仍被主動使用時，close-check 會把 lease 正確延長。