更新记录

1.2.1（2026-01-12）

1.2.1 (2026-01-12)

平台兼容性

云端兼容性

阿里云 腾讯云 支付宝云
× × √

云函数类插件通用教程

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

账易记 - 个人记账小程序 使用说明

📱 扫码预览

账易记小程序码

微信扫码体验「账易记」小程序

🖼️ 页面截图

首页 发布页面 统计页面 搜索页面 个人中心

首页 | 发布页面 | 统计页面 | 搜索页面 | 个人中心

📖 插件简介

账易记是一款基于 uni-app + uniCloud 开发的个人记账小程序，功能完善、界面美观、开箱即用。适合个人学习 uni-app 云开发，也可直接用于商业项目二次开发。

✨ 功能特点

功能 说明
📝 收支记录 快速记录日常收支，支持分类、标签、备注、图片
📊 统计分析 多维度统计报表（日/周/月/年），直观了解财务状况
📚 多账本管理 支持创建多个账本，分类管理不同场景
🏷️ 自定义标签 灵活的标签系统，个性化账单管理
📋 账单模板 常用账单一键记录，提升记账效率
🔍 智能搜索 支持关键词、金额范围、日期、标签等多条件筛选
👤 用户系统 微信一键登录，数据云端同步
💬 意见反馈 内置反馈功能，收集用户建议
🔧 GM后台 管理员数据统计和用户分析

🛠️ 技术栈

  • 前端框架: uni-app (Vue 3)
  • UI 组件: uni-ui
  • 后端服务: uniCloud (阿里云)
  • 数据库: uniCloud 云数据库
  • 云存储: uniCloud 云存储
  • 图表库: uCharts

📱 支持平台

  • ✅ 微信小程序
  • ✅ 支付宝小程序
  • ✅ H5
  • ✅ App

🚀 快速开始

环境要求

  • HBuilderX >= 3.0
  • Node.js >= 14
  • 微信开发者工具（如需微信小程序）

安装步骤

1. 导入项目

在 HBuilderX 中导入下载的项目

2. 安装依赖

npm install

3. 关联云服务空间

  1. 在 HBuilderX 中右键 uniCloud-alipay 目录
  2. 选择「关联云服务空间」
  3. 选择或创建一个阿里云服务空间

4. 上传云函数

  1. 右键 uniCloud-alipay/cloudfunctions/mainfun → 上传部署
  2. 右键 uniCloud-alipay/cloudfunctions/common → 上传所有公共模块

5. 初始化数据库

  1. 右键 uniCloud-alipay/database 目录下的 .schema.json 文件
  2. 选择「上传 DB Schema」

6. 运行项目

HBuilderX 中点击：运行 → 运行到小程序模拟器 → 微信开发者工具

⚙️ 配置说明（重要！）

购买插件后，您必须修改以下配置文件：

1. manifest.json

添加您的小程序 AppID：

{
  "appid": "__UNI__XXXXXXX",        // 您的 DCloud AppID（可在 DCloud 开发者中心获取）
  "mp-weixin": {
    "appid": "wxXXXXXXXXXXXXXXXX"   // 您的微信小程序 AppID
  }
}

2. 云函数配置

uniCloud-alipay/cloudfunctions/mainfun/utils/config.js

WXCONFIG: {
  APPID: "wxXXXXXXXXXXXXXXXX",      // 您的微信小程序 AppID
  APPSECRET: "XXXXXXXXXXXXXXXX"     // 您的微信小程序 AppSecret（在微信公众平台获取）
}

uniCloud-alipay/cloudfunctions/mainfun/utils/jwt.js

const JWT_SECRET = 'your-random-secret-key-32-chars'  // 替换为随机字符串（建议32位以上）

💡 生成随机密钥：可在终端执行 openssl rand -hex 32

uniCloud-alipay/cloudfunctions/mainfun/modules/growth/config.js

如果使用 growth（成长记录）模块，请配置：

case 'mp-weixin':
  return {
    appid: 'wxXXXXXXXXXXXXXXXX',    // 您的微信小程序 AppID
    secret: 'XXXXXXXXXXXXXXXX'      // 您的微信小程序 AppSecret
  }

3. 前端配置

common/config.js

// CDN 配置
export const CLOUD_CDN = {
  DOMAIN: 'https://your-env.normal.cloudstatic.cn',  // 您的云存储 CDN 域名
  CLOUDID: 'cloud://your-env-id'                     // 您的云存储环境 ID
}

// 广告配置（可选，如不使用广告可保持默认）
export const AD_CONFIG = {
  SKIP_AD_IN_DEV: true,                              // 开发环境跳过广告
  REWARDED_VIDEO_AD_UNIT_ID: 'adunit-xxxxxxxx',      // 激励视频广告 ID
  INTERSTITIAL_AD_UNIT_ID: 'adunit-xxxxxxxx'         // 插屏广告 ID
}

💡 CDN 域名获取：uniCloud 控制台 → 云存储 → 查看域名

4. 配置完成后

  1. 重新上传云函数：右键 mainfun → 上传部署
  2. 运行测试：确保登录、记账等功能正常

📁 项目结构

bookkeeping-unicloud/
├── api/                        # API 接口封装
│   ├── bill.js                 # 账单相关 API
│   ├── book.js                 # 账本相关 API
│   ├── category.js             # 分类相关 API
│   ├── user.js                 # 用户相关 API
│   └── ...
├── common/                     # 公共模块
│   ├── config.js               # 全局配置 ⚠️ 需修改
│   ├── request.js              # 请求封装
│   ├── controller/             # 控制器层
│   ├── manager/                # 业务逻辑层
│   └── utils/                  # 工具函数
├── components/                 # 公共组件
│   ├── bill-list/              # 账单列表
│   ├── number-keyboard/        # 数字键盘
│   ├── category-grid/          # 分类选择
│   ├── tag-manager/            # 标签管理
│   └── ...
├── pages/                      # 页面
│   ├── index/                  # 首页、记账、详情
│   ├── statistics/             # 统计分析
│   ├── profile/                # 个人中心
│   ├── book/                   # 账本管理
│   ├── category/               # 分类管理
│   ├── search/                 # 搜索
│   └── ...
├── uniCloud-alipay/            # 云函数目录
│   ├── cloudfunctions/
│   │   └── mainfun/            # 主云函数
│   │       ├── index.js        # 入口文件
│   │       ├── utils/          # 工具函数 ⚠️ 需修改配置
│   │       └── modules/        # 功能模块
│   │           └── bookkeep/
│   │               ├── user/   # 用户模块
│   │               ├── bill/   # 账单模块
│   │               ├── book/   # 账本模块
│   │               └── ...
│   └── database/               # 数据库 Schema
├── manifest.json               # 应用配置 ⚠️ 需修改
├── pages.json                  # 页面配置
└── package.json                # 项目依赖

🗄️ 数据库说明

表名 说明 主要字段
bookkeep_user 用户信息表 openid, nickName, avatarUrl, tags, templates
bookkeep_bills 账单记录表 userId, bookId, type, amount, category, date
bookkeep_setting 应用配置表 key, value, description
bookkeep_feedbacks 用户反馈表 userId, content, contact, status

❓ 常见问题

Q1: 登录失败，提示 "获取用户信息失败"

解决方案：

  1. 检查 utils/config.js 中的微信 AppID 和 AppSecret 是否正确
  2. 确保云函数已重新上传部署
  3. 检查微信小程序后台是否配置了服务器域名

Q2: 云函数调用失败

解决方案：

  1. 确保已关联云服务空间
  2. 云函数和公共模块都已上传
  3. 检查 uniCloud 控制台的云函数日志

Q3: 图片上传失败

解决方案：

  1. 检查 common/config.js 中的 CDN 配置
  2. 确保云存储已开通并获取正确的域名

Q4: 如何关闭广告功能？

在 common/config.js 中设置：

AD_CONFIG: {
  SKIP_AD_IN_DEV: true,  // 改为 true 跳过广告
}

📞 技术支持

如有问题，请通过以下方式联系：

  • 📧 邮箱：1119545729@qq.com

📄 版权说明

  • 本插件为付费插件，购买后可用于个人或商业项目
  • 禁止二次销售或免费分发
  • 购买即表示同意 DCloud 插件市场购买协议

感谢您的支持！祝使用愉快！ 🎉

隐私、权限声明

1. 本插件需要申请的系统权限列表：

- 网络访问权限：用于与 uniCloud 云服务通信，实现数据同步 - 相机权限：用于账单添加图片附件时拍照（可选功能） - 相册/存储权限：用于账单添加图片附件时选择本地图片（可选功能） - 用户信息权限：用于微信登录获取用户头像和昵称（微信小程序）

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

采集的数据： - 用户基本信息：微信 openid、昵称、头像（用于用户身份识别和个人中心展示） - 账单数据：收支金额、分类、日期、备注、标签、图片（用于记账核心功能） - 账本数据：账本名称、图标、排序（用于多账本管理功能） - 用户自定义数据：自定义标签、账单模板（用于个性化记账功能） - 反馈数据：用户提交的意见反馈内容（用于产品改进） 服务器地址： - uniCloud 阿里云服务器（由用户自行配置的 uniCloud 服务空间） - 微信开放平台接口 api.weixin.qq.com（用于微信登录验证） 数据用途： - 所有数据仅用于实现记账功能，存储在用户自己配置的 uniCloud 服务空间 - 不会将用户数据分享给任何第三方 - 不会用于用户画像、广告推送等商业用途

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

是，本插件包含可选的广告功能： 广告类型： - 激励视频广告：用户主动点击观看后可解锁高级功能或获得奖励 - 插屏广告：在特定页面切换时展示（可配置关闭） 展示频率： - 激励视频：仅在用户主动点击时展示，非强制 - 插屏广告：默认关闭，需用户自行配置开启 广告平台： - 微信小程序流量主广告（需用户自行申请广告位 ID） 关闭方式： - 在 common/config.js 中设置 SKIP_AD_IN_DEV: true 可完全关闭广告功能 - 不配置广告 ID 则广告功能自动失效 注：广告功能为可选模块，购买者可根据需要自行决定是否启用。

评论列表 撰写评论 向官方投诉

暂无用户评论。