在我们的人生重要时刻——无论是新婚之喜、乔迁之宴，还是寿诞庆典——总少不了亲友的祝福与“份子钱”这份沉甸甸的心意。然而，管理这些礼金记录，长久以来都依赖于容易出错、难以统计的手写礼簿。
今天，给大家介绍一款名为 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
构建高质量的技术交流社群，欢迎从事编程开发、技术招聘HR进群，也欢迎大家分享自己公司的内推信息，相互帮助，一起进步！
文明发言，以
交流技术、职位内推、行业探讨为主
广告人士勿入，切勿轻信私聊，防止被骗
点下方的“❤”支持我们，非常感谢！