从第一次连接，
到每一杯有记录。

只想整理咖啡

直接进入“咖啡记录”，填写已知信息。建立档案不需要先连接设备，可以从手中的熟豆或已有测量开始。

要读取设备数据

先在 App 的蓝牙设置连接对应设备，再进入该设备的功能页。手机系统显示蓝牙已打开，还需要在 App 内确认连接状态。

要分析照片

进入相应视觉分析模式，按页面要求准备照片和尺寸参照。相机或相册权限与蓝牙权限分别授权。

要回看以前的结果

进入对应历史记录，核对时间、样品和来源。历史结果可以离线阅读；实时采集需要连接设备。

1. 搜索列表里没有设备

   检查设备供电、手机蓝牙和系统中的 App 权限；将设备靠近手机，确认未被其他手机或电脑软件占用，再刷新搜索。

2. 可以看到设备，但连接失败

   先退出其他正在连接这台设备的软件，再重新连接。多台同类设备同时开机时，逐台确认目标，避免连接到另一台设备。

3. 显示已连接，但读数没变化

   回到对应设备功能页，核对当前目标，再按提示开始测量或采集。保存的历史读数与当前实时读数要分别查看。

4. 使用中断开连接

   先查看本次记录是否已保存，再恢复连接。不要假定断开期间的数据已完整补回；回看曲线时检查时间段是否连续。

咖啡档案：这是什么咖啡

记录名称、产地、处理法等基础信息。同一款咖啡可以在一个档案下保留不同采购或烘焙批次。

批次：这次来自哪里

采购批次区分不同次购入的样品，烘焙批次区分不同锅次。名称建议包含便于识别的日期或批次简称。

测量：这次观察到了什么

记录一次色值、粒径或其他测量，并保留样品类型、时间和来源。整豆与咖啡粉应分别注明，便于比较。

库存：这次实际增减了多少

生豆与熟豆分别管理；入库、出库、烘焙领用、取样、损耗和调整反映不同的实际动作。测量数值不能代替库存操作。

详情页的“当前批次范围”会影响展示的测量、库存和时间线。查不到某条记录时，先切回“全部记录”，再核对它归属的批次。没有分配批次的测量，可在待归属区域继续整理。

1. 建立档案和采购批次

   例如新建“花间 · 日晒”，填写已知信息，再添加“采购批次 A01”。不清楚的信息可以后补，不必为填写完整而猜测。

2. 记录生豆入库

   收到 5 kg 生豆后，按实际数量记录入库，并核对重量单位与包装数量。重量和袋数分别填写，避免把其中一项当成另一项。

3. 记录烘焙领用与熟豆产出

   本次使用 0.6 kg 生豆，得到 0.51 kg 熟豆。使用“烘焙领用”表单时，按提示填写领用量、熟豆产出与批次关系，完成后核对生豆和熟豆两边的库存变化。

4. 给这锅咖啡留下测量与品饮记录

   选择对应烘焙批次，再添加或关联测量。取样、销售或日常使用发生后，分别记录相应库存动作。回看时间线时，就能追踪这锅豆子的变化。

如果直接购买熟豆，也可以从熟豆入库、测量或品饮开始。无需先补造一段并未发生的生豆采购和烘焙过程。

确认保存状态

基础资料编辑区会显示保存状态；填写后等到页面显示已保存。新增测量、批次和库存操作则按各自表单的确认入口完成。

区分手动与已有测量

手动填写适合录入外部或纸面记录，关联已有测量便于追溯原结果。回看时同时阅读来源、样品类型和时间，避免把手动录入当成设备刚刚采集的数据。

找不到某个记录模块

先检查咖啡记录页的模块显示设置；模块可能被隐藏。模块入口也不代表手机能直接测出该项指标，测量仍需相应设备或有效的外部数据。

归档与导出

归档适合收起暂时不再使用的咖啡，之后可从归档入口查找。需要交接或分享时按导出页选择内容；导出一份报告与备份整个 App 数据用途不同。

1. 先进入对应咖啡和测量模块

   打开咖啡详情，找到有多条测量的模块并点“对比记录”。比较入口针对当前模块；例如要比较色值，就从色值测量列表进入。

2. 按问题选 2–4 条记录

   候选会显示批次、测量时间和样品类型，可跨批次选择。若想了解烘焙批次间的变化，挑选对应批次的记录；若想看同一批次的重复性，则挑同一批次不同时间的记录。

3. 横向看表格中的每一列

   每列代表一条记录，列名包含批次、时间与样品类型；每行代表一个有记录的指标。横向滑动可查看较多记录。显示“—”表示该条记录没有这个指标，不等于零，也不代表测量失败。

4. 先核对是否能公平比较

   确认样品类型、单位、测量来源和条件相近，再看共同指标的变化。整豆与粉样、手动录入与设备结果，适合分组理解；不要把它们混成同一组结论。

比较表帮助并排查看数据，不会替你判断“哪一批更好”。回到批次、测量来源和品饮记录，才能解释变化发生在哪里。

1. 写下本次观察

   例如两锅同一款咖啡的粉样色值不同，或者同一研磨设置的粒径分布看起来不同。先描述看到的差异，不急着把它归因于某个设置。

2. 列出可能影响结果的条件

   检查样品是生豆还是熟豆、整豆还是粉样，确认测量时间、来源、烘焙批次、研磨设置、取样和拍摄条件。不同条件可能同时造成差异。

3. 提出一个可以检验的原因

   把“是不是研磨更细导致冲煮变慢”改写成可核对的问题：同一批熟豆、同一冲煮方案下，只改变研磨设置，观察冲煮时间和品饮反馈是否一起变化。

4. 下一次只改变一个主要因素

   保持豆子、称量方式、器具和冲煮步骤尽量一致。把测量、冲煮回顾和主观风味都关联到对应批次，并写下这次唯一改变的因素。

5. 复盘时把结论说到证据允许的程度

   如果读数和品饮反馈都朝预期方向变化，可以说“这次结果与假设一致”；如果不同步，就保留差异并继续观察。少量记录不能证明普遍规律，也不应抹去不符合预期的结果。

可直接套用的记录句式：我观察到＿＿；本次与上次不同的是＿＿；我猜测＿＿可能有关；下一次我只调整＿＿；我会比较＿＿和＿＿。

样品类型

先确认是咖啡豆还是咖啡粉。不同样品类型、研磨与装填条件会影响比较，建议保留相同条件下的多次结果。

Agtron 主色值

用于观察咖啡的烘焙色值。通常数值较高表示颜色较浅，较低表示较深；跨设备比较时还要核对量表与测量条件。不要把色值直接当成风味评分。

烘焙度文字

结合设备提供的烘焙度信息阅读。记录整豆、粉样与对应读数时保持配对，避免把另一份样品的文字结论套到当前结果上。

CIELab

L* 表示明度，a* 与 b* 描述颜色方向。它们用于补充颜色观察，与 Agtron 是不同的表达方式；比较时记录所用模式和样品条件。

多维色值响应分布图是主色值的辅助表达。柱高或百分比不代表颗粒、像素的数量占比；横向显示参考值也不是每根柱的独立 Agtron 测量值。不要只凭柱形判断烘焙均匀性或风味。

重复测量时，保持豆／粉模式、研磨、取样量、铺平和装填方式一致。若结果差异明显，先复查样品准备和测量条件，再比较批次。

1. 采集前，给本锅建立清晰的身份

   确认设备、安装状态和样品条件，准备好锅次、豆种、处理法等信息。需要比较不同锅次时，尽量保持设备位置和观察条件一致。

2. 采集中，观察趋势并核对事件

   色值主图横向是时间，纵向是 Agtron；Crack 子图展示对应的爆裂信号。关键点只有在本次记录中存在时才有比较意义，回看时结合实际烘焙过程确认。

3. 结束后，先检查记录是否完整

   在色值曲线历史中找到本锅，核对开始时间、时长与关键事件，检查是否存在断线或缺失片段。不要把模拟图里的曲线形状当成推荐烘焙模板。

4. 补充元数据，再做比较

   曲线详情右上角的编辑入口可补充页面支持的锅次、豆种、处理法、投豆量和测量色值等信息。再结合成品测量、冲煮与品饮，比较本次调整的影响。

粒径单位 μm

μm 是微米，1,000 μm 等于 1 mm。它表示图像分析得到的颗粒尺寸，不是磨豆机刻度。

D10 / D50 / D90

当前结果页的关键百分位数采用体积加权口径：累计到 10%、50%、90% 时对应的粒径。D50 是这个口径下的中位径，不能读成“有一半颗粒的数量小于它”。

平均尺寸与颗粒数

标有“数量”的平均尺寸与标准差使用按数量统计的口径；颗粒数表示本次识别纳入统计的数量。它们与体积加权的 D50 含义不同，无需数值相同。

分布图与累计分布

分布图帮助观察颗粒主要集中在哪些尺寸区间；累计分布帮助阅读小于某尺寸的累计估算占比。读百分比前，先看页面标注的加权方式。

分布宽度

D10 到 D90 的间隔帮助观察分布覆盖范围。比较宽窄时，应同时核对 D50 和铺样条件；更窄的分布本身不能保证更好的风味。

1. 固定本次比较的条件

   使用同一份咖啡，记录磨豆机和研磨设置。按页面指引放置尺寸参照，保持背景、光线、距离与对焦条件相近。

2. 分别铺样，避免挑选颗粒

   每组样品尽量分散，减少重叠和粘连。不要只挑大颗粒或好识别的颗粒拍摄；画面中的样品需要能代表本次研磨。

3. 先验识别，再看统计

   检查是否把背景、参照物或成团颗粒误识别为样品。识别明显异常时先重新拍摄；单纯查看最终统计，可能错过前面的识别问题。

4. 保留条件与品饮结果

   分别保存两组结果和研磨备注，比较 D50、分布范围与识别质量，再结合冲煮和品饮决定下一步。优先一次调整一个变量。

豆子分析与膨胀分析也需要一致的拍摄条件。膨胀对比尤其要保留生豆与熟豆的样品对应关系，避免拿不同批次的照片解释同一次烘焙变化。

1. 准备好秤和冲煮器具

   将秤放稳，确认连接与重量显示，再按设备及页面提示去皮、准备计时。移动器具或去皮会改变重量状态，开始记录前先确认。

2. 设置本次目标

   在页面支持的方案中核对粉量、目标水量、阶段和时间。目标用于引导操作，记录中的实际结果用于复盘；两者出现差异时，先看发生在哪一段。

3. 观察注水与流速

   重量或注水曲线展示过程变化，流速图帮助观察注水节奏。流速起伏需要结合实际操作判断，碰触器具或称重扰动也可能影响曲线。

4. 结束后补上品饮反馈

   回顾页查看总注水、总用时、平均流速及可用的阶段信息，选择评分并填写“风味记录与下次调整”，再点击保存反馈。历史对比时优先选相同方案与相近条件。

浓度区的 TDS、饮品净重和样品温度需要有效来源；按当前页面手动录入，或使用明确支持的测量来源。秤的重量读数本身不等于 TDS。饮品净重也不等于总注水量，填写后再查看页面给出的萃取率，并保存浓度结果。

1. 给档案取一个容易识别的名字

   填写咖啡介绍，留意每个输入框的字数提示。建议记录能帮助辨认这批豆子的内容，风味文字使用自己观察或确认过的描述。

2. 按温度区间组织描述

   填写最低、最高温度和对应风味。设备根据温度匹配你填写的文字；温度变化不会让设备自动尝出新的香气或味觉。

3. 保存后检查预览

   使用页面提供的预览和模拟温度，核对不同温度下出现的描述。若某段文字没有出现，先检查温度范围和内容是否有效。

4. 选择二维码或发送到设备

   按页面生成并保存二维码，可用于对应咖啡的识别；连接受支持的设备后，也可使用“发送到风味仪”。发送后在设备上确认内容，保留 App 内档案供后续修改。

例如，可以用两个温度区间分别记录较高温时的香气印象和降温后的甜感、余韵。这只是组织品饮笔记的方法，具体描述来自你的实际体验。

App 更新

更新手机中的 COFFLOL。完成后打开 App，确认页面与原有记录可以正常使用；这一步不会自动说明设备固件已更新。

网络配置已发送

表示本次配置已发出，继续查看设备是否实际联网。配置失败时核对网络频段、英文网络名称和密码，再按设备页面提示处理。

升级指令已发送

继续等待设备执行升级与重启。部分固件不能完整回报结果；暂时断开连接也不能单独证明升级成功或失败，避免连续重复点击。

重新连接并核对版本

设备恢复后查看固件版本，确认与所选版本一致，再做一次基本操作检查。遇到异常时记录型号、升级前后版本与现象，便于支持人员判断。

1. 在旧手机生成备份

   从首页设置进入“备份数据”，等待生成完成。出现分享目标选择后，把备份文件保存到自己能再次找到的位置，不要只停留在分享面板。

2. 核对文件与日期

   确认保存的备份文件存在，并能在文件管理中找到。给重要备份保留清晰的日期标记；记录导出的图片或报告不能代替完整备份文件。

3. 在新手机恢复前保留现状

   先安装适合的新版 App。如果新手机已有重要记录，先另外备份，再选择正确的备份文件并阅读恢复提示。恢复会改动现有记录，不要默认它只是增加一份副本。

4. 恢复后抽查几类记录

   检查咖啡名称、批次、测量与历史曲线等实际使用的内容。确认需要的数据可正常打开后，再整理旧手机和备份副本。

看到恢复失败或格式不兼容时，保留原始备份，核对 App 版本和文件是否完整，再按提示处理。不要反复修改原文件内容来尝试导入。