做空间重建类应用时，预览图有时比模型更容易取得。用户看到一个清晰的缩略图，便会自然地认为即将导出的三维成果与它来自同一次采集。可是异步队列并不理解这种直觉：上一任务的缩略图可能延迟到达，下一任务的模型索引已经更新，页面却把两者拼在了同一张交付卡片上。这个问题发生在应用的结果编排层，而不必等到 3DGS 算法本身出错才会出现。本文设计一套 SplatProof 业务侧核对流程，只讨论预览与模型引用的归属绑定，不冒充 Spatial Recon Kit 的原生重建接口。华为已公开 3DGS 端侧重建能力，但不同设备和 SDK 中的输入、导出以及会话接口必须再以项目实际集成文档核对；下面的模拟数据不意味着任何端侧模型已经真实生成。## 一、一个缩略图可能造成的错误交付假设文旅展陈团队正在为“青釉瓷罐”制作 3D 展示资料。任务 GS-060 已经生成一张旧预览，随后发起任务 GS-061。第二个任务的模型资源引用先就绪，第一任务的预览回调却后到。若页面维护的状态只有 currentThumbnail 和 currentModel，它就可能展示 GS-060 的图，却提供 GS-061 的导出入口。页面肉眼可见，不代表资料身份可信。这里的关键不是阻止用户连续发起任务，而是把每一个结果都附上任务身份。UI 的“当前任务”仅负责显示选择，不应该成为某个异步回调修改数据归属的理由。无论模型文件实际采用哪种格式，预览资源与导出资源都需要拥有可比较的业务键。它可以来自服务层的任务记录，也可以来自应用自己维护的重建会话 ID，但必须贯穿完整交付链。本例统一使用演示号 GS-061，页面 ProofPage.ets，模型引用 model/GS-061，预览引用 preview/GS-061。演示时间定为 10:56。核对通过后显示 READY_TO_EXPORT，按钮为“导出确认”。这些均是 SplatProof 的示例字段，不是 Spatial Recon Kit 返回的官方字段或状态码。## 二、先冻结一份可解释的结果快照我更倾向于将缩略图、模型索引和页面当前选择视为三份资料，而不是三个可以随意覆盖的变量。用户可以切换任务，但已到达的资料归属不能跟着切换。第一段代码解决的就是“一个对象究竟代表哪次重建”的问题。ArtifactRef 明确拥有 taskId 和 ref，ExportProof 是界面核对时组合出来的快照。arktsinterface ArtifactRef { taskId: string; ref: string;}interface ExportProof { taskId: string; preview: ArtifactRef | null; model: ArtifactRef | null;}function checkProof(proof: ExportProof): boolean { return proof.preview !== null && proof.model !== null && proof.preview.taskId === proof.taskId && proof.model.taskId === proof.taskId;}这段逻辑没有声称 ref 已经可读，更没有检查文件内容是否完整；它守护的是身份一致性这一关。空引用失败，任务 ID 不匹配也失败。需要真正导出时，还必须做资源存在性、尺寸与容器可读性、可用存储空间等检查，不能把 true 直接解释成“模型校验全部通过”。真实项目若允许同一任务重复生成多个版本，还应把版本号或内容摘要加进快照，不能满足于任务号相同。这里故意不使用数组位置来关联文件。一个列表里排在第零位的缩略图，不一定与同位置的模型结果对应。重试、排序、并发与缓存命中都会打乱原有顺序。字段显式绑定虽然多写几行，但它给后续定位提供了证据：出错时能直接问“哪个回调写入了哪个 taskId”。## 三、迟到预览不应覆盖当前页面第二段逻辑负责接收模拟回调。当前任务为 GS-061 时，收到旧任务 GS-060 的预览就记录为忽略；不将它写进当前预览。即使任务号相同，也要先把新的资源写入业务快照，再统一计算门禁。页面从 BLOCKED 转为 READY_TO_EXPORT 是这个 Demo 的本地状态变化。arkts@State taskId: string = 'GS-061';@State previewTask: string = '';@State modelTask: string = 'GS-061';@State gate: string = 'BLOCKED';private receivePreview(result: ArtifactRef): void { if (result.taskId !== this.taskId) { console.info(`[SplatProof] stalePreview=${result.taskId} ignored`); return; } this.previewTask = result.taskId; this.checkTaskMatch();}private checkTaskMatch(): void { const ready: boolean = this.previewTask === this.taskId && this.modelTask === this.taskId; this.gate = ready ? 'READY_TO_EXPORT' : 'BLOCKED'; console.info(`[SplatProof] task=${this.taskId} previewTask=${this.previewTask} modelTask=${this.modelTask} state=${this.gate}`);}这些方法应放在 ProofPage 组件内部，资源引用在正式项目中使用完整类型；为突出身份比较，这里把页面显示用的 previewTask、modelTask 压缩成两个字符串。真实异步操作可能在两个线程或两个任务队列间交错，必须通过串行写入业务状态或统一调度器执行比较与提交。若预览解码仍在进行，还需要为解码任务单独绑定代次；不能因为回调入口检查过一次，就假设后续 await 返回时当前任务没有变化。@State 的作用是让页面依赖的普通展示值发生改变时触发重绘，它不是数据一致性的事务管理器。不要让子组件自己推断所属任务，也不要通过 UI 生命周期去伪造模型完成信号。若用户离开页面，持久化的重建结果仍由真正的业务服务管理；页面对象应停止接收不再需要的回调，必要时解除订阅，释放已经获得的缩略图解码资源。## 四、把门禁状态写进操作入口接下来才是界面。“导出确认”不能无条件出现为可操作按钮。它需要给用户一个明确的原因说明：模型还没到、预览还是旧版，或者两份引用已经一致。第三段示例让按钮随 gate 更新；实际导出操作由另一个经过权限与文件完整性检查的服务执行，不能把点击事件当作已完成导出。```arktsbuild() { Column({ space: 16 }) { Text(‘3DGS 交付核对’).fontSize(24) Text(任务 ID ${this.taskId}) Text(‘物件名称 青釉瓷罐’) Text(模型归属 ${this.modelTask}) Text(预览归属 ${this.previewTask}) Text(导出状态 ${this.gate}) .fontColor(this.gate === ‘READY_TO_EXPORT’ ? Color.Green : Color.Red) Button(‘导出确认’) .enabled(this.gate === ‘READY_TO_EXPORT’) .onClick(() => this.confirmExport()) }.padding(20).width(‘100%’)}````confirmExport()在演示工程里应核对模型引用仍然是GS-061，再转交真正的导出服务；本文不提供一个并不存在的 SpatialRecon.export()调用。这样写的价值是让“导出是否允许”和“导出是否成功”分开。前者属于页面门禁，后者属于任务执行结果。即使按钮被允许点击，文件保存失败、目标路径失效、磁盘空间不足，仍必须回到独立的错误状态。如果产品支持同一个任务的重新计算，门禁也不能在上一轮被置为READY_TO_EXPORT后一直保持绿色。重建代次改变时，应同时失效已有预览与模型引用，直到相同代次的新快照形成。这里没有补写那层复杂实现，是为了让读者看清这篇要保护的约束：**先确认结果属于同一任务，再允许进入导出阶段。**![](https://i-blog.csdnimg.cn/direct/7136b900dc8d425e96d1e25393dc422b.png)## 五、看日志时要分别追问两件事演示时可以先投递一条GS-060的预览回调，再送达GS-061的预览。预期日志先出现[SplatProof] stalePreview=GS-060 ignored，随后出现 [SplatProof] task=GS-061 previewTask=GS-061 modelTask=GS-061 state=READY_TO_EXPORT。这两行的作用是暴露身份判断路径，不是对重建速度、空间精度或实际模型质量作任何承诺。DevEco 画面中的 HiLog 文字是专为解释状态机而设计的示意输出。若进行真实调试，需要同时记录发起任务时的业务代次、原生重建会话关联键、预览解码的开始与结束、导出服务接受任务的时间点。线上日志不宜包含用户拍摄位置、模型资源绝对路径或可能识别个人的图像信息。只打印任务号和阶段代码通常更利于排障，也更容易做脱敏。最终手机画面展示青釉瓷罐示意缩略图，任务、模型与预览三者均为 GS-061，状态显示 READY_TO_EXPORT。这是一张 **UI 设计图**，不证明对应的 3DGS 模型真实存在，也不代表官方算法输出的效果。![](https://i-blog.csdnimg.cn/direct/67d8fc3c52b04eefa0845616d08c4808.png)## 六、模型身份对齐之后，还有哪些边界业务侧核对成功只是交付链的开端。空间重建任务可能处在多阶段流程中：采集数据可以合法但尚未重建，重建结束也可能尚未完成模型导出，模型文件落盘后还可能需要预览生成与资源索引刷新。不要用一个“已完成”同时覆盖这些含义；尤其不能把第三方图库里显示的缩略图当作模型实体的存在证明。对正式产品，我会把模型引用和预览引用写入一次不可变的交付记录，并让消费者根据该记录取得资源，避免页面当前选中项的变化影响文件下载。对导出中的用户取消，应用可以撤销本次导出意图，但不能擅自假设底层重建会话已被取消；真正的取消、销毁和文件清理由 SDK 与业务服务分别执行。只有在官方支持的设备、版本、系统能力条件均满足后，才能把此流程接到真实的 Spatial Recon pipeline 上。本篇的结果是一个可以人工复核的业务约束，而不是跑分：GS-060的迟到预览不会替换GS-061的当前预览，两个结果归属一致才显示READY_TO_EXPORT`。测试人员仍需在真实工程中覆盖重复回调、网络或磁盘失败、退后台、页面销毁、同任务重试与跨会话重新打开等场景。预期结果与已验证结果要在记录中分开，不能被一张漂亮的预览图混为一谈。官方资料：华为 HarmonyOS 空间计算能力介绍 https://developer.huawei.com/consumer/cn/features/spatialization；Spatial Recon 相关入口 https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/spatial-recon-c-spatial-recon-pipeline。后者本次公开页面未返回可核验的具体 C API 参数，因此正文没有编造原生接口示例。