用途:在 Bruno 中以 Bru Lang(.bru)格式创建和管理 API 集合,涵盖新增请求、创建环境、编写 pre/post 脚本与搭建集合骨架。注意本项目使用 .bru 格式,而非 OpenCollection YAML;Bruno 桌面应用与 VS Code 扩展通过集合根目录的 bruno.json 校验集合。
主要能力:按资源组织请求,目录树镜像 API 的 URL 路径,请求文件命名为 <verb>-<noun>.bru;支持路径参数、JSON/表单/多部分/文本/XML 等请求体;支持 bearer、apikey 等按请求配置的认证;支持声明式 assert {} 断言与 JavaScript tests {} 测试;支持环境文件与变量。
使用方式:先查阅官方文档(Bru Lang 概览、标签参考、语言设计、示例、变量、认证、.env 等,索引见 https://docs.usebruno.com/llms.txt)。写新请求前先读取现有请求,例如 find api -name "*.bru" | head -10。集合根目录需有 bruno.json,可含 collection.bru 集合级设置、environments/<env>.bru 环境文件与 .env.example。
关键规则:没有 enabled 字段,行首 ~ 表示禁用该行;认证按请求声明,如 auth: bearer 配 auth:bearer {},API key 用 auth:apikey { key / value / placement };跨请求值用 vars:post-response { TOKEN: $res.body.token } 设置会话级运行时变量,不要放进环境;环境文件在集合打开时读取,磁盘上新写入的文件不会热检测,需重新打开集合或通过 UI 创建。
限制:资料未提供安装命令、收费与价格、平台支持范围及具体效果数据。