基于 MofAdmin 的 AI 创作与打谱系统，对接国内主流 AI 平台，支持 AI 识谱、AI打谱；内置 iDapu 模块，支持 AlphaTex 乐谱编辑与 AI 智能打谱、激活码授权等能力。
必有谱 AIGC 系统 是一套前后端分离的 Web 应用：
- 后端：基于 PHP 8.1+ 与 ThinkPHP 8，采用模块化设计，模块可热插拔。
- 管理端：Vue 3（非构建模式）+ Element Plus，用于系统配置、用户与权限、AI 通道、iDapu 乐谱与激活码等管理。
- 用户端：Vue 3 + Element Plus + TailwindCSS + Vite 构建，支持 PC 与移动端自适应；集成 AlphaTab 乐谱渲染、iDapu/AlphaTex 文本编辑与 AI 打谱。
系统在通用 AIGC 能力（AI识谱）之上，通过 iDapu 模块提供：
- 乐谱的创建、编辑、保存（iDapu 文本 / AlphaTex 文本）。
- 使用 AI 根据自然语言、歌词或和弦描述生成 AlphaTex 乐谱。
- 激活码的生成、发放与用户端激活，便于商业化或授权管理。
- 对接国内各大 AI 平台，支持多通道配置与切换。
- AI 识谱、打谱。
- 后台常用组件封装，以 PHP 为主即可完成管理界面开发，降低前端参与度、提升开发效率。
- 双输入模式：支持 iDapu 文本 与 AlphaTex 文本 编辑，并可由后台配置默认曲谱类型与默认内容。
- AlphaTab 渲染：用户端集成 AlphaTab，实时渲染六线谱/简谱/五线谱。
- AI 打谱：根据自然语言、歌词或和弦进行，由 AI 生成符合 AlphaTex 语法的乐谱文本，可直接渲染。
- 可配置提示词：后台可配置系统提示词、打谱语法说明与示例片段，以提升生成质量与格式一致性。
- 激活码管理：后台支持激活码的创建、批量生成、编辑、删除与授权操作。
- 用户端激活：用户登录后可查看「我的激活码」、使用激活码激活，与现有用户体系打通。
- 配置灵活：可配置激活码有效期、AI 打谱所用通道、打谱模式、默认曲谱等。
- 前后端分离，RESTful API，JWT 鉴权。
- 模块化与热插拔，便于扩展与二次开发。
- 用户端 WEB 自适应，一套代码兼顾 PC 与 Mobile。
| 类别 | 技术 |
|---|---|
| 后端 | PHP 8.1+、ThinkPHP 8、MofAdmin |
| 前端（管理端） | Vue 3、Element Plus（非构建模式） |
| 前端（用户端） | Vue 3、Element Plus、TailwindCSS、Vite、AlphaTab、KaTeX、Markdown-it |
| 数据与缓存 | MySQL 5.7+、Redis 5.0+ |
| 其他 | Composer、Nginx/Apache |
- PHP 8.1+
- MySQL 5.7+
- Redis 5.0+
- Nginx 或 Apache
- Composer 2.0+
- Node.js 与 npm（用于构建用户端）
PHP 扩展：redis、zip、iconv、fileinfo、json。
若使用宝塔等面板，请在 PHP 设置中解禁：putenv、proc_open。
# GitHub
git clone https://github.com/zaokework/biupu-pro.git
# 或 Gitee
git clone https://gitee.com/zaokework/biupu-pro.git
cd biupu-pro在项目根目录执行（国内建议使用 阿里云 或 腾讯云 Composer 镜像）：
composer install-
复制环境示例文件并重命名为
.env：cp .env.sample .env
-
编辑
.env，配置：- 数据库：
[DATABASE]下HOSTNAME、DATABASE、USERNAME、PASSWORD、HOSTPORT、prefix - JWT：
[JWT]下KEY（必填，用于登录与接口鉴权） - 若使用 Redis，请根据框架约定在应用配置中启用并填写 Redis 连接
- 数据库：
在项目根目录执行：
php think mof:install按提示完成安装并创建管理员账号。
- 将网站根目录指向项目的
public目录。 - 确保 Nginx/Apache 已配置好 PHP 与 URL 重写（ThinkPHP 单入口）。
管理端为 Vue 非构建模式，无需额外构建。
- 访问：
https://你的域名/admin/index.html - 使用安装时创建的管理员账号登录。
- 在后台可配置 AI 通道、iDapu 打谱与激活码等相关选项。
-
进入用户端目录并安装依赖：
cd front-end/web npm install -
复制前端环境文件并配置接口地址：
cp .env.development .env.production
编辑
.env.production，将VITE_API_URL改为你的后端域名，例如：VITE_API_URL=https://你的系统安装域名
-
构建：
npm run build
-
将
front-end/web/dist目录部署到你的 Web 服务器（可与后端同域或独立域名），通过浏览器访问即可使用用户端（含乐谱编辑与 AI 打谱）。
更详细的安装步骤、常见问题与目录结构说明见 安装文档。
biupu-pro/
├── app/ # 应用层
├── module/ # 业务模块（含 idapu、user、ai 等）
│ └── idapu/ # iDapu 乐谱与 AI 打谱、激活码
├── front-end/
│ └── web/ # 用户端 Vue 项目
├── public/ # Web 根目录
├── .env.sample # 环境变量示例
├── composer.json
└── README.md
- 软件架构：软件架构说明（总体架构、后端模块与路由、前端双端、数据流与模块依赖）
- 使用说明：用户与管理员使用说明（前端打谱/有谱/个人中心、后台功能与常见流程）
- 开发文档：待完善
- iDapu 认证与接口说明：见
module/idapu/docs/
感谢以下项目与资源：
本项目遵循 Apache-2.0 开源协议发布，可免费试用。
其中所包含的第三方源码与二进制文件的版权信息见各自标注。
Copyright © 2018-2026 MouferStudio (https://pu.biunow.cn)
All rights reserved.
如有疑问或建议，可通过 官网 或项目 Issues 联系。
