Files
SkillFactory/README.md
T
chenlin 7f39abb613 release: SkillFactory v0.0.1
Add declarative single-leg import, fixed-anchor benchmark, masked shared-policy PPO prototype, regression tests, and consolidated documentation.
2026-10-10 09:58:30 +08:00

68 lines
3.6 KiB
Markdown
Raw 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.
# 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 学习和冻结调用;固定支座结果不证明整机迁移。