From 7b30819c22d46dd8657e17bcb175dec64e357a72 Mon Sep 17 00:00:00 2001 From: song_kang_shuai Date: Mon, 11 May 2026 17:54:20 +0800 Subject: [PATCH] =?UTF-8?q?feat(skills):=20=E6=9B=B4=E6=96=B0=20mmx=20Skil?= =?UTF-8?q?l=EF=BC=8C=E5=9F=BA=E4=BA=8E=20--help=20=E9=AA=8C=E8=AF=81?= =?UTF-8?q?=E5=AE=8C=E6=95=B4=E5=91=BD=E4=BB=A4=E5=8F=82=E6=95=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- mmx/SKILL.md | 187 +++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 137 insertions(+), 50 deletions(-) diff --git a/mmx/SKILL.md b/mmx/SKILL.md index f7539c4..ff771b5 100644 --- a/mmx/SKILL.md +++ b/mmx/SKILL.md @@ -1,14 +1,12 @@ --- name: mmx -description: MiniMax CLI 工具，提供文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索等 AI 功能 +description: MiniMax CLI 工具，提供文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索、图像理解等 AI 功能 --- # MiniMax CLI 工具 (mmx) ## 安装与初始化 -如果用户未安装 `mmx`，需要引导用户完成安装和登录： - ### 1. 安装 mmx-cli ```bash @@ -17,11 +15,9 @@ npm install -g mmx-cli ### 2. 登录 API Key -使用你的 API Key 完成鉴权（用户可选择以下任一方式）： - **方式一：用户直接提供 Key** - 用户告诉我 API Key（如 `sk-xxxxx`） -- 我执行：`mmx auth login --api-key sk-xxxxx` +- 执行：`mmx auth login --api-key sk-xxxxx` **方式二：交互式登录** - 执行：`mmx auth login` @@ -35,13 +31,27 @@ mmx auth status --- -## 功能概述 +## 全局选项 -`mmx` 是 MiniMax 的命令行工具，支持文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索、图像理解等功能。 +| 选项 | 说明 | +|------|------| +| `--api-key ` | API 密钥 | +| `--region ` | 区域: global (默认), cn | +| `--base-url ` | API 基础 URL（覆盖 region） | +| `--output ` | 输出格式: text, json | +| `--quiet` | 静默模式，不显示非必要输出 | +| `--verbose` | 显示 HTTP 请求/响应详情 | +| `--timeout ` | 超时时间（默认 300） | +| `--no-color` | 禁用颜色 | +| `--dry-run` | 仅展示不执行 | +| `--non-interactive` | 非交互模式（CI/agent 模式必须添加） | +| `--version` | 显示版本 | +| `--help` | 显示帮助 | -## 常用命令 +--- + +## 1. 文本对话 (text chat) -### 1. 文本对话 (text chat) ```bash # 基本对话 mmx text chat --message "你好" @@ -49,39 +59,53 @@ mmx text chat --message "你好" # 带系统提示词 mmx text chat --system "你是一个专业的程序员" --message "写一个快速排序" -# 多轮对话 +# 多轮对话（重复 --message） mmx text chat --message "Hello" --message "How are you?" # 指定模型 -mmx text chat --model MiniMax-M2-7 --message "Hello" +mmx text chat --model MiniMax-M2.7-highspeed --message "Hello" # 输出 JSON 格式 mmx text chat --message "Hello" --output json + +# 最大 token 数 +mmx text chat --message "详细解释" --max-tokens 8192 ``` -### 2. 语音合成 (speech synthesize) +--- -**⚠️ 约束: 默认使用中文语音，中文优先于英文** +## 2. 语音合成 (speech synthesize) + +**⚠️ 注意: 默认语音是英文 `English_expressive_narrator`，中文必须指定语音！** ```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 synthesize --text "快速朗读" --speed 1.5 + +# 指定音频格式 +mmx speech synthesize --text "测试" --format wav --out test.wav + # 查看所有可用语音 mmx speech voices + +# 筛选特定语言语音 +mmx speech voices --language chinese ``` -**中文语音列表（中文 TTS 必须使用以下语音）:** -- `Chinese (Mandarin)_Warm_Girl` - 温暖女孩（默认） +**常用中文语音:** +- `Chinese (Mandarin)_Warm_Girl` - 温暖女孩 - `Chinese (Mandarin)_Sweet_Lady` - 甜蜜女士 - `Chinese (Mandarin)_Kind-hearted_Antie` - 善良阿姨 - `Chinese (Mandarin)_Gentle_Youth` - 温柔青年 @@ -91,10 +115,10 @@ mmx speech voices - `Chinese (Mandarin)_Humorous_Elder` - 幽默长辈 - `Chinese (Mandarin)_Lyrical_Voice` - 抒情嗓音 -**英文语音列表:** -- `English_expressive_narrator` - 英文旁白 +--- + +## 3. 图像生成 (image generate) -### 3. 图像生成 (image generate) ```bash # 基本图像生成 mmx image generate --prompt "一只可爱的猫" @@ -108,14 +132,23 @@ mmx image generate --prompt "Logo" --n 3 # 保存到文件 mmx image generate --prompt "山水画" --out /tmp/landscape.jpg -# 指定尺寸 (512-2048, 8的倍数) +# 指定尺寸 (512-2048, 必须是 8 的倍数) mmx image generate --prompt "宽图" --width 1920 --height 1080 # 使用提示词优化 mmx image generate --prompt "猫" --prompt-optimizer + +# 添加 AI 水印 +mmx image generate --prompt "山水画" --aigc-watermark + +# 使用种子保持一致输出 +mmx image generate --prompt "城堡" --seed 42 ``` -### 4. 图像理解 (vision describe) +--- + +## 4. 图像理解 (vision describe) + ```bash # 描述本地图片 mmx vision describe --image photo.jpg @@ -127,31 +160,75 @@ mmx vision describe --image https://example.com/photo.jpg mmx vision describe --image photo.jpg --prompt "这张图里有什么动物？" ``` -### 5. 视频生成 (video generate) +--- + +## 5. 视频生成 (video generate) + ```bash # 文本生成视频 (T2V) mmx video generate --prompt "一个人在海边跑步" -# 图片生成视频 (I2V) +# 图片生成视频 (I2V) - 使用 Hailuo-2.3 mmx video generate --prompt "风景动画" --first-frame image.jpg +# 快速模式 I2V +mmx video generate --prompt "动画效果" --first-frame image.jpg --model MiniMax-Hailuo-2.3-Fast + +# 首尾帧插值 (SEF) - 使用 Hailuo-02 +mmx video generate --prompt "行走动画" --first-frame start.jpg --last-frame end.jpg + +# 主体参考 (S2V) - 使用 S2V-01 +mmx video generate --prompt "侦探行走" --subject-image character.jpg + +# 异步模式（不等待，直接返回任务 ID） +mmx video generate --prompt "机器人绘画" --async --quiet + +# 下载到文件 +mmx video generate --prompt "海边日落" --download sunset.mp4 + # 查看任务状态 -mmx video task get +mmx video task get --task-id # 下载视频 -mmx video download +mmx video download --file-id --out video.mp4 ``` -### 6. 音乐生成 (music generate) +--- + +## 6. 音乐生成 (music generate) + +**⚠️ 必须提供: --lyrics 或 --lyrics-optimizer 或 --instrumental** + ```bash -# 生成音乐 -mmx music generate --prompt "轻松愉快的钢琴曲" +# 自动生成歌词（推荐方式） +mmx music generate --prompt "超燃的CS游戏主题曲" --lyrics-optimizer --out battle.mp3 -# 生成歌曲 -mmx music generate --prompt "一首关于爱情的流行歌曲" +# 提供自定义歌词 +mmx music generate --prompt "流行音乐" --lyrics "第一段歌词" --out song.mp3 + +# 纯音乐（无人声） +mmx music generate --prompt "史诗管弦乐" --instrumental --out bgm.mp3 + +# 指定风格参数 +mmx music generate --prompt "温暖的民谣" --vocals "温暖男声" --instruments "木吉他，钢琴" --bpm 95 --genre folk --out folk.mp3 + +# 指定音乐结构 +mmx music generate --prompt "摇滚" --structure "verse-chorus-verse-bridge-chorus" --out rock.mp3 + +# 使用参考曲目 +mmx music generate --prompt "类似甲壳虫乐队" --references "The Beatles" --lyrics-optimizer --out beatles.mp3 + +# 指定输出格式 +mmx music generate --prompt "电子乐" --format wav --sample-rate 44100 --out electronic.wav + +# 音乐封面生成 +mmx music cover --prompt "流行风格" --audio https://example.com/song.mp3 --out cover.mp3 ``` -### 7. 网页搜索 (search query) +--- + +## 7. 网页搜索 (search query) + ```bash # 基本搜索 mmx search query --q "MiniMax AI 最新消息" @@ -160,27 +237,37 @@ mmx search query --q "MiniMax AI 最新消息" mmx search query --q "天气" --output json ``` -## 全局选项 +--- -| 选项 | 说明 | -|------|------| -| `--api-key ` | API 密钥 | -| `--region ` | 区域: global (默认), cn | -| `--output ` | 输出格式: text, json | -| `--quiet` | 静默模式，不显示非必要输出 | -| `--verbose` | 显示 HTTP 请求/响应详情 | -| `--timeout ` | 超时时间 (默认 300) | -| `--no-color` | 禁用颜色 | -| `--non-interactive` | 非交互模式 (CI/agent 模式) | +## 8. 其他命令 -## 查看配额 ```bash -mmx auth status +# 查看配额 +mmx quota show + +# 更新 mmx +mmx update + +# 配置管理 +mmx config show +mmx config set --key region --value cn ``` +--- + ## 帮助命令 + ```bash -mmx --help # 全局帮助 -mmx --help # 资源帮助 -mmx text chat --help # 命令帮助 +mmx --help # 全局帮助 +mmx --help # 资源帮助（如 mmx music --help） +mmx text chat --help # 命令帮助 ``` + +--- + +## 重要提示 + +1. **CI/Agent 模式**: 务必添加 `--non-interactive` 标志 +2. **中文语音**: `speech synthesize` 默认是英文，必须通过 `--voice` 指定中文语音 +3. **音乐生成**: 必须使用 `--lyrics`、`--lyrics-optimizer` 或 `--instrumental` 之一 +4. **查看帮助**: 使用 `mmx --help` 查看最新命令选项