Files
wxserver/上线部署指南.md
yuming 3965e542fc
部署到群晖 / deploy (push) Failing after 6m22s
接入自建后端 + Gitea CI/CD
- 新增 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

8.5 KiB
Raw Permalink Blame History

生日提醒小程序 - 上线部署指南

📋 上线流程概览

注册账号 → 获取AppID → 配置项目 → 上传代码 → 提交审核 → 发布上线
   ↓          ↓           ↓          ↓          ↓          ↓
 30分钟      即时        5分钟      5分钟      1-7天      即时

🎯 第一步:注册小程序账号

1.1 前往微信公众平台注册

网址https://mp.weixin.qq.com/

注册步骤

  1. 点击"立即注册"
  2. 选择"小程序"类型
  3. 填写账号信息(邮箱、密码)
  4. 激活邮箱(点击邮件中的链接)
  5. 选择主体类型:
    • 个人:无需营业执照(推荐个人项目)
    • 企业:需要营业执照和对公账户

1.2 填写主体信息

个人类型需要

  • 管理员身份证信息
  • 管理员微信扫码认证(需要绑定银行卡)

企业类型需要

  • 营业执照
  • 对公账户信息
  • 管理员身份信息
  • 300元认证费(可选,认证后可开通支付等高级功能)

1.3 完成注册

注册成功后,你将获得:

  • AppID(重要!)
  • 小程序管理后台访问权限

🔑 第二步:获取并配置 AppID

2.1 获取 AppID

  1. 登录 微信公众平台
  2. 进入"开发" → "开发管理" → "开发设置"
  3. 找到 AppID(格式:wx1234567890abcdef
  4. 复制保存

2.2 配置项目 AppID

修改 project.config.json

{
  "appid": "wx1234567890abcdef",  // 替换为你的真实 AppID
  "projectname": "birthday-reminder"
}

2.3 添加开发者

如果有其他人协作开发:

  1. 进入小程序后台
  2. "管理" → "成员管理" → "项目成员"
  3. 添加开发者(需要对方微信号)
  4. 设置权限(开发者/体验者)

⚙️ 第三步:完善小程序信息

3.1 基本信息设置

进入"设置" → "基本设置"

  • 小程序名称:生日提醒(或自定义)
  • 小程序头像:上传一个图标(推荐 256x256 像素)
  • 小程序介绍
    一款轻量级的生日提醒工具,支持公历和农历生日,
    智能提醒让你不错过任何重要日子。
    
  • 服务类目
    • 工具 → 效率 → 备忘录/提醒
    • 或 生活服务 → 综合生活服务

3.2 隐私保护设置

进入"设置" → "隐私与安全设置"

  1. 用户隐私保护指引
本小程序会收集和使用以下信息:
1. 您添加的人员姓名、生日等信息
2. 所有数据仅存储在您的设备本地
3. 我们不会上传或分享您的任何数据

数据使用目的:
- 提供生日提醒服务
- 展示纪念日列表和日历

您的权利:
- 可随时删除数据
- 可导出备份数据
  1. 涉及的接口
    • 选择图片(上传头像)
    • 剪贴板(导入/导出数据)

📤 第四步:上传代码

4.1 准备上传

在微信开发者工具中:

  1. 点击工具栏的"上传"按钮
  2. 填写版本号和备注:
    版本号:1.0.0
    备注:首次发布,包含核心功能
    
  3. 点击"上传"

4.2 版本号规范

建议使用语义化版本:

  • 1.0.0:首次发布
  • 1.0.1:修复bug
  • 1.1.0:新增功能
  • 2.0.0:重大更新

4.3 上传成功

上传成功后,代码会出现在小程序后台的"开发管理" → "开发版本"中。


👥 第五步:体验测试

5.1 添加体验者

上传后先让其他人体验测试:

  1. 进入小程序后台
  2. "管理" → "成员管理" → "项目成员"
  3. 添加"体验者"(最多50个)
  4. 体验者扫码即可使用

5.2 体验版测试

  • 体验者可以完整测试所有功能
  • 发现问题及时修复
  • 重新上传新版本

🚀 第六步:提交审核

6.1 配置审核信息

进入"开发管理" → "版本管理" → "开发版本" → "提交审核"

填写信息

  1. 功能页面
页面类型:首页
页面功能:查看人员生日列表

页面类型:添加页面  
页面功能:添加人员信息和纪念日

页面类型:日历页面
页面功能:查看纪念日日历
  1. 可提供的测试账号
无需测试账号(或提供一个演示账号)
  1. 版本描述
生日提醒小程序首次发布版本,主要功能:
1. 添加和管理人员信息
2. 支持公历和农历生日
3. 多种纪念日类型(生日、结婚纪念日等)
4. 智能提醒功能
5. 日历视图展示
6. 数据导入导出

6.2 审核时长

  • 正常情况1-3个工作日
  • 节假日:可能延长至7天
  • 首次审核:可能会慢一些

6.3 审核要点

容易被拒的原因

  • 功能描述不清晰
  • 涉及未申请的类目
  • 缺少隐私政策
  • 测试账号无法登录
  • 页面空白或无内容

避免被拒

  • 填写清晰的功能描述
  • 选择正确的服务类目
  • 完善隐私保护指引
  • 确保所有功能正常
  • 添加测试数据供审核

第七步:发布上线

7.1 审核通过

收到审核通过通知后:

  1. 进入"开发管理" → "版本管理"
  2. 找到"审核通过"的版本
  3. 点击"发布"按钮
  4. 确认发布

7.2 发布后

  • ⏱️ 生效时间5-10分钟内全网生效
  • 🔍 搜索:用户可以在微信搜索到你的小程序
  • 📱 分享:可以分享给好友使用

7.3 获取小程序码

发布后可以生成小程序码:

  1. 进入"设置" → "基本设置" → "小程序码"
  2. 下载并分享给用户

📊 第八步:运营推广

8.1 数据监控

进入"统计" → "数据分析",查看:

  • 访问次数
  • 用户数量
  • 留存率
  • 使用时长

8.2 推广方式

  1. 朋友圈分享:生成小程序卡片
  2. 微信群分享:发送给感兴趣的群
  3. 公众号关联:如有公众号可关联推广
  4. 附近的小程序:设置门店位置

🔄 后续更新流程

9.1 版本更新

发现bug或要添加新功能:

  1. 修改代码
  2. 测试通过
  3. 上传新版本(版本号递增)
  4. 提交审核
  5. 审核通过后发布

9.2 紧急修复

如果发现严重bug

  1. 快速修复代码
  2. 使用"加急审核"(有次数限制)
  3. 通过后立即发布

💰 费用说明

个人类型(推荐)

  • 注册:免费
  • 认证:不需要(个人类型无需认证)
  • 上线:免费
  • 使用:免费

限制

  • 无法开通支付功能
  • 部分高级接口受限
  • 本项目的所有功能都不受影响

企业类型

  • 注册:免费
  • 💰 认证300元/年(可选)
  • 上线:免费

优势

  • 可开通微信支付
  • 可使用所有高级接口
  • 可关联公众号

📝 常见问题

Q1: 个人可以注册小程序吗?

A: 可以!个人注册完全免费,本项目的所有功能都支持。

Q2: 多久可以上线?

A:

  • 注册:30分钟
  • 配置:10分钟
  • 上传:5分钟
  • 审核:1-7天
  • 总计:最快1天,一般3-5天

Q3: 审核不通过怎么办?

A:

  1. 查看拒绝原因
  2. 根据要求修改
  3. 重新提交审核
  4. 审核次数不限

Q4: 小程序可以改名吗?

A:

  • 个人类型:一年可改2次
  • 企业已认证:一年可改2次
  • 需要在后台申请

Q5: 需要服务器吗?

A: 本项目不需要!所有数据存储在用户本地。

Q6: 可以商用吗?

A: 可以,建议使用企业类型注册。


🎯 快速检查清单

上线前检查:

  • 已注册小程序账号
  • 已获取并配置 AppID
  • 已完善小程序信息(名称、头像、介绍)
  • 已设置服务类目
  • 已配置隐私保护指引
  • 已在开发工具中测试通过
  • 已添加体验者测试
  • 代码已上传到小程序后台
  • 已准备审核资料(功能描述、截图)
  • 已提交审核

📞 需要帮助?

官方资源

关键联系方式

  • 小程序客服400-901-0500(工作日 9:00-18:00

🎉 恭喜!

按照本指南操作,你的小程序很快就能上线让全网用户使用了!

预计时间线

  • 今天:注册账号、配置信息、上传代码
  • 第2-3天:等待审核
  • 第3-5天:审核通过,正式上线

加油!🚀