更新记录

1.0.0（2026-10-16） 下载此版本

1.0.0

• 首个版本发布：家庭任务打卡、星星激励、心愿兑换、成长统计、家庭成员管理
• 基于 uni-app（Vue3 + TypeScript）+ uniCloud（支付宝云空间）
• 含云对象后端（family-co / task-co / star-co / growth-co / feedback-co）与 DB Schema

平台兼容性

云端兼容性

uni-app x(5.26)

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

小星星家庭计划 · 插件使用说明

一款基于 uni-app（Vue3 + TypeScript） + uniCloud（支付宝云） 的家庭任务激励小程序模板：孩子完成任务攒星星，星星兑换心愿奖励，每一次努力都被记录。 本插件为标准 uni-app 项目（非 uni-app X），发布时请在「支持的 uni-app 版本」中勾选 uni-app。

一、功能清单

• 任务打卡（含撤销）、虚拟星星记账（收支事实来源 star-ledger）
• 心愿礼物屋：奖励列表、星星兑换、兑换二次确认与记录
• 成长统计：周报、月报、真实月历、星星账本
• 家庭成员管理：邀请码、转让、退出、解散、数据导出
• 三套主题：星星小熊 / 云朵小兔 / 森林小恐龙

二、环境要求

• HBuilderX 3.x（建议最新版，已支持 uni-app Vue3）
• 微信开发者工具（用于预览 / 调试 mp-weixin）
• 一个微信小程序 AppID（微信公众平台申请）
• 一个 uniCloud 服务空间（支付宝云，免费额度即可开发验证）
• Node.js（HBuilderX 自带，无需额外安装）

三、快速开始

1. 导入项目

HBuilderX → 文件 → 导入 → 从本地目录导入，选择本插件根目录（含 src 与 uniCloud-alipay 的 parent-stars 目录）。

2. 配置微信小程序 AppID

打开 src/manifest.json → 微信小程序配置，将 mp-weixin.appid 改为你自己的微信小程序 AppID。

默认值仅为作者占位，正式使用前请替换，否则无法在微信开发者工具中正常预览。

3. 开通并关联 uniCloud 空间（支付宝云）

1. HBuilderX 菜单：uniCloud → 打开云服务控制台 → 创建服务空间，选择支付宝云。
2. 在项目上右键 uniCloud-alipay 目录 → 关联云服务空间 → 选择刚创建的空间。
3. 在 uni-config-center 的 uni-id 配置中，填入你自己的微信小程序 appid 与 appsecret（用于登录与凭证，切勿提交到公开仓库）。

4. 上传云对象（务必勾选「上传依赖」）

在 uniCloud-alipay/cloudfunctions/ 下，逐个云对象右键 → 上传部署，并勾选「上传依赖」：

uni-config-center、uni-id-common 等公共模块会在勾选「上传依赖」时一并部署；如需单独部署，可右键对应公共模块 → 上传部署。

5. 上传数据库 Schema

在 uniCloud-alipay/database/ 下，右键全部 *.schema.json → 上传 DB Schema（共 8 个集合自动创建）。

6. 运行

HBuilderX → 运行 → 运行到小程序模拟器 → 微信开发者工具。首次进入按引导建家庭、加任务即可。

发布正式版前，记得将云对象分别上传到生产环境（uniCloud 云对象区分开发 / 生产环境，需分别上传验证）。

四、目录结构速览

parent-stars/
├─ src/                      # 前端（uni-app Vue3 + TS）
│  ├─ pages/                 # 页面：family / rewards / growth / mine 等
│  ├─ components/            # 公共组件（含 BottomNav 底部导航）
│  ├─ api/cloud.ts           # 云对象统一调用层（自动注入 token、归一化错误）
│  ├─ store/                 # 模块级 reactive 单例状态（无 Pinia）
│  └─ manifest.json
├─ uniCloud-alipay/          # 云端（支付宝云）
│  ├─ cloudfunctions/        # 云对象 *-co
│  └─ database/              # DB Schema（8 个集合）
└─ README.md

五、注意事项

• 非 uni-app X：本插件为标准 uni-app（Vue3 + TS）项目，请勿在 uni-app X 环境下导入。
• 配置替换：上线前请替换 manifest.json 中的微信 AppID，并在 uni-config-center 中配置自有 appid/appsecret 与 uniCloud 空间。
• 云端环境区分：开发验证用「开发环境」，正式发布请上传到「生产环境」并分别验证。
• 内容安全：当前版本 UGC（家庭名 / 昵称 / 任务名 / 反馈等）仅做长度与非空校验，微信 msgSecCheck 文本审核待接入；对外发布前建议补充，避免违规内容。

六、许可

仅供学习与非商业用途；商用请先取得作者授权。

七、小程序二维码说明

• 体验小程序码：扫描下方二维码可在微信中直接打开已发布的小程序，快速体验任务打卡、星星兑换、成长统计等全部功能。

  

• 生成你自己的小程序码：本插件为模板，上图的码指向作者已发布的小程序（仅用于体验）。当你按本文档部署到自己的微信小程序与 uniCloud 空间后，需从你自己的微信公众平台生成专属小程序码再对外分发：

  1. 登录微信公众平台 → 管理 → 小程序 → 小程序码 / 二维码；
  2. 选择启动页面路径（如首页 pages/family/family）与尺寸，生成并下载；
  3. 将下载的图片替换上图即可。