feat(skills): 添加 mmx MiniMax CLI Skill

2026-05-11 12:33:54 +08:00
parent 608ff45349
commit 023bdc806f
1 changed files with 160 additions and 0 deletions
@@ -0,0 +1,160 @@
+---
+name: mmx
+description: MiniMax CLI 工具，提供文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索等 AI 功能
+---
+
+# MiniMax CLI 工具 (mmx)
+
+## 功能概述
+
+`mmx` 是 MiniMax 的命令行工具，支持文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索、图像理解等功能。
+
+## 安装状态
+- 已安装于: `/home/xiaoshuai/.nvm/versions/node/v20.20.2/bin/mmx`
+- 认证状态: 已通过 API Key 认证
+
+## 常用命令
+
+### 1. 文本对话 (text chat)
+```bash
+# 基本对话
+mmx text chat --message "你好"
+
+# 带系统提示词
+mmx text chat --system "你是一个专业的程序员" --message "写一个快速排序"
+
+# 多轮对话
+mmx text chat --message "Hello" --message "How are you?"
+
+# 指定模型
+mmx text chat --model MiniMax-M2-7 --message "Hello"
+
+# 输出 JSON 格式
+mmx text chat --message "Hello" --output json
+```
+
+### 2. 语音合成 (speech synthesize)
+
+**⚠️ 约束: 默认使用中文语音，中文优先于英文**
+
+```bash
+# 基本语音合成（默认使用中文语音 Chinese (Mandarin)_Warm_Girl）
+mmx speech synthesize --text "你好，世界"
+
+# 保存到文件
+mmx speech synthesize --text "你好" --out hello.mp3
+
+# 指定中文语音
+mmx speech synthesize --text "你好" --voice "Chinese (Mandarin)_Warm_Girl"
+
+# 指定英文语音（需要明确指定）
+mmx speech synthesize --text "Hello" --voice English_expressive_narrator
+
+# 查看所有可用语音
+mmx speech voices
+```
+
+**中文语音列表（中文 TTS 必须使用以下语音）:**
+- `Chinese (Mandarin)_Warm_Girl` - 温暖女孩（默认）
+- `Chinese (Mandarin)_Sweet_Lady` - 甜蜜女士
+- `Chinese (Mandarin)_Kind-hearted_Antie` - 善良阿姨
+- `Chinese (Mandarin)_Gentle_Youth` - 温柔青年
+- `Chinese (Mandarin)_Gentleman` - 绅士
+- `Chinese (Mandarin)_Reliable_Executive` - 可靠主管
+- `Chinese (Mandarin)_News_Anchor` - 新闻主播
+- `Chinese (Mandarin)_Humorous_Elder` - 幽默长辈
+- `Chinese (Mandarin)_Lyrical_Voice` - 抒情嗓音
+
+**英文语音列表:**
+- `English_expressive_narrator` - 英文旁白
+
+### 3. 图像生成 (image generate)
+```bash
+# 基本图像生成
+mmx image generate --prompt "一只可爱的猫"
+
+# 指定宽高比
+mmx image generate --prompt "风景画" --aspect-ratio 16:9
+
+# 生成多张
+mmx image generate --prompt "Logo" --n 3
+
+# 保存到文件
+mmx image generate --prompt "山水画" --out /tmp/landscape.jpg
+
+# 指定尺寸 (512-2048, 8的倍数)
+mmx image generate --prompt "宽图" --width 1920 --height 1080
+
+# 使用提示词优化
+mmx image generate --prompt "猫" --prompt-optimizer
+```
+
+### 4. 图像理解 (vision describe)
+```bash
+# 描述本地图片
+mmx vision describe --image photo.jpg
+
+# 描述网络图片
+mmx vision describe --image https://example.com/photo.jpg
+
+# 自定义问题
+mmx vision describe --image photo.jpg --prompt "这张图里有什么动物？"
+```
+
+### 5. 视频生成 (video generate)
+```bash
+# 文本生成视频 (T2V)
+mmx video generate --prompt "一个人在海边跑步"
+
+# 图片生成视频 (I2V)
+mmx video generate --prompt "风景动画" --first-frame image.jpg
+
+# 查看任务状态
+mmx video task get <task_id>
+
+# 下载视频
+mmx video download <file_id>
+```
+
+### 6. 音乐生成 (music generate)
+```bash
+# 生成音乐
+mmx music generate --prompt "轻松愉快的钢琴曲"
+
+# 生成歌曲
+mmx music generate --prompt "一首关于爱情的流行歌曲"
+```
+
+### 7. 网页搜索 (search query)
+```bash
+# 基本搜索
+mmx search query --q "MiniMax AI 最新消息"
+
+# JSON 输出
+mmx search query --q "天气" --output json
+```
+
+## 全局选项
+
+| 选项 | 说明 |
+|------|------|
+| `--api-key <key>` | API 密钥 |
+| `--region <region>` | 区域: global (默认), cn |
+| `--output <format>` | 输出格式: text, json |
+| `--quiet` | 静默模式，不显示非必要输出 |
+| `--verbose` | 显示 HTTP 请求/响应详情 |
+| `--timeout <seconds>` | 超时时间 (默认 300) |
+| `--no-color` | 禁用颜色 |
+| `--non-interactive` | 非交互模式 (CI/agent 模式) |
+
+## 查看配额
+```bash
+mmx auth status
+```
+
+## 帮助命令
+```bash
+mmx --help           # 全局帮助
+mmx <resource> --help # 资源帮助
+mmx text chat --help  # 命令帮助
+```