MiniMax Client

基于 Next.js 16 的 MiniMax Web 客户端，支持：

• 文本对话
• 音乐生成（music-2.6）
• 歌词生成
• 本地历史记录

所有 MiniMax 请求均通过服务端代理，前端不直接暴露 API Key。

功能特性

• 对话、音乐、歌词三类能力统一入口
• 本地历史记录（新对话、查看历史、删除）
• 本地私有密钥目录（local-secrets/）便于配置与保护
• 一键健康检查（npm run doctor）

界面截图

首页 / 对话

音乐生成

歌词生成（参数区）

歌词生成（预览与历史）

设置页

技术栈

• Next.js 16
• React 19
• TypeScript
• Tailwind CSS

快速开始

1. 安装依赖

npm install

2. 初始化本地配置（自动创建密钥文件）

npm run setup

初始化后会生成：

• local-secrets/MINIMAX_API_KEY.txt
• .env.local（如果不存在）

3. 填写你的 MiniMax Key
   编辑 local-secrets/MINIMAX_API_KEY.txt，将第一行替换为真实 Key。
4. 导入并检查

npm run import-key
npm run doctor

5. 启动项目

npm run dev

打开 http://localhost:3000。

常用命令

npm run setup       # 初始化 .env.local + local-secrets 目录
npm run import-key  # 从 local-secrets/MINIMAX_API_KEY.txt 导入到 .env.local
npm run doctor      # 检查 MINIMAX_API_KEY 是否可用
npm run dev         # 启动开发环境
npm run lint        # 代码检查
npm run build       # 构建生产版本
npm run start       # 启动生产服务

目录结构

.
├─ src/
├─ scripts/
│  ├─ setup-env.mjs
│  ├─ import-key-txt.mjs
│  └─ doctor.mjs
├─ caogao/                      # 截图草稿目录
├─ local-secrets/               # 本地生成，已忽略提交
│  └─ MINIMAX_API_KEY.txt
├─ .env.example
└─ README.md

安全说明

• local-secrets/ 已在 .gitignore 中忽略
• .env.local 已忽略
• 请勿提交任何真实密钥
• 建议仅提交 .env.example 作为配置模板

常见问题

1) doctor 提示 Key 缺失

请先确认：

• local-secrets/MINIMAX_API_KEY.txt 第一行是有效 Key
• 已执行 npm run import-key

2) 音频时长显示异常

先检查生成接口返回的 status 与文件大小；若后端文件正常但前端显示异常，通常是前端解析或缓存问题，建议刷新后重试。

License

MIT