Files
SkillFactory/docs/contact_cycle_runtime.md

54 lines
4.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 运行与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`不能替代当前认证入口。