Grocy Inventory

🥫 本地 Grocy 库存管家,扫码即管

连接本地 Grocy 实例,管理家庭库存、购物清单、电池充电追踪,支持扫码快速出入库。

收藏
4.3k
安装
1.1k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Grocy Inventory Skill 是一个面向自托管 Grocy 库存管理系统的接口工具,通过 REST API 与本地运行的 Grocy 实例(默认 http://localhost:14611)通信。用户可通过该 skill 执行以下操作:

  • 库存查询:查看冰箱/ pantry 当前存货状态
  • 临期管理:筛选即将过期的产品
  • 条码操作:扫码查询产品详情、消耗库存、标记开封、库位转移
  • 电池追踪:管理可充电电池清单及充电记录
  • 购物清单:同步购物需求

所有操作均通过 curl 命令模板实现,需配置 GROCY-API-KEY 进行身份验证。

显著优点

1. 本地化部署:数据完全私有,不依赖第三方云服务
2. 条码驱动:支持扫码枪/手机条码快速出入库,降低手动录入负担

3. 场景完整:覆盖家庭库存管理的典型场景(采购→入库→消耗→报废)

4. 电池管理:独特的家用电池充放电追踪功能,扩展了传统库存边界

潜在缺点与局限性

  • 技术门槛高:需自行部署 Grocy 服务、配置反向代理或内网穿透
  • 无实时同步:依赖轮询或手动触发,无 WebSocket 实时更新
  • 网络限制:硬编码 localhost,远程访问需额外隧道配置
  • API Key 暴露风险:配置文件中明文存储 API 密钥,存在泄露隐患
  • 无事务回滚:消耗/转移操作一旦执行无法自动撤销

适合人群

  • 自托管爱好者(Homelab 用户)
  • 注重数据隐私的家庭管理者
  • 已部署 Grocy 并希望快速查询库存的用户
  • 需要电池充放电追踪的数码设备管理者

常规风险

  • 网络安全:若将 Grocy 暴露至公网且未启用 HTTPS,API Key 可能被嗅探
  • 数据一致性:并发操作可能导致库存数量冲突(Grocy 后端未严格串行化)
  • 误操作风险:条码识别错误或手动输入错误可能导致库存数据异常
  • 服务可用性:本地服务宕机时 skill 完全不可用,无降级方案

Grocy Inventory 内容

references文件夹
手动下载zip · 3.0 kB
grocy-api.mdtext/markdown
请选择文件