游戏客户端架构 / 系统课时

空间计算排障清单怎么写

空间计算排障清单怎么写

“检查坐标系”太宽泛,无法指导下次复现。有效排障清单应说明要采样什么、与什么独立期望比较,以及失败后检查哪一层。本节把常见空间故障转成可重复执行的夹具与证据记录。

学习目标

  • 按契约、变换、投影和时序组织检查
  • 使用独立地标避免往返测试自证
  • 保存足够重放问题的输入快照

清单从输入契约开始

先记录点或方向的语义、来源与目标空间、长度单位、角度单位、节点标识和采样阶段。然后检查数值是否有限、矩阵是否仿射、逆是否存在。输入契约未确定时,继续比较最终屏幕位置只会让多个错误互相抵消。

观察或检查 下一步证据
原点转换不符 对照节点世界位置与祖先链
原点正确,轴错 对照三条基轴与旋转顺序
长度随外观变化 对照缩放继承和单位方向
静态正确,运动抖动 对照同帧更新阶段与缓存版本
投影正确,UI 偏 对照视口偏移、DPI 与父局部映射

这些是定位顺序,不是凭现象直接判定根因。每次只改变一个因素,并保存改变前后的数值,避免同时改单位、矩阵顺序与 UI 偏移后无法解释为什么恢复正常。

独立夹具比互为逆更有力

往返检查证明正反函数一致,却不能证明符合真实约定。一个错误换轴和它的逆也能往返成功。应保留独立地标,例如明确的九十度转身后局部 (2,0,0) 应到世界 (10,2,0)。

以下使用 Python 3.12、NumPy 2.3.5,保存为 demo.py 执行 python demo.py。输出是当前夹具的检查结论,不把数值不符直接断言为某种唯一故障原因。

python
import numpy as np

def diagnose(matrix, point, expected):
    if matrix.shape != (4, 4) or not np.all(np.isfinite(matrix)):
        return "invalid values"
    if not np.allclose(matrix[3], [0, 0, 0, 1]):
        return "not affine"
    if np.linalg.cond(matrix) > 1e10:
        return "inverse unavailable"
    result = matrix @ np.append(point, 1)
    # 期望来自独立地标,而非再用待测矩阵算一遍。
    if not np.allclose(result[:3], expected):
        return "fixture mismatch"
    restored = np.linalg.inv(matrix) @ result
    return "passed" if np.allclose(restored[:3], point) else "roundtrip failed"

rotation = np.eye(4)
rotation[:3, :3] = [[0, -1, 0], [1, 0, 0], [0, 0, 1]]
translation = np.eye(4)
translation[:3, 3] = [10, 0, 0]
point, expected = [2, 0, 0], [10, 2, 0]
print("correct", diagnose(translation @ rotation, point, expected))
print("wrong_order", diagnose(rotation @ translation, point, expected))
print("zero_scale", diagnose(np.diag([0., 1, 1, 1]), point, expected))
projective = np.eye(4)
projective[3, 2] = -1
print("projective", diagnose(projective, point, expected))

预期输出:

text
correct passed
wrong_order fixture mismatch
zero_scale inverse unavailable
projective not affine

把复现记录写成可重放输入

记录引擎与项目版本、对象层级、相关节点局部 TRS、采样出的世界矩阵、相机视口矩形、原始鼠标位置、单位约定和预期结果。动画或物理参与时,还要记录关键姿态、固定时间步与查询过滤条件。只有一张错位截图,通常不足以重算问题。

投影问题单独保留裁剪坐标与 w,检查近远范围、相机前后和屏幕原点。射线问题保留起点、单位方向、最大距离与命中空间。UI 问题保留视口到窗口、窗口到父局部的两段映射,便于判断偏移与缩放究竟应用了几次。

自动检查应覆盖正常、边界和拒绝路径,例如零方向、零缩放、平行射线、跨角度插值、相机后方以及旧快照。容差根据坐标尺度与实际误差预算设置,不把所有偏差统一视为浮点问题。

修复完成后,把曾经失败的独立夹具留下,再验证真实运动场景。清单最后应给出证据与结果,而不是只写“已调整坐标”。能够从保存的输入重算同一终点,才意味着下一次出现类似问题时有可用的排查起点。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

空间计算排障清单怎么写

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通