图表注释

图表擅长展示某项变化的发生，但无法说明原因。图表注释正是用来记录这些原因的：点击Dashboard图表上的某个点并记录当时的情况，这样下个月你仍然能知道那个峰值的原因。

注释对应的是某个时间点的测量结果，而非单张图表。如果您在血糖数据上添加了注释，该注释会显示在所有血糖图表上，无论该图表显示的粒度如何。

撰写注释

点击图表上的任意一点。此时会弹出一个小型编辑器，其中显示日期、该点处的数值以及一个用于添加注释的输入框。输入发生的情况，然后点击“保存”。

记录的日期是您点击的那个时间区间，而不是您点击的瞬间。在月线图上添加的标注是关于该月的，因此它会保持在您放置的位置，而不是移动到今天。

您可以在同一点上添加多个注释。再次打开该点时，现有注释下方会显示一个新的输入框。

注释显示的位置

注释以小方块的形式显示在图表下方的条形中，并与它们所对应的点对齐。将鼠标悬停在小方块上可查看完整的注释，点击小方块则可对其进行编辑或删除。

当多个注释彼此靠近时，它们会合并成一个图标，显示注释的总数。点击该图标，编辑器会列出所有注释，这样即使工作繁忙的一周，也不会导致图标堆叠成一排。

一个注释，一张图表

注释紧随测量数据之后。由此衍生出两点，均属有意为之：

• 在日线图上添加的注释也会出现在同时间周期的周线图或月线图上，位于包含该注释的区域内。只需添加一次，无论您在何处查看该数据，注释都会显示出来。
• 单位并不重要。在以英里为单位的图表上标注的内容，也会出现在以公里为单位的相同图表上；而标注在mg/dL血糖图表上的内容，也会出现在mmol/L图表上。

随阅读材料附带的批注

某些来自您数据源的读数会附带一条注释，对于记录单一数值的测量数据（如血糖、氧气和温度），该注释也会以注释的形式显示出来。

这些被标记为属于测量数据本身，因为它们是读数的一部分，而不是图表上标注的内容。若要修改其中一项，请在FitnessSyncer Notebook中编辑该读数。您仍然可以在同一数据点上添加自己的注释。

哪些图表支持添加注释

任何横轴表示时间的图表（包括折线图、面积图、带范围的折线图、柱状图、堆积柱状图、流图和箱线图）均可添加注释。

底部轴上未显示时间的图表不支持此功能，因为没有日期可供添加注释。这包括散点图、直方图、热力图、“日”图表、饼图和环形图、仪表图以及 KPI 磁贴。

计算得出的数值也不支持添加备注。估计的糖化血红蛋白（A1C）、达标率或睡眠欠债是根据其他读数计算得出的，而非直接记录的，因此这些数值本身没有可供评论的读数。请在下方对应的读数处添加备注。

如果您希望某个图表不显示注释，并且您是FitnessSyncer Pro用户，请在Dashboard编辑器中打开该图表的设置，并为该图表关闭此功能。

您的注释

Dashboard 工具栏上的注释图标 可打开“您的注释”窗口，该窗口将您所写的每条注释按每次显示一百条的方式，以表格形式列出。

在那里，日期和文本都可以编辑。修改一个单元格后，点击“保存”，该注释在所有出现的位置都会随之移动或显示为不同内容。注释所属的测量值无法更改，因为这样会导致它被移动到你从未选择过的图表上。

进出口

“您的注释”中还设有“导出”按钮和用于导入的下拉框，因此您可以保留注释的副本，或者在其他地方批量编写注释后再将其导入。

导出时，将每条注释作为包含四列的CSV文件下载：

• 日期：注释适用的时间，以UTC格式的ISO日期和时间表示。
• DataField：注释所涉及的测量值，采用 FitnessSyncer 在内部使用的格式，例如 GLUCOSE_MMOL_PER_L。
• 测量值：该测量值的可读名称。此列仅供您在阅读文件时参考，导入时将被忽略。
• 注：您的文本。

“导入”功能会读取一个与源文件形状相同的文件。注释通过其日期和测量值来识别，而非通过 ID，因此，您导出、编辑并再次导入的文件会更新其所描述的注释，而不是为每个注释创建第二份副本。

无法读取的行不会导致文件处理中断。如果某行包含未识别的测量名称 FitnessSyncer、携带无法解析的日期，或注释为空，该行将被跳过；导入过程会告知您创建了多少行、更新了多少行、跳过了多少行，以及具体是哪些行。 超过一千个字符的注释会被截短，而非被拒绝。

在应用程序中

在 FitnessSyncer 应用中，iOS 和 Android 的图表上会显示注释，但这些注释在应用中仅限查看。请在网页端进行写入和编辑。