dsh-mmx-bridge 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node >=18）；该结论来自程序自动检查，未经人工实机验证。

dsh-mmx-bridge 兼容性怎么样？

自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node >=18）；该结论来自程序自动检查，未经人工实机验证。

dsh-mmx-bridge 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-mmx-bridge 还在维护吗？

GitHub 10 星。最近一次上游提交在 2026/9/18。

MiniMax 多模态桥 welsione/dsh-mmx-bridge

DeepSeek Harnessv1.0.10

welsione46 天前有提交已提供中文文档扫描：含敏感能力需联网ocr

在 GitHub 查看 ↗

一个工具 = MiniMax 全部多模态能力。让 DeepSeek…

36.7/100

综合分

GitHub 星标

435

npm 周下载

—/5

用户评分

数据截至 2026/9/18 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add dsh-mmx-bridge

npm 源 · dsh-mmx-bridge 的发布者账号已校验与本仓库一致

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：仅索引

是什么

dsh 原生插件 · vision

装得上吗

静态安装检查通过

未做真实安装

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 46 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查✓ 自动检查通过

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-mmx-bridge @ 1.0.10

✓Node 引擎要求 >=18 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/1 16:40:20

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件发起外部网络请求

查看扫描证据（共 43 处，展示前 31 条）

写入本地文件
lib/index.js:207
appendFileSync(opts.debugLog, new Date().toISOString() + ' [tool] ' + message + '\n')
读取本地文件
lib/index.js:258
if (!existsSync(opts.controlFile)) return {}
读取本地文件
lib/index.js:259
const raw = readFileSync(opts.controlFile, 'utf8').trim()
读取本地文件
lib/index.js:271
if (!existsSync(opts.statusFile)) return null
读取本地文件
lib/index.js:272
const lines = readFileSync(opts.statusFile, 'utf8').trim().split('\n').filter((l) => l.length > 0)
写入本地文件
lib/index.js:331
writeFileSync(opts.statusFile, JSON.stringify(payload) + '\n')
读取本地文件
lib/index.js:371
return typeof p === 'string' && existsSync(p)
执行外部命令固定命令
lib/index.js:381
const out = execFileSync('where', ['mmx'], { encoding: 'utf8', timeout: 8000 })
执行外部命令固定命令
lib/index.js:385
const out = execFileSync('/bin/sh', ['-c', 'command -v mmx'], { encoding: 'utf8', timeout: 8000 })
执行外部命令来自配置/变量
lib/index.js:457
if (!IS_WIN) return spawn(bin, args, opts || {})
执行外部命令固定命令
lib/index.js:460
return spawn('cmd.exe', ['/d', '/s', '/c', '"' + cmdline + '"'], Object.assign({}, opts || {}, { windowsVerbatimArguments: true }))
读取本地文件
lib/index.js:475
if (existsSync(candidates[i])) return candidates[i]
写入本地文件
lib/index.js:599
mkdirSync(opts.outDir, { recursive: true })
写入本地文件
lib/index.js:1198
writeFileSync(opts.controlFile, JSON.stringify(next))
写入本地文件
lib/index.js:1357
mkdirSync(opts.outDir, { recursive: true })
写入本地文件
lib/index.js:1362
writeFileSync(file, buf)
发起网络请求
lib/client.js:292
const res = await fetch("/api/mmx-bridge/status");
发起网络请求
lib/client.js:309
const res = await fetch(url, {
发起网络请求
lib/client.js:452
await fetch("/api/mmx-bridge/auth-status").then(function (r) { return r.json(); });
读取本地文件
lib/img-cache.js:98
const st = statSync(filePath)
读取本地文件
lib/img-cache.js:101
const bytes = readFileSync(filePath)
读取本地文件
lib/img-cache.js:137
const st = statSync(target)
读取本地文件
lib/img-cache.js:140
const bytes = readFileSync(target)
写入本地文件
lib/img-cache.js:165
writeFileSync(tmp, embedded)
写入本地文件
lib/img-cache.js:166
renameSync(tmp, target)
读取本地文件
lib/imgjson.mjs:609
if (opts.file != null) return readFileSync(opts.file, 'utf8');
读取本地文件
lib/imgjson.mjs:617
return readFileSync(jsonFile, 'utf8');
读取本地文件
lib/imgjson.mjs:644
const original = readFileSync(imageFile);
读取本地文件
lib/imgjson.mjs:678
const buf = readFileSync(imageFile);
读取本地文件
lib/imgjson.mjs:748
const buf = readFileSync(imageFile);
读取本地文件
lib/imgjson.mjs:762
const buf = readFileSync(imageFile);

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

⚠ 该插件运行需访问外部网络 / 远程 API，部署在国内无外网环境时可能无法正常使用。

依赖的 DSH / Cordis 模块

@deepseek-ai/schemastery@deepseek-ai/dsh-settings@deepseek-ai/dsh-home-paths

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

界面预览

1 张 · 点击查看大图

功能亮点

文本模型看图
文本模型画图
文本模型生视频

一个 mmx_bridge 工具就涵盖 MiniMax 全部多模态能力：DSH 纯文本模型能看图、画图、生视频、说话、唱歌、翻唱、搜索、查额度。

README

由 DeepSeek 最新模型翻译生成

dsh-mmx-bridge 一个工具 = MiniMax 全部多模态能力。让 DeepSeek Harness（DSH）的纯文本模型直接看图、画图、生成视频、说话、唱歌、翻唱、搜索、查额度。 Awesome DSH Plugin English · 简体中文概述（Overview） DSH 默认只支持纯文本对话——看不了图、画不了画、说不了话、做不了视频。dsh-mmx-bridge 通过一个 mmx_bridge 工具接入 MiniMax 全栈多模态模型，一次安装，8 种能力即开即用： v1.0.5 起：拖图直接发送，AI 就能识别——输入零改动。拖入/粘贴图片后正常发送：你的消息（图片＋提示词）在会话里原样显示，一个字节都不改。插件在背后把图片落盘到临时目录（默认 /tmp/mmx-out/）并替换为「图片地址＋本地路径」文本——Agent 收到地址后自动调用 read_image / mmx_bridge(describe) 查看图片。你感知不到中间过程。 v1.0.7 起：图片识别缓存（内嵌 JSON，默认开启）。识别结果以 imgjson 标准块（PNG tEXt / JPEG COM）写回图片本身，同图同问题再次读取直接复用，零 VLM 调用；追问按问题分层缓存，各层互不覆盖；图片被重新编码时缓存自动失效重建。可在设置页「插件配置」关闭。

展开完整文档（README 剩余 1 节）

dsh-mmx-bridge

一个工具 = MiniMax 全部多模态能力。 让 DeepSeek Harness（DSH）的纯文本模型直接看图、画图、生成视频、说话、唱歌、翻唱、搜索、查额度。

Awesome DSH Plugin

English · 简体中文

概述（Overview）

DSH 默认只支持纯文本对话——看不了图、画不了画、说不了话、做不了视频。dsh-mmx-bridge 通过一个 mmx_bridge 工具接入 MiniMax 全栈多模态模型，一次安装，8 种能力即开即用：

v1.0.5 起：拖图直接发送，AI 就能识别——输入零改动。 拖入/粘贴图片后正常发送：你的消息（图片＋提示词）在会话里原样显示，一个字节都不改。插件在背后把图片落盘到临时目录（默认 /tmp/mmx-out/）并替换为「图片地址＋本地路径」文本——Agent 收到地址后自动调用 read_image / mmx_bridge(describe) 查看图片。你感知不到中间过程。

v1.0.7 起：图片识别缓存（内嵌 JSON，默认开启）。 识别结果以 imgjson 标准块（PNG tEXt / JPEG COM）写回图片本身，同图同问题再次读取直接复用，零 VLM 调用；追问按问题分层缓存，各层互不覆盖；图片被重新编码时缓存自动失效重建。可在设置页「插件配置」关闭。

兼容性（Compatibility）

| 项目 | 说明 |
| DSH 版本 | 0.1.0-rc.7+（Web GUI profile）；已验证 0.1.0-rc.7 ~ 0.1.5-rc.2 |
| 运行时依赖 | Node 内置模块 + @deepseek-ai 生态 peer 包（宿主运行时提供），无第三方运行时依赖 |
| 外部依赖 | mmx-cli（工具调用时；插件支持自动扫描 / 配置路径 / 一键安装 / api-key 一键登录） |
| OS | macOS / Linux（一等支持）；Windows 尽力支持（os.tmpdir 默认路径、where mmx 发现、cmd.exe 启动分支已适配，未经真机验证） |

安装与卸载（Install / Uninstall）

前置条件

1. 已安装 DSH（v0.1.0-rc.7+）
2. 已安装 mmx-cli 并登录：npm i -g mmx-cli && mmx auth login

安装

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

快速开始（Quick Start）

一个工具，多模态全家桶。mmx_bridge 按 action 分发：

| action | 能力 | 关键参数 |
| describe | 图片理解（VLM） | image＋可选 prompt（追问） |
| image | 文生图 | prompt / aspectRatio / count |
| video | 文/图生视频 | prompt / image / duration / ratio / model |
| speech | 语音合成 | text / voice |
| music | 音乐生成 | prompt / lyrics / instrumental |
| cover | 音频翻唱 | prompt + audio 参考音频 |
| search | 联网搜索 | q |
| quota | 用量查询 | — |

视频参数说明（1.0.10 起）：duration / ratio 仅 MiniMax-H3 支持，传入时会自动选用 H3（也可用 model 显式指定：MiniMax-Hailuo-2.3 默认 / MiniMax-Hailuo-2.3-Fast（仅图生视频）/ MiniMax-H3 / MiniMax-H3-Max）。注意 MiniMax 的 Credits / Token Plan 账号不支持 H3 系列——H3 请求会报 2013 错误；插件已把该报错翻译成可操作提示。Credits 账号请省略 duration/ratio，默认 Hailuo-2.3 输出约 6 秒、16:9。

聊天里直接对 Agent 说即可，例如：「描述这张图片」、「生成一张赛博朋克猫的图」、「把这段文字变成语音」。

配置（Configuration）

所有配置均可通过设置页「插件配置」卡片或控制文件调整。

控制文件（默认 /tmp/dsh-vision-control.json）

| 键 | 默认 | 含义 |
| enabled | true | 插件总开关 |
| count | 3 | 每次文生图张数（1–8） |
| webSearchEnabled | true | web_search 改用 mmx-cli |
| readImageEnabled | true | read_image 改用 MiniMax VLM |
| imageBridgeEnabled | true | 图片桥：拖图直发、发给 LLM 前落盘替换 |
| imageCacheEnabled | true | 识别缓存：识别结果内嵌写回图片，同图同问复用 |
| mmxBin | 自动 | mmx 可执行文件路径（留空/删除 = 回到自动扫描） |

键缺省即按默认值（false 显式关闭）。设置页开关写入同一文件。

mmx 环境管理（设置卡「环境」区块）

插件自动完成 mmx-cli 的发现 / 配置 / 安装 / 登录全闭环：

1. 自动扫描：按优先级探测 控制文件 mmxBin > 环境变量 MMX_BIN > 自动扫描（command -v mmx / where mmx、/usr/local/bin/mmx、/opt/homebrew/bin/mmx、npm 全局目录等）；
2. 扫描不到 → 手动配置：设置卡「mmx 路径」输入真实路径保存（校验存在性），留空保存即清除、回到自动扫描；
3. 未安装 → 一键安装：设置卡一键执行 npm install -g mmx-cli（跟随系统 npm 配置），成功后自动重扫；
4. 未登录 → api-key 一键登录：设置卡输入 MiniMax API Key 点「登录」（内部执行 mmx auth login --api-key），Key 不落盘、不写日志、不回显；「登录状态」按钮实时查询 mmx auth status。
5. 模型自助修复（免去后台配置）：新增 mmx_env 工具（status / install / login / set-path）。mmx_bridge 报「找不到 mmx / 未登录 / 命令错误」时，错误信息自带修复引导；Agent 先 status 自查原因，再 install（一键安装）、login（向用户索要 API Key 后登录，Key 不写进输出）、set-path（配置路径）现场修复，最后 status 确认——用户无需进设置页，只管对话。

环境变量（MMX_）

| 变量 | 默认 |
| MMX_BIN | 平台默认（macOS /usr/local/bin/mmx；Windows mmx） |
| MMX_OUT_DIR | 系统临时目录下的 mmx-out（macOS/Linux 即 /tmp/mmx-out） |
| MMX_CONTROL_FILE | 系统临时目录下的 dsh-vision-control.json |
| MMX_STATUS_FILE | 系统临时目录下的 dsh-vision-status.json |
| MMX_DEBUG_LOG | 系统临时目录下的 dsh-mmx-multimodal-debug.log |
| MMX_INSTALL_PATH | /api/mmx-bridge/install-mmx |
| MMX_LOGIN_PATH | /api/mmx-bridge/login-mmx |
| MMX_AUTH_STATUS_PATH | /api/mmx-bridge/auth-status |

权限与数据（Permissions & Data）

- 生成/桥接产物：图片、视频、音频统一保存到 MMX_OUT_DIR（默认 /tmp/mmx-out/），经同源 /mmx-files/ 提供（支持 Range、防目录穿越）。
- 附件读取：桥接时从 DSH 附件存储（attachments/v1）按内容寻址读取图片字节，只读不写。
- 识别缓存写入：只写回插件自建的 bridge- 副本（位于 outDir 内）；绝不修改 DSH 附件存储中的原始对象。
- 缓存是明文：内嵌 JSON 未加密，懂文件结构的人可读——请勿在图片中放入不宜展示的信息。
- 重新编码即失效：图片经社交平台转存/压缩/截图后，内嵌缓存因 sha256 不匹配自动失效，读取端显式告知，而不是静默返回旧数据。

常见问题（Troubleshooting）

Q: 安装后看不到 mmx_bridge 工具？

确认 DSH 版本 ≥ 0.1.0-rc.7，且 mmx-cli 已安装（mmx --version）。刷新 Web GUI 页面后重试。

Q: 拖入/粘贴图片还是报「当前模型不支持图片」？

请确认插件已升级到 v1.0.5+ 并重启 dsh（服务端 ESM 缓存不热替换）、强刷页面；再到 设置 → 插件 → 插件配置 确认「图片桥」为「已启用」。本身支持图片输入的模型自动直通，不受影响。

Q: 图片识别缓存命中/失效是怎么工作的？

识别结果以内嵌 JSON（PNG tEXt/JPEG COM 标准块）写回图片桥副本。同图同问题再次读取（read_image 或 mmx_bridge(describe)）直接复用并标注 cached:true，零 VLM 调用；不同问题（追问）各自分层缓存，互不覆盖；图片字节变化（重新编码）后缓存显式失效并自动重建。

Q: 设置页「插件配置」看不到 dsh-mmx-bridge 管理卡片？

需插件 ≥ 1.0.4 并重启 dsh（服务端 ESM 缓存不热替换），再强刷 Web GUI 页面。

Q: 图片生成报错 "API key not found"？

先运行 mmx auth login 登录 MiniMax 账号。Token Plan 需确保套餐有效。

Q: 国内网络无法访问？

mmx-cli 直连 MiniMax API（api.minimax.chat），国内一般可直连。如遇问题检查代理设置。

开发（Development）

git clone https://github.com/welsione/dsh-mmx-bridge.git
cd dsh-mmx-bridge
npm test # 单元测试（图片缓存 / read_image 包装，真实 PNG/JPEG）
npm run check # 语法检查（4 个 lib 文件）
dsh plugin --profile web add . # 本地安装测试

架构

用户对话 → DSH Agent → mmx_bridge 工具 → mmx-cli → MiniMax API ↓ /mmx-files/ 同源服务（图片预览 / 音视频播放器）识别结果 → imgjson 块内嵌回写图片（PNG tEXt / JPEG COM）→ 下次同图同问直接复用

- 无第三方运行时依赖：Node 内置模块 + @deepseek-ai 生态包（宿主运行时提供）
- 同源产物服务：生成的文件经 /mmx-files/ 路径直接内嵌在对话中，支持 Range 请求
- Web GUI 增强：图片预览、音频/视频播放器、设置页管理卡片自动加载

许可证与安全（License & Security）

- MIT：LICENSE
- 不收集任何遥测；不读取系统凭据；不修改 DSH 附件存储
- 内嵌识别缓存为明文，无需保密信息；按需在写回前自行加密

相关项目

| 项目 | 说明 |
| DeepSeek Harness | DSH 本体 —— 一切皆插件的 Agent 框架 |
| MiniMax CLI | MiniMax 官方命令行工具 |
| awesome-dsh-plugin | DSH 插件精选集（本插件已收录） |
| dsh-recommend | DSH 插件排行榜（本插件已收录） |

如果这个插件对你有帮助，欢迎给个 ⭐ Star 支持一下！