網路與開發手冊

AI 工具使用指南

依地區資格、帳號、網路和呼叫端分層排查。尚未設定 9WVPN 用戶端時,請先依照快速入門完成安裝、匯入訂閱和連線測試;若已連線但工具仍出錯,請接著參閱本手冊的相關章節。

平台資格與功能入口

先確認要使用的是哪項功能。開啟 ChatGPT 登入頁、進入既有對話、在應用程式上傳檔案,以及透過程式呼叫模型,是不同的使用情境。即使屬於同一品牌,帳號資格、工作區權限、支援地區和計費規則也可能分別判定。排查時請記下「產品、入口、功能」:例如網頁對話可以開啟,但檔案無法送出;不要只記「這個 AI 不能用」。這樣即使稍後需要向管理員求助,對方也能直接找到相關設定。

依使用情境查官方說明,別只憑品牌猜測

先到服務供應商的說明中心查詢目前產品入口支援的地區,再確認方案、帳號類型和組織管理要求。產品介紹頁能載入,只能證明目前環境收到該頁面的回應;這不代表具備開發者 API 的使用資格,也不表示特定模型已開放。若官方說明沒有列出某項功能,請查看帳號中的功能入口、管理員指派紀錄或客服回覆;別把他人的截圖當成本帳號已獲授權的證明。下表提供核對方向,並非即時支援清單。

依產品入口核對功能權限
工具先區分的入口優先核對項目
ChatGPT網頁對話、開發者 API工作區、專案權限及各自的計費設定
Claude網頁應用程式、開發者主控台帳號所屬組織與目標模型的使用權限
Gemini一般使用者應用程式、開發者或雲端專案入口Google 帳號類型及所選專案的服務設定
CopilotMicrosoft Copilot、GitHub Copilot各產品的登入身分、授權與組織政策
Midjourney網頁工作區及已連結的使用入口身分連結、帳號權益與工作狀態
Cursor編輯器內功能、個別設定的模型入口編輯器登入狀態、團隊政策與實際請求目標

區分地區判定、功能限制與內容限制

網路出口 IP 可能是地區判定的依據之一,但地區結果也可能與帳號資料、組織所在地、專案設定或產品本身的適用條件有關。瀏覽器介面語言只是顯示偏好,改成其他語言不代表地區資格也會改變。組織成員也可能受到管理員限制:同事的個人空間可以上傳檔案,不代表企業工作區也允許上傳。比較結果前,請先確認雙方使用相同的帳號類型、入口和功能,避免把組織設定問題誤認為網路線路問題。

留意錯誤發生的時機。若送出前頁面已明確提示不支援該地區,請以服務供應商公布的正式條件為準,停止反覆嘗試該入口;若實際資訊與提示不符,請保留提示原文,並透過官方管道確認。若已能進行對話,但某類內容遭拒,請查看產品政策與目前的工作內容,不要試圖更換網路出口來改變內容判定。若只是看不到新功能,請先確認該功能是否已開放給目前帳號、方案或管理員,再檢查頁面是否完整載入。

使用不含敏感資訊的任務進行測試

首次測試請使用可重複的短文字,不要上傳工作資料,也不要拿真實圖片或原始碼當測試樣本。測試文件功能時,請自行建立空白範例,內文只放一句公開文字。如此便能區分「任務內容觸發限制」和「上傳入口無法使用」,也能避免稍後提交故障截圖時洩露客戶資訊。測試結果只適用於目前入口和測試條件;一次短對話成功,不代表較長的生成、檔案處理或團隊功能也已驗證。

若產品需要切換工作區,測試前先確認頁面上目前使用的身分。瀏覽器帳號選單、編輯器帳號選單和雲端主控台的專案選擇器,可能各自保留上次的選擇;同一個電子郵件地址也可能對應個人空間和受組織管理的空間。交接結果時請註明所選空間與功能,但不必在共用文件中貼上成員資料。入口描述得越清楚,後續複查就越不容易混淆不同權限下的結果。

網路出口 IP 與網路連線

使用 AI 網頁通常不只是開啟一個網站。初始頁面、身分驗證、靜態資源、檔案上傳和生成請求,有時會連向不同目標。瀏覽器收到頁面框架,卻遲遲看不到對話清單,表示至少有部分請求成功,不能直接判定為「完全斷線」。反過來說,如果本機連網域名稱都解析失敗,反覆重新整理登入頁也不會得到新的線索。請先確認最早失敗的階段是網域解析、建立連線、憑證驗證、登入轉址,還是送出請求後讀取回應。

確認哪個程序使用了哪條連線路徑

先觀察用來測試的瀏覽器,不要只看用戶端介面的連線狀態。在同一個瀏覽器開啟站內的 IP 檢測,記下顯示的出口和發生時間,再回到工具頁重現問題。檢測頁反映的是連線至檢測服務時使用的路徑,不能證明 IDE、終端機、內嵌瀏覽器或目標 API 也走相同路徑。若瀏覽器和用戶端的結果不一致,請檢查是否有個別代理設定、應用程式分流規則或組織網路政策;優先確認實際送出請求的程序,不要直接修改整台裝置的網路設定。

出口地區的顯示結果只能作為線索。不同資料庫對同一個位址的標示可能不一致,站內檢測結果也不代表第三方平台採用相同資料來源。IP 風險控管不等於地區判定:服務供應商可能針對異常工作階段、共用出口的流量模式或不一致的登入環境加強檢查,即使位址顯示在支援地區也一樣。遇到安全驗證時,請依官方步驟完成;驗證結束前不要連續切換出口,也不要在同一輪測試中加入新裝置或新的登入身分。

分開檢查 DNS 解析與憑證問題

若錯誤訊息指出找不到主機名稱,請先從正式入口確認網域拼寫,再檢查目前應用程式使用的是系統 DNS、瀏覽器自己的 DNS 設定,還是由代理伺服器解析。終端機查得到位址,只能證明這次終端機查詢成功,無法證明應用程式實際使用相同的解析路徑。網路剛切換時,既有連線和快取也可能讓問題延遲出現。請記下使用的應用程式和網路,完成調整後重新開啟受影響頁面,避免同時修改多處而無法還原。

若瀏覽器明確提示憑證不受信任、憑證名稱不符或有效期限異常,請先確認系統時間、存取的網域,以及公共網路是否仍待完成驗證。若組織裝置經過安全閘道,請由管理員確認信任設定與處理範圍。不要為了開啟網頁而關閉憑證驗證,也不要安裝來源不明的根憑證。若遇到仿冒頁面或無法解釋的憑證錯誤,請先停止輸入帳號資料,再透過可信任的裝置或受管理的環境確認。

依使用情境比較線路,不把涵蓋範圍視為保證

在服務供應商允許的地區和網路環境中,如需比較連線狀況,可先開啟伺服器頁面查看地區與線路類型。中轉、直連和 IEPL 專線代表不同的線路配置方式,光看類型名稱無法判斷第三方功能是否開放。比較時請固定使用同一台裝置、帳號和測試任務,每次只變更一項條件。文字對話可觀察第一段是否出現及後續輸出是否持續;檔案任務則分別檢查上傳是否完成、任務是否開始處理,以及結果能否取回。

若連線狀況時好時壞,請比較問題是否與休眠喚醒、網路切換或特定時段有關。只記下「換了之後就好了」,很難排除平台負載變化或舊連線關閉造成的影響。更有用的紀錄包括:原請求停在哪個步驟、重新連線後是否在同一步恢復,以及其他目標是否也同時受影響。連續觀察幾次都指向相同條件後,再帶著紀錄聯絡線路服務供應商;否則請先將它保留為待驗證的假設。

帳號註冊與登入工作階段

9WVPN 帳號和 AI 平台帳號分開管理。9WVPN 不需要電子郵件地址,只要使用者名稱和密碼即可註冊;第三方工具則依各自要求建立身分或接受組織邀請。開始前請先確認目前是在設定 9WVPN 用戶端、登入 AI 網頁,還是將 AI 平台身分授權給編輯器。這些步驟的驗證頁面可能很像,但任何一方的訂閱連結、帳號密碼或復原資料,都不應填入另一方的表單。

從正式入口前往,先確認帳號身分

請使用服務供應商或組織提供的正式入口,依平台要求填寫真實資料,並保留可正常使用的帳號復原方式。已有帳號時,請使用先前的登入方式;透過組織登入建立的身分,不一定等同於從另一個入口手動建立的個人身分。受邀成員可向管理員確認邀請寄給哪個身分、是否已接受,以及授權是否已指派。看到「沒有工作區」不代表帳號不存在,也可能只是進入個人空間,或尚未完成組織邀請。

首次登入、異地出差後恢復工作階段,或在新裝置上使用編輯器,都可能觸發額外安全驗證。輸入憑證前,請先查看網址列與網站標示;驗證完成前,保持目前的分頁和連線環境,不要反覆啟動新的流程。使用密碼管理工具時,請為不同網站設定獨立密碼;啟用平台提供的多因素驗證後,請將復原資料妥善離線保存。若收到非本人發起的登入確認通知,請勿核准,並從可信任的入口檢查既有工作階段。

遇到轉址循環,檢查回呼流程,不只查密碼

登入流程可能先開啟身分提供者,再返回原本的應用程式。若一直在登入頁和授權頁之間來回,請記下最後一個能成功開啟的網域、瀏覽器是否封鎖彈出視窗,以及是否已返回發起登入的應用程式。隱私擴充功能、網站資料限制和過期工作階段都可能使流程失效。在授權條件允許的情況下,可以使用乾淨的瀏覽器設定進行一次對照,或只檢查相關網站的設定;不必清除所有網站資料,也不要全面關閉瀏覽器防護。

編輯器發起授權時,可能會用系統瀏覽器開啟頁面,完成後再將結果交回編輯器。若瀏覽器顯示成功,但編輯器仍要求登入,請確認瀏覽器是否詢問要開啟應用程式、開啟的是否為目前使用的那一份應用程式,以及組織是否限制外部回呼。遠端桌面、容器或遠端開發主機也可能使發起端和接收端位於不同環境。請優先使用工具支援的登入流程和官方診斷方式,不要將授權回呼網址交給他人,也不要在客服案件中貼上含工作階段參數的截圖。

區分工作階段過期、帳號異常與組織變更

開啟很久的分頁可能保留了過期狀態。若舊頁面出錯,但重新開啟正式入口後能正常登入,請先在新頁面確認目前帳號和工作區,再依目標應用程式的正常登出流程更新舊工作階段。若出現憑證錯誤,請使用官方帳號復原功能,避免連續嘗試不同密碼。若收到陌生裝置登入通知,請先從可信任的環境查看活動中的工作階段,撤銷不認識的工作階段,並依平台指引更換憑證;接著確認同一組織的成員權限是否遭到變更。

團隊管理者排查權限消失時,請先核對近期的人員異動、授權回收和組織安全政策,不要直接歸因於網路變動。專案仍然存在,但某位成員無法進入,通常應核對成員指派與登入身分;若整個團隊同時受影響,再優先檢查方案狀態、身分提供者或平台公告。提交支援請求時,請說明帳號通知、最近一次成功存取的入口及失敗步驟;不要提供完整登入紀錄、復原碼或訂閱連結。憑證保管方式請參閱訂閱連結與公共網路安全指南。

串流輸出與檔案任務

AI 網頁可以開啟,不代表能穩定接收生成結果。頁面載入通常只涉及有限長度的請求,串流輸出則會在同一個回應中逐步傳送資料。途中經過的閘道可能會等到累積足夠資料才轉送,也可能在一段時間沒有收到資料時關閉連線。因此,「等很久後一次出現」「看到開頭後停止」和「一直沒有第一段」並非同一種情況;記下具體發生的階段,比籠統地寫「速度很慢」更有用。

先分辨沒有第一段與傳輸中斷

先送出簡短且不含敏感資訊的文字,觀察任務是否進入生成狀態、是否出現第一段,以及是否正常完成。可行時,請固定使用同一帳號、工作區和入口,並以相同長度的範例重現。若連第一段都沒有,應檢查平台是否正在排隊、請求是否尚未送出、伺服器是否遲遲沒有回應,或中間層是否緩衝資料。若已看到開頭才中斷,則應留意連線閒置逾時、裝置休眠、網路切換或伺服器主動停止。比對時先看第一段與完成兩個階段,不要以網頁載入速度代替輸出狀況。

若平台提供官方狀態頁,請核對相關產品和故障時段,不要只看整體狀態顏色。瀏覽器開發人員工具的網路面板可用來檢查哪些請求持續等待、遭到取消或回傳錯誤;重現前先開啟面板,只查看請求類型、狀態和時間,不要複製完整的請求標頭。應用程式可能使用事件串流、一般串流回應,或另外建立即時連線通道;具體方式應以平台文件和實際觀察為準,不能因為文字逐字顯示,就認定一定使用 WebSocket。

短文字通過後,再測試長篇輸出和附件

先保留一個短文字成功的範例,再用不重要的內容測試較長的回覆,並記錄是否總在相近階段停止。若輸出在切換無線網路或喚醒裝置後中斷,而新請求可以成功,應優先檢查舊連線是否失效,而非帳號權限問題。不要連續點擊重新生成;請先確認原任務是否仍在執行,特別是可能產生費用或寫入結果的任務。若平台提供復原或繼續功能,請依照其機制操作,不要假設重新整理一定會遺失或保留結果。

附件任務應拆分為選取檔案、完成上傳、開始處理和取回結果幾個階段。選取後立即遭拒,先檢查格式、權限和平台允許的檔案範圍;進度逐步增加卻停住,請檢查上傳網路和裝置狀態;若上傳完成後一直等待,則查看任務是否正在排隊或解析失敗。縮短文件或改用平台允許的範例格式再測試,有助於區分文字內容與傳輸路徑的問題。不要為了測試而在個人空間上傳公司資料,也不要將原始檔案附在對外客服案件中。

受管理環境中的代理伺服器與緩衝

若管理員確認只有經過組織閘道的請求才會集中成批回傳,請記錄同類請求在閘道前後的時間差,並由管理員檢查目標路由是否設定了回應緩衝、閒置逾時和連線總時限。不同參數的用途不同:總時限關係到整個請求可執行多久;閒置逾時用來判斷一段時間沒有資料時是否關閉連線;緩衝則會影響已收到的內容何時交給用戶端。不要一味延長所有逾時設定;應在授權範圍內針對特定業務路由調整,並確認資源使用量和其他流量是否受到影響。

也要分辨串流傳輸和頁面呈現問題。若網路面板顯示回應已正常結束,只有某個瀏覽器的介面卡住,請維持相同網路和任務,比較該瀏覽器在乾淨設定下的狀況。頁面擴充功能、編輯器呈現方式和本機資源都可能影響顯示。在網路不變的對照測試中恢復正常,問題線索就比較偏向應用程式端;若同時更換瀏覽器和網路,則無法據此判斷。

API呼叫與錯誤分層

網頁能使用,只代表目前網頁工作階段具備相應的存取條件。API 請求還需要通過開發者專案、模型權限、金鑰授權和配額檢查。開始設定前,請先從服務供應商文件確認正式 API 入口、驗證方式和請求欄位;再到開發者主控台確認專案歸屬、計費狀態和可用模型。不要從網頁工作階段擷取憑證交給程式,也不要將一個平台的請求欄位直接複製到另一個平台。介面看起來相似,不代表權限、錯誤格式或串流事件定義相同。

依失敗階段判讀錯誤

用戶端尚未收到 HTTP 回應時,請先檢查 DNS 解析、連線、憑證和代理設定。收到回應後,再查看狀態、錯誤內文和請求識別碼。以下分類是診斷方向,不是只看狀態碼就下結論的規則:企業閘道也可能產生錯誤頁面,用戶端程式庫也可能把多種底層錯誤歸為同一種例外。請確認回應格式是否符合服務供應商文件,不要把代理伺服器回傳的登入頁誤認為模型 API 的權限提示。

依可觀察到的狀況選擇下一步
狀況優先查看的線索下一步
沒有收到回應DNS 解析、交握或連線異常檢查送出請求的程序及網路路徑
驗證或授權失敗專案、角色與金鑰適用範圍確認憑證所屬帳號與模型權限,不要盲目重送
流量受限或配額不足錯誤細節、配額面板與等待提示依速率限制提示降低請求速度,或處理計費與配額
只收到部分輸出最後收到的事件與用戶端結束原因檢查逾時設定、串流讀取邏輯與結束條件

不帶憑證的檢查與最小請求

以下命令可在安裝 curl 的終端機中執行,向範例網域發出一般 HTTPS 請求,捨棄回應內文,只輸出狀態,以及 DNS 解析、交握和收到第一個位元組各階段的時間。各項時間是從請求開始計算的累計值,不能直接相加視為彼此獨立的耗時。這只能協助確認目前終端機的基本連線,既不會驗證目標 API,也不會檢查模型權限。若命令成功但業務請求仍失敗,下一步應在獲授權的環境中依服務供應商文件發出最小業務請求,而不是把網域換成來源不明的 API。

curl -sS -o /dev/null \
  -w 'http=%{http_code} dns=%{time_namelookup} tls=%{time_appconnect} first=%{time_starttransfer}\n' \
  https://example.com/

這種寫法適用於類 Unix shell;在 Windows 上可使用 curl.exe,將空裝置改成 NUL,並依目前 shell 的換行規則分行或合併為一行。若發生錯誤,導致某項時間沒有有效值,請搭配錯誤訊息確認請求是否到達該階段。使用代理或連線重用時,有些數值只反映用戶端可見的部分路徑,不能視為目標服務的完整內部處理時間。這也不適合作為發布條件,因為能連上範例網站不代表業務所依賴的服務也能連線。

將除錯記錄與正式環境憑證分開

最小業務請求應先選擇有權使用的模型和簡短輸入,確認非串流結果後再啟用串流選項,以便定位差異。請透過系統憑證工具、受控環境變數或金鑰管理工具提供金鑰,避免將金鑰寫入程式碼儲存庫、命令歷程或前端頁面。記錄時優先保留專案代稱、失敗階段、請求識別碼和必要狀態資訊;請求內文、授權標頭和含憑證的網址不應出現在共用記錄中。只有在平台明確說明診斷片段不含機密,且確認過內容後,才提供給支援人員。

正式環境呼叫加入逾時和取消機制後,請區分用戶端放棄等待與伺服器確認停止;前者不代表遠端沒有繼續處理。對於會計費或產生寫入效果的任務,重送前先查詢既有任務狀態;若平台明確支援冪等選項,請依文件使用。串流請求則應記錄是否已交付部分內容,並在顯示時標示不完整,避免用戶端悄悄重新請求,造成結果和費用重複。

命令列、IDE 與 CI 設定

開發環境的重點不是哪個視窗顯示已連線,而是實際執行請求的程序在哪裡運作。若命令列在本機執行、IDE 外掛在遠端主機執行、CI 工作在代管執行器上執行,它們各自有不同的 DNS 解析路徑、代理設定、憑證信任和權限。即使三者使用相同程式碼,也不能直接套用本機的診斷結果。請先畫出「發起端 → 網路邊界 → 目標 API」的路徑,再進入相應的執行環境檢查。

命令列:確認環境變數是否套用至目前程序

常見的代理伺服器環境變數包括 HTTPS_PROXY、HTTP_PROXY 和 NO_PROXY,但用戶端是否讀取、優先順序和例外比對語法,都取決於使用的工具。請先查閱工具文件,再確認變數設定在執行命令的 shell,或啟動服務所使用的設定中。圖形介面應用程式不一定會繼承終端機變數;已執行中的程序也不會自動更新。檢查時只需確認變數是否已設定,以及目標是否符合例外範圍,不要將整段變數內容輸出至畫面或記錄,因為代理伺服器位址本身也可能含有憑證。

若請求走錯路徑,請先確認是用戶端設定覆蓋環境變數,還是例外清單符合目標。在測試環境中逐項調整並記錄結果,不要直接將正式專案的整個網域範圍加入例外。臨時設定應限制在本次測試的程序中,測試完畢後撤銷。憑證鏈異常時,請透過受管理裝置或執行環境的正式方式安裝已核驗的信任資料;不要用關閉驗證的參數掩蓋問題,也不要將從其他裝置匯出的信任檔案隨程式碼上傳。

IDE:找出擴充功能執行環境與登入回呼

Cursor 或其他編輯器中的 AI 功能,可能由主程序、擴充功能主機或遠端工作區送出請求。請確認外掛安裝在本機還是遠端工作區,並開啟對應程序的輸出記錄,查看失敗發生在登入回呼、模型請求、索引或上傳哪個階段。系統瀏覽器能完成驗證,不代表擴充功能主機也能呼叫 API;若已完成登入但專案操作失敗,也請檢查團隊政策和編輯器允許傳送的檔案範圍。

排查時先使用空白或公開範例專案,關閉本次診斷不需要的自動索引和背景工作,避免並行流量影響觀察。若範例可用、工作專案卻不行,請核對組織規則、專案大小、排除清單和權限,不要將專案複製到個人帳號測試。套用工具支援的代理設定後,請依要求重新載入相關程序,再重複相同操作;修改前記下原值,還原時只撤銷本次變更。

CI:分別設定出口、憑證與失敗處理方式

CI 工作在執行器中運作,不會繼承開發者電腦的網路出口和本機設定。請依組織規則確認執行器所在地區和對外連線政策是否符合平台要求,並確認容器可以解析正式網域,且信任組織核准的憑證。內部代理伺服器位址不一定能從執行器連線,尤其是只綁定本機的位址。先使用不含憑證的連線檢查確認基本路徑,再讓受控的測試專案發出最小請求,並記錄問題出在哪類執行器及哪個步驟。

請將業務金鑰存放在 CI 提供的機密管理機制中,並限制只有需要該金鑰的受保護工作可以存取;由外部貢獻觸發的流程不應取得正式環境金鑰。避免啟用會輸出環境資訊或請求標頭的除錯模式,並限制建置產物和故障記錄的存取範圍。若測試目的只是驗證提交格式和解析邏輯,可使用本機範例回應,不必每次測試都呼叫外部模型。必須驗證真實 API 時,請限制並行數和逾時時間,並事先訂定相依服務無法使用時,是停止流程還是標記為暫時無法驗證。這樣既能避免將外部異常誤判為程式回歸,也能防止重跑工作造成用量暴增。

速率限制、帳號限制與複查

「目前無法繼續」可能表示請求過於頻繁、專案可用配額不足、帳號需要安全驗證,或服務供應商暫停了某項權限。這些情況需要不同的處理方式。請先閱讀完整錯誤內文和帳號通知,再查看開發者主控台、工作區狀態及官方服務公告。只有錯誤明確指出速率問題時,才按速率限制處理;若看到帳號停用或資格限制提示,不要用自動重試取代人工複查。

速率限制:從請求來源降低負載

速率限制可能適用於專案、模型或組織,也可能依請求數、輸入量或同時執行中的任務數計算。請先確認錯誤指出的是哪個層級:同一組織中的不同應用同時開始失敗,應檢查共用配額;若只有某個批次工作失敗,則先核對該工作的並行數和請求大小。若平台提供等待時間,請依提示等待;若沒有明確等待指示,且文件說明錯誤可重試,可逐步延長等待時間並加入少量隨機間隔,避免多個工作同時恢復而再次造成壅塞。

重試應設定次數或時間上限,收到取消訊號時也應停止。透過統一佇列控制並行數,比讓每個工作程序各自重試更容易掌握負載。一般互動情境可在介面顯示稍後重試或排隊狀態,避免使用者因沒有回應而反覆送出。測試降低負載的效果時,請維持相同專案和請求類型,觀察執行中的任務減少後錯誤是否也隨之降低;不要藉由輪換帳號、金鑰或網路出口規避限制。這會讓記錄和帳單更難核對,也可能違反平台規則。

配額不足:調整計費或減少用量,不是等待

若錯誤內文指向預算、專案用量上限或計費狀態,請先到管理介面確認警示。短時間請求量暴增可透過排隊緩解,但預算用盡時,多等幾次再重送通常沒有幫助。請檢查批次工作是否超出原定計畫,特別留意逾時後自動重送、失敗後整批重跑和工具反覆呼叫等情況。可先暫停工作,再比對請求紀錄和帳單確認用量變化;若需調整預算或申請配額,請交由具備相應權限的人員處理。

輸入過長也可能直接超出請求範圍限制,這與等待配額窗口恢復是兩回事。請核對平台提供的輸入範圍、計量規則和模型設定,刪除重複的上下文,將獨立任務拆開,並明確規劃如何合併各份結果。不要為了減少輸入而移除必要的安全限制或錯誤檢查邏輯。符合服務供應商允許的請求範圍後,再以小型範例檢驗輸出品質,避免結果雖然完整,卻缺少關鍵上下文。

帳號限制:保留證據並使用官方複查管道

遇到帳號限制時,請先區分安全保護、組織政策與服務供應商的政策通知。短期安全驗證可能需要確認身分;組織權限異動應由管理員核實;若服務供應商暫停或關閉帳號,則依通知使用申訴或複查入口。了解並遵守平台適用範圍、帳號共用政策、內容規範和自動化用量限制,是避免操作失誤的基礎。不要反覆建立帳號或不斷切換登入環境,也不要借用其他成員的憑證完成任務。

若懷疑金鑰外洩,請先透過可信任的入口撤銷有風險的金鑰,更新依賴該金鑰的合法工作,再核對可疑請求和費用。處理報告可列出時間、專案、已採取的止損措施和仍待查明的影響,但不要貼上外洩的金鑰值。若請求遭組織政策封鎖,請向管理員說明用途、資料類型和所需權限,由管理員判斷是否能開通,或改採經核准的替代工作流程;不要讓個人環境處理原本應由企業環境管理的資料。

排查順序與問題交接

完整排查應從可重現的問題描述開始。先說明平台、入口、工作區類型、執行環境和失敗操作,再描述預期結果。與其寫「Claude 無法連線」,不如說明是網頁能開啟,但登入後又回到原頁,還是已進入工作區卻無法開始生成;與其寫「Cursor 網路出錯」,不如指出問題發生在本機編輯器登入、遠端擴充功能送出請求,還是工作區上傳。請描述可觀察到的現象,暫時不要在標題中直接認定故障原因。

依據證據逐步排查,不要逐項碰運氣

  1. 確認適用條件。核對官方地區說明、帳號類型和功能權限。若明確不支援,請停止比較網路;若資料與提示互相矛盾,請記下發生時間並提出複查。
  2. 找出最早的失敗點。無法解析時先查網路;登入回呼失敗時先查工作階段或回呼;已有明確權限錯誤時就查專案和組織。保留完整錯誤訊息,不要只用「連不上」概括。
  3. 進行單一變數對照。維持相同帳號、入口和不含敏感資訊的任務,只改變本次懷疑的條件。記錄問題是否能重現,以及還原變更後出現什麼狀況。
  4. 重新測試原本情境。基本功能成功後,回到原先的任務類型,確認附件、長篇輸出或遠端執行是否也已恢復。不要只因首頁能開啟就將問題標記為已解決。

例如網頁對話正常,但終端機 API 沒有回應,請先在實際執行命令的終端機檢查 DNS 解析和代理設定,並確認是否使用組織指定的網路;不要先清除瀏覽器的網站資料。反過來說,若終端機已從官方 API 收到專案權限錯誤,代表至少這次請求已到達能回傳錯誤的環節;接著應先確認回應來源和專案授權。若多台裝置同時在同一平台發生問題,再比對服務狀態與團隊設定異動,避免每位成員各自反覆調整線路。

確認服務範圍,再決定聯絡對象

帳號資格、模型權限和內容處理錯誤,請向相關 AI 平台或工作區管理員確認;特定專案的呼叫配額和帳單,請查看開發者主控台或聯絡專案負責人;本機憑證、組織閘道和執行器出口,則交由裝置或網路管理員處理。若需確認 9WVPN 用戶端、訂閱或連線狀況,可前往客服頁面聯絡相關管道。若尚未完成連線設定,請返回快速入門依序核對,不要在多種用戶端之間反覆匯入同一份訂閱。

選用 9WVPN 時,可在價格方案頁比較月訂閱和流量包:月訂閱流量會依開通日每月重置;流量包用完為止,永久不過期。估算用量時,請考量文字、附件和背景同步是否都經過同一連線,再依實際使用紀錄選擇;也可參閱流量包與月訂閱選擇指南。網路訂閱與 AI 平台的功能權限和呼叫配額彼此獨立,升級網路方案不會改變第三方工作區權限。

交接資料應保留必要證據

提交問題時,請註明含時區的發生時間、產品入口、系統和執行位置、錯誤摘要、是否收到任何輸出,以及最能區分問題的一次對照結果。API 請求可附上平台產生的請求識別碼,但不要附上授權標頭、密碼、訂閱連結、完整回呼網址或原始請求內文。截圖請裁掉帳號詳細資料、工作區識別資訊和對話內容;若能用公開範例重現,就請改用範例。若必須分享詳細記錄,請先依組織規定遮蔽敏感資訊,並使用支援單位認可的私密管道。

問題解決後,請記錄實際變更的設定和觀察到的結果。若平台故障自行恢復,且沒有找到本機原因,請註明「已恢復,原因未確認」,不要寫成線路已修復。若排查時啟用過測試權限或暫時調整代理設定,結束後請予以撤銷。團隊可以保留不含機密的排查紀錄,記下負責人、複查入口和已知限制;下次遇到類似狀況時,先沿用現有證據,而不是照抄過去的結論。