更新记录

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

本项目仅开源 uni-app 用户端，基于 Vue3，适配网页和微信公众号。用 HBuilderX 导入本目录即可运行，供学习研究。

平台兼容性

uni-app(3.8.7)

其他

码兄冥想用户端

开源说明

本项目仅开源 uni-app 用户端，基于 Vue3，适配网页和微信公众号。用 HBuilderX 导入本目录即可运行，供学习研究。

能在哪些地方使用

普通用户可以在电脑或手机的网页里使用，也可以在微信里打开网页使用。

底部有三个主入口：首页、探索、我的。

对接了哪些第三方

下面这些是用户日常能直接感受到的外部服务，不是技术名词堆砌：

• 微信支付：开通会员时可以走微信支付。在手机网页上，需在微信里打开，并用公众号相关账号，才能出现微信支付。
• 支付宝：同样用于开通会员。
• 钱包余额：平台自己的余额支付，钱不够会提示换微信支付或支付宝。余额主要来自邀请好友产生的收益。
• 手机短信验证码：登录、注册、找回密码时，会往手机号发验证码（由服务端发送）。
• 企业微信客服：后台若配好了，可跳到企业微信和客服聊天。
• 电话客服：可直接拨打后台配置的客服电话。
• 个人微信客服：可复制客服***，或扫客服二维码添加。
• 手机系统能力：播放冥想课程和助眠声音、到点弹出闹钟提醒、拨打电话、复制邀请码和***、从相册选头像。

说明：网页和公众号里用手机号登录。微信小程序里可以授权微信并获取手机号登录。

用户能做什么

打开软件先看到什么

• 顶部按时间问好，已登录会显示自己的名字。
• 有轮播广告。
• 有四个快捷入口：夜间睡眠、专注时钟、日间小憩、正念呼吸。
• 首页按分类展示冥想课程，能看到封面、名称和简介，点「更多」可看该分类下的全部课程。
• 下拉可刷新首页。
• 正在播放时，底部会有迷你播放器，可暂停、继续，点进去回到正在听的内容。
• 已登录可把邀请链接分享给好友。

听冥想课程

• 在首页或「探索」里点进课程详情。
• 能看到标签、课程名、简介、导师头像和介绍。
• 课程按章节列出，每节有时长。
• 点「开始练习」进入播放页，可暂停、继续、切换章节。
• 播放页可设置定时关闭，可选不停止、1 分钟、20 分钟、30 分钟，也可取消定时。
• 标记为收费的章节，未开通会员时会锁住，并提示去开通会员。
• 可点爱心加入「我的喜欢」，再点一次取消喜欢。
• 详情底部有相关推荐，可接着看别的课程。
• 课程和助眠声音不会同时播：开始听课程会停掉声音，开始播声音会停掉课程。

探索和搜索

• 「探索」按后台配置的分类、子分类浏览课程。
• 右上角可搜索课程名称。
• 点进搜索结果同样进入课程详情。

夜间睡眠

• 拨动时间，设定想醒来的时刻，页面会显示预计睡多久。
• 点「开始睡眠」后进入倒计时，到点弹出「休息时间到了」，可结束闹钟。
• 睡眠过程中可打开助眠音乐，切换不同声音。
• 也可中途点「结束睡眠」。

专注时钟

• 选择专注时长，可选 20、25、30 分钟。
• 点「开始专注」后倒计时，到点提醒休息，也可提前结束。
• 专注时可以搭配助眠或白噪音一类的声音。

日间小憩

• 选择小憩时长，可选 15、25、30 分钟。
• 点「开始小憩」后倒计时，到点叫醒，也可提前结束。
• 小憩时同样可以播放声音。

正念呼吸

• 先选练习时长，从 10 分钟到 40 分钟，每档相差 5 分钟。
• 呼吸模式有两种：平衡呼吸法（吸气、呼气）、4-7-8 呼吸法（吸气、憋气、呼气）。
• 开始后画面会跟着吸气、憋气、呼气变化，并显示这一轮还剩几秒、总共还剩多久。
• 练习时可以打开声音。

开通会员

• 「我的」里可看到是否已开通会员，以及到期日期。
• 会员中心展示会员特权和套餐价格。
• 支付方式按当前打开方式显示，可能是：微信支付、支付宝、余额。
• 付款前需同意《VIP 权益条款》和《用户协议》。
• 开通后，原先锁住的课程章节可以播放。

邀请朋友

• 邀请好友页可看自己的邀请码，点一下即可复制。
• 可看已邀请人数、累计收益、已提现金额，以及邀请规则。
• 注册时可以填邀请码；从分享链接进来也会带上邀请关系。
• 有推广资格时，「我的」里会出现「我的团队」，可看一级、二级好友和收益明细。

钱包

• 可看能提现的金额，填写金额后提现。
• 提现可选微信或支付宝。
• 可绑定支付宝姓名和账号，也可上传微信收款码。
• 可看钱包明细和提现记录。

账号和设置

• 手机号 + 密码登录。
• 手机号 + 短信验证码登录。
• 单独注册、忘记密码并重置。
• 登录前需同意用户服务协议、隐私政策。
• 个人资料可改头像、用户名、年龄、性别（手机号不能改）。
• 设置中心：修改密码、用户服务、VIP 权益条款、关于我们、隐私政策、注销协议、退出登录。
• 可申请注销账号，提交后按注销协议处理，通过后不能再登录。

数据和记录

• 「我的」顶部可看累计登录天数、累计冥想时长、我的喜欢个数。
• 今日数据可看今日冥想、今日睡眠、今日专注，也可切换看全部累计。
• 今日数据里还能看当月冥想、睡眠、专注各做了多少次。
• 我的喜欢按探索分类筛选已收藏的课程。
• 最近播放按日期回看听过的内容。

消息和客服

• 「我的」里有消息提醒，未读数量会提示。
• 消息页有在线客服和系统消息。
• 客服按后台配置，可能是：打电话、企业微信、或复制并。

体验

体验地址：https://mingxiang.xianmaxiong.com

技术栈

运行

这份代码已经接到线上体验环境，不用改任何配置，打开后直接运行即可。

开始前请准备

1. 一台 Windows 电脑（苹果电脑也可以，步骤差不多）。
2. 下载并安装 HBuilderX（官方用来打开这类项目的软件）：
   打开浏览器，搜索「HBuilderX 官网」，进入 https://www.dcloud.io/hbuilderx.html，下载「正式版」，安装后打开。
3. 建议再装一个 Chrome 浏览器，用来打开运行后的页面。

第一步：拿到文件夹

1. 如果你收到的是压缩包（例如 zip），先右键「解压到当前文件夹」或「解压到指定文件夹」。
2. 解压后，请找到名字叫 mingxiang-uniapp 的文件夹。里面应该能看到 pages.json、App.vue、common 等文件。
3. 记住这个文件夹在电脑上的位置，后面要选中它。不要只打开里面某一个文件。

第二步：用 HBuilderX 打开整个项目

1. 打开已经安装好的 HBuilderX。
2. 点左上角 「文件」→「打开目录」（有的版本也叫「从本地打开」）。
3. 选中刚才的 mingxiang-uniapp 文件夹，确定。
4. 左侧出现一长串文件名，就说明打开对了。如果左侧是空的，说明选错了文件夹，请重新选带 pages.json 的那一层。

第三步：用浏览器运行

1. 在 HBuilderX 顶部菜单点 「运行」→「运行到浏览器」→「Chrome」。
2. 第一次可能会提示安装浏览器运行插件，点允许或安装，等它装完再重新点一次运行。
3. 电脑会自动弹出一个网页。出现首页、底部「首页 / 探索 / 我的」，就说明运行成功了。
4. 不要关 HBuilderX，关了网页可能会断开。

常见情况说明

• 点了运行没反应：确认打开的是整个 mingxiang-uniapp 文件夹，不是只打开了一个页面文件。
• 浏览器打开了但是花屏、一直转圈：等十几秒；仍不行就关掉网页，在 HBuilderX 里再点一次运行。
• 页面是空的、提示加载失败：检查电脑能否打开体验地址 https://mingxiang.xianmaxiong.com ；如果这个网页本身打不开，用户端也会没数据。
• 点首页课程或四个练习入口，提示先登录：这些功能需要登录后才能进，点「我的」去登录即可。
• 声音没出来：先点课程里的「开始练习」，或在睡眠、专注、小憩、呼吸页里打开音乐；电脑需要开着声音。
• 微信支付、支付宝点了没反应：需要商家自己的支付账号，这份开源代码一般只能看到支付按钮，不能真的完成收款。
• 客服、短信验证码收不到：这些依赖服务端和第三方账号，界面可以点，功能不一定通。

第一次建议怎么验收

1. 按第三步在 Chrome 打开。
2. 能看到首页轮播、四个练习入口、底部三个按钮。
3. 点「我的」，能看到登录入口。
4. 再点「探索」，能进入课程分类页。
   做到这里，就说明「这份用户端代码已经在你电脑上跑起来了」。