EverShelf 是什么？
EverShelf 是一款自托管的 Web 应用，用来记录储藏室里有什么、何时过期以及接下来该买什么。 README 称其为“self-hosted pantry manager — inventory, barcode scan, AI recipes, less waste”；它用 PHP 编写，搭配 SQLite 数据库和单页前端，代码以 MIT 许可证开源。
README 署名一位开发者 Stimpfl Daniel（GitHub：dadaloop82），并希望有更多贡献者加入。Joshumi Technologies 有一款无关的 iOS 应用使用相同名称；README 明确表示两者没有关联。
获取方式
EverShelf 是需要你自己安装的服务器；文档给出的方式是 Docker Compose，手机和平板通过浏览器或 Android 展台应用访问。
服务器（Docker Compose）
- 获取方式:
- README 快速开始：克隆仓库，把 .env.example 复制为 .env，运行 docker compose up -d
浏览器与手机
- 获取方式:
- 在浏览器中打开服务器地址（随附的 compose 文件使用 8080 端口）；在手机上可添加到主屏幕
Android 展台平板
- 获取方式:
- evershelf-kiosk.apk（版本 1.7.24，Android 7.0 或更高）
Unraid
官方网站
- 获取方式:
- evershelf.site
隐私说明
- 获取方式:
- evershelf.site 的 Privacy 部分：首页上的简短说明；未发现独立的政策文件
源代码
演示
- 获取方式:
- evershelf.site/demo，README 称其包含 AI
评测版本：v1.16.16，据 GitHub 发布记录于 2026 年 10 月 25 日发布；仓库最近一次更改在 2026 年 11 月 1 日。安装需要终端、Docker 和手动编辑的 .env 文件，属于面向开发者的部署方式，而不是双击安装。GitHub 发布列表中只有 Android 展台 APK。
运行要求
来源未给出 RAM 或 CPU 最低要求；已说明的条件是 Docker 或 PHP 8.0+、用于扫描的摄像头，以及用于 AI 的服务商密钥或 Llama 服务器。
服务器
- 来源说明:
- Docker 加 Compose，或指向仓库根目录、data/ 文件夹可写的 PHP 8.0+ Web 服务器
存储
- 来源说明:
- 数据卷中的 SQLite 数据库；内置备份保存在同一个数据卷里，请复制到别处
内存与 CPU
- 来源说明:
- 已阅读的来源中未说明
摄像头
- 来源说明:
- 条码扫描在浏览器中使用设备摄像头（据 Wiki 为 QuaggaJS）
展台
- 来源说明:
- Android 7.0（API 24）或更高；可选支持蓝牙厨房秤
AI
- 来源说明:
- Gemini 或 OpenAI 的 API 密钥，或 Ollama、llama.cpp、vLLM 等兼容 OpenAI 的 Llama 服务器地址
网络
- 来源说明:
- 为可信的家庭网络设计；若要从互联网访问，安全政策要求你自行添加认证层
这些条目来自 README、Wiki 和 SECURITY.md；PromptQuorum 未测量资源占用。
上手步骤
以下步骤依据项目 README，PromptQuorum 未实际运行。
- 1获取代码和配置模板
Why it matters: 用 git clone 拉取仓库，然后在项目文件夹中把 .env.example 复制为 .env。 - 2选择 AI 设置
Why it matters: 在 .env 中设置 AI_ENABLED=false 即可不使用 AI；若使用，请把 AI_PROVIDER 设为 gemini、openai 或 llama，并填入对应的密钥或基础 URL。 - 3启动容器
Why it matters: 运行 docker compose up -d 并打开 http://localhost:8080；以后更新时，README 给出的做法是先 docker compose pull，再 docker compose up -d。 - 4配对你的设备
Why it matters: 若设置了 API_TOKEN，网页界面会要求输入一次性配对码，该码显示在已配对设备的“设置、系统、安全”中，或在服务器日志里。
主要功能
以下每一项都来自项目的 README 或 Wiki；PromptQuorum 均未测试。
- 库存。 条码扫描、存放位置、保质期、已开封商品、收藏，以及 CSV 导入和导出。
- 购物。 带防浪费数量的智能购物清单、扣除已有库存后把缺少的食材加入清单的食谱，以及可选的 Bring! 同步。
- 烹饪。 逐步食谱，带语音朗读、计时器和零浪费小贴士。
- 提醒与日历。 通过 ntfy、JSON Webhook 或 Home Assistant 发送过期通知，另有适用于 Google 或 Apple 日历的 ICS 订阅源。
- 集成。 REST API、MCP 服务器、位于独立仓库的 Home Assistant 集成、带 Fuel Mode 的 Health Bridge，以及带蓝牙秤网关的 Android 展台。
AI 功能及运行位置
同一时间只启用一个 AI 服务商，在 .env 中选择：Gemini、OpenAI，或“llama”，即你自己运行的兼容 OpenAI 的端点；AI 也可以关闭。
- 商品识别。 AI 根据摄像头照片识别商品；配有 Gemini 密钥时，还可以查询其他查询方式找不到的条码。
- 保质期。 AI 读取标签照片并填写保质期字段。
- 食谱与聊天。 AI 根据储藏室里现有的东西编写食谱，并提供聊天；食谱也可以来自已连接的 Mealie 实例。
- 服务商。 示例配置记录了 Gemini、可更改基础 URL 和模型的 OpenAI，以及面向 Ollama、llama.cpp 或 vLLM 的 Llama 选项。Wiki 是按 Gemini 来描述 AI 功能的，没有说明哪些功能能用本地模型。
- 成本控制。 示例文件为 Gemini 分类调用设置了每日上限，并可估算 token 成本。
数据流向与隐私
官网称库存和历史记录留在你的设备或家用服务器上，AI 是可选的，并且没有遥测。 架构说明提到 data 文件夹中的 SQLite 数据库，安全政策则以可信的家庭网络为前提。
来源中提到的对外请求有：你选择的 AI 服务商（除非使用 Llama 选项，否则是 Gemini 或 OpenAI）、用于未知条码的 Open Food Facts、用于价格估算的 Open Prices，以及 Bring!、ntfy、Google Drive 备份和 PayPal 捐赠链接等可选服务。错误报告写入经过脱敏的本地日志，发送到 GitHub 需要再次主动选择。README 称，一次性对话框只提供捐赠或不捐赠的选择，不展示广告。公开演示使用云端 AI。
📌注: 这些是项目自己的声明，不是审计结果。PromptQuorum 未检查网络流量或源代码。
适合哪些人
- 拥有 Docker 服务器或 NAS 的自托管用户，想要私有的储藏室与保质期管理。
- 用储藏室里现有食材做饭的家庭，想要共享购物清单、过期提醒和用现有食材生成的食谱。
- Home Assistant 用户，想把保质期和购物数据放进智能家居或接入 MCP 的智能体。
我们未能核实的内容
- AI 质量。 商品识别、保质期读取和食谱质量均未测试，来源也没有说明哪些 AI 功能能配合本地 Llama 模型使用。
- 成熟度。 项目始于 2026 年 3 月，署名开发者为一人；PromptQuorum 未评估其稳定性和安全性。
- 安全文档。 SECURITY.md 仍把 1.7.x 列为受支持版本，远落后于当前的 v1.16.16。
- 数据声明。 “无遥测”和“数据留在家中”是项目的说法；我们未检查流量。
- 硬件需求。 没有文档化的 RAM 或 CPU 最低要求，在树莓派等小型设备上的速度也未检查。
竞品与替代方案
目录中在同一智能家居层还有一篇评测：Home Assistant 内的语音助手，EverShelf 为这个平台提供了集成。项目官网把 EverShelf 与 Grocy、Mealie 和 KitchenOwl 做了比较；这些储藏室和食谱管理工具不在目录中，PromptQuorum 也未核实该比较。
Home Assistant Assist
- 平台:
- Home Assistant、Web、iOS、Android
- 价格 / 许可证:
- 免费 / Apache-2.0
- 主要区别:
- 用于智能家居的语音控制，不是储藏室管理工具
关于Home Assistant Assist的文章（1篇）
请到各应用自己的页面确认当前价格、许可证和平台。
常见问题
EverShelf 是本地 LLM 吗？
不是。它是用 PHP 编写的储藏室管理应用，AI 交给 Gemini、OpenAI 或你自己运行的 Llama 服务器；官网称储藏室功能不用 AI 也能工作。
如何备份我的数据？
据发布说明，每天会以数据库快照的形式自动备份，但备份存放在数据卷内部，所以需要你自己把它复制到数据卷之外。
能和 Home Assistant 或 AI 智能体配合使用吗？
仓库链接了 Home Assistant 集成（ha-evershelf）和面向智能体的 MCP 服务器；PromptQuorum 两者都没有测试。
能在手机或平板上使用吗？
它可在浏览器中打开并添加到主屏幕，Android 展台应用面向壁挂平板。官网和 README 都没有链接 App Store 或 Google Play 页面。
界面支持哪些语言？
README 列出意大利语、英语、德语、法语、西班牙语和中文，应用会按 ?lang=de 这类链接的语言打开；贡献者翻译 translations/en.json 即可新增语言。
结论
EverShelf 是一种免费且更新活跃的方式，可以在你自己掌控的服务器上管理储藏室、保质期和购物，并提供可选的 AI 来识别商品、读取保质期标签和编写食谱。不足之处是：部署需要 Docker 和手动编辑的 .env 文件，除非自行配置 Llama 服务器，AI 会走 Gemini 或 OpenAI，项目还不到一年，而 AI 和隐私方面的说法在这里都无法核实。它适合本来就在自托管服务的家庭；想要双击安装的应用或语言模型助手的人，应该另寻他选。
来源
- EverShelf 官网 — 功能、FAQ 和隐私说明，2026 年 11 月 1 日查看。
- GitHub 上的 EverShelf — README、发布记录、示例配置、安全政策和提交动态，2026 年 11 月 1 日查看。
- 仓库中的 EverShelf Wiki 页面 — 功能、安装和 AI 服务商，2026 年 11 月 1 日查看。
- EverShelf Android 展台应用 README — 版本、最低 Android 级别和下载，2026 年 11 月 1 日查看。