用途:为智能体或自动化提供 Bambu 打印机的结构化本地状态,包括进度、ETA、AMS/HMS 状态、当前任务精确的 3MF 板元数据、模型预览图,以及开始/结束事件载荷,便于推送到 Discord、Webhook 或其他自动化。
主要能力:job eta 依据历史误差修正完成时间;history failure-correlations 关联失败任务与打印机、耗材、板、固件、速度、温度上下文;job timeline 重建单次打印的阶段、暂停、层、温度恢复与错误;job repeats 比较同一板的重复执行;ams runway 估算当前板剩余耗材是否够用;printer field-diff 比较本地持久化的脱敏 MQTT 字段变化。另有 printer status、events watch/monitor、job current/metadata/thumbnail、files list/download、history、maintenance、analytics 等命令。
使用方式:先安装 CLI,npx -y @mvanhorn/printing-press-library install bambu --cli-only,验证 bambu-pp-cli --version;失败可回退 go install github.com/mvanhorn/printing-press-library/library/devices/bambu/cmd/bambu-pp-cli@latest。设置 BAMBU_SERIAL 与 BAMBU_ACCESS_CODE,BAMBU_HOST 可选,运行 bambu-pp-cli doctor 验证。任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes。可用 bambu-pp-cli which "<能力描述>" 查找命令。
适用场景:需要本地真实打印状态、精确板预览、开始/结束事件、历史分析的监控与通知自动化。
限制:不支持打印机控制、派发打印、移动、加热、固件、摄像头控制或 AMS 写入;不支持开发者模式、仅局域网模式、Bambu Cloud、远程中继或农场管理;不支持切片、网格修复、MakerWorld 浏览或耗材库存管理。不得在参数、日志、消息或 MCP 调用中暴露本地访问码。显示端启动的任务可能只有打印机内 G-code,缺少 3MF 元数据。