用途:markers 是 bencium-loop 各命令在循环步骤结束时输出的机器可读 JSON 标记块的共享契约,规定标记的放置位置、内容规则和版本管理方式。CI 脚本、仪表盘和后续命令通过定位该 JSON 块读取结果,而不是解析自然语言文本。
主要能力:每个产生结果的循环边界都以一个围栏 ```json 块结尾。所有标记共用四个字段:_marker(名称)、version(整数版本)、ts(ISO8601 UTC 时间戳)、phase(产生该标记的循环阶段),各命令再定义自己的 schema 和填充方式。标记只报告状态,不包含建议、后续步骤或评论,这些应放在上方正文中。若步骤中途停止,应输出已知信息并标明结果不完整,而非不输出。
使用方式:标记必须是该步骤打印的最后内容,闭合围栏之后不能有任何正文、横幅或空白,否则下游解析会失败。若命令输出多个标记(如 /bencium-deploy 为 SMOKE 和部署各输出一个),每个标记都是其自身步骤的最后输出。
涉及的标记:bencium-build-result(/bencium-next Phase B)、bencium-verify-result(/bencium-verify)、bencium-smoke-result(/bencium-deploy Step 5.5)、bencium-deploy-result(/bencium-deploy Step 6)、bencium-rollback-result(/bencium-rollback)、bencium-retro-result(/bencium-retro)。Phase A(PLAN)不输出标记,因为它是只读门禁,且构建标记已记录所执行的计划。
版本管理:schema 用整数版本(version: 1)。新增可选字段不提升版本;删除字段、重命名字段或改变现有字段含义则提升版本。
限制:资料未提供具体安装命令、收费方式、平台支持或更多使用示例。