命令行和自动化

MDM 可以在不显示窗口的情况下通过以下三种方式运行：

• 应用程序自己的命令行，与 IDM 的开关相同：从脚本、批处理文件或另一个程序将下载任务交给正在运行的应用程序。
• misterdownloadmanager-cli，一个单独的命令行工具：在终端中下载文件、视频和种子，显示进度，无需应用程序。
• 自动化 API：其他程序通过本地、受令牌保护的通道列出正在运行的应用程序的下载（以 JSON 格式），并暂停、开始、移除或删除它们。AI 助手通过 MDM 的 MCP 服务器使用它：请参阅AI 助手。

示例使用 Windows 路径；在 macOS 和 Linux 上，程序名称相同，不带 .exe。

应用程序的命令行

misterdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]

开关可以以 / 或 - 开头，不区分大小写。如果 MDM 正在运行，命令会发送给它；如果未运行，MDM 会启动并执行命令。例如：

misterdownloadmanager.exe /d https://example.com/files/report.pdf /p D:\Reports /n
misterdownloadmanager.exe /d https://example.com/big.iso /a
misterdownloadmanager.exe /s

misterdownloadmanager-cli

它随 MDM 的每次下载一起提供，位于应用程序旁边（安装程序将其放在 MDM 的文件夹中）。它可以独立工作：应用程序无需运行，除了 status 和 api。

misterdownloadmanager-cli help <command>显示所有选项。如果命令失败（应用未运行，应用返回错误，下载中断），则以代码 1 退出。例如：

misterdownloadmanager-cli get https://example.com/big.iso -o D:\Downloads -c 16 --checksum sha256:9f86d0…
misterdownloadmanager-cli video-get "https://www.youtube.com/watch?v=aqz-KE-bpKQ" -f "b[height=720]"
misterdownloadmanager-cli torrent-get "magnet:?xt=urn:btih:…" --files 0

用于脚本和程序的 JSON

使用 --json（在命令之前或之后），每个命令都会打印 JSON 而不是文本，每行一个对象，供脚本和 AI 代理读取：

大小以字节为单位（null 表示未知），速度以字节每秒为单位。失败会打印 {"error": "…"} 并以代码 1 退出。例如：

misterdownloadmanager-cli --json get https://example.com/big.iso -o D:\Downloads
{"event":"progress","downloaded":4194304,"size":1073741824,"speed":52428800,"connections":8,"segments":8}
…
{"event":"done","path":"D:\\Downloads\\big.iso","size":1073741824,"seconds":20.4}

自动化 API

其他程序可以询问正在运行的应用正在下载什么，并暂停、开始、移除或删除下载。API 默认关闭；使用 misterdownloadmanager-cli api on 开启（使用 api off 关闭）。

程序如何与 MDM 通信

1. MDM 运行时，它会监听 127.0.0.1 的一个端口（仅限本机），并将端口和一个秘密令牌写入其数据文件夹中的 ipc.json：- Windows: %APPDATA%\misterdownloadmanager\ipc.json - macOS: ~/Library/Application Support/misterdownloadmanager/ipc.json - Linux: ~/.local/share/misterdownloadmanager/ipc.json - 便携版: data\ipc.json 在程序旁边。

令牌每次启动都会改变；只有能读取您数据文件夹的程序（您的程序）才能使用它。2. 连接到该端口并发送一行 JSON：令牌和命令的字段，例如 {"token": "<token>", "query": "list"}。3. MDM 回复一行：命令的 ok，或问题的 JSON 对象。

它能理解什么

当 API 关闭时，未知的问题或操作会得到{"error": "…"}的回答（此时会显示"code": "api-off"，供程序检查：错误文本可能会更改）。错误的令牌会得到denied的回答。

每个请求和回答都按字段在 JSON Schema 中描述：automation-api.schema.json（也在 https://misterdownloadmanager.com/automation-api.schema.json）。它由应用回答的代码生成，因此保持精确；程序可以根据它检查发送和读取的内容，或从中生成其类型。

示例

PowerShell (Windows):

$ep = Get-Content "$env:APPDATA\misterdownloadmanager\ipc.json" | ConvertFrom-Json
$client = New-Object Net.Sockets.TcpClient("127.0.0.1", $ep.port)
$stream = $client.GetStream()
$writer = New-Object IO.StreamWriter($stream); $reader = New-Object IO.StreamReader($stream)
$writer.WriteLine((@{ token = $ep.token; query = "list" } | ConvertTo-Json -Compress))
$writer.Flush()
$reader.ReadLine() | ConvertFrom-Json | Select-Object -ExpandProperty downloads | Format-Table file, status, downloaded, size
$client.Close()

Python：

import json, os, socket

ipc = os.path.join(os.environ["APPDATA"], "misterdownloadmanager", "ipc.json")  # see above elsewhere
ep = json.load(open(ipc))
with socket.create_connection(("127.0.0.1", ep["port"])) as s:
    s.sendall((json.dumps({"token": ep["token"], "query": "list"}) + "\n").encode())
    answer = json.loads(s.makefile().readline())
for d in answer["downloads"]:
    print(d["file"], d["status"], d["downloaded"], d["size"])

若要添加下载，请发送{"token": "…", "url": "https://example.com/a.zip", "silent": true}。