更新记录

1.0.0（2026-06-09）下载此版本

平台兼容性

uni-app(5.12)

Vue2	Vue3	Chrome	Safari	app-vue	app-nvue	Android	iOS	鸿蒙
-	-	√	-	-	-	-	-	-

微信小程序	支付宝小程序	抖音小程序	百度小程序	快手小程序	京东小程序	鸿蒙元服务	QQ小程序	飞书小程序	小红书小程序	快应用-华为	快应用-联盟
-	-	-	-	-	-	-	-	-	-	-	-

uni-app x(5.12)

Chrome	Safari	Android	iOS	鸿蒙	微信小程序
√	-	-	-	-	-

壁纸收藏家 (Collector Wallpapers) 使用说明

本文档面向项目使用者、运营人员及开发者，涵盖项目介绍、功能说明、部署配置、日常使用及常见问题等内容。

一、项目简介

壁纸收藏家 是一款基于 uni-app + uniCloud 开发的跨平台壁纸分享与下载应用。采用深色主题与液态玻璃（Liquid Glass）设计风格，支持移动端（微信小程序、App）和 PC 端（H5、Web）访问。

主要特点

沉浸式浏览：首页全屏卡片式壁纸展示，抖音风格交互
多端适配：一套代码同时适配手机、小程序和 PC 大屏
社区互动：用户可发布动态、点赞、评论、关注
积分体系：下载消耗积分，通过签到、看广告、邀请好友获取积分
会员特权：VIP 会员享受 4K 超清下载及专属动态壁纸
管理后台：完善的内容管理、用户管理、数据统计功能

二、功能总览

2.1 用户端功能

模块	功能说明
首页	全屏卡片式壁纸浏览，支持点赞、评论、下载、分享
搜索	按关键词搜索壁纸，支持分类筛选
社区	发布动态、浏览推荐/关注/热门内容、点赞评论
我的	个人中心、收藏、下载记录、浏览历史、积分记录
会员	VIP 开通、会员权益展示
签到	每日签到领取积分奖励
邀请	邀请好友注册，双方获得积分奖励
反馈	提交意见反馈，查看管理员回复

2.2 管理端功能

模块	功能说明
仪表盘	数据概览、用户增长趋势、下载排行榜
壁纸管理	壁纸增删改查、上架/下架、分类绑定
分类管理	分类增删改查、启用/禁用、合并重复分类
用户管理	用户列表、搜索、封禁/解封、积分调整
反馈管理	查看用户反馈、回复、更新处理状态
轮播图	首页轮播图配置
公告管理	系统公告发布、编辑、置顶
系统设置	积分规则、广告配置、全局参数调整
操作日志	管理员操作记录审计

三、部署与配置

3.1 环境要求

HBuilderX 3.7.0 或更高版本
uni-app Vue 3 版本
uniCloud 阿里云版（需开通服务）

3.2 首次部署步骤

步骤 1：打开项目

使用 HBuilderX 打开项目目录 Collector Wallpapers。

步骤 2：关联云服务空间

右键项目根目录下的 uniCloud-aliyun 文件夹
选择 "关联云服务空间"
按提示创建或选择已有的阿里云 uniCloud 服务空间

步骤 3：上传云函数

依次右键以下云函数目录，选择 "上传部署"（上传并部署：云端安装依赖）：

uniCloud-aliyun/cloudfunctions/co-wallpaper
uniCloud-aliyun/cloudfunctions/co-user
uniCloud-aliyun/cloudfunctions/co-admin
uniCloud-aliyun/cloudfunctions/co-community
uniCloud-aliyun/cloudfunctions/uni-id-co
uniCloud-aliyun/cloudfunctions/ad-callback
uniCloud-aliyun/cloudfunctions/user-center
uniCloud-aliyun/cloudfunctions/uni-admin

步骤 4：初始化数据库

打开 uniCloud-aliyun/database 目录
右键以下初始化数据文件，选择 "上传部署"：
- app-config.init_data.json（系统配置）
- wallpaper-category.init_data.json（分类数据）
右键其他 .schema.json 文件，选择 "上传部署" 以创建数据表结构

步骤 5：配置微信小程序（可选）

如需使用微信登录，编辑 manifest.json：

"mp-weixin": {
    "appid": "你的微信小程序AppID",
    "setting": { "urlCheck": false },
    "usingComponents": true
}

步骤 6：配置 uni-id（可选）

编辑以下文件配置认证参数：

uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-id/config.json

关键配置项：

配置项	说明
`passwordSecret`	密码加密密钥（生产环境务必修改）
`tokenSecret`	Token 加密密钥（生产环境务必修改）
`mp-weixin.oauth.weixin.appid`	微信小程序 AppID
`mp-weixin.oauth.weixin.appsecret`	微信小程序 AppSecret

步骤 7：运行项目

点击 HBuilderX 工具栏的 "运行" 按钮，选择目标平台：

运行到浏览器：测试 H5/PC 端效果
运行到小程序模拟器：测试微信小程序
运行到手机：真机调试

3.3 创建管理员账号

首次部署后必须创建管理员账号，否则无法进入管理后台。

方法一：通过注册页面创建

在登录页点击 "注册管理员账号"
填写用户名、昵称、密码
提交后即可创建超级管理员（角色：admin）

方法二：通过数据库直接设置

打开 uniCloud 云数据库控制台
找到 uni-id-users 集合
将目标用户的 role 字段修改为 ["admin"]

注意：超级管理员只能创建一次。如果已存在，注册页面会提示"超级管理员已存在"。

四、日常使用指南

4.1 普通用户使用流程

注册/登录 → 浏览壁纸 → 点赞/收藏 → 下载壁纸（消耗积分）
    ↓
积分不足 → 每日签到 / 观看广告 / 邀请好友 → 获取积分
    ↓
开通 VIP → 享受 4K 下载 / 专属壁纸 / 免积分下载

4.2 社区使用

进入 "社区" 页面
点击右下角 "+" 按钮发布动态
可上传图片、输入文字内容
支持点赞、评论、收藏他人动态
在 "关注" 标签查看已关注用户的动态

4.3 积分获取方式

方式	奖励积分	限制
每日签到	随机 1-5 分	每日 1 次
观看广告	1 分/次	每日上限 20 次
邀请好友	10 分/人	无上限
新用户注册	3 分	一次性

4.4 下载壁纸

在首页或详情页点击 "下载" 按钮
普通用户消耗 1 积分/次
VIP 会员可免费下载（不消耗积分）
下载记录可在 "我的 → 下载记录" 中查看

五、管理后台操作手册

5.1 进入管理后台

使用管理员账号登录
在个人中心（"我的"页面）会出现 "管理后台" 入口
点击进入仪表盘

5.2 壁纸管理

上传壁纸：

进入 "壁纸管理" → 点击 "新增"
填写壁纸标题、选择分类
上传壁纸图片（支持多张）
设置标签、分辨率、是否 VIP 专属
点击 "保存"

上架/下架：

在壁纸列表中，点击开关即可控制上架状态
下架的壁纸用户端不可见

5.3 分类管理

进入 "分类管理"
可新增、编辑、删除分类
支持拖拽排序
合并重复分类：系统自动检测名称相似分类，一键合并

5.4 用户管理

进入 "用户管理"
支持按用户名、手机号搜索
可执行操作：
- 封禁/解封：禁止/恢复用户登录
- 调整积分：手动增加或减少用户积分
- 修改角色：设置/取消管理员权限

5.5 反馈管理

进入 "反馈管理"
查看用户提交的反馈列表
点击 "回复" 输入处理意见
更新处理状态（待处理 / 处理中 / 已解决）

5.6 系统设置

进入 "系统设置" 可调整以下参数：

参数	默认值	说明
每次看广告奖励积分	1	广告积分奖励
每次下载消耗积分	1	下载成本
每日广告上限	20	单用户每日广告次数
新用户初始积分	3	注册赠送积分
邀请好友奖励积分	10	邀请奖励

六、积分与会员系统

6.1 积分规则

积分用途：下载壁纸（每次消耗 1 积分）
积分获取：签到、广告、邀请、注册奖励
积分记录：所有变动可在 "我的 → 积分记录" 查看

6.2 VIP 会员

特权：

4K 超清壁纸免费下载
专属动态壁纸资源
下载不消耗积分
尊贵身份标识

开通方式：

进入 "会员中心"
选择套餐（月卡 / 季卡 / 年卡）
完成支付（需配置支付接口）

注意：支付功能需要额外配置微信支付/支付宝接口，当前框架已预留接口，需根据平台文档完善。

七、常见问题 (FAQ)

Q1：部署后首页没有壁纸数据？

A：需要在管理后台上传壁纸，或通过数据库导入壁纸数据。首次部署数据库为空，需手动添加内容。

Q2：用户无法登录/注册？

A：

检查 uni-id-co 云函数是否已正确上传部署
检查 uni-id 配置是否正确
查看云函数运行日志排查错误

Q3：看广告没有获得积分？

A：

检查 ad-callback 云函数是否已部署
检查广告位 ID 是否正确配置
确认用户未超过每日广告上限

Q4：PC 端显示异常？

A：本项目已做 PC 端适配，如仍有显示问题：

检查浏览器是否为最新版本
清除浏览器缓存后刷新
检查屏幕分辨率是否大于 768px

Q5：如何修改应用名称和 Logo？

A：

应用名称：修改 manifest.json 中的 name 字段
Logo：替换 static/logo.png 文件
登录页标题：修改各登录页面的 nav-title 文本

Q6：如何备份数据？

A：

登录 uniCloud 控制台
进入云数据库
选择需要备份的集合
点击 "导出" 按钮下载 JSON 文件

Q7：忘记管理员密码怎么办？

A：

在数据库中找到该管理员记录
使用 uniID.encryptPwd('新密码') 生成加密密码
更新数据库中的 password 字段

八、技术栈与目录结构

8.1 技术栈

层级	技术
前端框架	uni-app (Vue 3)
后端服务	uniCloud (阿里云)
数据库	uniCloud NoSQL 云数据库
认证服务	uni-id
样式方案	自定义 CSS + 液态玻璃效果

8.2 核心目录说明

Collector Wallpapers/
├── pages/                      # 用户端页面
│   ├── index/                  # 首页
│   ├── community/              # 社区
│   ├── my/                     # 个人中心
│   ├── search/                 # 搜索
│   ├── detail/                 # 壁纸详情
│   ├── admin/                  # 管理后台页面
│   └── ...
├── uni_modules/                # uni-app 官方模块
│   └── uni-id-pages/           # 登录注册相关页面
├── components/                 # 公共组件
│   └── tabbar/                 # 自定义底部导航
├── static/                     # 静态资源
├── uniCloud-aliyun/            # 云服务目录
│   ├── cloudfunctions/         # 云函数
│   │   ├── co-wallpaper/       # 壁纸相关接口
│   │   ├── co-user/            # 用户相关接口
│   │   ├── co-admin/           # 管理员接口
│   │   ├── co-community/       # 社区接口
│   │   └── uni-id-co/          # 认证服务
│   └── database/               # 数据库 schema 和初始化数据
├── manifest.json               # 应用配置
└── pages.json                  # 页面路由配置

8.3 数据库集合列表

集合名	用途
`wallpaper`	壁纸数据
`wallpaper-category`	分类数据
`uni-id-users`	用户基础信息
`user-extra`	用户扩展信息（积分、VIP等）
`points-log`	积分变动记录
`download-log`	下载记录
`browse-history`	浏览历史
`community-post`	社区帖子
`community-comment`	社区评论
`feedback`	用户反馈
`banner`	轮播图
`announcement`	公告
`notification`	消息通知
`app-config`	系统配置
`admin-log`	管理员操作日志

附录：联系方式与更新记录

版本信息

当前版本：v1.0.0
最后更新：2026-06-09
适配平台：微信小程序、H5、App

开发建议

开发环境：建议使用 HBuilderX 进行开发，可获得最佳的 uni-app 开发体验
调试技巧：使用浏览器开发者工具（F12）可方便调试 H5 端
真机测试：微信小程序建议使用微信开发者工具 + 真机预览
性能优化：图片建议使用 CDN 或云存储，减少包体积

本文档由项目代码分析生成，如有疑问或需要补充，请根据实际业务需求调整。

隐私、权限声明

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

误

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

暂无

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

暂无

许可协议

Apache License Version 2.0, January 2004 http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

Definitions.

"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.

"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:

(a) You must give any other recipients of the Work or Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.

You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

APPENDIX: How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "{}" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.

Copyright 2025 DCloud

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.