Dòng lệnh và tự động hóa

MDM có thể được điều khiển mà không cần cửa sổ theo ba cách:

• Dòng lệnh của ứng dụng, các tùy chọn giống như của IDM: chuyển một lượt tải xuống cho ứng dụng đang chạy từ một tập lệnh, tệp bó hoặc chương trình khác.
• misterdownloadmanager-cli, một công cụ dòng lệnh riêng biệt: tải xuống tệp, video và torrent trong một thiết bị đầu cuối, có hiển thị tiến độ, mà không cần ứng dụng.
• API tự động hóa: các chương trình khác liệt kê các lượt tải xuống của ứng dụng đang chạy (dưới dạng JSON) và tạm dừng, bắt đầu, xóa hoặc loại bỏ chúng, thông qua một kênh cục bộ, được bảo vệ bằng mã thông báo. Các trợ lý AI sử dụng nó thông qua máy chủ MCP của MDM: xem Trợ lý AI.

Các ví dụ sử dụng đường dẫn của Windows; trên macOS và Linux, các chương trình có cùng tên mà không có .exe.

Dòng lệnh của ứng dụng

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

Các tùy chọn có thể bắt đầu bằng / hoặc -, trong mọi trường hợp. Nếu MDM đang chạy, lệnh sẽ được chuyển đến nó; nếu không, MDM sẽ khởi động và thực hiện lệnh. Ví dụ:

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

Nó đi kèm với mọi bản tải xuống của MDM, bên cạnh ứng dụng (trình cài đặt đặt nó vào thư mục của MDM). Nó hoạt động độc lập: ứng dụng không cần chạy, ngoại trừ status và api.

misterdownloadmanager-cli help <command>hiển thị mọi tùy chọn. Một lệnh thất bại (ứng dụng không chạy, nó trả lời bằng lỗi, một lượt tải xuống bị hỏng) sẽ thoát với mã 1. Ví dụ:

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 cho các tập lệnh và chương trình

Với --json (trước hoặc sau lệnh), mọi lệnh sẽ in JSON thay vì văn bản, mỗi đối tượng một dòng, để các tập lệnh và tác nhân AI đọc:

Kích thước tính bằng byte (null khi không xác định), tốc độ tính bằng byte mỗi giây. Một lỗi sẽ in {"error": "…"} và thoát với mã 1. Ví dụ:

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 tự động hóa

Các chương trình khác có thể hỏi ứng dụng đang chạy nó đang tải xuống gì, và tạm dừng, bắt đầu, xóa hoặc loại bỏ các lượt tải xuống. API tắt theo mặc định; bật nó bằng misterdownloadmanager-cli api on (và tắt bằng api off).

Cách một chương trình giao tiếp với MDM

1. Khi chạy, MDM lắng nghe trên một cổng của 127.0.0.1 (chỉ máy tính này) và ghi cổng cùng một mã thông báo bí mật vào ipc.json trong thư mục dữ liệu của nó: - Windows: %APPDATA%\misterdownloadmanager\ipc.json - macOS: ~/Library/Application Support/misterdownloadmanager/ipc.json - Linux: ~/.local/share/misterdownloadmanager/ipc.json - Một bản sao di động: data\ipc.json bên cạnh chương trình.

Mã thông báo thay đổi mỗi khi khởi động; chỉ các chương trình có thể đọc thư mục dữ liệu của bạn (của bạn) mới có thể sử dụng nó. 2. Kết nối với cổng đó và gửi một dòng JSON: mã thông báo và các trường của lệnh, ví dụ {"token": "<token>", "query": "list"}. 3. MDM trả lời bằng một dòng: ok cho một lệnh, hoặc một đối tượng JSON cho một câu hỏi.

Những gì nó hiểu

Một câu hỏi hoặc hành động không xác định được trả lời {"error": "…"}, cũng như một câu hỏi khi API tắt (sau đó với "code": "api-off", để các chương trình kiểm tra: văn bản lỗi có thể thay đổi). Một mã thông báo sai được trả lời denied.

Mọi yêu cầu và câu trả lời được mô tả, từng trường một, trong một JSON Schema: automation-api.schema.json (cũng tại https://misterdownloadmanager.com/automation-api.schema.json). Nó được tạo từ mã mà ứng dụng trả lời, vì vậy nó luôn chính xác; các chương trình có thể kiểm tra những gì chúng gửi và đọc dựa trên nó, hoặc tạo các kiểu của chúng từ nó.

Ví dụ

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"])

Để thêm một lượt tải xuống, hãy gửi {"token": "…", "url": "https://example.com/a.zip", "silent": true}.