良辰美小程序

良辰美是一个本地优先的微信小程序 MVP，用来管理家人生日和重要纪念日，查看倒计时，维护提醒计划。

当前功能

• 添加、编辑、删除生日、结婚日期和其他纪念日。
• 首页按最近日期显示倒计时。
• 详情页查看倒计时和提醒计划。
• 提醒计划支持提前 3 个月、1 个月、1 周、3 天、1 天和当天，默认提前 3 天。
• 用户主动授权后，可把单个纪念日写入手机系统日历并按年重复。
• 通过剪贴板导出/导入本地迁移码，导入默认智能合并。

数据与登录

• 当前版本不注册账号，不调用 wx.login / Taro.login，也不绑定 openid。
• 所有纪念日和提醒设置只保存在本机小程序缓存。
• 换手机或清理小程序缓存后，需要用迁移码手动迁移。
• 项目没有服务端、云数据库、Supabase 或订阅消息定时任务。

主要目录

src/
  app.config.ts                  小程序页面、窗口和权限配置
  app.tsx                        Taro 应用入口
  db/
    api.ts                       本机存储读写和迁移码导入导出
    types.ts                     纪念日类型
  pages/
    index/                       首页和迁移码导入导出
    anniversary-edit/            添加/编辑纪念日与提醒计划
    anniversary-detail/          详情和系统日历入口
  utils/
    anniversary.ts               日期计算和系统日历事件构造
    backup-code.ts               迁移码编码、校验和智能合并
    reminder.ts                  提醒计划归一化和展示文案
    system-calendar.ts           手机系统日历授权写入

常用命令

pnpm install
pnpm run lint
pnpm exec tsx tests/anniversary.test.ts
pnpm exec tsx tests/reminder.test.ts
pnpm exec tsx tests/backup-code.test.ts
pnpm exec tsx tests/year-options.test.ts
pnpm exec taro build --type weapp

上传微信开发版：

WEAPP_UPLOAD_KEY_PATH="/Users/project/1B/千百万刀/Knowledge/World/小程序/private.wx6fc6279e0e0a883d.key" \
WEAPP_VERSION=1.2.1 \
pnpm run upload:weapp

本文档为站内渲染。原始文件本地路径：saas/source/knowledge-world/Knowledge-World-小程序-纪念日管理小程序-源码提取-20260516085012-README-4be4cc.md（仅本地保留，不入库不部署）