简单好用、高颜值的个人与家庭物品资产管理小助手
界面预览 • 核心功能 • 快速上手 • 配置说明 • 联系交流 • 开源协议
记宝盒（jibaohe）是一款专为个人和家庭打造的 开源物品与资产管理小工具。
不管是新入手的数码好物、日常服饰，还是大家电、家具，记宝盒都能帮你轻松记录。它能自动算出每件物品的 “每天使用成本”（日均持有成本），让你清楚知道每一分钱花得值不值，告别盲目消费，轻松管好身边的每件宝贝！
| 物品总览 (首页) | 990+ 款生活图标 | 物品录入与日均算账 | 闲置卖出与残值结算 |
|---|---|---|---|
 |
 |
 |
 |
- 近千款精美图标（涵盖 15+ 常见分类）：内置 990+ 款 高清实用图标，数码、衣服、美妆、母婴、游戏、乐器、出行、家电、家具、健身等应有尽有，找东西一目了然。
- 一目了然的“日均成本”：输入购买价格和日期，系统自动帮你计算每天花了多少钱（例如 3000 元的平板用了 300 天，每天只需 10 元！），越用越划算。
- 贴心的状态分类与星标收藏：
- 星标收藏：常用、重要物品一键加星，快速查看。
- 在用 / 已退役：支持切换查看“正在使用”或“已淘汰/卖出”的物品，历史记录清晰不丢失。
- 分类快速筛选：按数码、电器、房产等分类一键过滤查找。
- 多种实用的排序方式：
- 看性价比：按日均成本从低到高/从高到低排序，看看哪个买得最值、哪个在“吃灰”。
- 按价格与时间：支持按购买金额、购买日期、使用天数等多种方式自由排序。
- 物品全过程记录与残值计算：支持记录购买价格、使用天数。当物品不用或二手转卖时，可标记“退役”并记录卖出残值，自动算出最终实际花费。
- 清晰的数据统计与图表：自动汇总拥有的资产总额、总体每日持有成本，直观图表展示各类消费分布，帮你更理性地管理消费。
- 数据安全，完全归自己所有：所有数据保存在本地数据库中，支持一键导出为表格（CSV），不用担心隐私泄露或服务停运。
- Docker（推荐安装 Docker Desktop，开箱即用，免配开发环境）
- 微信开发者工具（前往微信官方下载）
下载项目后，在 jibaohe 项目根目录下打开终端，执行一条命令即可：
docker compose up -d💡 运行说明：
- 容器会自动完成数据库初始化，并常驻后台运行在
http://localhost:5007；- 数据会自动持久化保存在本地
data/目录中，即使升级或重启容器数据也绝不会丢失。
💻 无 Docker 环境？点击展开本地 Python 运行步骤
- 安装依赖：
cd backend python3 -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
- 启动服务：
(保持终端窗口开启运行即可)
cp .env.example .env python init_db.py python app.py
-
生成前端配置： 另开一个终端窗口，在
jibaohe项目根目录下运行：cp utils/config.example.js utils/config.js
-
导入微信开发者工具：
- 打开 微信开发者工具，点击 “导入”（或“+”号添加项目）；
- 项目目录：选择刚刚下载的
jibaohe文件夹； - AppID：点击选择 “测试号”（无需注册小程序账号即可体验）；
- 关键设置（必看避坑）：在开发者工具右上角点击 「详情」 -> 「本地设置」，务必勾选 「不校验合法域名、web-view (业务域名)、TLS 版本以及 HTTPS 证书」；
- 点击确定进入，左侧模拟器就会正常加载出记宝盒界面啦！
Q1: 为什么打开小程序页面一直转圈或提示网络错误？
- 原因 1：后台服务没有启动或被意外关闭了。请确认运行
python app.py的终端窗口依然处于开启状态。 - 原因 2：微信开发者工具拦截了本地请求。请在开发者工具右上角点击 「详情」 -> 「本地设置」，勾选 「不校验合法域名」。
Q2: 我的数据保存在哪里？会不会泄露？
- 所有数据都只保存在你本地电脑的
backend/jibaohe.db文件中，没有任何云端上传，完全属于你自己的私有数据。 - 你还可以在小程序「我的」页面一键导出为 Excel/CSV 表格备份。
Q3: 换电脑后怎么迁移我的数据？
- 直接把
backend/jibaohe.db文件复制到新电脑对应的backend目录下即可无缝恢复所有物品记录。
日常本地体验直接使用默认配置即可。如需自定义修改，可参考：
| 配置项 | 含义说明 | 默认值 |
|---|---|---|
domain |
后端数据服务的访问地址 | http://localhost:5007 |
appName.full |
应用显示名称 | 记宝盒 |
apiPath.login |
登录接口路径 | /api/login |
| 配置项 | 含义说明 | 默认值 |
|---|---|---|
BASE_URL |
后端服务访问地址 | http://localhost:5007 |
DATABASE_URI |
本地数据库文件位置 | sqlite:///jibaohe.db |
SECRET_KEY |
本地数据安全密钥 | 随机字符即可 |
如果在使用或安装过程中遇到任何问题，欢迎通过以下方式联系与交流：
- 微信：csdnxr
- QQ：294323976
- 邮箱：leoucmao@gmail.com
- 提交建议 / Bug：GitHub Issues
- 本项目基于 MIT LICENSE 协议开源。
- 免责声明：本项目主要用于个人及家庭资产管理与学习交流。