Timefold疑问：TailChainSwap是否与Change、Swap移动选择器冲突？

问题现象 #

配置UnionMoveSelector包含change、swap和tailChainSwap三种MoveSelector，但调试日志显示仅tailChainSwap被选中；即使将tailChainSwap的fixedProbabilityWeight设为极低值（0.001），仍只有它被选中；仅当将其权重设为0时，才会被排除。

初始配置：

<unionMoveSelector>
  <changeMoveSelector>
  </changeMoveSelector>
  <swapMoveSelector>
  </swapMoveSelector>
  <tailChainSwapMoveSelector>
  </tailChainSwapMoveSelector>
</unionMoveSelector>

调整权重后的配置：

<unionMoveSelector>
  <changeMoveSelector>
    <fixedProbabilityWeight>1</fixedProbabilityWeight>
  </changeMoveSelector>
  <swapMoveSelector>
    <fixedProbabilityWeight>1</fixedProbabilityWeight>
  </swapMoveSelector>
  <tailChainSwapMoveSelector>
    <fixedProbabilityWeight>0.001</fixedProbabilityWeight>
  </tailChainSwapMoveSelector>
</unionMoveSelector>

核心原因 #

changeMoveSelector和swapMoveSelector没有生成任何有效候选Move，导致UnionMoveSelector只能从有候选的tailChainSwap中选择。即使设置了权重，没有候选的MoveSelector会被直接跳过，不会参与概率选择逻辑。

解决方案 #

1. 修正MoveSelector基础配置 #

确保changeMoveSelector和swapMoveSelector能生成有效候选：

• changeMoveSelector：必须指定目标实体类（entityClass）以及可分配的值范围（valueRangeProviderRef），确保存在可变更的不同值。
• swapMoveSelector：必须指定目标实体类，且当前问题中至少存在2个同类型的实体可以交换。

示例修正配置：

<unionMoveSelector>
  <changeMoveSelector>
    <fixedProbabilityWeight>1</fixedProbabilityWeight>
    <!-- 替换为你的实体类全路径 -->
    <entityClass>com.example.YourPlanningEntity</entityClass>
    <valueSelector>
      <!-- 替换为你定义的valueRangeProvider名称 -->
      <valueRangeProviderRef>yourValueRange</valueRangeProviderRef>
    </valueSelector>
  </changeMoveSelector>
  <swapMoveSelector>
    <fixedProbabilityWeight>1</fixedProbabilityWeight>
    <!-- 替换为你的实体类全路径 -->
    <entityClass>com.example.YourPlanningEntity</entityClass>
  </swapMoveSelector>
  <tailChainSwapMoveSelector>
    <fixedProbabilityWeight>0.001</fixedProbabilityWeight>
  </tailChainSwapMoveSelector>
</unionMoveSelector>

2. 验证候选生成情况 #

开启MoveSelector的调试日志，搜索类似以下的日志条目：

• ChangeMoveSelector generated X moves
• SwapMoveSelector generated Y moves

如果X或Y为0，说明对应MoveSelector仍未生成有效候选，需进一步检查实体配置、值范围定义是否符合业务场景要求。

3. 确认权重逻辑生效条件 #

fixedProbabilityWeight的权重分配仅针对有有效候选的MoveSelector生效。只有当change和swap都生成了至少1个候选后，权重比例才会起作用，UnionMoveSelector才会按配置概率选择三种Move。

内容的提问来源于stack exchange，提问作者Alexey