# 运行与CPU回归:Go2 FL参考+残差 当前实测基线为[0.4.2解析S1](contact_cycle_sim_performance_v042_result.md),公开生命周期与命令见[API](go2_fl_skill_v4_api.md)。本文件仅保留实现边界和测试入口,不重复历次运行过程。 ## 固定物理与动作合同 - 浮动根Go2 FL单腿,3kg合成负载/传感载体;有效系统约5.388kg,W指系统重量,不只负载重量。有界XY/转动辅助,竖直guide必须为0;使用仿真真值,不是无辅助平衡。 - 物理/失败检查500Hz,控制100Hz;名义9秒周期:承重3s、卸载1s、抬腿0.6s、摆动1.4s、落地0.8s、重新承重2.2s。 - 默认位移`[0.025,0.02,0]`m,净空0.05m+0.01m拱高。当前功能版本根XY30mm仅诊断,历史严格P1/RootXY仍按30mm判失败。 - 46D float32有限值观察,不能加载旧32D策略。索引0–31为原传感/命令;32–34根位置误差,35–37根速度误差;38接触Fn、39足端gap;40–42下一步归一化参考;43–45上一步夹紧请求残差。 - 原IK/载荷补偿参考只在reset或控制边界推进,不因读取观察推进。三维请求夹到±1,对应每关节±0.05rad,再投影至关节范围;投影不能扩大实际残差。 - 分别记录reference_used/next、residual_request、effective_residual与实际目标;PPO概率针对采样latent,不针对合成关节目标。解析是零残差,u256是冻结确定性残差**加同一解析参考**。 - 接触获取200ms内达到≥0.5W持续10ms且gap≤0.5mm;离地on/off为1/0.5mm、dwell10ms。原有限性、关节/力矩/速度、辅助及失控保护保持。 - SI单位;对外四元数xyzw,与后端显式转换。力/力矩坐标系和作用点明确,唯一COM外力合成入口,不重复叠加r×F或把辅助力当接触力。 - 无周期reset、pose写入、重锚、轨迹拼接/抽稀。失败保留首个来源及部分轨迹;timeout用reset前终端观察bootstrap,真实失败为0。 ## 实现入口 | 用途 | 仓库路径 | |---|---| | 公开Python/CLI | `scripts/go2_fl_skill.py`,`scripts/examples/go2_fl_skill_v4.py` | | 命令/配对/邮箱/绑定 | `source/SkillFactory/SkillFactory/legs/contact_cycle_sim/skill_*v4.py` | | 环境、逐步安全/记录/GUI/性能 | `source/SkillFactory/SkillFactory/tasks/manager_based/contact_cycle_sim/` | | 配置 | `configs/contact_cycle/`;资产规格`configs/legs/` | | 冻结只读加载/回放 | `legs/contact_cycle_sim/replay.py`、`scripts/replay_cycle_sim_residual.py` | | 只读功能审计 | `scripts/audit_cycle_functional_flow.py`、`audit_contact_cycle_functional.py` | | 监督/归属/监控 | `scripts/skill_launch_v4.py`及继承的functional/rootxy监督工具;[监控合同](contact_cycle_native_monitor_v3.md) | 旧32D训练、46D训练、RootXY入口均保留为实现/冻结输入,但不作为当前任务自动执行。u64不可替代原u256。 ## CPU测试 在仓库根执行,无GPU/Kit/训练: ```sh CUDA_VISIBLE_DEVICES='' PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 \ /home/cen/miniconda3/envs/linker_sim_isaac/bin/python scripts/test_cpu.py # 单项定位;不改变默认测试集/断言 CUDA_VISIBLE_DEVICES='' PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 \ /home/cen/miniconda3/envs/linker_sim_isaac/bin/python scripts/test_cpu.py \ tests/test_contact_cycle_live_cadence_v042.py /usr/bin/python3.12 scripts/go2_fl_skill.py validate CUDA_VISIBLE_DEVICES='' /home/cen/miniconda3/envs/linker_sim_isaac/bin/python \ scripts/go2_fl_skill.py validate --verify-frozen ``` `test_cpu.py`仅在测试进程映射SkillFactory包以跳过顶层Kit任务注册,运行保留的`tests/`;**不可用于运行绑定**。默认关闭外部pytest插件和物理集成opt-in;被skip的PhysX测试不是物理通过。旧发布/旧32D分支测试见[归档](README.md#历史资料),冻结manifest/运行绑定所需测试仍在原路径。 当前CPU环境为Python3.11/Torch2.7;真实运行是固定`/home/cen/IsaacLab`、`/home/cen/isaacsim-6.0.1`及RTX5080,不混为同一依赖资格。部分测试只读本机冻结快照或安装源,缺失/skip不能证明新机器已具备资格。`pyproject.toml`将默认收集范围限制为`tests/`,避免扫描`logs/`、sealed包或暂存目录;直接运行pytest仍须具备相应包/依赖。 不得在根目录`uv sync`或修改外部IsaacLab/Unitree资源来凑测试通过。CPU测试不调用Kit;真实新运行另按[执行边界](execution_authority.md)登记、绑定、监督与清理。通用`supervise_sim.py`不能替代当前认证入口。