人形机器人在 MuJoCo 仿真中的行为表现，很大程度上取决于关节动力学参数的精细配置。Atom01 的动力学参数并非简单照搬 URDF 的硬件规格，而是在 MJCF 中通过默认类别（default class）机制进行了系统化的增强与重映射。本页面向具备进阶仿真经验的开发者，深入解析 URDF 与 MJCF 之间的动力学参数映射关系、分层调优策略以及常见稳定性问题的诊断方法。在阅读本页之前，建议先掌握 连杆与关节体系架构 与 MJCF 模型设计原理 中的基础概念。

Sources: README.md

动力学参数架构总览

Atom01 的动力学参数分布在两个相互补充的模型文件中：URDF 承载了源自机械设计的硬件约束边界，而 MJCF 则在此基础上叠加了面向仿真的动力学增强项与执行器控制接口。理解这一分层架构是进行参数调优的前提——开发者不应孤立地修改单一文件，而需要意识到 URDF 中的 effort 与 velocity 限制在 MuJoCo 运行时并不会被原生读取，真正驱动仿真的是 MJCF 中的 joint 动力学属性与 actuator 控制范围。

flowchart LR
    subgraph URDF["URDF 硬件层"]
        J1[joint limit<br/>effort / velocity]
        J2[joint range]
    end
    subgraph MJCF["MJCF 仿真层"]
        D1[joint dynamics<br/>damping / frictionloss / armature]
        D2[actuator<br/>ctrlrange / gear]
        D3[option<br/>timestep / solver]
    end
    URDF -->|"参考基准"| MJCF
    MJCF -->|"覆盖增强"| 仿真引擎

具体而言，MJCF 中的关节动力学参数通过 default 节点下的三个类别进行批量管理：waist_joint_param 用于躯干关节，leg_joint_param 用于下肢六自由度链，arm_joint_param 用于双臂十自由度链。所有关节默认继承 damping="0.01"、frictionloss="0.01" 与 armature="0.01" 的基线配置，而踝关节则在实例级别单独覆盖 frictionloss="0.05" 以增强足端接触稳定性。

Sources: atom01.urdf, atom01.xml, atom01.xml

URDF 硬件约束层：功率与速度边界

URDF 中的 limit 元素定义了关节的物理工作边界，其中 effort 表示最大输出力矩（单位 N·m），velocity 表示最大角速度（单位 rad/s）。Atom01 的 23 个主动关节（不含浮动基座）依据机械结构强度与电机选型，被清晰地划分为两个功率等级。下肢与躯干关节（髋部三自由度、膝部、躯干偏航）统一采用 effort="120" velocity="25.0"，对应高扭矩、高转速的伺服模组需求；四肢末端关节（双臂五自由度、双踝）则采用 effort="27" velocity="8.0"，反映小体积执行器的输出约束。这种二元的功率分级是后续在 MJCF 中设置统一 ctrlrange="-200 200" 时需要注意的潜在风险点——控制范围若超过 URDF 的 effort 限制，可能导致仿真行为与真实硬件产生显著偏差。

值得特别关注的是，URDF 与 MJCF 中的关节活动范围（range）并非完全一致。例如左侧大腿俯仰关节在 URDF 中的限制为 -1.57 ~ 1.57，而在 MJCF 中被扩展为 -2.5 ~ 0.8；左侧髋部偏航关节在 URDF 中为 -1 ~ 0.2，在 MJCF 中则为 -1 ~ 0.2 但右侧对应关节为 -0.2 ~ 1。这种不对称性在调优过程中可能导致左右腿控制器参数移植时出现意外行为，建议以 MJCF 中的实际 range 为准进行控制器设计。

Sources: atom01.urdf, atom01.xml

MJCF 动力学增强层：阻尼、摩擦与惯量

MuJoCo 的 joint 元素支持 URDF 所不具备的三个核心动力学属性：damping（粘性阻尼）、frictionloss（库仑摩擦损耗）与 armature（电机电枢惯量）。这三个参数共同决定了关节在无控制输入时的被动响应特性，以及受到外力时的阻抗特征。Atom01 的 MJCF 配置采用了统一的低阻尼策略，所有关节默认 damping="0.01"，该值在保持系统响应灵敏度的同时，为数值积分器提供了必要的耗散项，防止高频振荡发散。

frictionloss 的设定则体现了明显的功能分区思想。除四个踝关节被显式提升为 0.05 外，其余 19 个主动关节均维持基线值 0.01。踝关节摩擦损耗的强化是为了补偿足端与地面接触时缺乏完整碰撞几何（ ankle 链接的碰撞体被注释掉）所带来的数值不稳定性，通过增大关节内部摩擦来抑制足底滑移与抖动。armature="0.01" 的引入则为所有关节增加了一个固定的旋转惯量项，模拟电机转子惯量对连杆运动的平滑效应，这在高频力控仿真中尤为重要，可有效降低因质量矩阵条件数过大导致的求解器迭代失败。

全局层面，option 节点启用了 frictionloss="enable" 标志，确保上述摩擦损耗参数被纳入 PGS 求解器的计算流程；配合 timestep="0.001" 与 iterations="100" 的设置，形成了稳定但计算开销适中的仿真节拍。若后续在强化学习训练中需要提升环境步频，减小 timestep 的同时往往需要同比例下调 damping 与 frictionloss，以维持等效的物理阻尼比。

Sources: atom01.xml, atom01.xml, atom01.xml

执行器模型与控制边界

MJCF 中的 actuator 段定义了 23 个 motor 类型的执行器，全部使用 gear="1" 的直驱配置，控制范围统一为 ctrlrange="-200 200"。这意味着控制器输出的原始力矩指令在到达关节之前不会经过减速比放大，其数值直接对应于关节坐标系下的力矩（单位 N·m）。虽然 MuJoCo 的 motor 执行器本身不模拟电流环或速度环的带宽限制，但控制范围与 URDF 的 effort 限制之间的映射关系需要开发者自行在控制算法中维护。

当前所有执行器采用完全一致的 ctrlrange，这在实际调优中是一个需要审慎评估的设定。对于低功率组关节（如踝关节的 effort=27 N·m），ctrlrange 高达 ±200 N·m 意味着控制器可以输出远超硬件极限的力矩，虽然在 MuJoCo 中关节不会因此损坏，但会导致仿真中的机器人表现出非物理的强鲁棒性，进而使迁移到真实机器人时的 sim-to-real 差距被放大。推荐在部署阶段依据 URDF 中的分组，将下肢高功率关节的 ctrlrange 限制在 ±120 附近，而将双臂与踝关节限制在 ±27 附近，以此在仿真中复现真实的饱和特性。

传感器系统为每个执行器配备了位置、速度与力矩反馈（actuatorpos、actuatorvel、actuatorfrc），并附加了 noise="1e-3" 的力矩测量噪声。这一噪声注入在强化学习训练中起到了正则化作用，防止策略过度依赖精确的力矩读数。调优动力学参数时，若增大 damping 或 frictionloss，等效的关节内阻上升，执行器需要输出更大的力矩来维持相同轨迹，此时力矩噪声的相对影响会下降，可能需要相应调整噪声幅值以保持训练难度的一致性。

Sources: atom01.xml, atom01.xml

分类调优策略与典型场景

基于上述参数架构，针对不同仿真目标的动力学调优应遵循“先分组、后实例、再全局”的递进逻辑。以下表格总结了各关节组的关键参数组合与推荐调优方向。

对于步态仿真的核心痛点——足端穿透与反弹——其根因往往不在于接触几何本身，而在于踝关节的 frictionloss 与全局 geom 的 solref 之间的阻抗匹配。当前地面几何的 solref="0.001 2" 定义了接触约束的弹簧-阻尼响应时间，若踝关节摩擦过大而接触阻尼不足，足部会在触地瞬间产生粘滑振荡（stick-slip）。此时建议同步微调 solref 的第一个参数（时间常数）或增大接触 friction 的第一个分量（滑动摩擦系数，当前为 0.9）。

若仿真中出现关节速度爆炸（某一自由度角速度在单步内跃升至异常值），应优先检查对应关节的 damping 与 armature 乘积是否过小，以及 actuator 的 ctrlrange 是否相对于关节惯量过大。一个快速诊断方法是临时将该关节的 damping 提升一个数量级至 0.1，观察振荡是否被压制；若有效，则说明问题出在耗散不足而非接触穿透。

Sources: atom01.xml, atom01.xml, atom01.xml

URDF-MJCF 参数映射速查

在跨格式维护模型时，以下映射关系与差异点最容易被忽略，建议作为调优工作的校验清单。

开发者在调整上述任一参数后，建议通过 模型检视与关节调试 中的可视化流程验证关节的被动回落特性（即撤除控制后关节在重力作用下的衰减曲线），以此判断阻尼与摩擦的配比是否合理。

Sources: atom01.urdf, atom01.xml

稳定性调优的延伸方向

关节动力学参数并非孤立存在，其与接触参数、求解器配置、质量分布共同构成了稳定性方程。当本页所述的参数调整无法解决仿真发散问题时，下一步应深入阅读 仿真稳定性优化指南，该页面对时间步长、求解器迭代次数与接触几何的耦合关系进行了系统性阐述。若调优目标是为强化学习训练构建更贴近真实的动力学环境，则 强化学习训练集成要点 中关于领域随机化（domain randomization）与执行器延迟建模的内容将提供直接可用的技术路径。