Dannex Download Manager
  1. ホーム
  2. ヘルプ
  3. アーキテクチャ

アーキテクチャ

Dannex Download Manager の各部分がどのように連携するか。

クレート

パス クレート 役割
crates/engine mdm-engine HTTP(S)またはFTP(S)経由で1つのファイルをダウンロード: プローブ、セグメントプランナー、接続ワーカー、レジューム状態、ホストごとの制限、速度制限、チェックサム、プロキシスクリプト
crates/app mdm-app デスクトップアプリ (dannexdownloadmanager.exe、egui): リスト、カテゴリ、キュー、スケジューラ、ダイアログ、トレイ、設定
crates/cli mdm-cli 進捗状況 (get、resume) を表示するヘッドレスダウンロード、動画、トレント、自動化 API のコマンド: アプリのプログラムが実行するライブラリ (dannexdownloadmanager --cli …) と、同じ引数、ターミナル、終了コードでそのプログラムを起動する小さなランチャー (dannexdownloadmanager-cli)
crates/mcp mdm-mcp MCP サーバー (dannexdownloadmanager-mcp): AI アシスタントが自動化 API を通じて、実行中のアプリのダウンロードを一覧表示、追加、操作します
crates/remote mdm-remote リモート コントロール (#141): ローカル ネットワーク上のペアリングされた電話またはコンピューターが使用するHTTPSサーバー(そのページ、ペアリング コード、デバイス トークン、自己署名証明書)。すべてのリクエストは、アプリが応答する自動化APIコマンドになります。
crates/nmhost mdm-nmhost ブラウザのネイティブメッセージングホスト: 拡張機能からキャプチャされたダウンロードを受け取り、アプリに渡す
crates/ipc mdm-ipc シングルインスタンスチャネル (トークンで保護されたローカルソケット)、データフォルダ、アプリとホストで共有されるキャプチャルール
crates/debrid mdm-debrid デブリッド アカウント (#44): サービスの公式 API (Real-Debrid、AllDebrid、Premiumize、TorBox) は、ファイル ホストのリンクをエンジンがダウンロードする直接リンクに変換します。
crates/extract mdm-extract アーカイブの展開 (#37): zip、tar、gz、xz は処理中。7z と RAR はインストール済みの 7-Zip を別のプログラムとして実行して処理します。
crates/geo mdm-geo ダウンロード サーバーの場所 (#140): DB-IP の Lite データ (tools/geo/build.py) から構築された IP-国範囲テーブルをこのコンピューターでのみ検索し、国の旗を表示します。
crates/tools mdm-tools yt-dlp と ffmpeg による動画ページの処理、gallery-dl による画像ギャラリーの処理 (それぞれ別のプログラムとして実行)。ネットワークアダプターが選択されている間、これらの接続は 127.0.0.1 上にある DDM のプロキシを経由し、そのアダプターを使用します (relay.rs)
crates/crash mdm-crash クラッシュおよびフリーズレポート: モニタープロセス、プロセス外ミニダンプ、シンボル化されたスタック、レポートテキスト、リリースログ (crash-reports.md)
crates/torrent mdm-torrent librqbitによるBitTorrentおよびマグネットリンク
crates/labserver mdm-labserver リクエストログと障害注入機能を備えたHTTP Rangeサーバー、および独自の障害を備えたFTP/FTPSサーバー (テストおよびベンチマーク用)
extension/ — Chromium (MV3) およびFirefox拡張機能
docs/ — ユーザーガイドとチュートリアル、このファイル、ベンチマークデータ。ウェブサイトはガイドをヘルプページとしており、ヘルプで開きます
website/ — dannex.kavangi.co.ke のページ (ホーム、ダウンロード、機能、テーマ、FAQ)。tools/website/build.py が docs/ のヘルプと CHANGELOG のニュースを 22 言語で追加し、GitHub Pages が公開します。

依存関係は内側を指します。app、cli、mcp、nmhost、remote は engine と ipc を使用します。エンジンはUIについて何も知りません。アプリは、イベント(進行状況、セグメント テーブルのスナップショット、完了、失敗)を通じてのみエンジンを認識します。

エンジン

Download
 ├─ probe()              size, resumable?, validators (ETag / Last-Modified), file name
 ├─ Planner (pure)       segment table: when a connection is free, the largest remaining
 │                       part is split in half (planner.rs, tested by random simulation)
 ├─ Worker × N           one HTTP/1.1 connection each, reused across segments; slow ones
 │                       are dropped and their part re-split
 │    └─ writes at its offset into <name>.mdm.part (created sparse)
 ├─ HostLimits           learns how many connections each server accepts
 ├─ Limiter (shared)     per-download and global token buckets
 ├─ State                segment table saved atomically (craft-atomic) for crash-safe resume
 └─ events → channel     Progress, Done, Failed

すべてのセグメントが完了すると、部分ファイルは期待されるサイズと照合され、所定の場所に名前が変更されます。ファイルの作成日はサーバーの作成日に従うことができます。

ダウンロードの最初のリクエスト (get) は、リダイレクトや、ファイルに直接つながるページ (待機ページの更新) に従います。リンクがファイルの直接のアドレスではないサイトには、sites/ にモジュールがあります (Google Drive: sites/gdrive.rs)。これはリンクをファイルのアドレスに変換し、サイト自身のページ (確認フォーム、エラーページ) を読み取り、拒否理由に名前を付けます (Error::Refused)。これらはネットワークなしでテストされた純粋な関数です。ラボサーバーは、エンドツーエンドテスト (labserver/src/drive.rs) のために、実際のホスト名でそのようなサイトをシミュレートします。

FTP と FTPS (ftp.rs) は、同じプランナー、ワーカー、状態管理を使用します。セグメントは、範囲指定した GET の代わりに制御セッション上で REST + RETR を使用し、SIZE と MDTM がヘッダーの役割を果たします。セッションはダウンロードごとにプールされ、セグメント間で再利用されます。

アプリ

固定ピクセル座標に描画された egui ウィンドウが 1 つと、ダイアログごとに即時ビューポートが 1 つあります。app.rs は状態 (ダウンロード、キュー、設定、リストの選択) を保持し、メニュー、ツールバー、キー、IPC コマンドをアクションに変換します。各ダイアログは独自のモジュールであり、Outcome (開いている、閉じている、値で完了) を返します。Windows 専用の呼び出しは win32.rs に限定され、Linux および macOS の対応する呼び出しは unix.rs に限定されます (セッション、ブラウザーのホスト、サウンド、フォルダーに表示、クラッシュ ハンドラーから開始)。その他のすべてのファイルは安全でポータブルな Rust です。フォントはシステムから取得されます: Windows の Fonts フォルダー、macOS のシステム フォント、Linux の fontconfig (theme.rs)。Windows では、ラテン文字、ギリシャ文字、キリル文字のテキストは DirectWrite (win32.rs、egui のグリフ ラスタライザー フックを介して) によって描画されます: [表示]→[テキスト]→[スムーズ]は自然なモードで、要求されたサイズでアンチエイリアスされ、フォント独自の進みで 4 分の 1 ピクセルに配置されます。[クラシック](既定) は GDI クラシック モードで、各文字のヒント付き形状と全ピクセル幅が結合されます。その他のスクリプトは egui によって整形および描画されます。

テーマ

コントロールの描画に使用されるすべての色とサイズは、アクティブなテーマ (#45) から取得されます。テーマは、ライトとダークのパレット、メトリック、コントロール スタイル、アイコン スタイル (palette.rs) で構成されます。

  • パレットの役割。 palette.rs は、安定したキー ("button.hot"、"list.row"、"caption"…)、説明、クラシックな外観のライトとダークの値を明示的に記述して、各役割を宣言します (クラシックな外観は派生しません)。共有ペインター (winui.rs、chrome.rs、list.rs、scrollbar.rs) は theme::colors() と theme::metrics() を介してそれらを読み取り、各コントロールの状態を決定します。描画コードは独自の色を保持しません。
  • 派生パレット。 derive.rs は、いくつかのシード (背景、表面、テキスト、アクセントなど) から完全なパレットを作成し、OKLab で他のすべての役割を混合し、WCAG コントラスト (テキストは 4.5:1、エッジは 3:1) を維持します。ハイ コントラストは、すべてのエッジをさらに強調します。native.rs は、システムのアクセントとコントラスト (Windows の設定、Linux の freedesktop ポータル、macOS のアクセント) からネイティブ テーマをシードします。
  • コントロール スタイル。 palette::Controls は各コントロールの形状 (テキスト ボックス、チェック ボックス、ボタン、進行状況バー、スクロール バー、フォーカス マーク、タイトル バー) を指定します。スタイル テーマ (メトロ、Adwaita、Breeze、Luna、Aero、Aqua、Emerald) はそれらを選択し、Windows では DDM がタイトル バー自体を描画します (caption.* の役割)。
  • テーマ ファイル。 themefile.rs は、データ フォルダーの themes から TOML または JSON を読み取ります (1 つのファイル、またはアイコンが隣接する <id>/theme.toml)。ファイルは変更する内容のみに名前を付けます。残りは inherits するテーマ (組み込みの ID または別のファイル、デフォルトではクラシックな外観) から取得され、サイクルが拒否されるチェーンをたどります。不明なキーはエラーではなく警告です。組み込みのスタイル テーマも、プログラムに含まれるそのようなファイルです (crates/app/assets/themes)。
  • アイコン セット。 themeicons.rs は、クラシックな外観が独自のアイコンを描画する場所に、テーマのアイコン (用途別に名前が付けられています: tb-add-url、cat-music…、16、24、32、48 px の SVG または PNG、テキストの色でインク付けされた -symbolic) を描画します。セットに不足している要件はクラシック アイコンを保持します。
  • ツールバー アイコンのスタイル。表示 → ツールバー → ライン スタイル (線画で、色はテーマに従います) または 3D スタイル: DDM 独自の光沢のある絵です (assets/icons/toolbar3d。tools/icon/toolbar_3d.py が 16 ~ 64 px で描き、画面上のサイズに合うものを使います。無効のときは icons.rs でグレーにします)。テーマがボタン用の独自のアイコンを持たず、アイコンを自身の色で描く場合に適用されます。アイコン セットを持つテーマや、アイコンを 1 色で描くテーマ (ハイ コントラスト) では、そのテーマのアイコンが使われます。

ウィンドウがコントロールを配置する場所はレイアウトのままです。ファイル名の前のアイコン (fileicons.rs) も同様です。Windows シェルのシステム イメージ リスト、macOS Finder (NSWorkspace)、Linux デスクトップのアイコン テーマ (xdgicons.rs、shared-mime-info、Icon Theme Specification)。各タイプは、ピクセル サイズごとに 1 回、バックグラウンド スレッドで検索されます。Tango のアイコン (バンドルされています) は、システムのアイコンが準備できるまで、またシステムにアイコンがない場所では常に表示されます。

描画

ウィンドウは OpenGL (eframe の glow) または eframe の wgpu を介してシステムのグラフィック API で描画され、そのバックエンドのみを使用します。Windows では Direct3D 12 (デフォルト)、Linux では Vulkan、macOS では Metal (選択肢があります。OpenGL は、実際のグラフィック カードがそれらを試すまでデフォルトのままです、#206)。表示 → 描画方法 で 1 つを選択し、次回の起動から適用されます。1 つのコード パスがすべてのシステムでこれを実行します (crates/app/src/renderer.rs)。選択したものが起動できない場合、もう 1 つが試行されるため、ウィンドウは常に開きます。システムの API で監視された起動は、最初のフレームが描画されるまでマーカーを残します。それより前に終了する起動 (ドライバー内のクラッシュ)、最初のフレームが 10 秒以内に表示されない起動 (DDM は OpenGL で再起動します)、または 10 分以内にグラフィック カードが 2 回失われた場合は、その理由が記憶され、メニューに表示されます。

表示 → インターフェイスのサイズ (scale.rs、#262) は、ディスプレイ自体のスケールに対する egui のズーム係数です。すべてのウィンドウはポイントでレイアウトされるため、その分だけ大きく開きます。画面より大きい場合はスクロールします。

データ

ダウンロード リストと設定は、データ フォルダー (downloads.json) にアトミックに保存されます。Windows では %APPDATA%\dannexdownloadmanager\、Linux では ~/.local/share/dannexdownloadmanager、macOS では ~/Library/Application Support/dannexdownloadmanager、ポータブル コピーの横にある data フォルダー、または MDM_DATA_DIR (mdm_ipc::data_dir) です。ブラウザー ホストはキャプチャ ルールに同じファイルを読み取るため、オプションでの変更は次回のキャプチャされたダウンロードに適用されます。

サインイン シークレット (デブリッド アカウント、サイトのログイン、プロキシのパスワード) はシステムのキーチェーン (secrets.rs、#44) に保存されます。Windows 資格情報マネージャー (win32.rs)、Linux の Secret Service、または macOS のキーチェーン (unix.rs) です。設定は、キーチェーンがシークレットを確認した後にのみ書き込まれる keychain:<service>/<scope>/<key> 参照をその場所に保持します。キーチェーンがない場合 (または DDM のためにロック解除されていないロックされたキーチェーンの場合)、シークレットは以前と同様に設定に保持されます。

ダウンロードのサーバーの場所 (#140) は、接続したアドレスの国であり、このコンピューターの mdm-geo のテーブルで検索されます (インターフェイス言語では countries.rs と表示されます)。リリース ジョブは、その月のデータからテーブルを再構築します (tools/geo/build.py --release)。

ブラウザ連携

page ──► extension ──native messaging──► mdm-nmhost ──ipc──► app

拡張機能は、ホストにどのファイル タイプを受け入れるかを尋ね、それらに対して各ダウンロードをチェックし、アプリがそれを受け入れた後にのみブラウザーのダウンロードをキャンセルします。そうでない場合、ブラウザーはそれを保持し、拡張機能はその理由を伝えます。

同じ応答には、オプション → 全般のキー (keys: page.js がクリックを保持するキー。リンクをブラウザーに任せるか、アプリに強制するかを決めます) と、表示する右クリック項目 (menu: 変更されると background.js がメニューを作り直します) も含まれます。動画ボタンを表示してよいかの応答には、ダウンロード パネルの設定 (panel: 動画やサウンド プレーヤーの上、最短の長さ、最初の隅) が含まれます。名前と既定値は mdm_ipc::capture のもので、アプリが保存する設定から読み取ります。拡張機能は、ブラウザーのウィンドウにフォーカスが戻ったとき (前回の問い合わせから数秒後)、ページが開始したとき (15 秒)、ダウンロードのとき (1 分) に、あらためて問い合わせます。

ツールバー ポップアップのダウンロード リスト (一時停止、再開、フォルダーを開く) とボタンの数字は、オートメーション API の list とアクションで、browser を付けてホスト経由で問い合わせます。アプリは、API のスイッチにかかわらずこれらに応答し、動画ボタンの画質メニューにも同様に応答します。ホストがそのためにアプリを起動することはありません。拡張機能が問い合わせるのは、ポップアップを開いているときか、ダウンロードの実行中だけです。

ホストは DDM 独自の拡張機能のみを提供します。その ID は mdm_ipc::extension (crates/ipc/src/extension.rs) の 1 か所にあります。展開されたコピーの ID (UNPACKED_ID、マニフェストの公開キーから)、Chrome ウェブストアの ID (STORE_ID、ストア独自のキーで署名されています。pack.ps1 はマニフェストのキーをストアのコピーから除外します)、Firefox アドオンの ID (FIREFOX_ID) とその addons.mozilla.org ページです。Edge と Opera ストアの ID はプレースホルダーであり、拡張機能がそこにリストされるまで提供されません。ホストはこれらの ID で各ブラウザーのマニフェストを書き込み、アプリは展開されたコピーの前にストアのコピー (Chrome に追加、Firefox に追加) を提供します。

リモート コントロール

phone ──HTTPS (paired token)──► mdm-remote ──ipc::Sink──► app (answer, remote_add)

--headless(headless.rs、#157) は、eframe なしで同じ App を実行します。ループは、コマンド チャネルによって起動されるベア egui::Context でその tick (すべてのフレームで logic が実行するもの) を呼び出し、その ui は呼び出しません。コマンドはリモート コントロールが追加するのと同じように追加されます (ウィンドウなし)。Dockerfile と docker/ (Compose、Unraid のテンプレート) は、サーバー (server.md) でそれを実行します。

サーバーはアプリのTokioランタイム上で実行され、ローカル ネットワーク アドレスごとに1つのリスナーがあります。各リクエストはチェックされ(Host、Origin、トークン)、remote とマークされた mdm_ipc::Command(リクエスト行で設定できないフィールド)に変換され、コマンド ラインと同じチャネルを通じてアプリに渡されます。アプリは、自動化APIに回答するのと同じように、次のフレームでそれに回答します。そのページは crates/remote/web で構築され、そのテキストはアプリのカタログ(remote.rs)から取得されます。

翻訳

UI が表示するすべてのテキストは crate::i18n (craft-i18n カタログ、i18n/<locale>.tsv) を通過します。tools/i18n/extract.py は、ソースから i18n/en.tsv を再構築し、各テキストに翻訳者向けのメモ (内容、表示場所、プレースホルダー) を付けます。tools/i18n/translate.py は、各言語のスタイル ガイド (i18n/style/) と用語集に従って、他のカタログに不足しているもの (行は #, machine とマークされています) を埋めます。人がレビューした行は決して置き換えられず、CI (reviewed_guard.py) は、その行を削除する変更を失敗させます。ウェブサイトには独自のカタログがあります (i18n/site/、tools/website/translate_site.py)。

画像

アプリのアイコンは図形から描画されます (tools/icon/dannex_logo.py。build_icon.py が 16 ~ 48 px のすべてのサイズを、整数ピクセルに合わせて手作業で配置して書き出します)。アイコンを表示する場所ではすべて、画面上のサイズに合う絵を使います (logo.rs)。Windows では、各ウィンドウのタイトル バーとタスク バーのアイコンを、そのディスプレイのスケールに合わせ (win32::crisp_icons。別のディスプレイに移してもそのまま保たれます)、トレイのアイコンはタスク バーのスケールに合わせます。表示 → DDM 通知領域アイコンでは、フルカラー (3D スタイル) か、タスク バーの色によるマークだけ (フラット スタイル: 暗いタスク バーでは白、明るいタスク バーでは暗い色。macOS ではテンプレート イメージ) を選べ、ダウンロード中は下端に細いバーが表示されます。

ヘルプ ページの画像 (docs/images/help/) は、1 つのリスト tools/shots/shots.toml から取得されます。tools/shots/make.py は、DDM 独自の /show <window> コマンド ラインを介して、画面外のテスト インスタンスで各ウィンドウを開き、ウィンドウのアクセシビリティ ツリーからトリミングと注釈を付け、ロスレス WebP を書き込みます。make.py check (CI) は、リスト、ページ、ファイルを同期させます。公開されたものは GitHub の Windows ランナー (docs-shots.yml) で取得されます。

協力者

tools/contributors.pyGitHub の公開 API から、プルリクエストやイシューをオープンしたユーザー、コメントしたユーザーを読み込みます (メンテナー、Claude、ボットは除外)。これは、ウェブサイトのホーム ページ、/contributors.html、ニュース ページの各リリース (build.py、すべてのビルド)、各リリースのノート (release.yml、前回のリリース以降に活動したユーザー)、および README (python tools/contributors.py readme、各リリースの準備時。GitHub では README 内の画像を丸くできないため、丸い写真は art/contributors/ にコミットされています) など、貢献者に感謝するすべての場所で使用されます。

テストとベンチマーク

cargo testmdm-labserverを対象に、接続が遅い場合や、切断・拒否される場合、範囲リクエストに対応していないサーバー、変更されるファイルなどの障害を注入して、単体テストとエンドツーエンドのダウンロードテストを実行します。tools/benchは公開されている速度比較を実行します。生データはdocs/bench/にあります。

ウィンドウのフレームは、推測ではなく実測します (crates/app/src/framestats.rs)。MDM_FRAME_STATS=1 は 1 秒ごとに、メイン ウィンドウの描画の回数、そのうち入力によるものの数、かかった時間 (メイン ウィンドウ、進行状況ウィンドウ、そのレイアウト)、それ以外を要求したコードの行をログに記録します。MDM_SYNTHETIC_LIST=10000 (作業用の MDM_DATA_DIR と組み合わせて) は、その数だけ架空の行を追加します。MDM_BENCH_SCROLL=10 は 10 秒間リストを自動でスクロールし、フレームの時間をログに記録します。アイドル中のウィンドウは、時計の分 (2 秒に 1 回) のほかはフレームを描画せず、リストは表示中の行だけを作ります。

無料、オープンソース、広告なし、試用期間なし。

Dannex Download Managerをダウンロード