effect · add_random_valid_trait_from_unit

实战用法

此 effect 专用于战斗相关事件中，当某个角色（如将领）通过战斗经历获得技能成长时，从其所属部队的可用特质池中随机抽取一个合法特质并授予该角色。典型场景是在战斗胜利或伤亡事件中为将领动态积累作战经验特质，令将领成长系统更具随机性与真实感。

# 在某战斗事件的 option 中，令 FROM（角色）获得其部队对应的随机合法特质
option = {
    name = my_battle_event.1.a
    add_random_valid_trait_from_unit = FROM
}

配合关系

由于当前白名单中没有同 scope 可用的其他命令，无法列出真实的交叉引用命令。请以实际白名单内容为准，避免引用不存在的命令。

常见坑

1. Scope 使用错误：此 effect 要求必须在 root scope 为 unit（部队单位）的上下文中调用，若在普通国家或角色 scope 中直接使用而未确保 root 是 unit，脚本将静默失败或报错，新手常误将其写在角色事件的顶层 scope 中而忽略这一前提。
2. target 误传：FROM 在此语境中必须指向一个合法的 character（角色），若事件链传递导致 FROM 指向非角色对象（如国家或部队本身），特质将无法正确授予，且游戏通常不会给出明显的报错提示，难以排查。