dsh-mimo-agent-tools
面向 DSH 智能体的 Xiaomi MiMo 搜索与多模态工具：mimo_search/vision/audio/video/asr/tts。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ch1bug/dsh-mimo-agent-tools#ceb833b9059d4a2d220c180f0b72db6734c0e62bMimo Agent Tools 以 dsh-mimo-agent-tools 发布，当前版本为 0.2.1-alpha.1-r1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH (DeepSeek Harness) Cordis plugin that turns the Xiaomi MiMo API into model tools for an agent: web search, image/audio/video understanding, speech-to-text, and text-to-speech.
Backed by the OpenAI-compatible endpoint https://api.xiaomimimo.com/v1.
| Tool | Model | Purpose |
|---|---|---|
mimo_search | mimo-v2.5-pro | Web search via the native web_search tool, returns answer + cited sources (incl. site_name/logo_url); optional force_search, user_location |
mimo_think | mimo-v2.5-pro / mimo-v2.5 | Deep thinking — full reasoning chain (reasoning_content) + final answer |
mimo_json | mimo-v2.5-pro / mimo-v2.5 | Structured JSON output via response_format: json_object |
mimo_vision | mimo-v2.5 | Image understanding — local files (auto base64) or public URLs, multi-image |
mimo_audio | mimo-v2.5 | Audio understanding / transcription (wav/mp3/flac/ogg/m4a) — local file or public URL |
mimo_video | mimo-v2.5 | Video understanding (mp4/webm/mov) — local file or public URL; optional fps / media_resolution |
mimo_asr | mimo-v2.5-asr | Speech-to-text with optional language hint — local file or public URL |
mimo_tts | mimo-v2.5-tts / -voicedesign | Text-to-speech to a .wav/.mp3 file — preset voices or free-form voice design; optional style (speaking tone) and format (wav/mp3) |
mimo_voiceclone | mimo-v2.5-tts-voiceclone | Voice cloning — reference clip + text → speech in that voice; optional format (wav/mp3) |
The plugin registers an audio-tools skill that guides when to use the four
audio tools (mimo_asr, mimo_tts, mimo_voiceclone, mimo_audio). The
tools themselves are always registered — they are lightweight pure-API calls —
so the skill only teaches usage, it does not gate the tools.
web_search tool requires the
connected-search plugin enabled in the MiMo console.python3 on the host (used by driver/mimo_driver.py).shell and sandboxPolicy services.The API key is resolved at tool-call time from the DSH credentials
service first (key name XIAOMI_API_KEY — the web Models page writes keys
there), falling back to the environment. Nothing is hardcoded:
| Source | Key | Priority |
|---|---|---|
DSH credentials service (~/.dsh/.credentials.yaml, web Models page) | XIAOMI_API_KEY | 1 |
| Environment | XIAOMI_API_KEY or MIMO_API_KEY | 2 |
Other options (environment, read at apply time):
| Env var | Purpose | Default |
|---|---|---|
MIMO_DRIVER | path to driver/mimo_driver.py | ~/.local/lib/mimo-agent-tools/driver/mimo_driver.py |
MIMO_TMP | temp dir for spec/response files | /tmp |
Install the driver at the default path (or point MIMO_DRIVER at it):
mkdir -p ~/.local/lib/mimo-agent-tools/driver
cp driver/mimo_driver.py ~/.local/lib/mimo-agent-tools/driver/
Multimodal payloads are multi-megabyte base64 strings. Agent shells commonly cap captured stdout (DSH's bash seam caps at 64KB), which silently truncates large payloads. The driver therefore does ALL file reading, body assembly and HTTP POSTing inside one python3 process, using spec/response files on disk — nothing large ever crosses the shell.
Standard DSH bundle — install with the official plugin command (auto-inits
the profile, pnpm-installs, and appends the bundle layer per
dsh.bundle.patch):
# From a local checkout, or via git/npm:
dsh plugin --profile web add /path/to/dsh-mimo-agent-tools
# or: dsh plugin --profile web add github:you/dsh-mimo-agent-tools
# Install the python driver to the default path (MIMO_DRIVER points at it):
mkdir -p ~/.local/lib/mimo-agent-tools/driver
cp driver/mimo_driver.py ~/.local/lib/mimo-agent-tools/driver/
# Restart dsh web; the tools mount automatically.
Dependencies are declared as peerDependencies (ecosystem convention —
@deepseek-ai/dsh-tools is already loaded in the DSH process, so nothing is
duplicated). dsh plugin add installs the bundle into the profile's
node_modules where peer deps resolve against the running harness.
style instruction rides
the user message for preset voices and becomes an inline (风格) tag prefix
for voicedesign voices.mimo-v2.5-tts-voicedesign does not accept an audio.voice field — it
uses optimize_text_preview instead.mimo-v2.5-asr) must not receive a thinking field.input_audio.data / video_url.url accept either a public URL or a
data:<mime>;base64,... data URL (video base64 capped at 50MB per the docs).max_keyword, default 3) — see MiMo
pricing. force_search (default true) trades freshness against cost;
user_location biases results, e.g.
{"type":"approximate","country":"China","region":"Hubei","city":"Wuhan"}.mimo_think) returns reasoning_content + content; in
multi-turn agent conversations with tool calls, reasoning_content from
earlier turns must be echoed back or the API returns 400.mimo_json) needs an explicit JSON shape description in
the prompt (fields, types, nesting); keep max_completion_tokens generous so
the JSON is not truncated mid-document.python3 tests/test_driver.py # driver request-body assembly (14 cases)
node --test tests/tools.test.mjs # tool registration surface (10 cases)
node --test tests/speech.test.mjs # speechToText provider surface (4 cases)
speech.js is a separate plugin entry that plugs Xiaomi MiMo ASR
(mimo-v2.5-asr) into dsh's official voice-input stack as a cloud
provider: the built-in 🎤 capture → RPC → provider-registry pipeline stays
untouched; recordings are transcribed by MiMo and the transcript lands in
the input box.
inject: ['speechToText', ...]) on deployments
without @deepseek-ai/dsh-experimental-voice-input-bundle — the agent
tools are unaffected either way.speech-to-text row's defaultProvider
to mimo. Bundle order matters: this package must compose AFTER the
voice-input bundle in dsh.profile.bundles (the override only lands on an
already-inserted row). SenseVoice stays registered and can be re-selected
in the official voice settings.XIAOMI_API_KEY entry in the DSH credentials
service the tools use.MIT