@hellofriday430/opencode-minimax-bridge

将 MiniMax mmx CLI 的能力桥接为 OpenCode 原生工具。

能做什么

安装后，OpenCode 会话中会多出 6 个直接可用的工具：

| 工具 | 功能 | |---|---| | mmx_search_query | Web 搜索 | | mmx_vision_describe | 图片理解与描述 | | mmx_image_generate | 图片生成 | | mmx_speech_synthesize | 文字转语音（TTS） | | mmx_music_generate | 音乐生成 | | mmx_quota_show | 查询 MiniMax API 配额用量 |

在对话中直接告诉 OpenCode 即可使用，例如：

"搜索一下 MiniMax 最新的模型发布" "生成一张夕阳下的沙滩图片" "把这段文字转成语音"

前置条件

• Node.js 20+（插件使用 --experimental-strip-types）
• mmx-cli：MiniMax 官方 CLI 工具
• MiniMax API Key：需要从 MiniMax 平台 获取

安装

# 1. 安装 mmx-cli（全局）
npm install -g mmx-cli

# 2. 安装此插件（全局）
npm install -g @hellofriday430/opencode-minimax-bridge

# 3. 配置 MiniMax API Key
# 方式 A：环境变量（推荐）
set MINIMAX_API_KEY=你的key

# 方式 B：mmx 配置文件
mmx config set api-key 你的key

配置

在 全局 opencode.json（%APPDATA%\opencode\opencode.json）或 项目 opencode.json 中添加插件名：

{
  "plugin": [
    "@hellofriday430/opencode-minimax-bridge"
  ]
}

重启 OpenCode 后即可使用。

验证

cd node_modules\@hellofriday430\opencode-minimax-bridge
npm run verify

验证脚本会检查：插件布局、mmx CLI 是否可用、6 个工具是否完整注册、端到端调用是否正常。

可用工具详情

mmx_search_query

Web 搜索。返回搜索结果摘要。

参数: --q <查询词>

mmx_vision_describe

对图片进行识别和描述。支持本地图片路径或 URL。

参数: --image <路径或URL>

mmx_image_generate

根据文字描述生成图片。

参数: --prompt <描述词> [--style <风格>] [--aspect-ratio <比例>]

mmx_speech_synthesize

将文字合成为语音。

参数: --text <文本> [--voice-id <音色ID>] [--speed <语速>]

mmx_music_generate

生成音乐或歌曲。

参数: --prompt <描述词> [--duration <时长>] [--instrumental]

mmx_quota_show

查询当前 MiniMax API 账户的配额余量。

无需参数

工作原理

插件通过 Node.js 直接调用 node <mmx.mjs> 执行 mmx CLI 命令，将 mmx 的 JSON Schema 参数定义自动转换为 Zod 类型，OpenCode 的 LLM 能正确理解每个参数的含义和类型。

License

MIT