# SkillFactory v0.0.1 仓库:[chenlin/SkillFactory](https://gitea.robotquan.com/chenlin/SkillFactory)。 真实单腿资产的导入、固定支座仿真与共享策略训练原型。当前覆盖 **Go2 FL / Go1 FL**;第一周 Go2 基准已完成验收,共享 PPO 仅通过短更新测试,**尚无已收敛、冻结或验证泛化的 Skill**。 ## 运行环境 本机已验证: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,不安装新运行时。 ```bash # 仓库根目录;避免旧 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 必须在任务配置/动作类导入之前启动;以下仿真入口已处理。 ## 通用单腿:导入 → 验证 → 短训练 ```bash 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 的声明顺序,不是任意腿的通用压地指令。 ## 保留的第一周基准 ```bash "$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 ``` ## 测试与接口 ```bash "$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/leg_interface.md`](docs/leg_interface.md):资产/token/动作契约、验收阈值与证据、实现边界。 - `SkillFactory-LegSkill-v0`:结构化 token 与专用 PPO 原型入口;不能直接交给仅接受平坦观测的旧 RSL-RL trainer。 - `SkillFactory-SingleLegAnchor-Go2-v0`:保留 `[B,19]` 验收接口。 - `Template-Skillfactory-v0`:原 Cartpole 与 `scripts/rsl_rl/` 入口保留。 生成资产、日志、checkpoint 不入库;换机器需重建复验。当前采样器每轮重启 Kit,仅适合短接口测试,**不要据此直接长训或宣称高吞吐**。后续优先常驻采样、留出形态评估,再实现 latent 学习和冻结调用;固定支座结果不证明整机迁移。