HarmonyOS 7.0 端侧3DGS实验⑧:失败案例与复现【鸿蒙心迹】
一、前言
打开“桌面三维记录册”的记录详情,读者需要找到三个答案:记录在哪里,当时用了什么,下一步是什么。只有一张效果图或一句“重建失败”,不足以让别人判断结论,也无法指导下一次任务。
本篇用三个概念区分复核目标。证据复核是检查已有材料能否支持任务,例如输入尺寸要求是否来自对应文档。协议重复是按相同规则重新采集和执行;路线相同,实际图像、位姿和现场条件仍可能不同。输入重放则重新使用同一份输入数据,需要持久化材料、完整输入契约及重新推入的验证依据。记录索引不能自动提供后一种能力。
前七篇目前交付的是协议、记录结构与验证计划,尚无实际采集批次、任务产物、质量结果、性能采样或经验证的浏览路径。因此,本篇整理案例归档规则、实验包规划和未完成事项,成功与失败案例保持待补,不能称为可运行实验包或已复现报告。
归档时,成功表示指定阶段有满足判定条件的证据;明确失败表示该阶段已有可解释的失败依据;未执行表示操作尚未开始;已执行但结果未知表示发生过操作,却不足以确认结果。四种口径都要落到具体阶段,准备受阻不能计作运行失败。
二、变量与条件
2.1 环境、协议与执行记录分别关联
继续使用experimentId、sampleId和baselineId定位实验、样本与基线,以captureBatchId、reconstructionTaskId和artifactRef连接输入、任务与产物。质量检查、性能测量和浏览尝试分别保留qualityCheckId、performanceRunId与browseAttemptId。同一产物被观察多次,不应合并成一次执行。
重建的environmentRef、质量观察的observationEnvironmentRef及浏览的browsingEnvironmentRef各司其职。设备型号、芯片、完整系统构建号、SDK/API、应用构建与工具版本随对应记录保存;样本、采集协议、保存配置、观察范围和测量方法则说明操作条件。未知字段保持未知,不用当前设备信息补写旧任务。
引用应指向当次确定的记录,并保留来源类型和时间。文档更新时间、资料读取时间与实验发生时间分别记录。本次沿用前七篇最新采用稿,不要求读者协调多个历史版本。
2.2 文档适用范围与实测范围分栏
共享与会话起始版本标为6.1.0(23),NG回调另标为26.0.0起,本篇不引入该调用。HarmonyOS 7.0保持系列定位,现有资料未建立准确映射;重建起始标记也不能移用于GSPlugin加载能力。
三、执行过程
3.1 案例归档:先定位阶段,再讨论失败
一条案例按“问题—环境—前置条件—实际操作—阶段结果—证据—原因假设—后续动作”组织。索引负责把这些材料连接起来,具体返回值和观察仍保留在原阶段记录中,避免复制后出现互相矛盾的结果。
输入接收、重建、保存、文件检查、质量观察、性能测量和浏览验证分别归档。若未来重建成功而保存明确失败,应保留两项结果;若没有产物,浏览尚未开始,就记录未执行及原因;若完成通知缺失,只能保留结果待确认。这里说明的是条件分支,没有对应的已发生案例。
失败现象与原因假设也要分开。画面未显示是观察,文件损坏可能只是猜测;重拍、改背景是处置动作,处置后的新观察才用于讨论是否改善。即使新尝试没有再次看到现象,也要限定条件和检查范围,不能自动标记“已修复”。
C1是案例条目的JSON骨架,所有字段均为应用设计。当前实际案例索引保持为空;下面的空条目只解释字段,不分配案例编号,也不计入案例数量。
{
"caseId": null,
"experimentId": null,
"sampleId": null,
"baselineId": null,
"captureBatchId": null,
"reconstructionTaskId": null,
"artifactRef": null,
"problem": null,
"environmentRef": null,
"stageRecordRefs": [],
"causeHypotheses": [],
"dispositionRecordRefs": [],
"reproductionRecordRefs": [],
"conclusionScope": null,
"blockingStage": null,
"knownFacts": [],
"missingEvidence": [],
"evidenceRefs": []
}
stageRecordRefs的每项应标明阶段和记录引用,通过原记录找到前提、操作、状态及证据。多次质量检查或浏览尝试分别关联;dispositionRecordRefs关联处置及处置后复核。准备缺口可单独保存为摘要,不为它制造失败案例。blockingStage只是应用受阻位置,既有rawStatus仍按来源保留,浏览异常不能覆盖重建返回值。

图1为案例索引规划,当前尚无实际成功或失败案例。
3.2 实验包清单:列出需要什么,也写明缺少什么
实验包首先需要阅读入口,说明材料范围、阅读顺序和未完成事项。读者应能从一个问题找到对应协议,再找到执行记录与结论。下面是逻辑分组,不表示已经生成目录或压缩包。
| 材料分组 | 拟包含内容 | 当前处理 |
|---|---|---|
| 阅读入口 | 范围、顺序、限制、未完成事项 | 规划说明结构 |
| 环境与协议 | 环境档案及采集、质量、性能、浏览协议 | 前篇有方法,实际条件待补 |
| 输入材料 | 原始输入、对应相机信息、来源与可用性 | 未取得,不宣称可重放 |
| 任务与事件 | 调用原值、通知、阶段与计时记录 | 未取得 |
| 产物与检查 | 实际文件、任务归属、格式核验 | 未取得 |
| 观察与测量 | 质量记录、原始采样、工具与计算方法 | 未取得 |
| 结论与复现 | 案例索引、证据表、尝试及差异 | 规划结构,结果待补 |
每个条目还要说明材料类型、用途、来源、是否实际包含、缺失原因和可支持的操作。文档摘录、空模板与实测材料分别标识。有来源链接只说明存在引用入口,不等于文件已包含;有模板也不等于实验已完成。
C2以待补输入材料说明清单结构。included为false表示该项尚未包含,availableOperations为空表示尚未确认可支持的操作,不能解释为输入已经检查通过。
{
"reproductionPackageId": null,
"packageScope": "静态桌面物品实验材料规划",
"materialEntries": [
{
"materialType": "原始输入及对应相机信息",
"evidenceKind": "待补实测材料",
"purpose": "核对输入来源与可用性",
"sourceRefs": [],
"included": false,
"availability": "未取得",
"missingReason": "尚无实际采集批次",
"availableOperations": [],
"evidenceRefs": []
}
],
"missingEvidence": ["实际输入、事件、产物和测量材料待补"],
"evidenceRefs": []
}
清单没有填写不存在的路径、大小或校验值。后续取得文件后,再记录其身份与核验方法;完整性检查只能回答文件是否一致,不能证明内容质量或加载兼容。
sessionRecordRef是记录引用,不是会话快照。会话说明工作目录存放重建所需数据,并规定任务结束后销毁会话,但没有据此提供可移植实验包或跨退出恢复的保证。复制工作目录不能直接写成恢复步骤。
若以后交付工程,还需提供实际源码版本、依赖与构建说明,并单列真实验证记录。当前没有完整工程,因此不安排安装包或下载承诺。

图2为材料组织规划,目录分组不表示已有对应文件。
3.3 复现步骤:按目标选择路径
复核文档与记录从第四节的陈述出发,检查来源、条件及限制,记录缺失或不能支持的部分。当前可以检查方法与文档约束;遇到实测陈述却没有执行材料时,应停在证据不足,不能用协议代替结果。
重新观察已有产物要求实际文件、归属和经核验的访问、加载或播放路径。沿用第5篇观察范围与定位方法,收集画面及操作证据。打不开或无法定位时,停止依赖这些前提的质量评价。这条路径不要求重新重建,也不能把视频观察扩展成自由视角验证。
重新执行采集协议先按第1篇核验能力和接入条件,再按第2、3篇新建批次、登记条件及输入检查,使用独立会话,沿用第4篇手动保存流程。随后分别取得质量、成本和浏览证据。任一前提缺失,就停止依赖步骤,保留已经完成的部分。
同一输入重放另列为待验证路径。当前不提供导入、恢复或重放命令;即使资料允许重复输入数据帧,也不能据此证明已持久化的数据能正确重建为有效输入。
C3是复核规则的text伪代码,不调用SDK,也不执行文件操作。
确定目标:文档复核、产物观察、协议重复或输入重放
关联原陈述;有真实案例时再关联 caseId
为本次复核或尝试建立独立记录
保存目标、环境差异、操作引用和计划范围
若目标为文档复核:检查来源、原文及适用范围
若目标为产物观察:检查 artifactRef、归属和观察路径
若目标为协议重复:检查能力、输入及任务管理前提
若目标为输入重放:另查持久化、输入契约和重放验证
对所选路径的每一步:
核对前提、应收集的证据类型和停止条件
若关键材料或契约不足:
保存 knownFacts、missingEvidence、blockingStage
未开始的步骤保持 notExecuted
停止依赖步骤,保留此前证据
否则按对应协议开展该步并记录实际操作
分开记录阶段结果、原始信息及解释依据
保存实际到达位置、检查范围和未完成原因
将新记录关联到 reproductionRecordRefs;不覆盖原记录
预期证据类型说明要收集什么,不预设执行会成功。尚未尝试、条件不具备和尝试后未再观察到现象必须区分。最后一种情况还要核对是否真正到达原问题发生的位置;如果只完成加载,没有执行原来的视角操作,就不能声称现象未复现。

图4为路径与停止条件规划,尚未完成实机复现;输入重放待核验。
四、观测结果
4.1 先盘点材料,再讨论结果
本节的结果是材料盘点。前七篇中的空表和JSON骨架用于规定记录方式,没有形成真实执行样本。
| 已有方法 | 缺失执行材料 | 目前可得结论 | 后续所需证据 |
|---|---|---|---|
| 第1篇环境与支持核验 | 实机环境、查询记录 | 设备能力尚未验证 | 环境及查询原值 |
| 第2、3篇采集与观察协议 | 实际批次、输入、推入记录 | 尚无可用输入证明 | 逐帧对应与有效性检查 |
| 第4篇阶段与保存规则 | 调用、通知、实际文件 | 重建与保存未执行 | 判定依据及文件检查 |
| 第5、6篇质量与成本口径 | 观察、原始采样 | 无质量与性能结论 | 共同范围、工具及测量证据 |
| 第7篇浏览验证计划 | 加载、显示、操作及收尾记录 | 无经验证浏览路径 | 逐项执行与资源证据 |
成功和失败案例区均保持待补。准备缺口可以汇总,但不能进入运行失败的分母。未知数量不填写0,也不生成通过率、失败率、性能趋势或最优规模。
后续有数据时,仍须保留中断、条件偏差和缺测,不能只挑成功或最快的一次。耗时引用原阶段的起止事件、时钟、单位和暂停规则;内存、温度与能耗保留各自测量对象和方法。归档不会把不完整区间变成完整耗时,也不会把电量变化变成精确能耗。
4.2 让陈述与依据逐项对应
结论表要同时表达“说了什么”和“凭什么说”。文档约束、实验协议、交付状态和实测发现应能分别检索,避免读者把设计选择当成官方保证。
| 陈述 | 依据类型 | 来源或实验关联 | 适用范围 | 缺口 |
|---|---|---|---|---|
| 输入宽1080、高1440 | 文档约束 | 共享重建指南“输入数据帧” | 该资料所述两种输入路径 | 实际输入检查待补 |
| 固定物品、移动设备,分别改变因素 | 系列协议 | 第2篇第二、三节 | 静态桌面物品的比较设计 | 协议尚未执行 |
| 某类物品更适合重建、某种背景提高质量 | 待验证陈述 | 尚无实测关联 | 尚不能确定 | 对照产物、共同质量范围及条件记录 |
| 当前无经验证的自由视角浏览路径 | 交付状态 | 第7篇第四节 | 本系列当前交付 | 实际加载、显示与操作证据 |
宽高数值来自文档,不是实测结果,也不是可互换的分辨率建议。提供加载入口,但不能代替实际兼容性和交互证据。系列尚未验证某条路径,也不意味着系统不具备相应能力。
C4给出待填写的结论证据骨架。basisType可按上表分类,basisReason解释依据如何支撑陈述;这些都是应用字段,不承担自动审核。
{
"claimId": null,
"statement": null,
"basisType": null,
"sourceRefs": [],
"caseRefs": [],
"evidenceRefs": [],
"basisReason": null,
"conclusionScope": null,
"missingEvidence": [],
"reviewResult": null,
"reviewReason": null,
"reviewedAt": null,
"nextAction": null
}
文档陈述关联具体文档与章节,不必填写实验编号;实测发现才关联真实案例、条件和原始证据。null表示未知,空数组表示尚未关联,不能据此判定通过。一个陈述同时包含文档要求和效果推断时,应拆开记录,分别说明依据。

图5为证据分类与关联方式,不代表已形成实测结论。
4.3 物品与采集建议:保留方法,等待效果证据
物品选择仍从用途开始:需要多角度回看,能够静止摆放,可以重复采集,并能明确希望查看的部位。这些条件用于决定是否值得安排实验,不能推出某种材质的成功率。
采集建议限定为执行协议:先登记条件,再记录实际覆盖,观察异常,按理由决定保留或重拍。重拍建立新批次并关联原批次,不能覆盖旧输入和处置理由。反光、低纹理、背景、距离与采集规模都进入待比较条件,不据标签建立物品排名。
建议入口依次检查需求、能力与输入依据、对应范围的实测证据。需求不明确时先确定回看目标;前提不足时补依据;具备前提但缺少效果证据时进入待验证实验。有了证据,也只在共同观察范围内讨论质量与成本,不将局部表现推广到整件物品。

图3为业务选择与实验准备规则,尚非实测质量推荐。
五、结论
待补事项需要说明影响、已有入口、缺少材料及完成判断,不能只留下“以后再测”。
| 问题与影响范围 | 已有材料 | 需补材料与完成判断 |
|---|---|---|
| 输入有效性影响采集与推入 | 第2、3篇协议及输入指南 | 核清相机信息对应、有效性和生命周期,取得逐次检查与推入证据;重放另补持久化及重新推入验证 |
| 终态与保存配置影响任务管理 | 第4篇流程及重建指南 | 补齐回调、返回语义、终态和完整保存配置,取得可解释的调用、通知及文件记录 |
| 观察与工具影响质量和成本评价 | 第5、6篇口径 | 补齐观察路径、定位方法和工具依据,取得对应范围的观察及原始采样 |
| 文件访问与资源契约影响浏览 | 第7篇计划及加载指南 | 补齐运行时访问、加载参数、显示、相机控制与资源所有权,取得操作和收尾证据 |
这些完成判断要求证据足以解释结果,不要求结果必然成功。图4的停止条件用于保留执行边界,图5的缺口记录用于限制结论。系统提供的能力、应用需实现的管理逻辑与外部工具承担的测量,仍分别核验。
即使以后完成少量样本,结论也只覆盖登记的设备、条件和观察范围。未覆盖底面不视为已经恢复;没有几何真值与误差评价,就不报告尺寸精度。视频播放与自由视角浏览继续分开验证。
本篇结束的是八篇方法规划的整理。静态桌面物品从采集到浏览的真实实验闭环仍待证据;现有归档结构让后续工作能够从明确的缺口继续,而不必把未知改写成成功或失败。
更多推荐



所有评论(0)