用途:指导编写、修改与审查 MaaFramework(MaaFW)Pipeline。全流程分新建轨与修改轨:新建轨按需求→拆分与状态清单→文件结构与命名→素材准备→节点编写→流程组合→自查与交接推进,大任务逐级拆为嵌套子流程;修改轨按摸底→搜引用→修改→自查进行。
主要能力:解释执行模型(节点三段式识别→动作→next,轮询与转移,timeout / on_error 归属,[JumpBack] 仅正常态生效);给出识别选型(TemplateMatch、OCR、ColorMatch、DirectHit、FeatureMatch、神经网络、And/Or)与动作编写要点;说明 roi 收紧、threshold 起点、*_wait_freezes 优先于硬 delay;坐标卫生要求点击目标由识别结果推导,偏移用 target_offset 并注明依据;循环须有终止论证(限次、识别门控或挂机意图),DirectHit 禁入循环。
使用方式:pipeline 按 jsonc 解析,纯说明用 //,结构化注释用 desc/ _desc,占位用 code/ _code;新建默认 Pipeline v2 嵌套写法(MaaFW v4.4.0+),存量项目跟随既有风格;跨任务共享文件用 general.json;节点名跨文件全局解析、大小写敏感,同名即错误。素材从基准分辨率的框架截图裁剪,裁后须在来源位置自匹配复核。
适用场景:MaaFW 自动化流程开发与维护,包括任务拆分、状态翻译、弹窗处理、失败路径兜底及存量重构。
限制:字段精确语义、参数与版本支持未在本文复制,需路由 MaaLLMWiki 的 3.1-任务流水线协议核对;未能探索(无设备、无授权、禁副作用)时应停下并报告缺口;抢购、QTE 等毫秒级反应超出轮询模型。改节点名或素材路径前须全库搜引用。上述内容依据公开资料整理,更多细节见其 references 目录。