MiniMax Agent 可将自然语言需求直接生成可运行 CLI 工具:登录验证后,用 mmx code generate 生成带 --dry-run、--prefix 的批量重命名脚本,检查 os.rename() 异常处理,再通过 mmx code build 打包为单文件二进制或 mmx code publish 发布为共享命令。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用 MiniMax Agent 直接生成可运行的命令行工具,跳过手写 CLI 框架、参数解析、错误处理等重复劳动,让 Agent 把“我要一个批量重命名图片的工具”这种自然语言需求,直接编译成带 help、支持 --dry-run、自动识别扩展名的完整 CLI 程序。
确认 Agent 已接入 MMX-CLI 并具备代码生成能力
打开终端,运行 mmx auth status。如果返回 ✅ Authenticated 且状态码为 0,说明已登录;若提示 ❌ Not authenticated,需先执行 mmx auth login 并按提示完成鉴权。
运行 mmx code --help。能看到完整子命令列表(如 generate、test、build),证明编程模型已就绪。如果报错 command not found,说明 MMX-CLI 未全局安装,需回到用户目录重新执行 npm install -g @minimax/mmx-cli。
用自然语言描述需求,触发 Agent 生成 CLI 脚本
在支持 Agent 的环境(如 Claude Code 或 OpenClaw)中,向 Agent 发送指令:
“写一个 Python CLI 工具:接收文件夹路径,把其中所有 .jpg 文件按创建时间顺序重命名为 photo_001.jpg、photo_002.jpg… 支持 --dry-run 预览不执行,支持 --prefix 自定义前缀,默认为 photo,输出重命名日志到 stdout。”
Agent 将调用 MiniMax 编程模型生成完整脚本,包含 argparse 解析、pathlib 路径操作、datetime 排序逻辑和清晰的 print 输出。这一步无需指定语言版本或依赖声明——MMX-CLI 默认使用 Python 3.10+ 兼容语法。
【必须检查生成代码中的 os.rename() 是否包裹 try/except OSError】 否则遇到权限拒绝或文件占用时会直接崩溃,而非友好提示。
本地验证并打包为可执行命令
方法一:直接运行生成的脚本
将 Agent 输出保存为 rename_photos.py,在终端执行:python rename_photos.py /path/to/images --dry-run。观察输出是否列出预期重命名序列,无报错即通过基础校验。
方法二:用 MMX-CLI 构建原生可执行文件
执行 mmx code build --input rename_photos.py --output rename-photos。该命令调用内置 PyOxidizer 流程,生成单文件二进制,无需目标机器安装 Python。生成物默认放在当前目录,文件名不含 .py 扩展名。
赋予执行权限:chmod +x rename-photos,然后移至 PATH 下(如 mv rename-photos /usr/local/bin/)。之后任意目录下输入 rename-photos --help 即可调用。
注入 Token Plan 用量监控并发布为共享命令
第一步:启用用量上报
在脚本头部添加注释行:# mmx:track-usage。MMX-CLI 在执行时会自动捕获本次调用消耗的 Token 数,并写入本地 .mmx/usage.log。
第二步:生成带签名的分发包
运行 mmx code publish --name photo-renamer --version 1.0.0 --desc "Batch rename JPGs by creation time"。该命令会压缩脚本、嵌入数字签名、上传至 MiniMax 内部 registry,并返回唯一安装指令:mmx install photo-renamer@1.0.0。
第三步:他人安装即用
协作方只需执行上一步返回的 mmx install 命令,工具将自动下载、校验签名、解压到 ~/.mmx/bin/ 并软链接至 /usr/local/bin。无需 clone 仓库、无需 pip install、无需读 README。


















