dsh-mmx-bridge
welsione/dsh-mmx-bridge
MiniMax multimodal bridge: one `mmx_bridge` tool covers image understanding/generation, video, TTS, music, cover, web search and quota; optional `web_search`/`read_image` takeover; inline players/image previews right in the Web GUI (npm: `dsh-mmx-bridge`).
Install
dsh plugin --profile web add github:welsione/dsh-mmx-bridgeREADME
dsh-mmx-bridge
一个工具 = MiniMax 全部多模态能力。 让 DeepSeek Harness（DSH）的纯文本模型直接看图、画图、生成视频、说话、唱歌、翻唱、搜索、查额度。
English · 简体中文
为什么需要这个？
DSH 默认只支持纯文本对话——看不了图、画不了画、说不了话、做不了视频。dsh-mmx-bridge 通过一个 mmx_bridge 工具接入 MiniMax 全栈多模态模型，一次安装，8 种能力即开即用：
v1.0.5 起：拖图直接发送，AI 就能识别——输入零改动。 拖入/粘贴图片后正常发送：你的消息（图片＋提示词）在会话里原样显示，一个字节都不改。插件在背后做两件事：消息进入会话时被核心放行；发给 LLM 前，把图片落盘到临时目录（默认
/tmp/mmx-out/）并替换为「图片地址＋本地路径」文本——Agent 收到地址后自动调用read_image/mmx_bridge(describe)查看图片。你感知不到中间过程：图片放进输入框，AI 就能看到它。可在设置页「插件配置」关闭该行为。
快速开始
前置条件
一条命令安装
dsh plugin --profile web add dsh-mmx-bridge
⚠️ npm 不通？改用
dsh plugin --profile web add github:welsione/dsh-mmx-bridge
安装后重启 dsh（服务端 ESM 缓存不热替换），再刷新 Web GUI 即可使用。详见 AGENT.md。
让 Agent 帮你装（复制给 Agent 的提示词）
帮我安装 DSH 插件 dsh-mmx-bridge（仓库 https://github.com/welsione/dsh-mmx-bridge ）：
执行 `dsh plugin --profile web add dsh-mmx-bridge` 装到 web GUI profile；npm 拉不动就改用 `dsh plugin --profile web add github:welsione/dsh-mmx-bridge`。装完验证插件已挂载，并提醒我重启 dsh（设置页管理卡片需重启才生效）。
卸载
dsh plugin --profile web rm dsh-mmx-bridge
效果展示
| 图片生成 | 语音合成 |
|---|---|
 |  |
| 图像识别（VLM 描述） | 插件配置页 |
|---|---|
 |  |
架构
用户对话 → DSH Agent → mmx_bridge 工具 → mmx-cli → MiniMax API
↓
/mmx-files/ 同源服务
（图片预览 / 音视频播放器）
- 零 npm 运行时依赖：仅使用 Node.js 内置模块
- 同源产物服务：生成的文件经
/mmx-files/路径直接内嵌在对话中，支持 Range 请求 - Web GUI 增强：图片预览、音频/视频播放器、设置页管理卡片自动加载
兼容性
| 项目 | 说明 |
|---|---|
| DSH 版本 | 0.1.0-rc.7+（Web GUI profile） |
| 运行时依赖 | 零 npm 依赖（Node 内置模块） |
| 外部依赖 | mmx-cli（工具调用时） |
| OS | macOS / Linux / Windows（需 Node.js 18+） |
常见问题
Q: 安装后看不到 mmx_bridge 工具？
确认 DSH 版本 ≥ 0.1.0-rc.7，且 mmx-cli 已安装（mmx --version）。刷新 Web GUI 页面后重试。
Q: 拖入/粘贴图片还是报「当前模型不支持图片」？
请确认插件已升级到 v1.0.5+ 并重启 dsh（服务端 ESM 缓存不热替换）、强刷页面；再到 设置 → 插件 → 插件配置 确认「文本模型直接收图（图片桥）」为「已启用」。开启后拖图/粘贴图片发送：你的消息（图片＋提示词）在界面与会话中原样保留；发给 LLM 前插件把图片落盘到临时目录（默认 /tmp/mmx-out/）并替换为「图片地址＋本地路径」文本，Agent 自动调用 read_image / mmx_bridge 查看图片。本身支持图片输入的模型自动直通不受影响；需要原生行为时关闭该开关即可。
Q: 设置页「插件配置」看不到 dsh-mmx-bridge 管理卡片？
DSH rc.7 起设置页按服务端注册的 settings 命名空间分发卡片，需插件 ≥ 1.0.4（1.0.4 起注册 dsh-mmx-bridge 命名空间）。确认安装版本 ≥ 1.0.4 并重启 dsh（服务端 ESM 缓存不热替换），再强刷 Web GUI 页面。
Q: 图片生成报错 "API key not found"？
需要先运行 mmx auth login 登录 MiniMax 账号。如果使用 Token Plan，确保套餐有效。
Q: 视频生成失败？
MiniMax 视频生成有队列限制，高峰期可能需要等待。检查 mmx quota 确认额度充足。
Q: 国内网络无法访问？
mmx-cli 直连 MiniMax API（api.minimax.chat），国内一般可直连。如遇问题检查代理设置。
相关项目
| 项目 | 说明 |
|---|---|
| DeepSeek Harness | DSH 本体 —— 一切皆插件的 Agent 框架 |
| MiniMax CLI | MiniMax 官方命令行工具 |
| awesome-dsh-plugin | DSH 插件精选集（本插件已收录） |
| dsh-recommend | DSH 插件排行榜（本插件已收录） |
贡献
欢迎提 Issue 和 PR。开发流程：
git clone https://github.com/welsione/dsh-mmx-bridge.git
cd dsh-mmx-bridge
npm install
npm run build # 构建 lib/
dsh plugin --profile web add . # 本地安装测试
许可证
如果这个插件对你有帮助，欢迎给个 ⭐ Star 支持一下！