一、立项背景和目标。AI 生成音乐技术(以 Suno 为代表)让普通人无需乐理即可创作歌曲,但官方工具使用门槛高、缺乏中文社区与作品管理。蛙鸣音乐(wmMusic)定位为网易云风格的 AI 音乐创作与音乐社区平台,用户用一句话描述灵感即可生成完整歌曲,并可在社区内分享互动,目标是降低 AI 音乐创作门槛并沉淀原创音乐内容。
二、软件功能与核心模块。系统由跨平台客户端、运营后台、服务端组成。客户端含五大模块:1)AI 写歌:提供简单模式(一句话灵感自动写词谱曲)与自定义模式(指定歌名、风格、歌词),支持纯音乐、人声性别、音乐风格与情绪氛围选择,每次生成保留一首;2)音乐播放:完整播放列表、进度控制、后台播放、迷你播放器与 LRC 歌词同步;3)发现:搜索、分类浏览与热门推荐;4)社区:动态分享、评论、关注创作者、作者主页与作品集;5)我的:资料编辑、收藏、播放历史、我的作品及 mp3 下载。运营后台提供作品审核、分类、评论、用户、邀请码、系统设置与数据统计。
三、业务流程。用户登录后在 AI 写歌页选择模式并填写灵感,系统校验蛙币余额后向 Suno 提交生成任务并扣费;通过轮询与异步回调获取进度,服务端将音频、封面、歌词转存本站;生成完成后用户可试听、下载或提交审核,审核通过后在社区与发现页公开发布,其他用户可播放、评论与关注,形成创作 — 审核 — 传播闭环。
一、整体架构与设计思路。采用前后端分离、多端复用架构。客户端基于 UniApp 3.0 + Vue 3.4 + Vite + Sass,一套代码通过条件编译产出微信小程序、H5、Android/iOS 应用,采用主包加分包、预加载策略控制首屏体积;服务端基于 Spring Boot 3.4 + Java 21 + Spring Data JPA + MySQL + Spring Security + JWT,通过 RestTemplate 对接 Suno 开放接口,并接入平台统一钱包实现蛙币计费。
二、我的负责模块与成果。本人独立负责前后端架构与全部编码。前端完成 20 个页面、108 个源文件约 1.8 万行;后端完成 73 个 Java 文件约 6300 行、14 张数据表,合计约 2.44 万行。打通了 AI 生成、转存、计费、审核、社区互动、统计的完整链路,并实现配置脱敏以支持公开仓库协作。
三、难点与解决方案。1)多端兼容:小程序对音频域名有白名单限制且不支持 m3u8,服务端将 Suno 的音频、封面统一转存到本站并做失败重试,保证三端均可播放。2)异步任务编排:Suno 生成耗时较长,采用前端轮询加 Suno 回调双通道更新任务状态,并用本地缓存避免重复查询。3)LRC 歌词生成:优先调用官方时间轴接口将 alignedWords 转换为标准 LRC;无时间轴时按歌曲时长与每行字数加权估算,保证歌词与进度对齐。4)计费一致性:生成前校验余额、提交成功后才扣费,接入平台统一钱包与账户体系,避免重复扣费与余额不一致。5)下载与路径安全:仅允许本人下载已审核通过作品,做服务端路径归一化防目录穿越,下载异常时返回非 200 状态,避免客户端把错误信息存成音频。