用途：在 Three.js（WebGPU/TSL）中构建曲射线太空特效，覆盖三类原生声明——艺术化变形、Ellis 零测地线解、史瓦西零测地线解；Kerr（旋转黑洞）由独立验证的外部求解器负责，无求解器时返回 unsupported-model。数值积分本身不会把艺术化场变成度规解。
主要能力与用法：先选定唯一声明（装饰性弯曲/吸积盘选艺术有界射线，读 artistic-rays-and-disks.md；球状喉部穿越选 Ellis；非旋转透镜或物理薄盘选史瓦西）。再声明数值域：效果到世界变换与有界积分范围、相机事件与射线原点方向、统一长度基准、状态向量及其积分参数、环境朝向与正交标架，以及 miss、setup-rejected、unsupported-model 等预步进结果。度规射线用 Ellis 喉半径 a 或史瓦西质量长度 M=G M_SI/c^2 无量纲化，并保留回到米的换算。使用 WebGPURenderer 与 TSL 节点函数，确认 WebGPU 后端。有界步进流程：变换与相交、初始化状态、提议候选段、连续定位并根细化最早事件、累加传输、每次提交一次状态推进。终止状态包括 escaped、horizon、core、opaque、invalid、step-cap、attempt-cap 等；step-cap 限定已提交步，attempt-cap 限定接受加拒绝的尝试。仅对逃逸射线采样外部环境，方向由出射切线在声明标架下重建。静态球形透镜可选用临界分割传输图或缓存，需先读 lens-cache-and-history.md。验证需用确定性种子环境，比较 h、h/2、h/4 收敛性、事件残差与角误差，Ellis 与史瓦西还需独立 CPU float64 参考。
限制：非均匀缩放须显式导出变换后度规与标架并重新验证，否则在 setup 拒绝；非平稳度规须外部求解器或通过演化误差门限标注为准静态，否则不支持；渲染中的 delta 不作射线步长。以上收费、价格、平台与具体安装命令资料未提供。