Files
AstrAI/scripts/docker/lib/train-common.sh
T
ViperEkura 350e4a1849 feat: add online ppo with value-model critic and gae advantages
- register online_ppo train type backed by PPOStrategy: token-level clipped surrogate over GAE advantages plus masked value regression against rollout-pinned returns, with explained-variance metrics
- fold the reference-KL penalty (k3 estimator) into per-token rewards before GAE and pin advantages/returns on RolloutResult so replayed gradient steps optimize fixed targets
- add self-contained ValueModel critic with a zero-initialized value head and backbone warm-started from policy weights; AutoRegressiveLM stays untouched and trunk parity is pinned by tests
- step the critic's own optimizer outside the policy-version lock with the same max_grad_norm clipping as the policy
- persist critic state as value_model.pt/value_optimizer.pt checkpoint extras; resume restores it, fails loudly when missing, and the train.sh completeness check requires the extras for online_ppo configs
- extract shared rollout sequence/logprob helpers from GRPO (behavior unchanged) and add ppo_gamma/ppo_gae_lambda/ppo_vf_coef CLI options
2026-09-05 01:59:50 +08:00

80 lines
2.2 KiB
Bash
Executable File

#!/usr/bin/env bash
log_info() {
printf '[INFO] %s\n' "$*"
}
log_warn() {
printf '[WARN] %s\n' "$*" >&2
}
die() {
printf '[ERROR] %s\n' "$*" >&2
exit 1
}
require_command() {
command -v "$1" >/dev/null 2>&1 || die "Required command not found: $1"
}
validate_job_name() {
[[ "$1" =~ ^[A-Za-z0-9][A-Za-z0-9._-]*$ ]] ||
die "Invalid TRAIN_JOB_NAME '$1'; use letters, numbers, dot, underscore, or dash"
}
checkpoint_extra_files() {
# Additional files a complete checkpoint must contain for the strategy
# configured in the given training YAML. PPO persists critic state as
# checkpoint extras (value_model.pt / value_optimizer.pt); a resume
# without them must not look complete.
local config="$1"
[[ -n "${config}" && -f "${config}" ]] || return 0
if grep -Eq '^[[:space:]]*train_type:[[:space:]]*["'\'']?online_ppo' "${config}"; then
printf 'value_model.pt value_optimizer.pt'
fi
}
checkpoint_is_complete() {
local checkpoint="$1"
local file
[[ -d "${checkpoint}" ]] || return 1
for file in meta.json config.json model.safetensors optimizer.pt scheduler.pt ${CHECKPOINT_EXTRA_FILES:-}; do
[[ -s "${checkpoint}/${file}" ]] || return 1
done
return 0
}
checkpoint_coordinates() {
local name
name="$(basename "$1")"
[[ "${name}" =~ ^epoch_([0-9]+)_step_([0-9]+)$ ]] || return 1
printf '%d %d\n' "$((10#${BASH_REMATCH[1]}))" "$((10#${BASH_REMATCH[2]}))"
}
list_complete_checkpoints() {
local checkpoint_dir="$1"
local checkpoint coordinates epoch step
for checkpoint in "${checkpoint_dir}"/epoch_*_step_*; do
[[ -d "${checkpoint}" ]] || continue
coordinates="$(checkpoint_coordinates "${checkpoint}")" || continue
checkpoint_is_complete "${checkpoint}" || continue
read -r epoch step <<<"${coordinates}"
printf '%012d %012d %s\n' "${epoch}" "${step}" "${checkpoint}"
done | sort -n -k1,1 -k2,2
}
find_latest_checkpoint() {
local checkpoint_dir="$1"
local latest
latest="$(list_complete_checkpoints "${checkpoint_dir}" | tail -n 1)"
[[ -n "${latest}" ]] || return 1
printf '%s\n' "${latest#* * }"
}