更新记录

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

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

平台兼容性

uni-app(3.8.7)

其他

宠物社交用户端

开源说明

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

能在哪些地方使用

养宠人可以在电脑或手机的网页里使用，也可以在微信里打开网页使用。想开店的人也可以在同一套用户端里申请商户入驻；审核通过后，再到商户端管理门店、服务和订单。

底部有五个主入口：首页、社区、档案、活动、我的。

对接了哪些第三方

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

• 腾讯地图：自动识别当前城市；选城市；填写收货地址或门店位置；看医院、服务商家的位置，并打开手机里的地图去导航。
• 微信支付：买宠物用品、约服务、开通会员、给钱包充值时，可以走微信支付。在手机网页上，需在微信里打开，并用公众号相关账号，才能出现微信支付。
• 支付宝：同样用于下单付款、充值和会员开通。
• 钱包余额：平台自己的余额支付，钱不够会提示换微信支付或支付宝。
• 手机短信验证码：登录、注册、找回密码、绑定手机号时，会往手机号发验证码（由服务端发送）。
• 微信快捷登录：在微信里可以走微信授权登录；若当前环境没有配好公众号，会改用手机号登录。
• 电话客服：可直接拨打后台配置的客服电话。
• 个人微信客服：可复制客服***，或扫客服二维码添加。
• 平台在线客服：登录后可在网页里和平台客服发消息。
• 人工智能养宠助手：智能工具箱里可以问诊、起名、翻译叫声、鉴定品种、检测心情，并结合宠物档案给出建议。
• 手机系统能力：获取定位、打开系统地图导航、拨打电话、复制订单号和***、从相册选头像、宠物照片和证件照片。

养宠人能做什么

打开软件先看到什么

• 自动定位当前城市，也可以自己换城市。
• 顶部能搜索宠物用品、服务、百科。
• 右上角可每日签到，签到后可获得积分。
• 有一排快捷入口（在线问诊、宠物寄养、预约医生、宠物洗澡、宠物托运、上门喂养、智能工具、养宠百科，具体以后台配置为准）。
• 有轮播广告，点进去可跳到对应内容。
• 首页展示养宠必修课、推荐服务和萌宠好物，能看到封面、名称、价格。
• 下拉可刷新首页。

逛社区、发动态

• 社区分成：关注、推荐、同城、精选、话题广场。
• 看宠友动态、图片和视频，可点赞、评论、关注作者，进入对方主页。
• 可按话题、圈子、同城查看内容。
• 登录后可发布图文或视频动态，选择话题和位置。
• 「我的」里可进创作中心，看作品、数据和创作任务。
• 消息里能看到赞和收藏、新增粉丝、评论和 @、系统通知。

给毛孩子建档案

• 添加宠物档案：名字、头像、品种、性别、生日等基本资料。
• 看体重趋势，记录成长点滴。
• 记驱虫、疫苗、体检报告，并看到下次提醒。
• 养宠记账，按分类看花费。
• 预约洗护、喂养等服务时，可以选择已有的宠物档案。

预约养宠服务

• 在线问诊：用 AI 智能医生描述症状，结合档案得到初步建议。
• 预约医生 / 宠物医院：看医院列表和医院详情、医生介绍，选时间预约，成功后可在订单里查看。
• 宠物寄养：选家庭寄养或门店寄养，填写宠物、时间和联系方式后下单。
• 宠物洗澡 / 洗护：选到店或上门，看套餐和商家，确认后预约。
• 上门喂养：选按次或按天，填写地址和时间。
• 宠物托运：选航空、陆运或专车，填写起点和终点。
• 服务订单状态大致包括：待接单、待确认、待到店、服务中、已完成、已取消。
• 可联系商家、联系客服、看地图导航。

买宠物用品

• 看商品列表、商品详情、规格、价格和全部评价。
• 可加入购物车，或立即购买。
• 下单时选收货地址，可新增、编辑、删除地址，也可设默认地址。
• 可先选一张优惠券再付款。
• 商家发货后可看物流公司和运单号，可复制单号、确认收货。
• 好物订单状态大致包括：待付款、待发货、待收货、待评价、售后/退款。

看课程和养宠百科

• 首页和课程列表里看养宠课，进入课程详情学习。
• 付费课程走下单支付，支付成功后在「我的课程」里继续看。
• 养宠百科可按主题看养护知识。

参加活动和领养

• 活动页有分类入口，常见的是：新人福利、限时秒杀、宠物赛事、公益领养（具体以后台配置为准）。
• 新人福利可领券、看首单权益。
• 限时秒杀可看倒计时和秒杀商品，再去下单。
• 宠物赛事可看赛程、报名或投票（按当期活动说明）。
• 领养大厅可看待领养宠物、宠物详情，填写资料申请领养，也可以自己发布领养信息。
• 「我的领养」里可看我发布的、我申请的和已领养记录。

智能工具

• 智能工具箱包含：AI 智能医生、萌宠起名、宠物翻译器、品种鉴定、心情检测。
• 登录后才能使用，部分工具会用到已填写的宠物档案。

付钱怎么付

• 下单后弹出支付窗口，可选：余额、微信支付、支付宝（按当前打开方式显示，不是每种环境都有微信支付）。
• 可先选一张优惠券再付款。
• 余额不够会提示换其他方式。
• 支付成功后订单生效；没付完可在订单里继续「去支付」。

优惠券、钱包和会员

• 领券中心领券，我的优惠券里查看已领的券。
• 钱包可充值（微信或支付宝）、提现、绑定提现账号、看资金明细和提现记录。
• 可看积分、积分明细，并用积分兑换礼品或优惠券。
• 每日签到可领积分。
• 可开通或续费超级会员，查看会员有效期。

邀请朋友赚钱

• 邀请好友、看邀请海报和邀请码、看我的团队、看收益明细。
• 登录、注册时可填邀请码；从分享链接进来也会带上邀请关系。
• 团队支持看一级、二级好友和对应收益。

账号和设置

• 手机号 + 短信验证码登录（没注册过会自动注册）。
• 手机号 + 密码登录。
• 单独注册、忘记密码并重置。
• 微信里可使用微信快捷登录。
• 登录前需同意用户协议、隐私政策。
• 个人中心改头像、昵称等基础资料。
• 设置里可看账号安全、修改密码、隐私设置、关于、协议，并退出登录。
• 可申请注销账号，提交后由平台审核，通过后不能再登录。

订单里还能做什么

• 「我的」里按状态看商品订单：全部、待付款、待发货、待收货、售后/退款。
• 服务预约、医院预约也可以在订单里分开查看。
• 可复制订单号、联系客服、联系商家、导航到店、确认收货。
• 待付款可继续支付。
• 完成后可写评价。

消息、客服、帮助

• 「我的」里有消息入口，未读数量会提示。
• 客服按后台配置，可能是：打电话、***，或平台在线聊天。
• 帮助中心看常见问题。
• 意见反馈可提交建议或投诉，并可填写联系方式。

商家能做什么

用户端里可以申请入驻，日常经营在审核通过后的商户端完成。

• 在「我的」里进入商户入驻，填写门店名称、***和门店位置。
• 选择经营服务：宠物洗护（到店或上门）、宠物寄养（家庭或门店）、宠物托运（航空、陆运或专车）、上门喂养（按次或按天）。
• 如果是宠物医院，需要额外上传医院资质。
• 按所选服务上传营业执照、门头照、身份证或运输资质。
• 同意《商户入驻协议》后提交，可查看审核中、已通过、已驳回。
• 驳回后可修改资料重新提交。
• 审核通过后，使用***登录商户端，管理服务、商品和订单。

体验

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

技术栈

运行

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

开始前请准备

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

第一步：拿到文件夹

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

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

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

第三步：用浏览器运行

1. 在 HBuilderX 顶部菜单点 「运行」→「运行到浏览器」→「Chrome」。
2. 第一次可能会提示安装浏览器运行插件，点允许或安装，等它装完再重新点一次运行。
3. 电脑会自动弹出一个网页。出现首页、底部「首页 / 社区 / 档案 / 活动 / 我的」，就说明运行成功了。
4. 如果浏览器问能不能获取位置，点「允许」，首页才能显示当前城市。
5. 不要关 HBuilderX，关了网页可能会断开。

常见情况说明

• 点了运行没反应：确认打开的是整个项目文件夹，不是只打开了一个页面文件。
• 浏览器打开了但是花屏、一直转圈：等十几秒；仍不行就关掉网页，在 HBuilderX 里再点一次运行。
• 页面是空的、提示加载失败：检查电脑能否打开体验地址 https://cwsjyh.xianmaxiong.com ；如果这个网页本身打不开，用户端也会没数据。
• 地图不显示或定位失败：需要腾讯地图的钥匙（项目里已预填，有过期或额度用完的可能）。学习看页面时可以先忽略地图。
• 微信支付、支付宝点了没反应：需要商家自己的支付账号，这份开源代码一般只能看到支付按钮，不能真的完成收款。
• 客服、短信验证码收不到：这些依赖服务端和第三方账号，界面可以点，功能不一定通。

第一次建议怎么验收

1. 按第三步在 Chrome 打开。
2. 能看到首页轮播、底部五个按钮。
3. 点「社区」，能看到动态列表。
4. 点「我的」，能看到登录入口。
5. 再点「活动」，能进入活动页。
   做到这里，就说明「这份用户端代码已经在你电脑上跑起来了」。