grafana-bake-annotation

概述

此技能从 Zephyr 烘焙日志中提取可添加注释的烘焙事件，运行 Grafana 注释 CLI，并将命令（不含输出）写入烘焙日志的 ## grafana 部分。

有关如何查找烘焙日志和读取 Zephyr 条目，请参阅 [[zephyr]] 技能。

注释内容

仅为具有明确事件时间戳的、离散且有明确时间范围的烘焙操作添加注释。

添加注释：

• 喂养酵种 → feed_starter
• 酵种达到峰值 → starter_peaked
• 混合（将面团与酵种混合） → mix
• 每次拉伸和折叠 → stretch_fold
• 开始长时间不间断的基础发酵（完成所有拉伸和折叠后） → long_bulk_start
• 整形 → shape
• 放入冷藏室进行低温发酵 → cold_retard_start
• 割包 → score
• 放入烤箱 → bake_start
• 取下锅盖 → lid_off
• 出炉 → bake_done

跳过观察记录、温度读数、问题、反思，以及没有具体操作时间的条目。

标签约定

使用 snake_case 标签。

对于具有明确开始和结束时间的操作，使用 _start 和 _done 后缀。

使用 long_bulk_start（不要用 bulk_start）——从技术上讲，基础发酵在混合时就已开始；此标签表示完成拉伸和折叠后，长时间不间断发酵阶段的开始。

脚本

添加注释脚本：

/Users/mtm/pdev/taylormonacelli/diminutivedragon/scripts/annotate-grafana.py

删除注释脚本：

/Users/mtm/pdev/taylormonacelli/diminutivedragon/scripts/clear-annotations.py

这些脚本会自动从 AWS SSM Parameter Store（/diminutivedragon/grafana_token，区域 us-west-2）获取 Grafana 令牌。

此 SSM 参数由 AWS CLI 在 Terraform 管理范围之外创建。

如需在本地覆盖令牌（例如用于测试），请在运行前将 GRAFANA_TOKEN 设置到环境中。

切勿将令牌值写入烘焙日志或任何已提交的文件。

运行注释命令

在一次调用中通过重复使用 --time 和 --label 参数对传入所有事件。

传入前，请将所有时间戳转换为 ISO 8601 格式。

uv run --directory ~/pdev/taylormonacelli/diminutivedragon \
  scripts/annotate-grafana.py \
  --time 2026-05-28T20:39:00 --label feed_starter \
  --time 2026-05-29T06:31:00 --label starter_peaked

更新烘焙日志

运行注释命令后，将命令写入烘焙日志的 ## grafana 部分，并使用围栏代码块。

不要将输出行（“Added annotation id=...”行）写入日志——仅写入命令。

章节所有权

## grafana 部分由多个技能共享。

此技能负责其中的围栏注释命令代码块。

章节顶部包含两个仪表板链接：overall 和 bulk ferment，由 [[zephyr-grafana-links]] 技能负责。

写入注释命令时，请保留这些链接，不要在此处删除或重写它们。

烘焙结束时，bake_done 注释也表示需要为这些链接固定结束时间；请参阅 [[zephyr-grafana-links]] 技能。

更正错误

按 ID 删除注释：

uv run --directory ~/pdev/taylormonacelli/diminutivedragon \
  scripts/clear-annotations.py --id 42

删除后，重新添加更正后的注释，并更新烘焙日志中的 CLI 代码块。

提交

每次运行注释后都要提交烘焙日志，以便在需要时可以单独还原更改。