扫一扫食品条形码,看懂配料表,给出安全等级。 本地自用离线版:无后端、无云端 OCR、不上传任何数据、不上架应用商店。
「放心用」 是一款完全离线的食品安全助手:对准包装上的条形码,或对配料表拍张照(也可手输), App 在手机本地解析配料表、识别食品添加剂、比对 GB 2760 使用规定、评估营养成分, 给出 A / B / B- / C / D 五级安全评级与逐项解释。
对标产品:剂安安(深圳市剂康科技,已不可用)。
| 能力 | 状态 |
|---|---|
| 配料表 / 营养成分表 评分与 A–D 分级 | ✅ 已实装(纯端上,扣分逐条开账,硬规则兜底,D 级分数单向封顶) |
| 知识库 | ✅ 559 添加剂 / 654 别名 / 260 限量规则 / 405 原料 / 3012 离线商品 / 10970 品名字典 / 44 人群规则(真源:data/raw/kb/*.csv) |
| 实时扫码(EAN/UPC/CODE128) | ✅ 已实装(左上角稳固展示「扫描条形码」,操作区紧凑自适应防挤压;EAN-13 校验位校验、UPC-A 自动补零归一) |
| 拍照 / 相册 OCR(端上中文) | ✅ 已实装(Google ML Kit + 四角/四边自由拖拽裁剪框 + 824字食品包装繁简自动转换) |
| 原料与果蔬汁智能派生识别 | ✅ 已实装(青提/西梅/阳光玫瑰等全收录,果蔬原汁/果泥/原浆/果肉 100% 自动精准识别为原料) |
| 营养成分表结构化提取与校验 | ✅ 已实装(九宫格自动对齐、kJ/kcal 与 g/mg 智能折算与数值偏低预警、防"苯甲酸钠/麦芽糖浆"串扰) |
| 配料表透视与一键修正 | ✅ 已实装(识别结果原文透视高亮;点击未收录词底部微卡片推荐候选,一键替换并极速重算) |
| 条码 → 商品信息(多源降级) | ✅ 已实装(本地种子库 → 本地缓存 → OFF → 国内条码,1.2s 极速熔断断网不卡顿,支持完全离线) |
| 货比三家与健康替代推荐 | ✅ 已实装(支持连续扫描沉淀多款备选托盘,按 GB 大类聚合横评,推荐更优配料商品) |
| 评测海报导出与长图分享 | ✅ 已实装(底端弹窗一键渲染并保存 3x 高清长图至手机相册,自动复制文字评测摘要) |
| 历史记录管理 | ✅ 已实装(按品类折叠与评级筛选,重命名/补录条码,全周期控制器内存释放治理) |
| 测试保障与工程规范 | ✅ 81/81 项全量测试绿灯(含条码校验位/类别映射/硬规则单向兜底/UI标题契约测试) |
| 架构与算法规格 | ✅ 纯端上离线分级引擎、AP/NP/PP 扣分开账与硬规则单向下调闭环 |
| 发布版本 APK | ✅ 最新发布包:fangxinyong-v1.0.8.apk |
⚠️ 关于内置商品库:food_product_seed中除少数来自公开资料的编号外,大部分是脚本等差生成的示例编号, 校验位合法但不等价于超市实拍可扫中的商品码;不要把"内置 3012 款"当作实测覆盖率。 校验位非法的编号已在 ETL 构建期直接丢弃。
| 项 | 决定 |
|---|---|
| App 正式名 | 放心用 |
| 工程代号 | FoodGuard(内部代码命名保持稳定) |
| Android 包名 | com.aeromantic.fangxinyong |
| 后端 | 不接。无服务端,纯端上 |
| 云端 OCR | 不用。端上 ML Kit 中文识别 + 手动输入兜底 |
| 分发方式 | GitHub Releases 发布,自签 APK 自用 |
| 适用范围 | 所有可食用食品(含饮料、调味品、保健食品);日化/用品不在范围内 |
| 网络 | 可联网自用:条码 → Open Food Facts / 第三方接口查商品信息(默认关闭,需在设置页手动开启);不开启则全程零网络请求 |
| 数据与隐私 | 条码、配料表、照片永不上传;开启联网时仅发出纯条码号检索品名 |
FoodGuard/
├─ README.md 项目说明文档
├─ LICENSE 开源许可证(MIT)
├─ .gitignore Git 过滤规则
└─ app/ Flutter 客户端源码
├─ lib/ 业务逻辑与界面
│ ├─ core/ 核心算法、文字归一化、繁简转换
│ ├─ data/ 本地 SQLite 与离线知识库仓储
│ ├─ domain/ 添加剂匹配、营养评估、安全评分引擎
│ └─ presentation/ 页面与交互 UI
├─ assets/knowledge/ 内置离线食品添加剂与安全知识库(SQLite)
└─ test/ 自动化测试套件(81 项测试全绿)
# 1. 进入 Flutter 源码目录
cd app
# 2. 运行自动化测试套件(81 项全绿)
flutter test
# 3. 代码规范静态分析(0 错误 0 警告)
flutter analyze
# 4. 本地运行调试
flutter run
# 5. 构建正式发布包
flutter build apk --release
# 生成的安装包位于 app/build/app/outputs/flutter-apk/app-release.apk本 App 依据国家公开标准(GB 2760-2024、GB 28050 等)与权威国际机构公开评估(JECFA / IARC / EFSA)在手机本地端上离线计算, 仅供大众日常选购食品时快速看懂标签与参考,不构成医疗营养诊断建议,也不能替代实验室专业理化检测;不对厂商包装实际添加量是否超标作出法律判定。