MiniMax CLI v1.0.14:设备码登录、多轮 REPL、文件存储与代理支持,一条命令链路补齐
一句话结论
MiniMax 官方 CLI 在 v1.0.13 和 v1.0.14 两个版本(2026 年 5 月发布)里补齐了一批此前只能靠平台控制台或裸 API 完成的能力:OAuth 设备码登录流程命令化并直写配置文件、交互式多轮对话终端 mmx text repl、文件上传/列表/删除三命令、全局 HTTP/HTTPS 代理支持,以及 SDK 能力从 CLI 内部拆成独立可引用的模块文档。对在终端和脚本里跑 AI 生成流程的用户,这两版把「登录—对话—文件—网络环境」四个环节的断点全部接上了。本站此前介绍过这个 CLI 的七类核心命令与 v1.0.21 的语音与视频增量,本文聚焦 v1.0.13–v1.0.14 这一窗口的功能补齐。
OAuth 设备码登录:从浏览器跳转到终端闭环
v1.0.14 的 PR #139 把 OAuth 设备授权流程(RFC 8628)做成了登录菜单的正式选项。过去用 API Key 登录要手动复制粘贴,现在 mmx auth login 会给出三选项菜单:全球站 OAuth、中国站 OAuth、API Key。选 OAuth 后 CLI 走设备码流程,浏览器完成授权,令牌直接写入 config.json,后续命令自动刷新。
命令行参数也做了免交互优化:mmx auth login --recommend 跳过菜单直接进 OAuth,配合 --region=global 或 --region=cn 连区域选择也一并跳过——这两条参数组合是脚本化部署场景(CI/CD、容器启动)的关键入口。官方 README 同步更新了登录流程说明,登录成功后显示完整面板而非残缺标签。
mmx text repl:多轮对话终端
PR #141 加入的 mmx text repl 是这个窗口里体感变化最大的功能。此前 mmx text chat 是单轮命令:一条消息一次响应,会话不保留。REPL 模式进入交互式终端后,对话历史、系统提示词、模型选择都在会话内管理。
源码显示 REPL 实现了完整的斜杠命令集:/save 把对话导出为 JSON 文件(可挂进后续脚本处理)、/system 设置系统提示词、/model 切换模型、/clear 清空历史但保留系统提示词、/history 查看全部消息预览。配套的行编辑器支持历史上下翻(方向键)、光标移动,原始思考输出替换为彩色循环动画指示——等待模型响应时终端不再刷屏未解析的思考文本。
对写自动化脚本的智能体,/save 导出的 JSON 对话文件可以直接作为下游输入,把「终端里人工调提示词 → 导出对话 → 脚本批量重放」这条链路打通了。
文件存储三命令与 SDK 文件模块
v1.0.14 的 PR #143 加入 FileSDK 模块和对应的 mmx file 命令族:
| 命令 | 功能 | 典型用法 |
|---|---|---|
mmx file upload | 上传文件到 MiniMax 存储 | mmx file upload --file doc.pdf |
mmx file list | 列出已上传文件 | mmx file list |
mmx file delete | 删除存储文件 | mmx file delete --file-id <id> |
--purpose 参数区分文件用途(默认 retrieval,可设 vision),上传完成后返回的 file_id 可以直接在图像理解等命令里引用。v1.0.13 同窗口的 PR #124 补了「下载失败时保留已下载文件」的保护,配合 v1.0.14 的 PR #145/#147 给 ImageSDK 和 SpeechSDK/MusicSDK 加的文件保存支持,生成结果落盘链路完整了。
全局代理:一次配置全网生效
v1.0.13 的 PR #126 用 undici 的 ProxyAgent 加 setGlobalDispatcher 实现全局代理,所有 fetch 请求自动走代理,调用点零改动。配置方式两种:
第一种是环境变量,优先级从高到低为 HTTPS_PROXY > HTTP_PROXY > ALL_PROXY;第二种是配置文件,mmx config set --key proxy --value http://HOST:PORT 写入后持久生效。官方在 PR 说明里给出了验收方式:HTTPS_PROXY=http://127.0.0.1:7890 mmx quota show 验证流量确实经过代理。网络错误提示也同步改进,报错会明确指向代理配置而非误导性的「检查代理设置」。
SDK 独立文档:从 CLI 内嵌到可直接引用
v1.0.13 的 PR #122 把 SDK 能力正式独立成 SDK.md 文档。开发者现在可以 npm install mmx-cli 后直接 import { MiniMaxSDK } from 'mmx-cli/sdk',用 TypeScript 调用文本、图像、视频、语音、视觉理解、搜索、配额七个模块,不必经过命令行封装。
Quick Start 之外,SDK.md 给出了每个模块的完整代码示例:文本支持流式响应(stream: true 后 for await 逐事件消费)、视频区分同步等待与异步任务(async: true 立即返回 taskId,getTask 轮询)、语音合成返回 base64 音频可直接写文件。配额模块还提供了 isQuotaResponse / isAccountBalanceResponse 两个类型守卫,区分 Token Plan 凭证与按量 API 密钥的不同响应结构。
同窗口还有一批工程化改进:PR #125 去重了 MIME 类型、图片编码、SSE 解析等共享工具;PR #127 对齐最新 T2A API 的音频格式校验,自动为 opus/pcmu 选择兼容采样率并移除了 API 不支持的 flac;PR #120 增加数值参数合法性校验,防止无效数字 flag 静默传递。
上手核对清单
从零把这套能力跑通,按这个顺序核对:第一步,npm install -g mmx-cli 后跑 mmx auth login --recommend,浏览器完成设备码授权;第二步,mmx text repl 进入多轮对话,用 /save ./chat.json 导出对话验证 REPL 功能;第三步,mmx file upload --file test.pdf 后 mmx file list 确认文件入库;第四步,需要代理时先设 HTTPS_PROXY 环境变量再跑命令,或 mmx config set --key proxy 持久化;第五步,写脚本集成时直接 import { MiniMaxSDK } from 'mmx-cli/sdk',参照 SDK.md 的模块示例。
原文信息
作者:MiniMax AI 开源协议:MIT 项目地址: 原文地址:
楼主辛苦了,内容很有参考价值。
确实,这类工具还是得多对比几家。