从病例页面通过 Agent 上传

Upload via Agent 把 Windows 工作站上的文件直接附到 Cympha 牙科病例，可先修复网格，日志中会记录文件的来源.

适用人群： 在 Cympha 上查看病例、想直接从 Windows 工作站附加文件（典型场景：扫描仪导出、CBCT 归档、治疗记录）而不必先拖到浏览器里的临床医生、技工所经理、案件工作人员. 终态：文件已挂到病例上，活动日志显示 via Cympha Agent 条目.

读完你会掌握： Upload via Agent 按钮在病例页上的位置，点完会发生什么，以及当 Agent 不在它该在的地方时怎么处理.

所需时间： Agent 已配对时不到一分钟 —— 大部分时间是文件选择器本身. 首次设置是另一个任务，由 Install and pair Cympha Agent Manager 单独覆盖.

开始之前

关于这个特性，有几件事要先了解：

**只在桌面端可用. ** Upload via Agent 只出现在真正的桌面浏览器上 —— 也就是带鼠标（或触摸板）、能 hover 的设备. 在手机和平板的触摸模式下按钮会被隐藏，因为 Cympha Agent Manager 是一个 Windows 托盘程序，那些设备本来也跑不了. 如果你以为按钮会出现在 iPad 上结果没有，原因就在这里 —— 用旁边那个普通的 Upload 替代.
**需要在你正在使用的同一台 Windows 工作站上安装并配对 Cympha Agent Manager. ** 网页应用通过你自己机器上的本地连接寻找 Agent；没有远程模式. 配对是一个显式步骤——托盘菜单的 Pair to Cympha… 加上浏览器中的批准——必须先完成配对，Agent 上传才能工作. 如果还没安装，请先完成 Install and pair Cympha Agent Manager.
**先打开一个病例. ** 这是按病例执行的操作. 前往 app.cympha.com/cases/<your-case-id>（任何你能看到的病例，例如通过侧边栏的 Cases）. 然后滚动到页面底部的 Activity 区域.

步骤 1 — 找到按钮

在病例页上，Activity 区域底部有一个撰写行，右侧有一组小按钮，其中包括 Upload 和 Upload via Agent.

按钮正下方有时会出现一行小的内联状态：

Agent not running — click to start（琥珀色）—— 你在此账户上配对过 Agent，但托盘程序当前没有在这台机器上运行. 点击按钮会尝试唤醒它.
Agent not installed — click to download（灰色）—— 你的账户没有配对记录，因此系统认为你从未安装过. 点击按钮会打开安装对话框.

如果两行都没有出现，说明 Agent 正在运行且可达 —— 这是顺利路径.

步骤 2 — 点击 Upload via Agent

接下来发生什么，取决于网页应用在你机器上找到了什么：

**Agent 可达. ** 提示框确认 Agent 已接下任务. 切换到 Agent（它会把自己的窗口带到前台，或到系统托盘找它），继续步骤 3.
**Agent 不可达但已安装. ** Windows 会尝试通过安装程序注册的链接启动它. 你会短暂看到 "Starting your Agent Manager…" 的提示，系统给它几秒时间启动. 如果它应答了，上传照常进行.
**Agent 确实不存在. ** 会打开安装对话框. 按照安装说明操作、启动托盘程序，然后在对话框中按 Continue —— 上传会从中断处继续，无需再次点击 Upload via Agent. 完整的首次流程（包括配对）见链接的安装指南.

步骤 3 — 在 Agent Manager 中选择文件

Agent 接下任务后，会打开原生 Windows 文件选择器. 选择一个或多个文件并点击 Open.

Agent 会把选中的文件交给一个自动在浏览器中打开的小型工作页. 你会看到带每个文件进度行的状态卡片. 文件字节直接传输到存储——不会经过 Cympha 的 API 服务器. 请保持该标签页打开，直到显示 Upload complete —— 上传中途关闭会中止正在进行的传输.

之后会发生什么

上传完成后，工作页标签显示 Upload complete. 切回病例页查看活动日志. 你会在顶部附近看到一条新条目：

Sarah Lin uploaded scan-upper-arch.stl via Cympha Agent (DESKTOP-SARAH-LIN)

via Cympha Agent 后缀和括号中的机器名，将它与同一个人的浏览器上传区分开. 活动日志的更多约定见 Read the case activity log.

疑难解答

**按钮完全不可见. ** 按顺序检查两件事：(1) 你在真正的桌面浏览器上（不是手机/平板触摸模式）；(2) 病例页 Activity 区域的撰写行可见 —— 只读的共享视图会隐藏所有上传按钮.

**内联状态显示 "Agent not running — click to start"，点了没反应. ** 手动打开托盘图标（任务栏右下角的 Cympha 图标 —— 可能需要点显示隐藏的图标箭头）. 如果图标也不在，说明 Agent Manager 确实没在运行 —— 从开始菜单启动它，然后再次点击 Upload via Agent.

**我收到 "Cympha Agent Manager error — Couldn't reach the Agent Manager." ** Agent 可能崩溃了，或者你机器上的安全软件拦截了浏览器与 Agent 之间的本地连接. 右键托盘图标选择 Show window 看它是否有响应；如果没有，Quit 后从开始菜单重新启动.

**文件选择器在 Agent 中打开了，但我取消了. ** 没问题 —— 任务会在 Agent 侧被静默丢弃. 再次点击 Upload via Agent 开始新任务.

**工作页卡在 "Sign in to continue your upload". ** 工作页标签在一个未登录的浏览器上下文中打开了. 通过该页面上的 Sign in 按钮登录；上传会从中断处继续.

**活动日志显示上传者是我，但不是我干的. ** Agent 配对到你的 Cympha 账户；任何能在你工作站上运行托盘程序的人都能以你的名义上传. 如果担心这一点，请在你不信任的工作站上通过托盘菜单 Unpair from Cympha（这会遗忘存储在那台机器上的凭据），或在 Cympha 个人资料的 Paired Agents 区域撤销配对.

最后更新 2026-07-30.