用途:在明确约束下自动调优游戏或系统参数,使其逼近目标指标,适用于迭代配置权重、赔付表、触发条件等场景。
主要能力:以受控循环方式调整参数,每轮只做小幅、可追溯的改动,并记录配置哈希或版本;将观测指标与目标对比计算差值,仅保留在不违反硬约束前提下改善目标的改动;通过确定性验证门控检查每项指标是否落在容差范围内,硬约束一旦被突破立即失败,并要求达到最小运行次数后才允许最终通过。
使用方式:先定义平衡契约,声明目标指标、容差、硬约束与停止条件,以及允许变动的参数及其边界;记录调优前基线并制定迭代计划;执行模拟或评估运行并比较指标;最后准备签核交接,返回最终参数集、指标表、通过或失败的门控结果、补丁计划与精确验证命令。验证命令为:python3 scripts/validate_balance_runs.py --input <path/to/balance_runs.json> --spec <path/to/target_spec.json>,非零退出码视为阻塞结果。
输出契约:目标契约(指标、容差、约束)、运行摘要(基线、最佳运行、最终运行差值)、门控结果(每项指标与硬约束的通过或失败)、补丁计划(需更新的确切文件与参数)、残余风险(未解决的漂移或不稳定问题)。
限制与规则:平衡改动须有界且可逆;硬约束不可协商;每份报告都须包含基线对比;不收敛的循环应标记为阻塞。参考资料包括 references/workflow.md、references/metric-rules.md、references/signoff-template.md。具体收费、价格与平台信息暂未提供。