Cympha
全部文档

在 Studio 中打开 .cyp 并完善方案

设计师在 Cympha Studio 中以与医生相同的视角、颜色和照片打开 .cyp，再切换到 GuideMia 的隐形矫治器软件 OrthoPlus 完成分步工作.

适用人群： 刚接到分派、想在动手前先看到医生当时所看到的那个场景（同样的镜头角度、同样的测量、同样的照片库）的设计师.

读完你会掌握： .cyp 文件落在硬盘的哪里，如何在 Cympha Studio 里打开它，如何读懂继承下来的视图，以及如何切换到 OrthoPlus 做正畸方面的细调，最后把结果保存回去.

所需时间： 第一次大约八分钟. 来回流程熟练后，每个病例约两分钟.

开始之前

你需要：

  • 一个角色为 Designer 的 Cympha 账号（或代行设计师职责的 Lab Manager）. 如果你还在待审状态，请看 A designer's first day on Cympha —— 在技工所经理批准之前，你的分派队列是空的.
  • 已安装的 Cympha Agent Manager，托盘里显示 Paired. 安装 + 配对的步骤见 Install and pair Cympha Agent Manager.
  • 已配置的 Cloud Monitoring 工作区. 右键托盘图标 → Cloud Monitoring → Configure workspace…，用 Choose folder… 选一个文件夹. 在你选定之前对话框显示 (not set)——没有默认路径——选好后监控自动启动.
  • 如果病例是正畸/隐形矫治，需要一份桌面版 GuideMia OrthoPlus. Studio（浏览器应用）可以看、可以测量、可以重构视图；OrthoPlus 才是你真正移动牙齿的地方.

你应该已经能在 app.cympha.com/assignments 的 My Assignments 里看到至少一个状态为 Designing 的病例. 先打开一次再往下读 —— 接下来你会在病例详情页和桌面之间来回切.

第 1 步 —— 在硬盘上找到病例文件夹

当 Agent 轮询 Cympha 发现有一个病例分配给你时，它会在你工作区下创建一个子文件夹来实例化这个病例：

{workspace}/{category}/{PatientName_Date_caseID}/

实际路径长这样：

D:\CymphaWorkspace\ortho\Lara_Bianchi_2026-05-28_a31f4c\

类别前缀就是病例类型 —— 形如 ortho、alignerbot 或 implant 的文件夹. 文件夹里通常会看到：

  • 医生上传的上下颌扫描网格.
  • 一份 lab_slip.pdf —— 汇总订单，病例数据变更时会刷新.
  • 医生附带的照片、X 光片或其他附件.
  • 以及——当医生是通过 Cympha Studio 的 Create Cympha Case 建立病例时——一份 .cyp，即承载医生场景的 Studio 工程文件. 通过普通新病例表单（直接上传 STL）提交的病例没有它；如果你的文件夹里没有 .cyp，原因就在这里，直接用网格开工即可.

如果文件夹还没出现，打开托盘菜单 → Cloud Monitoring → Show panel，看状态行. 显示 Paired, polling for cases 的话，再等 60 秒. 显示 Not paired 或 Idle 的话，按 Agent 安装文档重新配对.

第 2 步 —— 在 Studio 中打开 .cyp

.cyp 是 Cympha Studio 的工程文件. 它会重建医生最后看到的场景，包括：

  • **镜头角度和缩放. ** 他们保存前的同一观察角度 —— 颊侧、合面、舌侧、四分之三.
  • **网格外观. ** 牙齿/牙龈颜色、透明度、医生绘制的任何标注.
  • **照片库. ** .cyp 旁边的 .png / .jpg / .webp 同级文件会以医生上次排列的顺序作为照片集呈现.
  • **测量. ** 医生放置的任何牙对牙或牙弓宽度测量.

打开方式：进 studio.cympha.com（Studio 无需登录即可打开和渲染），用 Open project…，从病例的工作区文件夹里选中这份 .cyp. Studio 会恢复保存的场景.

你应该落到一个像医生在电话里描述给你的截图那样的场景 —— 而不是一个通用的合面俯视图.

为什么不直接打开网格而要折腾 .cyp？ 两个原因. 第一，医生的取景告诉你他们在意什么（中线、后牙倾斜、第三磨牙撞击）；直接进 OrthoPlus 会丢掉这层语境. 第二，照片库就在旁边 —— 你可以在 3D 场景和临床照片之间切换，不用离开浏览器.

第 3 步 —— 读懂继承下来的视图

在动任何东西之前，先在 Studio 里花 30–60 秒：

  • 切换镜头 —— 用右上角的立方体小部件，或者 Front / Left / Right / Upper / Lower 预设按钮. 注意医生把活动镜头留在了哪个视图 —— 那就是他们认为的"头版"视图.
  • 翻看照片库. 比对患者真实口腔和扫描渲染. 留意软组织上的细节（唇线、牙龈萎缩），这些在网格上看不到.
  • 再读一遍右侧面板里的病例参数 —— 计划范围、咬合分类、拔牙、附件偏好. 这些直接来自 AlignerBot 或正畸 intake 表单，优先级高于聊天里的任何说法.

简报里有任何含糊的地方，先打开病例详情页的 Case Chat（参与者是你、技工所经理和医生）问清楚，再花 20 分钟在 OrthoPlus 里做错方向.

第 4 步 —— 切到 OrthoPlus 做正畸工作

Studio 是读和测量. 要移动牙齿，切换到 OrthoPlus.

在同一台工作站上打开 OrthoPlus，从病例的工作区文件夹打开该病例. OrthoPlus 会接管同样的网格以及已有的 .gos（OrthoPlus 的工程文件）.

如果这是首次设计、还没有 .gos，OrthoPlus 会自动走 自动扫描修复 → AI 分割 → 自动牙齿排列 这条链，然后进入治疗计划阶段. 完整的新病例走查见 OrthoPlus — your first aligner case end-to-end.

做你的细调：阶段化、附件位置、IPR、迭代回合，按病例需要来. 边做边保存 —— OrthoPlus 会把 .gos 写回同一个病例文件夹.

第 5 步 —— 把交付物送回云端

先弄清哪些文件会上云、哪些不会. .gos 工程文件只留在本地——它不在 Agent 的上传清单上，永远不会出现在 Cympha 的病例里. 你的云端交付物是 OrthoPlus 导出的审阅和转移文件：

  • **.gvw 审阅文件. **导出到病例文件夹后，Agent 会自动上传——无需点击. 注意这是一个触发器：.gvw 经由 Agent 到达处于 Designing 状态的病例时，会自行发起 Plan 审批请求，所以请在方案真正可以给医生看时再导出.
  • .gos.gpk 转移包（OrthoPlus 在阶段完成时的转移保存产物）. 与大多数其他文件类型（.stl、.xml、.pdf 等）一样，它会停在 Agent 的 Cloud Monitor 面板里等你点击 Upload——打开托盘图标 → Cloud Monitoring → Show panel，在 New in workspace 下查看.

文件上传后会出现在浏览器里病例详情页的 Files 面板里. 不要等 .gos 本身出现在那里——按设计，它永远不会.

接下来会怎样

  • 如果你还没上传 .gvw，病例仍在 Designing 状态，客户那一侧看不到任何变化. 要往前推进，按 Save and request approval 操作.
  • **.cyp 的来回流程. ** 如果你在 Studio 里重新排了场景（新镜头、新标注、新照片顺序），保存回去会更新 .cyp —— 但只更新镜头/标注/照片的状态，不更新底层网格. 下次打开这个病例的医生会看到你标注后的视图，而不是他自己的.

疑难排查

**工作区里没出现病例文件夹. ** 打开托盘菜单 → Cloud Monitoring → Show panel. 如果状态行是 Not paired，重新配对 Agent（看安装文档）. 如果是 Paired 但病例没下来，可能病例还在 Submitted 或 Intake Review —— Agent 只下载那些持有人是你且状态为 Designing 的病例.

**Studio 打开了，但场景是空的. ** .cyp 需要与其同级资产文件一起使用；如果扫描还没下完、或者 .cyp 到达时缺了同级文件，场景会是空的. 检查工作区文件夹 —— 病例详情 Files 面板里列出的每个文件都应该在硬盘上. 如果不是，在托盘里点 Cloud Monitoring → Show panel 查看下载错误.

**OrthoPlus 看不到病例文件夹. ** OrthoPlus 需要 Agent 创建的"以患者命名"的文件夹结构；把它指向一堆扁平的 .stl 文件不会触发病例感知流程. 在文件资源管理器里打开工作区文件夹，确认子文件夹名匹配 PatientName_Date_caseID/.

**Studio 显示医生的镜头角度但没有照片. ** 医生没给这个病例附照片 —— 对于纯设计型的 AlignerBot 病例这是正常的. intake 表单里照片是可选的. 如果你确实需要照片，通过客户聊天线程联系医生.

**保存的 .gos 没出现在 Cympha 上. ** 它永远不会出现 —— 按设计，.gos 工程文件不在 Agent 的上传清单上. 会上云的是导出的交付物：.gvw 审阅文件（自动上传）和 .gos.gpk 转移包（在 Cloud Monitor 面板里等你点 Upload）.

*相关教程：下一步看 Save and request approval；更深入的 Studio 工作流看 Cympha Studio cookbooks；OrthoPlus 那一侧的完整走查看 OrthoPlus — your first aligner case end-to-end. *

CymphaLMSCymphaStudio