统一 3D 与共享设计流程：迁移与恢复

状态：第 1–8 节描述的统一 3D 更新已作为 1.7.29（270） 从冻结源码标签 v1.7.29（2026-10-11）发布，现有 Floe QA 组的内部 TestFlight 可用性已独立核验。其后的 1.7.30（271）热修复只调整服务商名称归一化与蓝牙授权时机。你当前安装的版本可能早于两者；外部（公测）审核是独立门槛——不要在只有一份重要数据时仅凭本页直接迁移；实时安装状态以 CURRENT_STATUS.md 为准。

第 9 节描述未发布的进行中更新（分支 codex/design-workflows-20261013，基线 734e97f5）：未提交、未编入 App、未做界面验收、不可安装；只有集成完成后才会补充其验证步骤。两种状态都无需迁移既有数据。

1. 本次变更

3D 创建入口统一。画布顶部原来的两个 3D 创建按钮已移除；底部插入菜单（+ ▸ 3D 模型（统一工作台））会在画布内创建一个原生 .floecad 模型节点，并打开与其他入口相同的全屏工作台。3D 全景 仍是独立的全景查看节点。
既有旧版 3D 场景节点不会因升级被删除或自动转换：在你明确打开编辑（首次编辑）之前，它保持只读预览。
设计流程的四个入口（创作起始、当前文件、原始聊天附件、画布节点）共用同一套流程与服务；不会新建主工作区、隐藏画布或平行副本存储。
原生 .floecad 节点和既有画布设计子文档不受影响：新增字段对旧数据解码为缺省，旧 canvas.design* 画布工具保持兼容。

2. 更新前

记录当前版本与构建号（设置 → 诊断与关于）。
导出重要文档和画布，并在 App 之外保留一份副本。
在核对更新效果前，保留设备上的现有 App 数据，尤其是仍在使用旧版 3D 场景时。

3. 转换旧版 3D 场景（首次编辑）

打开包含旧 3D 场景节点的画布，此时仍是只读预览。
双击该节点（或使用其编辑操作）：这个明确动作就是首次编辑。Floe 会先校验整个场景。
可以转换时：先在本机写入可恢复备份，创建一个画布持有的 .floecad 文档并完成转换，然后显示 3D 场景迁移 面板，列出已知视觉差异。从该面板打开工作台。
被拒绝时：不会写入任何内容；面板列出具体不可用的值，节点保持只读预览。
转换完成后先核对模型，再用 应用到画布 更新原节点，或用 创建分支 新建分支节点。核对结果前请保留 App 数据。

4. 转换保留与不保留的内容

保留：节点 ID、名称、位置、尺寸和连线；各对象的位置、旋转、缩放、颜色/粗糙度/金属度与隐藏状态；相机位置/目标/FOV；灯光与背景。五种旧图元（圆角方盒、球体、圆柱、圆锥、平面薄板）会成为工作台毫米单位下的真实网格（旧版米 ×1000）。

不伪造：转换不会编造参数化特征树或建模历史——结果是普通几何体，与其他图元一致。导入的 DWG/DXF 图纸不同：其二维图元仍可编辑，而 3D 图元、块、外部参照、样条和代理内容保持只读。图纸不是原生 3D 模型，并非所有 3D 文件都可编辑。

写入前即拒绝（原件保持不变）：非有限数值、零/负或超范围缩放、无效颜色/相机/灯光值、重复对象 ID。

5. 已知视觉差异

光照：强度按工作台比例归一化并有界；精确原值保留在场景备份中。
阴影：以平面地面投影近似旧版方向光阴影贴图。
曲面为细分网格；旧版圆角为真实几何，弦高误差有界。

光照与阴影两项差异都会显示在迁移面板中，并随转换后的文档记录，重新打开时仍可核对。

6. 出现问题时

保留原件：排障期间不要删除 App 数据、画布备份或迁移备份。
重试：可重试的失败会复用同一个已预留文档；不会产生部分提交的节点。
反馈时附上：安装版本/构建号、画布与节点名称、界面提示，以及可公开的脱敏截图。

7. 设计流程数据

既有画布设计工程仍是节点的画布子文档，没有迁移步骤。
文件、聊天附件与创作入口通过既有构件权威保存设计信封。原文件/附件保留；只有 Floe 可写入的来源才会就地更新，否则结果以新内容返回（聊天附件会在原任务中返回为新附件）。
采纳必须由你在面板中明确确认，并且只发送到原始任务（没有来源任务的目标只能直接采纳）。确认授权一次性有效：App 重启后不会保留，已认领的尝试失败后也需要重新确认。来源在冻结后发生变化时，候选会以修订冲突被拒绝；手动修改和晚到结果都会保留，不会静默覆盖。
只有实际接通的能力才提供“生成首个结果”（目前是已配置模型时的图片生成）；Floe 不能生成的输出类型不作承诺。生成结果未知时不会自动重新提交——需明确放弃未知尝试才能重新生成；生成期间设计发生变化时，结果会保留，可绑定到当前修订。

8. 更新后核对

旧 3D 场景节点在编辑前仍以只读预览打开。
用一份测试场景（副本，或可承担转换的场景）验证：出现迁移面板并能打开工作台。
既有原生 .floecad 节点与画布可打开；转换进行中切换画布文档时，结果只会在原文档中出现，不会改动新选中的文档。
文件预览 → 设计流程 可在可写工作区文件上打开；带文件/图片附件的消息出现聊天附件菜单；任何采纳前都会请求确认。
服务商配置保持并可保存；待处理的 iCloud 同步可重试，无需重新输入密钥。

9. 下一个更新（未发布）：对话式设计流程

分支 codex/design-workflows-20261013（基线 734e97f5）实现共享设计流程的下一轮。该源码未提交、未编入 App、未做界面验收、不可安装，也不在上述验证步骤的覆盖范围内。 它不改变任何既有数据格式，无需迁移：

同一任务内自然语言开始与继续。 创作首页的类型选择菜单和必填简报/受众表单从所有可达入口与重开路径移除（不存在隐蔽同款表单）。一段描述会经既有任务启动创建普通任务，后续消息继续该任务。已保存的简报、规范、历史与候选保留并显示为可编辑摘要；已保存请求在有绑定原任务时恢复原任务，读取旧数据不会启动模型运行。未发送草稿在取消/重启后保留，且不会占用其他任务的草稿。
四个入口共用一个服务。 聊天、创作首页、当前工作区文件、原始聊天附件共用同一强类型绑定、修订权威与确认；画布节点保留其既有面板。不新建隐藏画布、第二工程或平行运行时。画布保留布局/图片能力，不获得 Linux、网页工程目录或普通任务完整工具集。
三种工况。 制作不经表单产出新成果；修改在冻结修订内编辑并保留范围外内容；重构先确认必须保留的内容、数据、功能与格式，再在独立候选中重组。“优化一下”不会被静默当作重做。
重构权威。 保留确认记录只是数据（Codable、摘要公开），本身不能授权。真正的权威是单次领取后由可信处理器铸的非 Codable 回执，绑定精确的目标/任务/基线修订/操作/摘要，并在暂存任何候选字节或开始生成之前校验。采纳期的一次性确认不变。模型 JSON 的 source/digest 永远不是权限。
候选与冲突。 候选先预览/对比再采纳；手动编辑移动基线后，更新原件的采纳会以修订冲突失败而不是覆盖，分支则安全新建。附件采纳结果只回到原始任务。
其他未发布修复。 CAD 新增工具级 create/import（内置工厂创建合法 .floecad；把 STEP/IGES/STL/OBJ/glTF 导入起草为需你确认后才 apply 的提案，网格导入不伪造特征历史）。委派子代理如实报告 partial/预算耗尽/取消/错误，而不是 ok；Linux 未知结果文案说明会话已拆除、下一命令冷启动；逐调用计时把真实单调执行与排队时间分开记录。

在该更新完成集成、编译、真实模型 UI 验收并发布之前，请把它当作仅有模块级证据的计划，而不是可用行为。