用途:为 Max for Live 设备开发与调试提供系统化排查流程。当设备不工作时按固定顺序推进:错误消息 → JSON 有效性 → 格式合规 → I/O 接线 → 初始化时序 → 架构。
主要能力:提供常见 Console 报错与成因对照(如 "Could not open this device"、JSON 解析错误、"No such object"、Live API 未初始化、通知回调内改值报错等);说明 Max Console/Max Window 的打开方式、颜色含义、过滤与 REPL;列出 [print] [error] [capture] [t b s] [message] 等调试对象。在 Live 内可通过右键设备标题栏选择 Open Max Window 查看运行时错误。
JSON 与格式:指出 LLM 生成 .maxpat 的典型损坏,包括非法控制字符与 BOM、box id 重复或缺失、numinlets/numoutlets/outlettype 长度不符、类名拼写错误、尾逗号与注释、补丁线指向不存在的进出口、patcher 字典顺序漂移等;建议用 ;max sortpatcherdictonsave 1 稳定键序。
工作流与限制:编辑可经 Max 的 File 菜单保存,保存会更新当前 Set 中该设备的全部实例;冻结设备编辑会先复制到 User Library。架构方面区分 Apple Silicon 的 arm64、Intel 的 x86_64 与 Windows 的 mxe64,第三方 Package 未必可靠打包;Live Intro/Lite 不支持第三方 M4L。.amxd 在 Live 打开时改动磁盘文件不会自动生效,需重新拖入或重启。
引用工具(保留原样):https://github.com/shakfu/py2max、https://github.com/Ableton/maxdevtools、https://github.com/Ableton/m4l-connection-kit、https://github.com/Cycling74/n4m-examples、https://github.com/Barnard-PL-Labs/MaxPyLang。具体价格与授权信息暂未提供。