在 Studio 中打开云盘文件

用 View in 3D viewer 打开云端文件，扫描或方案会在 Cympha Studio 中显示，您可以在把它附到所属牙科病例之前先查看或测量.

**适用对象：**云盘中已有 3D 文件（扫描、治疗方案、Cympha 项目包）、希望在 Cympha Studio 中查看——测量、复核、截图——而无需先附加到病例的临床医生、Lab Manager 和设计师.

**完成后您将掌握：**Studio 支持打开哪些文件格式、View in 3D viewer 操作位于何处、Studio 打开文件后会做什么，以及如果您决定把文件变成病例，它与病例工作流如何衔接.

**所需时间：**几秒钟. 整个流程两次点击：打开行菜单，点击查看.

开始之前

您需要：

文件已位于您 app.cympha.com/cloud 的云盘中. 若尚未上传，请先参见管理您的 Cympha Cloud 文件.
文件为可查看格式. Cympha Studio 的"按 URL 打开"入口识别：
- .stl、.ply、.obj — 标准 3D 网格（口内扫描、模型导出）.
- .gvw、.gvw.zip — GuideMia OrthoPlus 治疗病例文件. 携带了规划的牙位、分割以及先前设计会话中的标注.
- .cyp — Cympha 项目包（含清单与资源的单个 zip）. Studio 直接通过预签名 URL 打开.
现代浏览器. Studio 完全在浏览器中运行——桌面端的 Chrome、Edge、Firefox、Safari. 在移动端能加载，但工作区为真实屏幕设计.

不带病例的 Studio —— 从 My Cloud 打开是查看者模式的交接. 您是在检查文件. 要开展真正的设计工作（请求变更、保存回 .cyp、运行 AI 类别），需要病例——参见 create cympha case from Studio 了解 Studio 内的路径.

步骤 1 — 在云盘中找到文件

打开 app.cympha.com/cloud 并导航到包含该文件的文件夹. My Cloud 浏览器顶部的面包屑显示您所在位置；点击任意段即可跳回上层.

每个文件行显示文件名、大小（B/KB/MB）和右侧的三点 More actions 菜单.

步骤 2 — 打开行菜单

在文件行点击三点 More actions 按钮. 菜单包括：

Download — 始终显示.
Share — 将文件发送给他人（参见从云盘分享文件）.
View in 3D viewer — 仅当 Cympha 识别扩展名为可视化时显示. 若您看到的是 Open in browser，则该文件不是 Studio 处理的 3D 格式——点击只会在新标签页中下载/打开原始文件.
Rename、Move、Delete — 文件管理操作，详见管理您的 Cympha Cloud 文件.

步骤 3 — 点击 "View in 3D viewer"

点击 View in 3D viewer. 会发生两件事：

Cympha 为该文件生成一个短期有效的预签名下载 URL（经过认证、会过期、直接指向您存储的链接）.
一个新浏览器标签页打开 Studio 的"按 URL 打开模型"入口：https://studio.cympha.com/#/new?model=<presigned-url>. Studio 自动检测该 URL 指向的是网格、.gvw 项目还是 .cyp 包，并分派到对应的加载器.

您无需为此另行登录 Studio——文件通过预签名 URL 提供，不经 Studio 自身的认证. 如果文件很大（CBCT、复杂的 .cyp），Studio 在流式传输时会显示加载状态.

为什么是预签名 URL 而非直接链接 —— 您的云盘文件是私有的. 预签名 URL 是一次性、短期签名，允许 Studio 在不暴露凭据的情况下获取字节. 该 URL 几分钟后失效；无法作为永久链接分享.

步骤 4 — 在 Studio 中工作

可执行的操作取决于文件类型：

网格（.stl、.ply、.obj） — 环绕、缩放、以毫米为单位测量两点间距离、截图. 原始网格不附带分割或规划状态，因此工作区是通用网格查看器.（断层切片视图是 CBCT 功能——需要加载 DICOM 体数据，而非网格.）
.gvw / .gvw.zip — Studio 作为 GuideMia 项目加载. 获得分割好的牙位、所有规划位置以及底部的步骤栏. 便于在不持有副本的情况下复核设计.
.cyp — 完整的 Cympha 项目包. Studio 读取清单并恢复工作区状态——分割、方案、标注，所有已保存的内容.

您可以：

截图并保存到本地.
测量与标注（标注在会话内存在，除非保存）.
将工作另存为 .cyp — 如果想保留工作，请通过 Studio 汉堡菜单中的 Save project as… 另存为新的 .cyp，然后将该 .cyp 上传回您的云盘.
将修改后的病例方案推送回云端 — 对于从云端 URL 打开的 .gvw，已登录的复核者会在病例栏看到一个云上传按钮，可将修改后的病例方案直接保存回源文件旁边，无需下载步骤.
从这里创建病例 — Studio 有一个 Create Cympha Case 操作，会将当前场景作为新病例的起点. 参见 create cympha case from Studio.

步骤 5 — 多选（变通方法）

行内菜单一次只能打开一个文件——本版本中没有多选 Open in Studio 操作. 如果您需要在同一个 Studio 会话中查看多个文件，两种变通方法：

**将它们保存为单个 .cyp 包. **如果它们是同一设计的组成部分（上颌扫描 + 下颌扫描 + 咬合），规范做法是创建包含全部内容的项目包. 在 Studio 中构建一次，上传回 My Cloud，之后一次 View in 3D viewer 点击即可加载全部.
**每个文件在各自标签页打开. **依次在每个文件上点击 View in 3D viewer. 每个都在独立的 Studio 标签页打开. Studio 标签页之间相互隔离，您可在它们之间切换但不能共享状态.

后续会发生什么

文件保留在 My Cloud——查看不会移动或修改它.
查看不会覆盖原文件. 对于网格和 .cyp 包，您在 Studio 中所做的更改仅存在于该 Studio 标签页，除非您显式保存并重新上传. 对于从云端 URL 打开的 .gvw，已登录的复核者可以用云上传按钮将修改后的病例方案推送回去——它保存在源文件旁边，而不是覆盖源文件.
如果您认为该文件是真实工作流的起点，请使用 Studio 的 Create Cympha case 操作（参见 create cympha case from Studio），或关闭 Studio 并使用从云盘文件夹创建病例走文件夹驱动路径.
预签名 URL 会过期. 如果您将 Studio URL 加入书签，过期后会失效;请从 My Cloud 重新打开以获取新的 URL.

疑难解答

**菜单显示 "Open in browser" 而非 "View in 3D viewer". **该文件的扩展名不在 Studio 识别的 3D 范围内. 要么是非 3D 文件（PDF、图片、文档），要么是 Studio 当前不解析的格式. 请改用 Download，或转换/导出为支持的格式之一（.stl、.ply、.obj、.gvw、.gvw.zip、.cyp）.

**Studio 标签页打开了但场景是空的. **通常是 Studio 还未抓取就预签名 URL 过期了，或文件损坏 / 扩展名伪装. 关闭标签页，回到 My Cloud，再次点击 View in 3D viewer 以获取新的 URL.

**提示框显示 "Could not open viewer". **云盘 API 的预签名 URL 请求失败——最常见是瞬态认证抖动. 刷新云盘页面后重试. 若仍然失败，您的会话可能已过期；请退出登录后重新登录.

**Studio 显示了文件但它巨大 / 方向错误 / 漂浮在空中. **这是源文件的问题，而非 Studio. 原始网格带有自身的坐标系；如果它从非牙科工具导出，方向可能与 Cympha 的约定不一致. 使用 Studio 的变换工具重新定位，或在原始软件中以合理的参考框架重新导出.

**我在 Studio 中做了更改，想保存到云盘. **对于从云端 URL 打开的 .gvw，登录后使用云上传按钮将修改后的病例方案推送回去. 其他情况，请通过 Studio 汉堡菜单（Save project as…）保存到本地机器，然后将该 .cyp 上传回 My Cloud——这将成为原文件旁边的新文件.

**我想让这个文件进入病例，而不仅是查看. **两条路径：(1) 关闭 Studio，回到 My Cloud 的文件夹，使用 Create case from folder（参见从云盘文件夹创建病例）；(2) 在 Studio 内使用 Create Cympha case 从当前场景开立病例（参见 create cympha case from Studio）.