CLI・ポート・環境変数
エントリポイント一覧
| コマンド | 役割 | 常駐性 |
|---|---|---|
gui.py | WebUI バックエンド ＋ プロセス監視 | 常駐 |
alas.py | 単一インスタンススケジューラー | 常駐（インスタンス実行中） |
tui.py | ターミナル操作画面 | 対話的 |
mcp_server_sse.py | 独立 MCP SSE サービス | 常駐 |
gui.py
bash
uv run python gui.py [options]| オプション | 役割 | デフォルト値 |
|---|---|---|
--host | リッスンアドレス | deploy.yaml の WebuiHost（未設定時は 0.0.0.0） |
-p, --port | リッスンポート | WebuiPort（未設定時は 25548） |
-k, --key | 認証パスワード | deploy.yaml の Password |
--ssl-key | HTTPS 秘密鍵 | なし |
--ssl-cert | HTTPS 証明書 | なし |
--run <实例...> | 起動と同時に指定インスタンスを実行 | なし |
--electron | Electron クライアントからの実行フラグ | 無効 |
--cdn | 廃止済み | — |
実行例：
bash
uv run python gui.py --host 127.0.0.1 -p 25548 -k "your-password"
uv run python gui.py --ssl-key key.pem --ssl-cert cert.pemポート番号の決定優先度
コマンドライン引数 > deploy.yaml > ソースコードのデフォルト値。ポート変更が反映されない場合は、デプロイ設定等で上書きされていないか確認してください。
alas.py
bash
uv run python alas.py [实例名]| 動作 | 詳細 |
|---|---|
| インスタンス名省略時 | デフォルトの ap を使用 |
| 存在しないインスタンス名 | 終了コード 2 で即時終了（デフォルトへの自動フォールバックは行いません） |
| 停止方法 | プロセスの終了。停止制御ファイルや専用シグナルは非提供 |
| 作業ディレクトリ | module/logger.py インポート時に自動的にプロジェクトルートへ変更 |
外部スケジューラー連携規約はスケジューラーのライフサイクルを参照してください。
tui.py
ターミナルベースの UI です。コアプログラムの設定およびデバイス接続レイヤーを共有し、ブラウザのない環境や状態のクイック確認に適しています。
mcp_server_sse.py
bash
uv run python mcp_server_sse.pyデフォルトでポート 22268 を使用します。OCR サービスとポートが重複しているため、同一マシンで併用する場合はどちらか一方を変更してください。
使用ポート一覧
| ポート | 用途 | 設定変更の可否 |
|---|---|---|
25548 | WebUI / WS | ✅ WebuiPort |
22267 | 启动器 WebUI | 启动器内部 |
22268 | 独立 MCP / OCR サービス | ✅ OcrServerPort で変更可能 |
22302 | Android OCR | Android 内部制御 |
22300 / 22400 | レガシーホストプロセス検出 | ❌ 変更不可 |
環境変数一覧
| 環境変数名 | 役割 | デフォルト値 |
|---|---|---|
ALAS_DEBUG_SERVER | 1 に設定時、ローカル限定のデバッグサービスを起動 | 無効 |
AZURPILOT_OCR_THREADS | OCR セッションの intra-op スレッド数上限（1〜16） | 自動 |
AZURPILOT_ANDROID | 1 に設定時、/android/* ルーティングを登録 | 無効 |
ALAS_LAUNCHER_PID | ランチャーが注入。子プロセスの所属を識別 | なし |
ALAS_LAUNCHER_JOB_BREAKAWAY | ランチャーが注入。Windows Job Object からの脱離を宣言 | なし |
ALAS_WEBUI_TRUST_SECRET | ランチャーが注入するワンタイムログイン認証トークン | なし |
AZURPILOT_ANDROID_DIST_BASE | 旧版 Android 事前ビルドフロントエンドのダウンロード基点 URL | なし |
AZURPILOT_ANDROID_GIT_MIRROR | Android GitHub フォールバックミラーのプレフィックス | なし |
AZURPILOT_REPO / AZURPILOT_REF | Android Runtime ビルド時のソースコード参照先 | なし |
ランチャー内部用環境変数の手動設定禁止
ALAS_LAUNCHER_PID を手動で設定すると、意図しないプロセススキャンクリーンアップに巻き込まれる恐れがあります。また、ALAS_WEBUI_TRUST_SECRET はパスワードレス認証トークンであるため、手動指定はセキュリティ境界を破壊します。
主要ディレクトリとパス
| パス | 内容 | 削除の可否 |
|---|---|---|
config/ | インスタンス設定、deploy.yaml、remote-access.json | ❌ 削除不可 |
azurpilot.db | 統計ログおよび永続化データ | ❌ 削除不可 |
log/ | 実行ログおよびエラー画面記録 | トラブルシューティング完了後に削除可 |
cache/ | ランタイムキャッシュ | ✅ 削除可 |
AzurPilot_Data_Backup/ | 日次自動バックアップ | 保持ポリシーに従い管理 |
.venv/ | Python 仮想環境 | 再構築可能 |
frontend/dist | フロントエンドビルド成果物 | 再構築可能 |
データディレクトリの実際のパスは実行形態により決定されます。Android Runtime では rootfs 内の /opt/azurpilot に配置されます。
プロセス終了ステータスのセマンティクス
gui.py の監視ループは以下の終了事由を識別します：
| 終了種別 | トリガー要因 |
|---|---|
| アップデート終了 | stop_event セット後にワーカーが正常終了 |
| 設定・初期化エラー | 起動フェーズで即時失敗（自動再起動は抑止） |
| 敏感任务停止 | 调度器 exit(1)，父进程感知 |
| ユーザー手動停止 | WebUI の停止操作によりプロセスツリーを終了 |
詳細な終了コードマッピングは module/runtime/process_manager.py および gui.py の監視ループの実装を参照してください。
ドキュメントサイト管理コマンド
| コマンド | 役割 |
|---|---|
npm run dev | ローカル開発サーバー起動 |
npm run build | docs/.vitepress/dist への静的ビルド |
npm run preview | ビルド成果物のローカルプレビュー |
npm run check | リンク・ナビゲーション・SEO 検証 |
npm run test:e2e | Playwright によるブラウザ E2E 検証 |
npm run shots | 複数ブレークポイントでの画面キャプチャ検査 |