玩《太空工程师》的都知道，飞船开着开着就歪了这件事有多烦。造了一艘大船，推进器不对称、货舱装了重东西、或者说你手动转向的时候总得不停按反方向键去“刹车”，姿态一塌糊涂。后来我试着用游戏里的可编程块写脚本做飞船姿态矫正，实测下来比手动稳太多了。这篇帖子就把我踩过的坑和写脚本的思路捋清楚，给同样想搞姿态矫正的朋友做个参考。
我默认你已经至少跑过一个基础的可编程块脚本，知道游戏内C#是什么概念，但细节不用怕，我会把关键步骤都拆开说，甚至新手按这个思路也能做出能用的姿态矫正。
1. 为什么需要姿态矫正
1.1 飞船在空中“跑偏”的高发场景
先聊聊什么情况下你会需要姿态矫正，而不是靠手动按键去顶。游戏里的飞船一旦超过几十个小方块，手动控制的精度就会急剧下降。
最常见的情况是一边推进器点得多、一边点得少。哪怕你造的是标准对称船，战斗损失、货仓装矿、钻头伸出去钻小行星，都可能导致飞船质心偏移。这时候你按W往一个方向飞，飞着飞着船就朝一边转。另一个很常见的就是太阳帆（太阳能板）对朝向敏感，你要用它充电，必须把船头对准太阳，但一旦你手动调整过角度，船就会慢慢晃开。
还有一种是自动导航或者降落的时候，你想让飞船自动对正某个朝向（比如对接舷窗的方向），但手动去按轴转，总是要来回推，最后要么转过头要么转不到位。
所以姿态矫正脚本最直接解决的，就是“不靠人手按键、让飞船自动稳定在对准的朝向”。
1.2 手动矫正的痛点
你先试试纯手动打“姿态”：按住鼠标中键拖视角，或者用陀螺仪控制方向，你会发现船是有惯性的。你松开按键，船并不是马上停，而是还会转一段。你需要在快到位的时候提前按反方向键“刹车”，但每次力度很难把握，轻了刹不住，重了就反向又转了。
要是船特别重，陀螺仪转速慢，来回修正就更烦。更麻烦的是，你在手动对正的时候没法干别的，比如你想一边让飞船对准某个方向一边去操作钻头，纯手动就很难。而脚本不一样，它每秒几十次甚至上百次地检测偏差、自动调节推进器和陀螺仪的出力，飞船就像被一只无形的手稳稳扶住。
1.3 脚本能省掉哪些操作
姿态矫正脚本可以做到：
- 点一下，把船头原地对准指定朝向。
- 自动锁锟，让船在飞行时保持当前姿态相对惯性不变。
- 配合自瞄、对接、搜敌等自动操作，腾出你的手去拉警报、启动武器或切换视角。
我写这个脚本最主要的目的就是对准太阳板方位时不再手动纠正，其次就是对接的时候不再反复调方向。实际用下来，只要陀螺仪数量够、推进器出力足，脚本比老玩家手动操作还平滑。
2. 姿态矫正脚本的核心原理
2.1 游戏里的朝向是怎么表示的
太空工程师里，每个网格（Grid）有它自己的空间朝向，这个世界坐标系是三维的，游戏引擎底层用四元数（Quaternion）来表示旋转，但在脚本里我们通常把它转成欧拉角（Euler Angle），方便理解和控制。
你可以把飞船的朝向想象成三个轴：船头朝向、船顶朝向、船右朝向。在代码里，我们用Transform的WorldMatrix来取得这三个方向向量。矫正姿态本质上就是让你船头指向目标方向，同时船顶跟船右也固定在一个合适的状态上，也就是整体对正朝向。
很多新手会把“正面朝向”理解成只要船头对就行，但实际游戏中，比如对接、起降、用太阳帆，都要求“船顶”或者“船侧”也固定。比如你的船头对着太阳，但船顶如果不正，刮到旁边的小行星，还是会麻烦。所以我的脚本里做了全轴矫正，不是单轴锁头。
2.2 PD控制器：为什么直接补角度不行
自动矫正光看“现在朝向”和“目标朝向”的差是不够的。假如你直接按误差比例加推力，船快到目标位置时速度会特别大，直接冲过头；然后反向再冲，就会来回震荡，跟手动操作差不多。
所以这里要用PD控制器：比例项（P项）负责“偏了多少就补多少”，微分项（D项）负责“船还在转的时候提前刹一点”。D项相当于阻尼，它的作用就是当你接近目标朝向时，根据角速度自动减弱控制力，防止冲过头。
我用的核心公式大致是这样：
误差向量 = 目标朝向向量 - 当前朝向向量 角速度向量 = 陀螺仪的测量值（每秒转动多少弧度） 控制力 = 误差 * Kp - 角速度 * KdKp和Kd是调出来的系数，调Kp越大”拉回力”越强，调Kd越大“刹车”越强。如果Kp太大Kd太小，飞船就来回晃；如果Kd太大，飞船反应迟钝，像是没力气。
2.3 推进器与陀螺仪：谁干谁的活
姿态矫正有两种执行机构：陀螺仪（Gyroscope）和推进器（Thruster）。
陀螺仪是最适合的旋转执行器，它的特点是不耗燃料、能直接用功率产生力矩，但它的力矩有个上限（由陀螺仪数量和质量决定）。如果你的飞船特别大，一个陀螺仪根本掰不动，得装几个并联。陀螺仪的转速和功率都可以通过脚本控制（设置GyroOverride）。
推进器也能喷出横向推力产生旋转力矩，但会消耗燃料，推力有限，而且如果用反方向的推进器刹车会特别费油。不过在某些情况下——比如你想快速转头，光用陀螺仪太慢，可以同时调用左右两侧的推进器做辅助偏航。
我最终的方案是：默认用陀螺仪执行姿态稳定，如果误差较大（超过30度），短暂启动侧向推进器辅助快速转向，等误差小于阈值再切换回全陀螺仪模式。这样既省燃料又保持平滑。
3. 从零写一个姿态矫正脚本
3.1 脚本环境和基础框架
在太空工程师里，脚本写在编程块（Programmable Block）的C#编辑器里，游戏每帧（或者你设定的Update频率）都会调用Main函数。你要做的事就是在这个Main里循环处理。
首先，你要拿到主飞船的引用，我推荐用Me.CubeGrid获取当前网格。然后拿到所有陀螺仪和推进器：
List<IMyGyro> gyros = new List<IMyGyro>(); List<IMyThrust> thrusters = new List<IMyThrust>(); Me.GridTerminalSystem.GetBlocksOfType(gyros); Me.GridTerminalSystem.GetBlocksOfType(thrusters);注意，GetBlocksOfType会包含所有子网格的部件，如果你的船有转子或活塞，可能会拿到别的部分的陀螺仪，需要过滤掉不是本网格的：
gyros = gyros.Where(g => g.CubeGrid == Me.CubeGrid).ToList();这一步很容易忽略，不然你装了连接的小船上的陀螺仪，脚本会把它们一起控了。
3.2 获取当前朝向与目标朝向
在Main里，获取飞船当前位置和朝向：
IMyCubeGrid grid = Me.CubeGrid; Vector3D shipForward = grid.WorldMatrix.Forward; // 船头方向 Vector3D shipUp = grid.WorldMatrix.Up; // 船顶方向 Vector3D shipRight = grid.WorldMatrix.Right; // 船右方向目标朝向怎么定义？最常见的是“让船头指向某个位置”，比如你想让船头对准某个GPS坐标点，那么目标Forward向量就是：
Vector3D targetForward = (targetGPS - grid.GetPosition()).Normalized();如果你还要求船顶方向也固定，比如“船顶朝向上方”，那么目标Up向量可以取世界坐标系的上方向。然后就构建一个从当前朝向到目标朝向的旋转，求出旋转轴和旋转角度。C#里有个高级方法是计算四元数差，但更直观的是用叉积：
Vector3D rotationAxis = Vector3D.Cross(shipForward, targetForward); rotationAxis.Normalize(); double angle = Math.Asin(Vector3D.Dot(Vector3D.Cross(shipForward, targetForward).Length(), Vector3D.Dot(shipForward, targetForward) > 0 ? 1 : -1));注意，这里有个坑：叉积算出的向量的长度就是sin角，直接求Asin就能得到旋转角。但Unity/游戏坐标全靠右手系，你要小心符号。我习惯是先算旋转轴，再根据需求计算控制方向的符号。
3.3 扭转控制信号，限制转速和推力
陀螺仪的控制是通过一个方向向量和转速大小来指定的。在游戏里，你给陀螺仪的GyroOverride设一个Vector3D，它就会按那个轴方向转，转速由向量长度决定。
把旋转轴和误差结合起来，就能产生控制力矩：
Vector3D rotationError = rotationAxis * controlGain;但为了防止船转太快，你要对向量长度做限制，比如限制最大转速为每秒0.5弧度（约30度每秒），超过就归一化。
然后对每个陀螺仪设定：
gyro.GyroOverride = true; gyro.GyroOverrideAxis = rotationError; gyro.SetValueFloat("GyroOverrideX", ...);实际操作中，我用的是自定义属性写起来更方便，简化的设置方式如下：
var errorVector = rotationAxis * scaledSpeed; foreach (IMyGyro g in gyros) { g.SetValue("Override", true); g.SetValue("GyroOverrideAxis", errorVector); }需要注意的是，游戏里的陀螺仪默认是按照网格局部坐标来设置Override轴的，所以你要把世界坐标的旋转轴转换到网格局部坐标。用Vector3D.Transform(rotationAxis, MatrixD.Transpose(grid.WorldMatrix))转换。
3.4 完整脚本骨架
我把脚本的关键骨架放在下面，你可以在自己的编程块里直接改改参数跑：
public Program() { Runtime.UpdateFrequency = UpdateFrequency.Update10; } public void Main(string argument, UpdateType updateSource) { IMyGridTerminalSystem gridTerminal = GridTerminalSystem; var gyros = new List<IMyGyro>(); var thrusters = new List<IMyThrust>(); gridTerminal.GetBlocksOfType(gyros); gridTerminal.GetBlocksOfType(thrusters); // 过滤子网格 gyros = gyros.Where(g => g.CubeGrid == Me.CubeGrid).ToList(); thrusters = thrusters.Where(t => t.CubeGrid == Me.CubeGrid).ToList(); Vector3D shipPos = Me.CubeGrid.GetPosition(); Vector3D targetPos = new Vector3D(0, 0, 0); // 这里替换为你的目标GPS坐标 Vector3D currentForward = Me.CubeGrid.WorldMatrix.Forward; Vector3D targetForward = Vector3D.Normalize(targetPos - shipPos); Vector3D rotationAxis = Vector3D.Cross(currentForward, targetForward); double angle = Math.Asin(MathHelper.Clamp(rotationAxis.Length(), -1.0, 1.0)); rotationAxis = Vector3D.Normalize(rotationAxis); // 如果角度太小，就不需要矫正 if (Math.Abs(angle) < 0.01) { SetGyroControl(Vector3D.Zero, 0.0f); return; } // 控制增益 float kp = 3.0f; float kd = 0.5f; // 这里读取角速度，需要从陀螺仪列表读取 Vector3D shipAngularVelocity = gyros.First().GetVelocity(); // 投影到旋转轴 double angularVel = Vector3D.Dot(shipAngularVelocity, rotationAxis); // 控制量 double control = angle * kp - angularVel * kd; double maxSpeed = 0.5; control = MathHelper.Clamp(control, -maxSpeed, maxSpeed); Vector3D overrideVec = rotationAxis * control; // 转换到局部坐标 Vector3D localOverride = Vector3D.Transform(overrideVec, MatrixD.Transpose(Me.CubeGrid.WorldMatrix)); foreach (IMyGyro g in gyros) { g.Orientation = Me.CubeGrid.Orientation; // 确保旋转对齐 g.SetValueFloat("Override", 1f); g.SetValue("GyroOverrideAxis", localOverride); } // 辅助推进器 if (Math.Abs(angle) > 0.3) { // 启动推进器辅助，这里省略，只演示陀螺仪 } } void SetGyroControl(Vector3D localOverride, float speed) { foreach (IMyGyro g in gyros) { g.SetValueFloat("Override", speed); g.SetValue("GyroOverrideAxis", localOverride); } }这个代码只是演示基础流程，实际使用还要处理角速度读取（比如从陀螺仪接口里拿实际的角速度）、目标朝向在滚动方向上的稳定控制。如果你只想锁定船头方向，不关心滚动，只控制两个轴即可；如果要全姿态矫正，你还需要再算一个“绕Forward轴”的旋转误差，控制船顶和船右的方向。
4. 实战中的坑与调试技巧
4.1 陀螺仪力不够：怎么疯狂转不动
很多人的船很大，但只装了2个陀螺仪，这时候就算你的控制算法正确，飞船也反应很慢。我在一艘50万公斤的运输船上，装了4个大陀螺仪，才勉强能在5秒内转90度。
解决办法：
- 增加陀螺仪数量，并且把Override轴设成局部坐标，注意陀螺仪本身也有方向和朝向，在网格里装歪了会导致轴混叠。
- 陀螺仪设置里有一个“转速上限”，默认可能很低，我在脚本里直接把
MaxOverrideSpeed调大一点。 - 如果陀螺仪真的不够，你可以在转向时，用左右舷的推进器做辅助转角。
我测试过，对于大型船，最好同时控制横摇的推进器（用喷气背包和推进器的侧喷），否则转向角度大时，陀螺仪要转半天。
4.2 方向判断相反：左右不分
写这个脚本最常的bug就是Override轴的方向写反了。因为陀螺仪的方向向量是“右手定则”，而我用的是叉集，很可能算出来的方向正好相反。
解决办法就是加入一个手动“反转”变量：bool invert = true;如果发现船越调越偏，就把rotationAxis乘以-1。我在调试时开着驾驶舱，看着船慢慢地往反方向转，就知道是这里的正负号反了，改一次就行。
另外，如果你脚本里控制的目标是船头对准GPS，但陀螺仪被装反了，也会造成方向混乱。所以在代码里，我用gyro.Orientation和网格Orientation做了一次匹配，尽量让陀螺仪的本地方向和网格方向一致。
4.3 游戏内Update频率与续航
游戏内脚本不是每帧都跑，而是基于UpdateFrequency。我用Update10是每10个Tick（约每秒6次）跑一次，如果你要求非常平滑，可以改成Update1（每帧），但这样会消耗更多游戏性能，在服务器里还可能被管理员限制。
一般来说，姿态矫正不用每帧都跑，每秒6次和每秒60次效果差不多，因为陀螺仪自身的响应本来就有滞回。不过你注意，PD控制器的Kd要根据更新频率来调，频率低就适当减小Kd，否则会出现控制量乱跳。
4.4 堆栈溢出与心跳计数
有一段时间我的脚本跑久了会卡死。排查发现是花了大量时间在GetBlocksOfType（它每次都扫描整个网格），所以我改进成在构造方法Program()里只查一次，把列表缓存下来，只用引用更新。
另一个小技巧是加一个调试输出，用Echo("angle...");在编程块的LCD上显示角度误差和输出力矩，很方便观察有没有调过头。
4.5 多轴锁定：别只用船头
如果你的船头对准了目标，但船身还在慢慢滚，这是因为轮换轴没有控制。需要再检测船顶方向与目标Up方向的夹角，施加一个绕Forward的俯仰/偏航力矩来稳定。
我后来在第2版里加入了“LockFullAttitude”开关，可以用参数控制是否要求船顶也固定。对接、入坞时用全锁定向，巡航时只锁船头，方便省燃料。
5. 调试参数速查表
这里给你一个我自己调参时的对照表，你直接拿你的船去试，Kp先从小调大，Kd从大调小，有一组很合适的工作点：
| 场景 | Kp | Kd | 结果 |
|---|---|---|---|
| 船太小，陀螺仪响应快 | 12 | 5 | 非常稳但反应快 |
| 中型货船，4陀螺仪 | 5 | 2 | 平滑不震 |
| 超大量级，10陀螺仪+辅助推力 | 3 | 1.5 | 大角度转向平稳 |
| 刚开始测试 | 2 | 0.5 | 安全不飞掉 |
记住原则：如果船在目标位置前后震荡，把Kp调小或Kd调大；如果反应迟缓转不动，把Kp调大或Kd调小。
6. 进阶：把姿态矫正接入自动驾驶
当你把姿态矫正脚本跑通后，最大的瓶颈不再是“能不能转”，而是“怎么和游戏里的自动导航协调”。
我的做法是给编程块加一个参数接口：在Main里读取字符串参数，比如target:GPS:X:Y:Z:0，或者用"attitude:lock"来切换自动矫正模式。然后通过定时器块连接，让驾驶员按一下面板上的某个按键，就执行一次转向。
这样你可以在一个控制面板里集成多个预设朝向：起飞朝向、入港朝向、太阳帆朝向。甚至可以用脚本监听传感器，探测到障碍物后自动把船侧偏向，不过这就是另一个项目了。
我实测下来，姿态矫正脚本只要跑起来、调参调稳，基本不怎么需要再管。用了它之后我手动操作率降了七八成，再也没掉进以前那种“按W转圈”的尴尬。
最后再分享一个小技巧：脚本跑多了之后，也许你会感觉某个朝向总是锁定不到位，那不是算法问题，很可能是你这个网格的重心偏偏到一侧了，做一个稳定的姿态矫正不如把重心对齐一下。先用脚本把船头指向某个方向，然后关掉矫正，看它往哪侧漂，就用这个信息去做配重。按这个顺序来，远比单纯调Kp和Kd更有效。
