01 · 连接
记住设备，少做重复连接
记住常用的咖啡机和电子秤，在 App 前台尝试重新连接。秤晚一点开机，也会继续寻找上次使用的设备。手动断开后，暂停本次使用中的自动重连。
- 设备分别连接，状态分别看清。
- 成功连接后，按设备加密记住咖啡机密码。
- 常用设备不用每次从头选择。
连接表现受设备、系统权限、距离和蓝牙环境影响，恢复连接不代表自动恢复未确认的机器操作。
流程示意
- 打开 App 前台尝试恢复连接
- 寻找记忆设备 秤晚开机也会继续寻找
- 分别显示状态 咖啡机与秤分别连接
独立开源 · Android · 非官方 Alpha 项目
连上 HOYI，看清这一杯。
记住常用设备，分享参数配方，把两杯萃取放在一起对照。从开始冲煮到回看记录，让每一次调整都有迹可循。
需要 Android 8.0 及以上和低功耗蓝牙。功能与设备支持以所下载版本的说明为准。
为什么选择 OpenHOYI
围绕日常冲煮，多做一步
四个核心特色，以及当前版本里需要留意的边界。
02 · 配方
分享参数配方，导入前先看清
把 OpenHOYI 参数配方复制成文本，或通过 JSON 文件分享。收到配方后，粘贴或选择文件，先查看参数，再确认保存。本机压力配方还可以调整温度、目标重量和分段压力、水量。
执行资格取决于配方模式、参数校验和设备状态。旧版曲线库导入仍为只读；并非所有导入文件都能直接执行。
流程示意
- 选中配方 查看名称、模式和分段参数
- 分享文本或文件 传递配方参数，不夹带私人复盘笔记
- 预览后导入 参数与版本冲突先看清，再决定保存方式
03 · 对比
两杯放在一起，看清哪里不同
选出 A、B 两杯，在同一坐标轴上对照压力、累计水量、秤重或温度，每次专注一个指标。再结合时长、结束时秤读数、豆子、曲线和笔记，回看这次调整带来了什么变化。
对比用于观察过程差异，不提供自动稳定性评分或口感判断。
功能示意，非 App 截图 · 示例数据
- A · 时长
- 32.1 s
- A · 结束时秤读数
- 22.40 g
- B · 时长
- 32.8 s
- B · 结束时秤读数
- 21.90 g
- 同豆
- 同曲线
- 示例笔记 1 条
同豆、同曲线更便于对照；缺测、未知结果和不同时间起点会明确提示。A/B 两条曲线均为示例数据，不是真实萃取记录；结束时秤读数不一定等于最终出杯量。
04 · 电子秤
更多电子秤选择，更多过程信息
已接入 BOOKOO、Felicita、TIMEMORE、Acaia 和 DiFluid 的指定型号与协议。萃取时查看重量，也可以打开独立秤工具，观察重量趋势、使用软件计时。
去皮、电量和自动动作因型号而异。先查看完整兼容列表，再确认你的电子秤能做什么。
指定型号与协议
- BOOKOO
- 已采集协议 · 有有限实机连接与归零记录
- Felicita
- 指定 ASCII 通知协议
- TIMEMORE
- DOT · TES017 / Basic3 Link · TES016
- Acaia
- A · PROCHBT / ACAIA；AP · LUNAR / PEARL / PYXIS
- DiFluid
- Microbalance / difluid / Mb Ti
不代表品牌所有型号兼容。BOOKOO 之外已接入的型号仍待对应实机验证；自动动作能力以型号和协议为准。
日常冲煮
从选配方，到下一次调整
常用配方，放在顺手的位置
100 条工厂曲线，5 个首页快捷槽位。看缩略图选配方，也能再次使用上杯曲线，按最近使用或常用程度查找。
萃取过程，边做边看
压力、温度、累计注水与秤重推导的 g/s 流速实时显示。读数缺失时明确留空，不把过期数据当作当前状态。
这一杯，留下你的判断
记录豆子、粉量、研磨、品尝笔记和下次调整。长期复盘与近期采样分开保存，让你的经验不只停留在一张曲线上。
豆子用了多少，也记得清楚
按批次记录豆子、日期和余量。确认投粉后记录消耗，调整库存时保留流水。
还有这些
- 独立秤工具
- 查看重量与趋势，按能力显示电量，并提供 App 软件计时。
- 数据导出
- 导出近期历史 ZIP 与长期复盘 JSON；历史 ZIP 目前只有导出，没有回导入口。
- 旧数据迁移
- 通过指定 JSON 显式导入旧曲线与旧历史，只读保留，不会自动读取旧 App 私有数据。
- 布局与偏好
- 手机竖屏、平板横屏，支持深浅主题与中英文界面。
数据与边界
先把这几件事分清
配方与记录不同
配方分享的是名称、温度、目标重量和分段控制参数，不含萃取遥测或私人笔记。旧版曲线库是独立的只读导入路径。
两杯对比不等于自动评分
当前支持 A/B 两杯、一次一个指标。没有多杯批量分析、稳定性评分或自动口感判断。
长期复盘不等于永久保存采样
近期历史保留最近 30 天、最多 500 条。长期复盘的元数据和笔记独立保存，原始采样仍受缓存保留范围影响。
界面
在手机或平板上，按自己的节奏冲煮
平板横屏展开设备状态和曲线，手机竖屏把日常入口放在底部。支持深浅主题与中英文界面。
以下为在平板上运行模拟演示包的实际界面截图，数据为模拟数据；不代表真实设备萃取或所有场景已完成验收。下载版本的界面可能有所不同。
兼容设备
下载前，先核对设备
- 手机 / 平板
- 支持 Android 8.0 及以上、具备低功耗蓝牙的手机和平板。目前没有 iPhone 或 iPad 版本。
- HOYI 咖啡机
- 面向 HOYI 咖啡机。固件 1.1.3 有有限实机连接与萃取启停记录；1.1.4 已根据协议证据开放控制，启停与设置仍待实机验收。其他固件不开放控制。
电子秤型号与验证状态
以下为当前开发分支的接入范围。不同发布版本包含的型号可能不同，请以下载版本的发布说明为准，并以实际型号、协议与固件为准。
| 型号或协议范围 | 已接入能力 | 验证状态 |
|---|---|---|
| BOOKOO，已采集协议 | ||
| Felicita，指定 ASCII 协议 | ||
| TIMEMORE DOT，TES017 | ||
| TIMEMORE Basic3 Link，TES016 | ||
| 旧款 TIMEMORE，广播名 timemore scale | ||
| Acaia A，PROCHBT / ACAIA | ||
| Acaia AP，LUNAR / PEARL / PYXIS | ||
| DiFluid，Microbalance / difluid / Mb Ti |
以上不代表品牌全系列兼容。只广播为 ULTRA 的 BOOKOO 旧档案使用另一协议路径，不具备自动去皮或目标重量控制资格。当前只有已采集 BOOKOO 协议具备相关自动动作的代码准入，仍不能把它当作已验证的无人看守自动停水能力。
下载
下载 Android 测试版
到 GitHub Releases 查看版本说明、适配范围与 APK。OpenHOYI 仍处于 Alpha 阶段，请先了解限制，再决定是否试用。
Alpha 阶段，不是稳定版。
前往 GitHub Releases-
核对版本
查看包名、版本说明、签名与 APK 校验信息。
-
连接设备
确认机器空闲，开启蓝牙与必要权限。咖啡机和电子秤分别连接，同一设备不要同时交给多个 App 连接。
-
确认状态，再开始
等设备就绪、读数更新后操作。首次试用时留在机器旁，保留机器本身的停水方式。
下载前核对
- 包名
- io.openhoyi.mobile
- 版本
- 在 Releases 里核对版本名、版本码与签名说明
- 完整性
- 在同一版本页面核对 APK 的 SHA-256
Debug / Alpha 预发布，不是正式发行版。源码提交映射由构建方声明，未验证可重复构建。
完整风险与免责声明
OpenHOYI 是个人实验项目，与咖啡机制造商无关联，也未获其认证。应用会向机器发送蓝牙控制指令，软件缺陷或兼容问题可能导致控制异常、数据丢失、设备不可用或损坏。目标重量自动停止、设置写入、异常恢复与覆盖升级仍待完整验收，不适合无人看守使用；不要依赖按目标重量自动停水。
已有旧版时，遇到安装冲突、签名不一致或降级提示就先停下，不要卸载旧版或清除数据。旧版记录不会自动迁移，需要手动导出再导入。
在适用法律允许的最大范围内，软件按“现状”提供，不作保证；本声明不排除法律规定不得排除的责任。
常见问题
可能还想知道
页面截图是怎么来的？
本页截图来自 M2105K81AC 平板，采自合入后的模拟演示包 0.2.0-preview.76（76），展示横屏布局，不是网站实时数据；截图使用模拟数据，不保证与下载版本一致。连接、配方与两杯对比区的流程和图表为功能示意。
原图保留未修改，展示图仅连续裁去系统栏，没有重绘界面。源码提交映射已核验为 58bbd96f；这不代表可重现构建、所有合入后检查通过或硬件验收。
这是 HOYI 官方应用吗？
不是。OpenHOYI 由个人独立开发，与制造商无关联，也未获其认证。源码公开在 GitHub，欢迎提交问题和改进。
能和旧版 HOYI 应用一起装吗？
可以并存，但同一台设备不能同时被两个应用连接。旧版记录不会自动迁移，需要手动导出再导入；遇到安装或升级冲突时，不要卸载旧版或清除数据。
搜不到设备怎么办？
检查蓝牙与应用权限，断开其他应用的连接，让电子秤进入可发现状态，再核对型号与固件是否在支持范围。结果不明确时先核对设备实际状态，不要反复发送控制指令。
