构建 PlatformIO 工程 适用场景 - 中标明 或工作区中存在 。 - 用户希望对 PlatformIO 工程执行编译、清理或上传固件。 - 烧录或调试流程需要新的 、 或 。 - 需要在构建前确认 PlatformIO CLI 是否就绪。 必要输入 - 工作区路径（包含 ），或一份已有的 。 - 可选的环境名称（environment）。 自动探测 - 脚本启动即自动复用工程根目录 中上次成功的 profile 作为默认参数（显式参数优先，无需先手动传 ）； 仅用于断言缓存必须存在，无缓存则非零退出。无缓存或用户明确要求重新探测时，脚本自动回退到正常扫描。 - 脚本自动检测 命令是否可用并获取版本。 - 解析 中的环境列表，提取 platform、board、framework 和上传协议。 - 识别 section 中的 作为默认环境。 - 若未指定环境且存在默认环境，使用默认环境；否则使用第一个环境。 - 在 中搜索 firmware.elf/hex/bin 产物，按 排序。 - 若存在多个同样合理的环境，列出候选而不是静默猜测。 执行步骤 1. 先阅读 references/usage.md，确认本次是环境探测、列出环境、执行构建，还是仅扫描产物。 2. 若不确定环境是否就绪，先运行自带脚本 scripts/platformio builder.py 的 模式确认…