Files

T

部署到群晖 / deploy (push) Failing after 6m22s

Details

- 新增 server/：Node + Express + SQLite + node-cron 实现登录、纪念日 CRUD 和定时订阅消息推送
- 新增 .gitea/workflows/deploy.yml：推送即触发群晖 Docker 部署，监听 15002
- utils/api.js：自动按 envVersion 切换本地/线上 BASE_URL
- app.js 与 add-anniversary.js 移除 wx.cloud 调用，改走自建后端
- cloudfunctions/ 暂保留以便回滚
- 一并提交此前未入库的首页 / 设置页 / 日历 / 万年历等改造

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-06-01 15:44:09 +08:00

4.9 KiB

Raw Blame History

快速开始指南

🎯 项目已完成！

你的生日提醒小程序项目已经完全搭建好了！下面是使用说明。

📦 项目文件结构

生日提醒小程序/
├── app.js                    # 小程序入口
├── app.json                  # 全局配置
├── app.wxss                  # 全局样式
├── project.config.json        # 项目配置
├── sitemap.json              # 站点地图
├── README.md                 # 完整文档
├── PRD.md                    # 产品需求文档
├── 快速开始.md                # 本文件
│
├── pages/                    # 所有页面
│   ├── index/               # 首页（人员列表）
│   ├── person-detail/       # 人员详情
│   ├── add-person/          # 添加/编辑人员
│   ├── add-anniversary/     # 添加/编辑纪念日
│   ├── calendar/            # 日历视图
│   └── settings/            # 设置页面
│
├── utils/                    # 工具类
│   ├── storage.js          # 数据存储管理
│   ├── lunar.js            # 农历转换
│   └── date.js             # 日期工具
│
└── images/                   # 图片资源
    └── .gitkeep

🚀 如何使用

1. 打开微信开发者工具

下载并安装微信开发者工具
打开工具，选择"导入项目"
选择本项目目录
AppID填写：touristappid（使用测试号）

2. 图标说明

✅ tabBar 已配置为 emoji 图标模式，无需添加图片文件：

🏠 首页
📅 日历
⚙️ 设置

如需添加自定义图标，可以在 images/ 目录添加图片并修改 app.json 配置。

3. 运行项目

点击"编译"按钮
在模拟器中查看效果
可以开始测试各项功能

✅ 核心功能已实现

✅ 1. 人员管理

添加人员（姓名、昵称、头像、备注）
编辑人员信息
删除人员
搜索功能

✅ 2. 纪念日管理

支持多种类型（公历生日、农历生日、纪念日等）
自定义纪念日类型
设置重要程度
支持公历/农历切换

✅ 3. 提醒设置

开启/关闭提醒
设置提前天数（3/7/14/30天或自定义）
近期纪念日显示

✅ 4. 日历视图

月历展示
标记纪念日
本月纪念日列表
快速浏览

✅ 5. 数据管理

导出数据（复制到剪贴板）
导入数据
清空数据

📱 页面说明

首页（人员列表）

查看所有添加的人员
显示最近的纪念日和倒计时
搜索和筛选
浮动按钮快速添加

人员详情页

查看完整信息
管理该人员的所有纪念日
编辑、删除操作

添加人员页

输入完整信息
上传头像（可选）
保存到本地

添加纪念日页

选择关联人员
选择类型
设置日期（公历/农历）
配置提醒和重要程度

日历页

月历视图
标记有纪念日的日期
本月纪念日列表

设置页

导入/导出数据
清空数据
查看版本信息

💡 使用建议

首次使用

先添加几个人员
为每个人添加1-2个纪念日
设置重要程度和提醒
查看日历和列表效果

数据备份

定期导出：设置 → 导出数据
导入恢复：设置 → 导入数据
注意：导入会覆盖现有数据

农历生日

选择"农历"类型
输入农历日期
系统会自动计算

⚠️ 已知限制

tabBar图标：需要手动添加图标文件，否则tabBar可能显示异常
农历计算：当前使用简化算法，准确性有限
提醒功能：小程序限制，无法真正的后台推送
头像上传：使用本地临时路径，刷新后会丢失

🔧 可选优化

1. 替换农历库

npm install lunar-javascript

然后在 utils/lunar.js 中使用。

2. 添加云开发

使用微信云开发实现数据同步
支持多设备
真正的推送通知

3. 添加更多图标

使用 iconfont 或 iconify
统一设计风格

📞 遇到问题？

常见问题

Q: tabBar显示异常？ A: 需要添加图标文件到 images/ 目录，或者删除 app.json 中的 tabBar 配置。

Q: 数据丢失？ A: 建议定期导出数据备份。在设置页可以导出当前所有数据。

Q: 提醒不工作？ A: 小程序限制，无法真正的后台推送。需要在小程序前台运行时才能触发。

Q: 农历日期不准确？ A: 当前使用简化算法。建议使用成熟的农历库如 lunar-javascript。

🎉 完成！

现在你可以：

打开微信开发者工具
导入项目
开始使用和测试
根据需求进一步优化

祝你使用愉快！如有问题，欢迎反馈。

4.9 KiB Raw Blame History Unescape Escape