Cympha
全部文档

设备配对：安装并配对 Cympha Agent Manager

设备配对把运行 Cympha Agent Manager 的 Windows 工作站连接到 Cympha 的牙科病例管理，本文介绍如何安装 Agent、在账号中配对并批准它，并通过托盘图标确认它正常运行.

适用人群： 第一次在 Windows 工作站上配置 Cympha Agent Manager 的设计师、技工所经理和 AlignerBot 操作员. 你应该已经有一个 Cympha 账号.

读完你会掌握： 如何安装 Agent、把它配对到你的 Cympha 账号，以及如何读懂托盘状态判断它是否在工作.

所需时间： 大约十分钟. 其中大部分是安装程序运行的时间，加上你的杀毒软件做决定的时间.

开始之前

检查以下事项：

  • **Windows. ** Agent 只支持 Windows —— Windows 10 或 11，64 位. 不支持 Mac 和 Linux 工作站. 如果你用的是 Mac，技工所经理需要专门配一台 Windows 机器做 AlignerBot 工作.
  • **你的 Cympha 账号邮箱. ** 与你登录 app.cympha.com 用的是同一个邮箱. 配对时你要在 Agent 里输入它，准备好.
  • **一个已登录的浏览器会话. ** 在你的默认浏览器里打开 app.cympha.com 并提前登录，再去点 Approve. 审批会在你当前打开的任意 Cympha 页面上以应用内模态弹出 —— 没登录的话，模态弹不出来.

第 1 步 —— 下载安装程序

登录 app.cympha.com. 应用会直接把你链接到安装程序文件 —— 最简单的触发方式是在任意病例上点 Upload via Agent（此时机器上还没装 Agent），会弹出带下载链接的安装对话框.

下载文件是单个安装程序 .exe. 保存下来的文件名中可能带有版本号. 存到你的 Downloads 文件夹.

为什么不上 Microsoft Store？ Agent 要访问本地文件（你的扫描仪导出文件夹、OrthoPlus 工程文件夹）并在系统托盘里运行. Store 沙箱里的应用做不到，所以我们提供一个常规安装程序.

第 2 步 —— 运行安装程序

双击 .exe. Windows SmartScreen 第一次可能弹出 "Windows protected your PC" 警告 —— 点 More info，再点 Run anyway.

安装程序是标准的"下一步/下一步/安装"向导；默认值即可. 点 Install，等进度条，最后点 Finish. Agent 自动启动，一个 Cympha 小图标出现在系统托盘里（任务栏右下角，时钟旁边）. 全新装的 Windows 上你可能需要点显示隐藏的图标箭头才能看到它.

托盘提示读作 Cympha Agent Manager.

第 3 步 —— 打开托盘菜单

右键 Cympha 托盘图标. 你会看到这个菜单：

  • Show window
  • Pair to Cympha…（Unpair from Cympha 仅在配对后才出现在这里）
  • File Monitoring（子菜单：Configure folders…、Start monitoring、Show pending files）
  • Cloud Monitoring（子菜单：Configure workspace…、Start monitoring、Show panel、Reset sync state…）
  • CBCT Segmentation…
  • Cancel CBCT Segmentation
  • AlignerBot（子菜单 —— 只有当该工作站装了 GuideMia OrthoPlus 时才出现）
  • Quit

刚装完时你还没配对. 点 Pair to Cympha….

第 4 步 —— 输入你的 Cympha 账号邮箱

弹出一个标题为 Pair to Cympha 的对话框. 导语写着 "Enter the email of the Cympha account you want to pair this Agent Manager to. After you submit, open Cympha in your browser (signed in to that account) and approve the request."

下面是一个标签为 Cympha account email: 的输入框，占位符 you@example.com. 输入你登录 app.cympha.com 用的同一个邮箱（例如 sarah.lin@smile-lab.com）. 点 Send pair request.

Agent 把请求发到 Cympha，然后开始轮询你的批准. 不会自动打开浏览器标签 —— 你自己切过去.

为什么需要两台设备？ 任何能在你笔记本上跑安装程序的人都能在对话框里输个邮箱. 我们要确保是真正的你 —— 已经在 Cympha 上登录的那一位 —— 从一个独立的、已认证的会话里批准这次配对. 这就是为什么需要浏览器这一侧.

第 5 步 —— 在浏览器里批准请求

切到浏览器，如果没开就打开 app.cympha.com，并确认你登录的就是步骤 4 里输入的那个邮箱对应的账号.

几秒内，无论你当前停在 Cympha 哪一页，都会弹出一个标题为 "Cympha Agent pair request" 的模态. 它会提醒你：只有当这是你在自己机器上触发的请求时才批准. 模态列出你账号下所有待处理的配对请求，每条显示：

  • 工作站主机名（例如 DESKTOP-SARAH-LIN）.
  • OS 字符串.
  • Agent 版本.
  • Install ID（一个短标识，方便你区分是笔记本还是台式机）.
  • 请求提交时间，以及过期时间.

如果信息都对得上，在那一行点 Approve（或者如果不是你发起的就点 Deny）. 没有待处理请求后模态自动关闭.

如果模态没立刻出来，在 Cympha 里切到另一个标签页再切回来，或者刷新一下 —— 模态在应用挂载/聚焦时拉取.

切回 Agent. 几秒内（它每 3 秒轮询一次），配对对话框关闭，Agent 记录配对令牌. 完成.

配对以长期凭据的形式保存在你的 Windows 用户配置中 —— 即使你在浏览器里登出 app.cympha.com，也不需要再来一遍. Agent 在重启和升级之后保持已配对.

接下来会怎样

  • **Cloud Monitoring. ** 打开托盘菜单 → Cloud Monitoring → Configure workspace… 选一个本地文件夹. 配置完成后，Agent 订阅你的 Cympha 病例 —— 一旦病例分给你（或 AlignerBot），相关文件会自动落到工作区. 每次都会有一条简短的托盘通知.
  • **File Monitoring 默认关闭. ** 如果你想让 Agent 监视你的扫描仪导出文件夹，并在每次有新文件出现时提示你创建病例，用 File Monitoring → Configure folders… 和 Start monitoring. 对椅旁扫描仪设置有用，纯设计工作不必.
  • AlignerBot 从自己的子菜单运行（如果 OrthoPlus 已安装）：AlignerBot → Configure… 和 Start AlignerBot. 子菜单里的 "Idle" 行是只读标签，显示 worker 的实时状态.
  • **更新. ** 新版本发布时，Agent 会显示一个横幅，带 Download 按钮，点击后在浏览器中打开下载地址 —— 它绝不会自行安装任何东西. 由你决定何时运行新安装程序；配对在升级后保留.

疑难排查

**浏览器里从没弹出审批模态. ** 确认你登录 app.cympha.com 用的是你在 Agent 里输入的完全相同的邮箱. 试着切到另一个 Cympha 标签页再切回来，或者刷新页面 —— 模态在应用挂载/聚焦时拉取. 如果你输入的邮箱没有对应的 Cympha 账号，什么都不会发生 —— 请求会静静过期，不会送达任何人，请仔细核对地址. 配对请求的有效期为 1 小时；超时后 Agent 会显示 "Last pair request expired. Click 'Pair to Cympha' to send a new one."

**审批模态显示的工作站不对. ** 每行对应一个待处理请求. 如果你在 Agent 里多次点过 Send pair request，你会看到多行 —— 批准主机名和提交时间匹配的那一行，Deny 其它的.

**我点 Approve 后 Agent 对话框还显示 "Pending". ** Agent 每 3 秒轮询一次；稍等. 如果超过这个时间还在 pending，在 Agent 对话框里点 Cancel，重新走 Pair to Cympha…. 如果还卡，你的工作站可能在企业代理后面，https://api.cympha.com 被拦了 —— 请 IT 放行.

**我配对了错的邮箱. ** 右键托盘图标 → Unpair from Cympha，再用正确的邮箱走一次 Pair to Cympha…. 注意桌面端的 Unpair from Cympha 只会遗忘存储在这台机器上的凭据 —— 要清理账户侧，还需在该账户 Cympha 个人资料的 Paired Agents 区域移除这台机器.

**AlignerBot 子菜单不在. ** 该工作站上没检测到 GuideMia OrthoPlus. 先装 OrthoPlus，然后重启 Agent Manager.

**点 "Run anyway" 之后 Windows SmartScreen 还是拦截安装程序. ** 你的 IT 部门大概以严格模式启用了 SmartScreen. 他们需要把安装程序加白，或者用管理员账号代你运行.

*相关教程：如果还没在你的技工所上启用 AlignerBot 服务，看 Onboard your lab on Cympha —— 服务启用后 Agent 才有病例可拉. *

CymphaLMSCymphaStudio