$ man ai-network.requirements
AI 工具真正檢查哪些項目
多數問題不只是「網頁能不能開啟」。驗證、對話、檔案處理與開發介面可能經過不同的請求路徑，需要分別判斷。
地區判定與出口一致性
AI 服務通常會綜合出口 IP 所在地區、帳戶地區、瀏覽器工作階段與服務政策來決定頁面內容。登入前後頻繁更換國家或線路，可能使驗證流程反覆檢查，出現跳回登入頁、要求重新確認或功能入口消失等情況。較穩妥的做法是先選擇符合服務開放範圍的地區，完成登入後繼續使用同一地區的線路，避免在工作階段中途反覆切換。
長連線與串流輸出
對話回答通常不是一次下載完整內容，而是持續接收分段結果。連線短暫不穩、代理規則只涵蓋部分網域、瀏覽器休眠或系統切換網路，都可能導致回答中途停止。此時單純追求更大頻寬意義有限，更值得觀察的是連線是否持續、DNS 與請求是否經過同一路徑，以及用戶端在背景是否仍維持通道。
區分帳戶狀態與網路問題
地區提示、帳戶權限、服務端繁忙與本地網路故障，可能呈現相似介面。排查時先確認官方狀態與帳戶頁面，再檢查出口地區，最後更換線路。不要一看到錯誤就連續切換多個國家，也不要在短時間內反覆提交登入請求。將帳戶問題與線路問題分開，才能避免無效操作干擾判斷。
工具政策優先於線路能力
線路可以改善跨境連線，但不會改變工具本身的服務範圍、帳戶資格、內容規則或付費地區要求。使用前應查看對應工具的官方地區說明與帳戶政策。當付款資料、帳戶地區與出口地區互相衝突時，應依照官方流程處理，而不是靠頻繁換線掩蓋問題。
$ matrix.read --tools
工具 × 線路需求對照
下表不提供可用率承諾，也不以單次連通結果作為長期結論。工具政策與地區開放情況可能變動，使用時應一併核對官方說明。
| 工具 | 主要網路特性 | 選線重點 | 常見異常 |
|---|---|---|---|
| ChatGPT | 網頁驗證、持續對話、檔案處理與串流輸出 | 選擇服務開放地區，保持登入前後出口地區一致，優先觀察長連線是否持續 | 登入循環、回答中斷、地區提示、檔案請求失敗 |
| Claude | 長篇對話、持續串流回應、帳戶地區驗證 | 避免在工作階段中途切換地區，保持瀏覽器與系統代理路徑一致 | 頁面可開啟但對話失敗、輸出停止、工作階段要求重新驗證 |
| Gemini | 帳戶體系、地區功能差異、網頁資源分網域載入 | 確認帳戶地區與服務範圍，檢查分流規則是否遺漏相關請求 | 入口消失、頁面反覆重新整理、部分資源無法載入 |
| Copilot | 網頁、系統整合與編輯器擴充功能可能使用不同連線 | 讓編輯器程序與擴充功能程序明確使用代理，不只設定瀏覽器 | 網頁正常但編輯器無回應、登入回呼未完成 |
| Midjourney | 帳戶驗證、互動平台連線、圖片資源載入 | 讓驗證與資源存取使用同一地區，檢查媒體網域是否進入通道 | 驗證成功但資源空白、互動請求停滯 |
| Cursor | 編輯器登入、模型請求、程式碼上下文上傳與串流回傳 | 確認桌面應用程式繼承系統代理，專案終端與編輯器網路設定不要互相衝突 | 瀏覽器可用但編輯器逾時、補全停頓、登入回呼失敗 |
對照表的重點不是替工具貼上「快」或「慢」的標籤，而是確認請求從哪裡發出。瀏覽器、桌面應用程式、編輯器擴充功能、專案終端與自動化工作可能使用不同的代理設定。只有入口、驗證與業務請求都經過預期線路，連線結果才具備可重現性。
$ auth.session --stable
註冊登入階段的處理順序
驗證階段對出口變更更加敏感。先固定地區，再處理帳戶；不要把每個提示都視為線路故障。
先確定使用地區
開啟工具前先查看官方開放地區，選擇相符的線路。確定地區後再啟動瀏覽器或桌面應用程式，讓登入頁、身分驗證回呼與登入後主介面使用同一出口。若瀏覽器保留舊工作階段，可先登出帳戶並關閉相關頁面，再透過固定線路重新進入。
只清除必要的網站狀態
遇到登入循環時，優先清除對應工具的網站資料，不要一次刪除所有瀏覽器資料。接著檢查系統時間、瀏覽器隱私擴充功能與指令碼封鎖規則。某些登入回呼會開啟新分頁或跳轉至關聯網域，過度封鎖可能使驗證停在最後一步。
核對帳戶與服務政策
如果頁面明確顯示帳戶、地區或資格提示，應先依照官方說明處理。更換線路無法修改帳戶本身的地區資料，也不能取代工具要求的驗證流程。連續切換出口只會增加變數，讓後續排查更難重現。
$ compare web api
網頁版與 API不是同一條路徑
網頁能完成對話，不代表命令列或伺服器端呼叫已設定正確。兩者的驗證方式、網路出口與錯誤提示都不同。
網頁版著重工作階段完整性
網頁版通常由瀏覽器管理登入狀態，同時載入指令碼、介面請求與靜態資源。若只代理主網域，關聯請求仍可能從本地網路直接連線，最後可能出現頁面框架載入但內容區空白，或按鈕點擊後沒有回應。
排查時可先暫時關閉複雜分流，讓相關請求統一經過同一條線路；確認功能恢復後，再逐項收緊規則。瀏覽器擴充功能也可能自帶代理或請求過濾功能，需避免與系統通道重複接管。
API 著重程序出口與逾時
API 呼叫可能來自本地指令碼、容器、遠端主機或自動化工作。它不一定繼承瀏覽器代理，也不一定讀取桌面用戶端設定。應先確認發出請求的程序位於哪台機器，再檢查該環境的 DNS、代理變數、憑證鏈與出口地區。
串流介面還需要呼叫端持續讀取回傳內容。如果用戶端函式庫、反向代理或工作執行器提前結束連線，表面上像是網路中斷，實際原因可能在程式設定。金鑰只應放在受控的金鑰管理系統或環境設定中，不要寫入網頁、儲存庫與日誌。
分層檢查順序
- 請求來源：確認是瀏覽器、桌面應用程式、本地終端、容器還是遠端工作在發起連線。
- 解析路徑：確認網域解析與業務請求使用一致的網路路徑，避免解析結果與出口地區互相衝突。
- 代理繼承：檢查目標程序是否讀取系統代理，或是否需要在應用程式內另外設定。
- 驗證結果：區分網路逾時、權限不足、帳戶限制與請求參數錯誤，不要把所有失敗都歸因於線路。
- 串流讀取：確認呼叫端會持續接收回應，並允許工作在輸出期間維持連線。
$ dev.environment inspect
命令列、IDE 與 CI設定要點
開發者情境最常見的問題，是不同程序看到的網路環境並不相同。應按照執行位置設定，而不是依照畫面上看到的應用程式名稱設定。
23VPN(AI) / DEV-ROUTE
從程序邊界開始檢查
命令列：終端通常會繼承啟動時的環境。連線到線路後，已開啟的終端可能仍保留舊設定。重新啟動終端，再確認代理變數是否由目前工具讀取。若專案指令碼自帶網路設定，應避免它覆寫系統設定。
IDE 外掛：編輯器主程式、擴充功能主機與內建終端可能是不同程序。網頁驗證成功但補全沒有回應時，應分別檢查編輯器代理、擴充功能日誌與登入回呼。不要只用瀏覽器的存取結果判斷外掛網路。
容器：容器擁有獨立的網路邊界，主機已連線不代表容器會自動使用相同出口。需要確認容器如何存取代理、如何解析網域，以及重建後設定是否仍然存在。
CI：自動化工作執行於遠端環境時，本地 23VPN 線路不會自動延伸到該環境。應依據工作所在平台的網路政策設定合規出口，並使用平台提供的金鑰管理功能保存憑證。日誌只記錄必要狀態，不輸出完整驗證資訊。
開發環境也應避免「全域代理」與「應用程式代理」同時疊加。雙重接管可能引起迴圈、連線重複封裝，或讓請求落到非預期出口。建立設定時應遵循一項清楚原則：由哪一層負責轉送，就讓其他層維持預設；需要分流時，再依工具網域與程序逐步新增規則。
$ diagnose common-failures
常見失敗現象與成因
先記錄現象，再修改設定。一次只變更一個變數，才能判斷是哪個步驟產生效果。
頁面可以開啟，但提交問題後一直沒有輸出
登入完成後又返回登入頁面
網頁版正常，Cursor 或 Copilot 仍然逾時
API 在本地可用，放入 CI 後失敗
回答經常在中途停止
更換多個地區後，錯誤反而更多
$ route.select --final
AI 加速選線方法
先滿足地區與工作階段一致性，再判斷連線持續性，最後才比較日常使用體驗。
依官方開放範圍選擇地區
工具政策是第一項限制。先確認目標服務支援的地區，再從相應地區的線路中選擇。不要把線路名稱視為可用保證，也不要用頻繁切換地區取代帳戶與政策核對。
單次工作階段維持同一出口
登入、授權回呼、主介面與持續對話盡量使用同一地區。需要換線時，先結束目前工作階段，再重新開啟工具，減少舊連線與新出口混用。
確認真正發出請求的程序
瀏覽器測試只代表瀏覽器。IDE、終端、容器與 CI 應分別驗證代理繼承與出口路徑。開發者尤其要檢查應用程式層級設定是否覆寫系統設定。
使用相同工作比較線路
選擇固定工具、固定帳戶與固定操作流程，分別觀察登入、首段回應與長篇輸出是否持續。一次只更換線路，不要同時修改瀏覽器、DNS 與代理規則。