单选项映射¶

类型 ID：tool.single_choice_mapping，位于“工具”。这是一个默认公开的初始值变量节点：创建后自动进入变量声明和运行前公开参数面板。用户在下拉框中选一个名称，节点输出对应整数，可连接数值比较或“切换整型”决定执行路径。

例如“窗口运行 → 1、屏幕运行 → 2、ADB 运行 → 3”，或“副本 7 → 7、副本 8 → 8、副本 9 → 9、不刷副本 → 0”。映射值不限于选项顺序。

配置和编辑¶

节点上可单选、切换公开/私有，并修改公开名称。双击或点“编辑选项”可新增、重命名、上下移动选项，修改映射整数；取消不改变原配置。默认两项分别映射 1 和 2，新增项选择未占用的正整数作为初值。

• 选项数量为 1–64，每项有稳定 id、显示 label 和整数 value；ID 和映射整数均不得重复，名称不能为空。
• 当前选择只保存为顶层整数 value，不是数组下标，也不另存 selectedOptionId。重排或改名不改变输出；修改选中项的映射整数会同步当前值。
• 删除当前项前需先选择其他项；最后一项不能删除。失效或不属于选项的整数会被拒绝，不静默回退到 0 或第一项。
• isPublic 缺省为 true，可以显式关闭；运行前公开参数只允许选择，不允许改选项定义。保存时按最新蓝图验证，过期选项不能偷偷切换运行模式。

{
  "options": [
    {"id": "window", "label": "窗口运行", "value": 1},
    {"id": "screen", "label": "屏幕运行", "value": 2},
    {"id": "adb", "label": "ADB 运行", "value": 3}
  ],
  "value": 3,
  "isPublic": true,
  "publicName": "运行模式"
}

端口与运行¶

沿用初始值变量节点的端口顺序：输入 0 为整数设置值、输入 1 为执行；输出 0 为映射整数、输出 1 为执行。数据按需读取，执行链经过本节点时直接继续。连线只传整数值，不携带选项名称或变量身份。

输出 0 可直接连接“执行类”中的切换整型输入 1（选择值），不需要中间转换。Switch 仍按 0..N-1 编号匹配：默认映射 1/2 对应 case1/case2，不是 case0/case1；映射不在当前分支范围内则走 Default。执行路线须另接 Switch 的执行输入，单有整数连线不会启动路线。

公开参数覆盖、显式设置输入和变量 Get 的结果必须是已有映射整数，不接受字符串或小数代替。变量 Get 根据实际声明节点保留选项定义；缺失或不一致的声明不能作为有效映射执行。公开参数仍沿正常公开值保存权限，不授予蓝图或商品内部编辑权。

本页描述开发候选行为；源码/目录存在不代表已经完成所有实际客户端场景验收。GT4AI 操作见AI 使用手册。