注意： 1. 首次进入应用会跳出设置Gemini Key和Bring！账号，如无，可以直接点击“Avanti（下一步）”跳过完成。 2. 进入后可点击右下角“Config”，点击语言界面，选择“English”，点击“Save”后进行语言切换。 ## 功能特性 - 食材库存管理：支持手动录入、条码扫描、库存位置管理、开封状态与保质期跟踪，适合冰箱、冷冻室和常温储物柜的日常盘点。 - AI 辅助识别：可选接入 Google Gemini，为条码困难场景提供拍照识别、保质期读取、库存聊天和食谱推荐。 - 购物清单联动：Bring! 账号是可选项；即使不配置 Bring!，仍可进入 `Shopping` 页面查看本地购物建议，再按需决定是否同步到外部清单。 - 烹饪模式：支持按步骤查看菜谱、定时器和语音播报，适合边做饭边操作。 - 家庭共享数据：库存、设置、聊天记录和菜谱计划统一保存在服务器侧 SQLite，同一实例下的手机、平板和桌面端会看到相同数据。 ### 日常使用方式 1. 添加商品时，可点击右上角 `📷` 进入 `Scan` 页面；如果当前浏览器拿不到摄像头权限，页面会显示 `Cannot access camera`，这时可改用 `Name` 页签手动录入。 2. 这次实测可复现的录入路径是：`📷 -> Name -> 输入商品名 -> ✅ -> 📥 ADD -> 选择位置 -> ✅ Add`。 3. 在 `Pantry` 页面可按 `Pantry / Fridge / Freezer / Other` 过滤库存；点击单条商品后，可在弹层中使用 `📤 Use`、`✏️ Edit`、`🍳 Recipe` 和删除按钮。 4. 在首页可通过 `🍳 Quick recipe with expiring products →` 直接调用 Gemini Chef；在 `Log` 页面可以核对每次 `Added` 与 `Used` 的时间和位置。 5. 在 `Shopping` 页面，即使 Bring! 未配置，也能点击 `Suggest what to buy` 获取本地 AI 购物建议；只有真正需要外部同步时才需要补齐 Bring! 账号。 ### 可选配置 1. `Gemini API Key`：启用拍照识别、保质期 OCR、AI 食谱、AI 聊天、智能购物建议等增强能力；未配置时，基础库存功能仍可正常使用。需要结合小猪佩奇使用。 2. `Bring!` 账号：仅在你要把购物清单同步到 Bring! 时才需要；不配置也可以使用 `Shopping` 页面里的本地建议。 创建方式：先在手机端安装 Bring! 官方 App，下载入口见 [Bring! 官网](https://www.getbring.com/en/home)；注册后再回到 EverShelf 的 `Settings -> Bring! Shopping List` 填写邮箱和密码。 桌面核对：Bring! 也提供 [Web App](https://web.getbring.com)，可用 Bring! 账号或 Google sign-in 登录查看清单。 密码相关：如果忘记密码，可在 Bring! 登录页使用 `Forgot your password?`；如需修改密码，Bring! 官方说明当前需要在手机 App 内完成。 3. `TTS` 语音播报：有两种配置方式。 浏览器内置语音：进入 `Settings -> Voice (TTS)`，打开 `Enable TTS`，在 `TTS Engine` 选择 `Browser (offline, no configuration)`，再按需选择语音、语速和音调即可；这种模式不需要额外账号或接口，适合本地浏览器直接播报。 外部语音接口：如果你要接 Home Assistant 或自建 REST API，把 `TTS Engine` 切到 `External server`，填写 `Endpoint URL`、`HTTP Method`、认证方式以及 payload 字段名；如果服务端需要令牌，可在界面中填写 `Bearer Token` 或 `Custom Header`。填完后可以直接点 `Send Test Voice` 验证。 服务端预置：应用会把界面里保存的外部 TTS 配置写入服务端运行配置，对应变量包括 `TTS_URL`、`TTS_TOKEN`、`TTS_METHOD`、`TTS_AUTH_TYPE`、`TTS_CONTENT_TYPE`、`TTS_PAYLOAD_KEY`；如果你更习惯手工部署，也可以先在服务端 `.env` 或持久化配置文件中预填这些值。