一款开源、数字化的结婚份子钱管理神器

在我们的人生重要时刻——无论是新婚之喜、乔迁之宴，还是寿诞庆典——总少不了亲友的祝福与“份子钱”这份沉甸甸的心意。然而，管理这些礼金记录，长久以来都依赖于容易出错、难以统计的手写礼簿。

今天，给大家介绍一款名为 gift-book 的开源项目，它正致力于用数字化的方式，优雅地解决这一痛点。

简介

gift-book是一款纯本地、零后端、完全本地运行的单页 Web 应用，旨在为各类红白喜事提供一个现代化、安全、高效的礼金（份子钱）管理。它彻底告别了传统的手写礼簿，通过数字化的方式解决了记录、统计、查询和存档的全部流程，以简单易用为最高设计原则。

核心功能

极致的录入体验

秒级记账：姓名、金额、渠道（微信/支付宝/现金）全键盘操作，回车即录。

智能风控：实时检测重名、重复金额，防止“记重了、记错了”。

自动大写：输入数字，自动生成规范中文大写（如：壹仟元整）。

语音播报：支持 TTS 语音朗读（“张三 贺礼 一千元整”），方便宾客现场核对金额，又能撑场面。

双屏互动 & 仪式感

访客副屏：支持开启副屏页面，实时投射数据到外接屏幕/电视，主屏录入，副屏展示，方便现场宾客核对金额。

隐私脱敏：副屏自动开启隐私模式，仅展示最新记录全名，历史记录自动打码。

收款码展示：副屏支持自定义上传展示东家收款码，方便宾客现场扫码。

双色主题：内置「喜庆红」与「肃穆灰」两套 皮肤，适应红白喜事不同场景。

专业级报表与归档

真·PDF 引擎：内置 PDF 渲染器（非简陋的浏览器打印），支持自定义字体、封面图、背景纹理，生成精美的电子礼簿。

智能分批：数据量超 1000 条自动分卷生成，防止浏览器内存溢出。

审计留痕：全链路记录修改历史（时间轴），支持软删除（作废），每一笔变动都有迹可循。

双重备份：

Excel：标准 
.xlsx 报表，含完整修改日志。

数据文件：导出加密的数据备份，支持跨设备全量恢复。

开发部署

1. 获取代码 (Git)

首先将仓库克隆到本地：

# 克隆项目
git clone https://github.com/jingguanzhang/gift-book.git
# 进入目录
cd gift-book

2. 环境准备

你只需要一个代码编辑器（推荐 VS Code）和一个现代浏览器（Chrome/Edge）。

3. 启动开发

虽然直接双击 
index.html 可以运行，但为了避免浏览器的安全策略限制（如本地文件访问限制、模块加载跨域等），强烈建议使用本地静态服务器运行。

方式一（推荐）：VS Code Live Server

安装 VS Code 插件：Live Server。

右键选择 “Open with Live Server” 。

方式二：Python (Mac/Linux/Win) 在项目根目录下打开终端，运行：

# Python 3
python -m http.server
# 访问 http://localhost:8000

4. 项目结构


index1.html: v1.1 专业版主入口（核心代码均内嵌于此，方便单文件分发）。


index.html: v1.0 基础版主入口。


static/: 静态资源目录。


tailwindcss.js: 样式引擎。


xlsx.full.min.js: Excel 导出库。


pdf-lib.min.js: PDF 生成引擎。


crypto-js.min.js: 加密库。


fontkit & 
.ttf: 字体文件（用于 PDF 生成）。


guest-screen.html: 副屏显示页面。

5. 部署上线

本项目是纯静态资源，部署非常简单：

直接上传：将所有文件上传至 GitHub Pages、Vercel、Nginx 或任何静态文件服务器。

无需编译：不需要执行 
build 命令，源码即产物。

界面预览

开源地址

https://github.com/jingguanzhang/gift-book