局外演绎：无声综合征肉鸽辅助协议

约 2293 字大约 8 分钟

提示

请注意 JSON 文件是不支持注释的，文本中的注释仅用于演示，请勿直接复制使用

资源存放位置

assets/resource/data/sos 下存放着相关资源

字段说明

顶层结构

{
    "types": [],              // 节点类型数组，包含所有可能的节点类型
    "common_interrupts": {},  // 公共中断配置（可选）
    "节点类型名称": {}        // 每个节点类型的具体配置
}

common_interrupts - 公共中断配置

common_interrupts 字段用于定义可重用的中断组，避免在多个节点中重复配置相同的中断列表。

{
    "common_interrupts": {
        "message": ["SOSNextMessage"],                    // 消息中断组
        "message_left": ["SOSNextMessage_left"],          // 左侧消息中断组
        "stats": [                                        // 属性提升中断组
            "SOSWarning",
            "SOSStatsUpButton",
            "SOSStatsUp"
        ],
        "artefact": [                                     // 造物相关中断组
            "SOSArtefactsObtained",
            "SOSSelectArtefact",
            "SOSLoseArtefact",
            "SOSStrengthenArtefact"
        ],
        "harmonic": [                                     // 谐波相关中断组
            "SOSHarmonicObtained",
            "SOSSelectHarmonic"
        ],
        "resonator": [                                    // 共鸣者相关中断组
            "SOSResonatorObtained",
            "SOSSelectResonator"
        ],
        "others": [                                       // 其他常用中断
            "SOSDice",
            "SOSContinue",
            "SOSEventEnd",
            "CloseTip"
        ],
        // 可以组合多个中断组创建新的组合
        "EncounterAlongTheWay": "@message_left+@stats+@artefact+@harmonic+@resonator+@others+SOSClickEventRec",
        "TheOnlyWay": "@message+@stats+@artefact+@harmonic+@resonator+@others"
    }
}

节点类型列表

types 字段定义了所有支持的节点类型：

已完成节点 - 已完成的节点
必经之路 - 主线故事事件
途中偶遇 - 支线事件
藏宝地 - 获得宝藏
休憩处 - 恢复与休息
购物契机 - 花费金雀子儿购买商品
巧匠之手 - 升级和置换造物
遭遇 - 简单的战斗
途中余兴 - 具备特殊规则的战斗
冲突 - 较为困难的精英战斗
险象环生 - 难度逐步递增的连环战斗挑战
恶战 - 极其危险的首领战斗
对话 - 对话事件节点

节点配置结构

每个节点类型包含以下字段：

{
    "event_name_roi": [x, y, w, h],  // 事件名称识别区域，null 表示不需要识别事件名
    "actions": [],                    // 默认动作序列（用于无事件名或通用处理）
    "events": {},                     // 特定事件的动作配置（可选）
    "interrupts": []                  // 中断处理节点列表（可选）
}

节点类型分类

无事件名节点（直接执行 actions）：

购物契机
遭遇
途中余兴
冲突
恶战
巧匠之手

有事件名节点（需识别具体事件，执行对应 events 中的配置）：

必经之路
休憩处
藏宝地
险象环生

动作类型 (Action Types)

1. RunNode - 运行节点

运行预定义的流程节点

{
    "type": "RunNode",
    "name": "节点名称"
}

常用节点：

SOSTeamSelect - 队伍选择
SOSCombat - 战斗流程
SOSContinue - 继续/确认按钮
SOSEventEnd - 事件结束
BackButton - 返回按钮
SOSConfirm - 确认按钮

2. SelectOption - 选项选择

选择对话或事件选项（垂直排列）

{
    "type": "SelectOption",
    "method": "OCR" | "HSV",          // 识别方法：OCR文字识别 或 HSV颜色识别
    "expected": ["选项1", "选项2"],  // OCR方法：期望的文字内容（必需）
    "order_by": "Vertical",           // 排序方式：Vertical(垂直) 或 Horizontal(水平)，默认 Vertical（可选）
    "index": 0                        // 选项索引，默认 0 表示第一个，-1 表示最后一个（可选）
}

OCR 方法：

通过识别文字内容来选择选项
expected 可以是字符串或字符串数组，按顺序优先匹配
会为每个 expected 值创建独立的识别节点进行匹配

HSV 方法：

通过颜色识别来选择选项
使用 index 参数指定选择第几个选项

3. SelectEncounterOption - 途中偶遇选项选择

专用于"途中偶遇"场景的选项选择（水平排列）

{
    "type": "SelectEncounterOption",
    "method": "OCR" | "HSV",          // 识别方法：OCR文字识别 或 HSV颜色识别
    "expected": "选项文字",           // OCR方法：期望的文字内容
    "order_by": "Vertical",           // 模板识别排序方式：Vertical(垂直) 或 Horizontal(水平)，默认 Vertical
    "index": 0                        // HSV方法：选项索引，默认 0 表示第一个，-1 表示最后一个
}

OCR 方法：

通过识别文字内容来选择选项
expected 为字符串，指定期望识别的文字内容
order_by 用于放大镜图标模板识别的排序方式，默认 Vertical

HSV 方法：

通过颜色识别来选择选项
使用 index 参数指定选择第几个选项
order_by 用于放大镜图标模板识别的排序方式，默认 Vertical

中断处理节点 (Interrupts)

在执行动作过程中可能触发的中断处理节点：

SOSSelectHarmonic - 选择谐波
SOSHarmonicObtained - 获得谐波
SOSSelectArtefact - 选择造物
SOSArtefactsObtained - 获得造物
SOSLoseArtefact - 失去造物
SOSStrengthenArtefact - 强化造物
SOSSelectResonator - 选择共鸣者
SOSResonatorObtained - 获得共鸣者
SOSStatBreakthrough - 属性突破
SOSStatsUpButton - 属性提升按钮
SOSStatsUp - 属性提升
SOSWarning - 警告提示
SOSNextMessage - 下一条消息
SOSNextMessage_left - 下一条消息（左侧）
SOSContinue - 继续按钮
SOSDice - 骰子事件
SOSEventEnd - 事件结束
SOSClickEventRec - 点击事件矩形
CloseTip - 关闭提示

中断引用语法

interrupts 字段支持两种配置方式：

1. 数组方式（传统方式）：

{
    "interrupts": [
        "SOSArtefactsObtained",
        "SOSStatsUpButton",
        "SOSStatsUp"
    ]
}

2. 字符串引用方式（推荐）：

使用 @ 符号引用 common_interrupts 中定义的中断组：

{
    "interrupts": "@stats+@artefact+@harmonic+@resonator+CloseTip"
}

引用语法规则：

使用 @组名 引用 common_interrupts 中定义的中断组
使用 + 连接多个引用或中断节点
可以混合使用引用和直接指定的中断节点
引用会在运行时展开为对应的中断节点列表

示例：

// 引用单个中断组
"interrupts": "@stats"
// 展开为: ["SOSWarning", "SOSStatsUpButton", "SOSStatsUp"]

// 组合多个中断组
"interrupts": "@stats+@artefact"
// 展开为: ["SOSWarning", "SOSStatsUpButton", "SOSStatsUp", "SOSArtefactsObtained", "SOSSelectArtefact", "SOSLoseArtefact", "SOSStrengthenArtefact"]

// 混合引用和直接指定
"interrupts": "@stats+@artefact+CloseTip"
// 展开为: ["SOSWarning", "SOSStatsUpButton", "SOSStatsUp", "SOSArtefactsObtained", "SOSSelectArtefact", "SOSLoseArtefact", "SOSStrengthenArtefact", "CloseTip"]

// 使用预定义的组合
"interrupts": "@TheOnlyWay"
// 展开为: ["SOSNextMessage", "SOSWarning", "SOSStatsUpButton", "SOSStatsUp", "SOSArtefactsObtained", "SOSSelectArtefact", "SOSLoseArtefact", "SOSStrengthenArtefact", "SOSHarmonicObtained", "SOSSelectHarmonic", "SOSResonatorObtained", "SOSSelectResonator", "SOSDice", "SOSContinue", "SOSEventEnd", "CloseTip"]

事件配置示例

简单战斗节点示例

"冲突": {
    "event_name_roi": null,  // 不需要识别事件名
    "actions": [
        {
            "type": "RunNode",
            "name": "SOSTeamSelect"  // 1. 选择队伍
        },
        {
            "type": "RunNode",
            "name": "SOSCombat"  // 2. 进入战斗
        }
    ],
    "interrupts": "@stats+@artefact+@harmonic+@resonator+CloseTip"  // 使用中断引用语法
}

复杂事件节点示例

"休憩处": {
    "event_name_roi": [858, 72, 132, 33],  // 识别事件名称的区域
    "events": {
        "俱乐部来客": {  // 特定事件名称
            "actions": [
                {
                    "type": "RunNode",
                    "name": "SOSContinue"  // 1. 点击继续
                },
                {
                    "type": "SelectOption",
                    "method": "HSV",
                    "index": -1  // 2. 选择最后一个选项（HSV识别）
                },
                {
                    "type": "RunNode",
                    "name": "SOSEventEnd"  // 3. 结束事件
                }
            ],
            "interrupts": [  // 可能触发的中断
                "SOSArtefactsObtained",
                "SOSStatsUpButton",
                "SOSStatsUp",
                "SOSLoseArtefact",
                "SOSNextMessage"
            ]
        }
    }
}

带选项识别的事件示例

"必经之路": {
    "event_name_roi": [858, 72, 132, 33],
    "events": {
        "旅途的开始": {
            "actions": [
                {
                    "type": "RunNode",
                    "name": "SOSContinue"
                },
                {
                    "type": "SelectOption",
                    "method": "OCR",
                    "expected": [
                        "奥秘",    // 优先选择这些属性
                        "力量",
                        "激情",
                        "反应",
                        "感知"
                    ]
                },
                {
                    "type": "RunNode",
                    "name": "SOSEventEnd"
                }
            ],
            "interrupts": [
                "SOSSelectHarmonic",
                "SOSHarmonicObtained",
                "SOSStatsUp"
            ]
        }
    }
}