shiwuji

项目概述

拾物记（ShiWuJi）是一款基于 Flutter 开发的家居物品收纳管理 App，帮助你解决明明记得家里有某样东西、却翻箱倒柜找不到的烦恼。它让你为每件物品记录存放位置、分类信息、购买日期和保修状态，支持 AI 拍照识别、电商订单批量导入和 WebDAV 云备份，让家里的物品管理井井有条。它的核心设计理念是用最少的操作管理最多的物品：用房间到柜子到格子再到物品的空间结构对应现实收纳场景，录入时选位置就像把东西放进柜子一样自然；再用拍照识别和订单导入把新建记录的成本降到几乎为零。App 支持 Android、iOS、Windows、Linux 和 Web 五个平台，采用 MIT 协议开源。

主要功能

• AI 拍照识别：拍张照片，AI 自动填充名称、品牌、分类，支持 18 家以上 AI 服务商。
• 物品管理：记录名称、价格、分类、存放位置、购买日期、保修天数、照片、品牌和备注。
• 空间层级：房间到柜子到格子再到物品，四级结构实现精确定位。
• 保修追踪：自动计算保修到期，首页展示即将到期、已过期和在保物品统计。
• 分类管理：内置数码、家电、护肤、厨房、衣物、书籍、收纳、玩具、运动、文具、钥匙、工具等 12 个分类，支持自定义扩展。
• 订单导入：一键导入电商平台订单，批量生成物品记录。
• 统计卡片：首页展示物品总数、资产总值、本周新增和本月增长。
• 物品筛选：按分类或保修状态筛选，按时间、价格、到期日排序。
• 空间管理：房间、柜子、格子三级空间管理，实时查看占用情况。
• WebDAV 备份：连接坚果云、Nextcloud 等任意 WebDAV 服务，备份和恢复数据库。
• 更新检查：从 GitHub Releases 拉取最新版本信息，App 内提示更新。
• 本地通知与数据加密：保修到期本地提醒，并基于 PBKDF2 与 AES 对数据库加密。

适用人群

• 经常找不到家中物品、希望系统化管理收纳的用户。
• 家里物品多、需要记录保修和购买信息的家庭用户。
• 想用 AI 拍照快速录入、不想手动填表格的用户。
• 关注数据隐私、希望用 WebDAV 自建云备份的用户。
• 需要在手机和电脑多端使用的用户。

快速上手

1. 下载并安装对应平台的拾物记 App（Android、iOS、Windows、Linux 或 Web）。
2. 首次打开可按引导了解界面，首页展示物品总数、资产总值和保修统计。
3. 进入空间管理，先创建房间、柜子和格子，搭好家里的空间结构。
4. 新增物品时填写名称、价格、分类和存放位置，也可用 AI 拍照识别自动填充，或导入电商订单批量生成。
5. 首页会自动提醒即将到期或已过期的保修物品。
6. 在个人中心连接 WebDAV 服务（如坚果云、Nextcloud），把数据库备份到云端。
7. 开发者可从源码运行：克隆仓库后依次执行 flutter pub get、dart run build_runner build、flutter run。

核心优势

• 空间即结构：三级空间层级直接对应现实收纳场景，录入自然直观。
• AI 降低门槛：拍照识别和订单导入让建记录几乎零成本，解决懒得记的问题。
• 自动化省心：保修自动计算、到期自动提醒、数据自动加密备份。
• 多端覆盖：一套代码覆盖 Android、iOS、Windows、Linux 和 Web 五个平台。
• 隐私可控：数据库本地加密，备份走用户自选的 WebDAV 服务。
• 开源免费：MIT 协议开源，代码可审查、可自行构建。

系统要求

• 操作系统：Android、iOS、Windows、Linux、Web。
• 支持架构：Flutter 跨平台构建；Android 可使用 split-per-abi 拆分包。
• 额外依赖：从源码构建需安装 Flutter SDK；AI 识别与云备份需自备相应服务。

注意事项

• AI 拍照识别需要自行配置受支持的 AI 服务商及密钥。
• WebDAV 备份需要自备支持 WebDAV 的网盘或服务器。
• 从源码构建后修改 models、database/tables 或 providers 时，需重新执行 build_runner 生成代码。