feat(skills): 更新 mmx Skill，基于 --help 验证完整命令参数

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 <key>` | API 密钥 |
+| `--region <region>` | 区域: global (默认), cn |
+| `--base-url <url>` | API 基础 URL（覆盖 region） |
+| `--output <format>` | 输出格式: text, json |
+| `--quiet` | 静默模式，不显示非必要输出 |
+| `--verbose` | 显示 HTTP 请求/响应详情 |
+| `--timeout <seconds>` | 超时时间（默认 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 <task_id>
+mmx video task get --task-id <task_id>
 
 # 下载视频
-mmx video download <file_id>
+mmx video download --file-id <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
 ```
 
-## 全局选项
+---
 
-| 选项 | 说明 |
+## 8. 其他命令
-|------|------|
-| `--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
+# 查看配额
+mmx quota show
+
+# 更新 mmx
+mmx update
+
+# 配置管理
+mmx config show
+mmx config set --key region --value cn
 ```
 
+---
+
 ## 帮助命令
+
 ```bash
-mmx --help           # 全局帮助
+mmx --help              # 全局帮助
-mmx <resource> --help # 资源帮助
+mmx <resource> --help    # 资源帮助（如 mmx music --help）
-mmx text chat --help  # 命令帮助
+mmx text chat --help     # 命令帮助
 ```
+
+---
+
+## 重要提示
+
+1. **CI/Agent 模式**: 务必添加 `--non-interactive` 标志
+2. **中文语音**: `speech synthesize` 默认是英文，必须通过 `--voice` 指定中文语音
+3. **音乐生成**: 必须使用 `--lyrics`、`--lyrics-optimizer` 或 `--instrumental` 之一
+4. **查看帮助**: 使用 `mmx <command> --help` 查看最新命令选项