将桌面客户端与账户关联

概述

要让 Whisperer macOS 客户端访问您的会话、订阅和知识库，您需要将其与账户进行一次关联。仅安装应用并不能自动获得访问权限——设备需要经过授权（设备验证）。

关联基于安全的一次性码流程：应用发起登录请求，您在浏览器中完成身份验证，获取一次性验证码，浏览器随后将您重定向回应用。验证码是一次性的，有效期为 30 分钟。

适用场景

  • 安装客户端并完成权限向导后。
  • 在新电脑或重装系统的电脑上登录时。
  • 当应用无法识别您的账户时（您已退出所有设备、更改了密码等），需要重新关联。

操作步骤

  1. 在应用中发起登录。 在 Mac 上打开 Whisperer 并启动登录/关联流程。应用向服务器请求一次性验证码（POST /v1/auth/desktop/code），并在浏览器中打开关联网页 /app/connect。
  2. 在浏览器中登录账户。 在 /app/connect 页面上，使用邮箱和密码登录。如果您还没有账户——请先注册并确认邮箱（参见注册与登录）。邮箱未确认前无法登录。
  3. 确认设备关联。 登录后，网页控制台将一次性验证码与您的账户绑定。
  4. 返回应用。 浏览器会通过 whisperer://auth?code=...&state=... 协议自动跳转回 Whisperer。若出现系统提示"在 Whisperer 中打开？"——请确认。
  5. 等待验证码换取令牌。 应用将一次性验证码换取访问令牌，并将其存储在安全存储中（加密）。之后，客户端即与您的账户完成关联。
  6. 验证。 确认应用中显示您的账户和套餐信息。现在可以开始会话了。

截图

📸 [截图：macOS 客户端的登录发起界面]

📸 [截图：带有登录表单的 /app/connect 网页]

📸 [截图：macOS 系统提示"在 Whisperer 中打开？"（whisperer:// 协议）]

常见问题

  • 验证码已过期。 一次性验证码有效期为 30 分钟。若耗时过长或中途中断，关联将无法完成。解决方法：返回应用重新发起登录——系统将签发新的验证码。
  • 浏览器未跳转回应用。 若 whisperer:// 协议跳转未自动触发，请确保 Whisperer 已安装在"应用程序"文件夹中，然后重新登录。当出现打开应用的系统提示时——请确认。
  • 登录失败——邮箱未确认。 邮箱未通过 6 位验证码确认前无法登录。请先确认邮箱，然后重试。
  • 打开了多个 /app/connect 标签页。 同时打开多个关联页面会导致流程出错。请关闭多余的标签页，并从应用重新开始关联。
  • 账户被冻结或封禁。 若账户状态为 frozen/banned，关联将无法完成——请联系客服。

最佳实践

  • 安装后立即进行关联，不要拖延——这样可以轻松在验证码 30 分钟的有效期内完成操作。
  • /app/connect 页面只在一个标签页中保持打开。
  • 若您更改了密码或退出了所有设备，请重新关联客户端——旧令牌已失效（token_version）。
  • 不要手动传递一次性验证码，也不要分享 whisperer://auth?... 链接——它是专属于您设备的密钥。

相关文章