使用方法

886字程度約3分

この文書は機械翻訳です。もし可能であれば、中国語の文書を読んでください。もし誤りや修正の提案があれば、大変ありがたく思います。

maa-cli の主な機能は、MaaCore を呼び出してアークナイツのゲームタスクを自動化することです。さらに、利便性のために MaaCore を管理する機能も提供しています。

ヒント

Windows のパッケージマネージャー（winget）で maa-cli をインストールした場合、以下のコマンドの maa は maa-cli に置き換えてください。

MaaCore の管理

maa-cli は MaaCore とリソースをインストールおよび更新できます。以下のコマンドを実行するだけです：

maa install # MaaCore とリソースをインストール
maa update # MaaCore とリソースを更新

maa-cli 自身の更新

maa-cli は自身を更新できます。以下のコマンドを実行するだけです：

maa self update

注意：パッケージマネージャーで maa-cli をインストールしたユーザーは、パッケージマネージャーで maa-cli を更新してください。このコマンドはそのようなユーザーには機能しません。

デフォルトでは、選択したチャンネルのバージョンが現在のバージョンより新しい場合にのみ更新されます。現在のバージョンより古い場合でも選択したチャンネルのバージョンをインストールしたい場合（例: nightly から stable へ戻す場合）は、--force を付けてください。バージョンが同じ場合はスキップされます：

maa self update stable --force

タスクの実行

MaaCore のインストールと設定が完了したら、タスクを実行できます。maa-cli は、定義済みタスクとカスタムタスクの 2 種類のタスクをサポートしています。

定義済みタスク

一般的なタスクについて、maa-cli はいくつかの定義済みタスクを提供しています：

maa startup [client]: ゲームを起動してメイン画面に入ります。[client] はクライアントタイプで、空欄の場合はゲームクライアントを起動しません。
maa closedown [client]: ゲームクライアントを終了します。[client] はクライアントタイプで、デフォルトは Official です。
maa fight [stage]: 戦闘タスクを実行します。[stage] はステージ名（例：1-7）で、空欄の場合は前回または現在のステージが選択されます。
maa copilot <maa_uri>...: 作業を自動実行します。<maa_uri> は作業の URI で、複数の URI は順番に実行されます。maa_uri には maa://1234 またはローカルファイルパス ./1234.json を指定できます。
maa sscopilot <maa_uri>: 保全駐在を自動実行します。<maa_uri> は保全駐在作業の URI です。
maa paradoxcopilot <maa_uri>...: 逆理演算を自動実行します。<maa_uri> は逆理演算の作業 URI で、複数の URI は順番に実行されます。
maa roguelike <theme>: 自動ローグを実行します。<theme> はローグのテーマで、Phantom、Mizuki、Sami、Sarkaz、JieGarden から選択できます。
maa reclamation <theme>: 生息演算を自動実行します。<theme> は生息演算のテーマで、現在は Tales テーマのみ利用可能です。

これらのタスクはいくつかのパラメータを受け付けます。maa <task> --help で具体的なパラメータを確認できます。

公式サーバーのプレイヤーが、ゲームを起動し、理性剤を 3 つ使用して BB-7 を周回し、その後ゲームを終了したい場合は、以下のコマンドを実行します：

maa startup Official && maa fight BB-7 -m 3 && maa closedown

MAA がサポートするタスクは多岐にわたるため、maa-cli がすべてのタスクの定義済みオプションを提供することはできません。それに加えて、上記の例のように複数のタスクを実行したい場合もあるでしょう。この問題を解決するため、maa-cli はカスタムタスクの機能を提供しています。カスタムタスクは異なるタスクを組み合わせることができ、各タスクのパラメータと実行順序をより細かく制御できます。さらに、カスタムタスクは条件判定をサポートしており、条件に応じて特定のタスクを実行するかどうか、またはどのパラメータで実行するかを決定できます。これは日常タスクの自動化に活用できます。カスタムタスクは設定ファイルで定義されます。設定ファイルの配置場所と記述方法の詳細はカスタムタスクドキュメントを参照してください。設定ファイルを作成した後、maa run <task> でカスタムタスクを実行できます。ここでの <task> はカスタムタスクファイル名で、拡張子は含みません。

タスクサマリー

定義済みタスクとカスタムタスクのいずれの場合も、maa-cli はタスク実行終了後にタスクのサマリー情報を出力します。これには各サブタスクの実行時間（開始時刻、終了時刻、実行時間）が含まれます。一部のタスクでは、タスクの結果概要も出力されます：

fight タスク：ステージ名、回数、消費した理性剤の数、ドロップ統計。
infrast：各施設に配置されたオペレーター。製造所と貿易所では、産物タイプも含まれます。
recruit：各公開求人のタグ、星数、状態、および合計募集回数。
roguelike：探索回数、投資回数。

タスクサマリーが不要な場合は、--no-summary パラメータで無効化できます。

タスクログ

maa-cli はログを出力します。ログレベルは低い順に Error、Warn、Info、Debug、Trace で、デフォルトのログレベルは Warn です。ログレベルは環境変数 MAA_LOG で設定できます（例：MAA_LOG=debug）。-v または -q でログレベルを上げたり下げたりすることもできます。

maa-cli はデフォルトで標準エラー出力（stderr）にログを出力します。--log-file オプションを指定するとログをファイルに出力でき、ログは $(maa dir log)/YYYY/MM/DD/HH:MM:SS.log に保存されます。$(maa dir log) はログディレクトリで、maa dir log で取得できます。--log-file=path/to/log でログファイルのパスを指定することもできます。

デフォルトでは、出力されるすべてのログにタイムスタンプとログレベルのプレフィックスが付きます。この動作は環境変数 MAA_LOG_PREFIX で変更できます。Always に設定すると常にプレフィックスが付き、Auto に設定するとログファイルへの出力時にはプレフィックスが付きますが、stderr への出力時には付きません。Never に設定すると、ログファイルへの書き込み時であってもプレフィックスは付きません。

その他のサブコマンド

上記のコマンドのほか、maa-cli には次のサブコマンドもあります：

maa list: 利用可能なすべてのタスクを一覧表示します。
maa hot-update: ホットアップデートリソースを手動で更新します。基本リソースは引き続き MaaCore と一緒にインストールする必要があります。
maa remainder <divisor>: 当日の DayMod 条件で使用するオフセット値を取得します。--timezone オプションでタイムゾーンを指定できます。
maa dir <dir>: 特定のディレクトリのパスを取得します。たとえば maa dir config で設定ディレクトリのパスを取得できます。
maa version: maa-cli と MaaCore のバージョン情報を取得します。
maa convert <input> [output]: JSON、YAML、TOML 形式のファイルを他の形式に変換します。
maa complete <shell>: 自動補完スクリプトを生成します。
maa activity [client]: ゲームの現在のイベント情報を取得します。client はクライアントタイプで、デフォルトは Official です。
maa cleanup: maa-cli と MaaCore のキャッシュを削除します。
maa import <file> [-t <type>]:: 設定ファイルをインポートします。file は設定ファイルのパスです。-t オプションで設定ファイルのタイプ（cli、profile、infrast など）を指定できます。

その他のコマンドの使用方法は maa help で、個々のコマンドの使用方法は maa help <command> で確認できます。