SkillFactory v0.0.2
真实单腿资产的导入、固定支座仿真与共享策略训练原型。当前覆盖 Go2 FL / Go1 FL;第一周 Go2 基准已完成验收,共享 PPO 仅通过短更新测试,尚无已收敛、冻结或验证泛化的 Skill。
统一软硬件描述规范
唯一规范入口:docs/software_hardware_spec.md。最新机器格式为 PartSpec / SoftwareSpec v2,示例位于 configs/parts/ 与 configs/software/;旧版规范及 Schema 已移除。发布版本 v0.0.2 与描述格式版本 v2 独立。
# Python 3.12,需已有 jsonschema;无需启动 Kit
python3 scripts/validate_descriptions.py \
--hardware configs/parts/*.json --software configs/software/*.json
通用 v2 adapter 尚未实现;下述单腿仿真继续使用保留的 configs/legs/ 运行输入。设计模板、静态校验通过均不等于已支持对应部位的仿真、训练或实机部署。
运行环境
本机已验证:Isaac Sim 6.0.1、Isaac Lab 3.0.0(core 6.1.17)、Python 3.12、Torch 2.10 CUDA、Kit PhysxCfg。不修改外部 Lab/Unitree,不安装新运行时。
# 仓库根目录;避免旧 conda/venv 抢占解释器
unset CONDA_PREFIX VIRTUAL_ENV
export PYTHONPATH="$PWD/source/SkillFactory${PYTHONPATH:+:$PYTHONPATH}"
export PYTHONUNBUFFERED=1
LAB=/home/cen/IsaacLab/isaaclab.sh
路径可按机器调整。不要在仓库根执行 uv sync:根 pyproject.toml 的依赖源仍是 Lab 模板配置;使用已有 Lab 解释器。需要安装项目时用该解释器 -m pip install -e source/SkillFactory。Kit 必须在任务配置/动作类导入之前启动;以下仿真入口已处理。
通用单腿:导入 → 验证 → 短训练
for leg in go2_fl go1_fl; do
"$LAB" -p scripts/assets/extract_leg.py --spec "configs/legs/$leg.json"
"$LAB" -p scripts/assets/convert_leg.py --bundle "assets/generated/legs/$leg"
done
"$LAB" -p scripts/leg_worker.py --bundle assets/generated/legs/go2_fl \
--num_envs 64 --steps 120 --output logs/leg_interface/verify
"$LAB" -p scripts/train_leg_skill.py \
--bundles assets/generated/legs/go2_fl assets/generated/legs/go1_fl \
--num_envs 16 --horizon 32 --updates 1 --output logs/leg_interface/train_smoke
新腿通过 JSON 声明源路径、安装切口、辅助支链、受控关节及足端,不按 Go2 名称硬编码。extract_leg.py --source-root 可覆盖示例机器路径。重提取后必须重新转换;分层 USD、网格、许可证与 manifest 整体保留。
GUI:给验证命令加 --num_envs 1 --viz kit;默认无 GUI。接触验证加 --contact-action 0,0,1,该动作只适用于示例 Go2/Go1 的声明顺序,不是任意腿的通用压地指令。
保留的第一周基准
"$LAB" -p scripts/assets/extract_go2_leg.py
"$LAB" -p scripts/assets/convert_go2_leg.py
"$LAB" -p scripts/anchor_smoke.py --num_envs 1 --mode contact --steps 600 --viz kit
# 完整验收约 11 分钟;开发时用 --suite contract
"$LAB" -p scripts/verify_anchor.py --suite full --num_envs 64 \
--duration 600 --reset_count 1334 --output logs/week1_anchor/acceptance
测试与接口
"$LAB" -p scripts/list_envs.py --show_presets
PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 "$LAB" -p -m pytest tests -q
# 可选:额外启动旧任务 B=1/16/64 Kit 集成测试
PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 ANCHOR_RUNTIME_TESTS=1 "$LAB" -p -m pytest tests/test_anchor_contract.py -q
"$LAB" -p -m ruff check source/SkillFactory scripts tests
docs/software_hardware_spec.md:统一软硬件描述规范 v2;支持腿/臂/手/夹爪/躯干/头部/底座/传感器的结构与语义端口,示例在configs/parts/。v2 adapter 尚未实现,当前可运行的仍是单腿 v1。docs/leg_interface.md:现有单腿兼容运行链路、验收阈值与证据;不作为另一份描述规范。SkillFactory-LegSkill-v0:结构化 token 与专用 PPO 原型入口;不能直接交给仅接受平坦观测的旧 RSL-RL trainer。SkillFactory-SingleLegAnchor-Go2-v0:保留[B,19]验收接口。Template-Skillfactory-v0:原 Cartpole 与scripts/rsl_rl/入口保留。
生成资产、日志、checkpoint 不入库;换机器需重建复验。当前采样器每轮重启 Kit,仅适合短接口测试,不要据此直接长训或宣称高吞吐。后续优先常驻采样、留出形态评估,再实现 latent 学习和冻结调用;固定支座结果不证明整机迁移。