將桌面客戶端與帳戶關聯
概述
要讓 Whisperer macOS 客戶端訪問您的會話、訂閱和知識庫，您需要將其與帳戶進行一次關聯。僅安裝應用並不能自動獲得訪問權限——裝置需要經過授權（裝置驗證）。
關聯基於安全的一次性碼流程：應用發起登入請求，您在瀏覽器中完成身分驗證，獲取一次性驗證碼，瀏覽器隨後將您重定向回應用。驗證碼是一次性的，有效期為 30 分鐘。
適用場景
- 安裝客戶端並完成權限嚮導後。
- 在新電腦或重灌系統的電腦上登入時。
- 當應用無法識別您的帳戶時（您已退出所有裝置、更改了密碼等），需要重新關聯。
操作步驟
- 在應用中發起登入。 在 Mac 上開啟 Whisperer 並啟動登入/關聯流程。應用向伺服器請求一次性驗證碼（
POST /v1/auth/desktop/code），並在瀏覽器中開啟關聯網頁/app/connect。 - 在瀏覽器中登入帳戶。 在
/app/connect頁面上，使用電子郵件和密碼登入。如果您還沒有帳戶——請先註冊並確認電子郵件（參見註冊與登入）。電子郵件未確認前無法登入。 - 確認裝置關聯。 登入後，網頁控制檯將一次性驗證碼與您的帳戶綁定。
- 返回應用。 瀏覽器會透過
whisperer://auth?code=...&state=...協議自動跳轉回 Whisperer。若出現系統提示"在 Whisperer 中開啟？"——請確認。 - 等待驗證碼換取令牌。 應用將一次性驗證碼換取訪問令牌，並將其儲存在安全儲存中（加密）。之後，客戶端即與您的帳戶完成關聯。
- 驗證。 確認應用中顯示您的帳戶和套餐資訊。現在可以開始會話了。
常見問題
- 驗證碼已過期。 一次性驗證碼有效期為 30 分鐘。若耗時過長或中途中斷，關聯將無法完成。解決方法：返回應用重新發起登入——系統將簽發新的驗證碼。
- 瀏覽器未跳轉回應用。 若
whisperer://協議跳轉未自動觸發，請確保 Whisperer 已安裝在"應用程式"資料夾中，然後重新登入。當出現開啟應用的系統提示時——請確認。 - 登入失敗——電子郵件未確認。 電子郵件未透過 6 位驗證碼確認前無法登入。請先確認電子郵件，然後重試。
- 開啟了多個
/app/connect標籤頁。 同時開啟多個關聯頁面會導致流程出錯。請關閉多餘的標籤頁，並從應用重新開始關聯。 - 帳戶被凍結或封禁。 若帳戶狀態為
frozen/banned，關聯將無法完成——請聯絡客服。
最佳實踐
- 安裝後立即進行關聯，不要拖延——這樣可以輕鬆在驗證碼 30 分鐘的有效期內完成操作。
/app/connect頁面只在一個標籤頁中保持開啟。- 若您更改了密碼或退出了所有裝置，請重新關聯客戶端——舊令牌已失效（token_version）。
- 不要手動傳遞一次性驗證碼，也不要分享
whisperer://auth?...連結——它是專屬於您裝置的金鑰。