設定概要

Alius はプロジェクト設定を .alius/config/ に保存します。各ファイルは特定の設定ドメインを扱い、TUI の埋め込み /config、/model、/init コマンドでインタラクティブに管理するか、ファイルを直接編集できます。

ファイル目的
config.tomlメイン設定 — ランタイムメタデータ、デフォルトモデル/プロバイダー、UI、セッション、ログ
providers.tomlプロバイダー定義、互換ルーティング層、ローカルモデルライブラリ、Base URL と API Key
model.tomlPlan/Execute/Review 3ロールモデル割り当て
soul.tomlAgent アイデンティティ（Agent Card 互換設定）
tools.toml内蔵/MCP/プラグイン/ワークフローツール、タイムアウト、確認、登録設定
permissions.tomlファイルシステム、シェル、ネットワーク、メモリ、プロジェクトドキュメント、リモート A2A 権限
protocol.tomlプロトコルインターフェースの有効化とイベント/コマンド設定
mcp.jsonMCP サーバー宣言

初期化の進捗は .alius/runtime/init-state.toml に保存され（設定ファイルとは別）、設定ファイルの一部ではありません。

プロバイダー設定

providers.toml は最も重要な設定ファイルの一つで、プロバイダー定義、互換ルーティング層、ローカルモデルライブラリを含みます。

内蔵プロバイダー

Alius には以下のプロバイダーが内蔵されています：

プロバイダー IDプロダクトラベルOpenAI 互換 Base URLAnthropic 互換 Base URL
bigmodelBigModel GLM（Zhipu Coding Plan）https://open.bigmodel.cn/api/coding/paas/v4https://open.bigmodel.cn/api/anthropic
xiaomi_mimoXiaomi MiMo（Token Plan）https://api.xiaomimimo.com/v1https://api.xiaomimimo.com/anthropic
deepseekDeepSeekhttps://api.deepseek.comhttps://api.deepseek.com/anthropic

プロバイダー設定構造

[router]
strategy = "tier"
default = "medium"

[tiers.light]        # Plan Model 層
model = "glm-4-flash"
provider = "bigmodel"

[tiers.medium]       # Execute Model 層
model = "glm-4-plus"
provider = "bigmodel"

[tiers.high]         # Review Model 層
model = "glm-4"
provider = "bigmodel"

[providers.bigmodel]
kind = "openai"
base_url = "https://open.bigmodel.cn/api/coding/paas/v4"
api_key_env = "BIGMODEL_API_KEY"
enabled = true

ローカルモデルライブラリ

providers.toml の [[model_library.models]] セクションはプロジェクトレベルのモデルエントリを保存し、/model で管理、/config で割り当てます。

各モデルエントリの内容：

フィールド説明
id安定したエントリ ID、通常プロバイダーとモデル名から派生
display_nameユーザー向けのモデルラベル
provider[providers.<name>] に一致するプロバイダー識別子
base_urlこのモデルエントリが使用する Base URL
model_nameランタイムに送信されるプロバイダーネイティブのモデル ID
reasoning_note互換性の注記
enabledこのエントリが選択可能かどうか

例：

[[model_library.models]]
id = "bigmodel_glm-4-flash"
display_name = "GLM-4-Flash"
provider = "bigmodel"
base_url = "https://open.bigmodel.cn/api/coding/paas/v4"
model_name = "glm-4-flash"
enabled = true

モデル割り当て

model.toml は3ロールモデル割り当てアーキテクチャを保存します：

schema_version = 1

[assignment]
plan = "bigmodel_glm-4-flash"      # Plan Model
execute = "bigmodel_glm-4-plus"     # Execute Model
review = "bigmodel_glm-4"          # Review Model
ロール説明互換マッピング
Plan Model目標理解とプラン生成に使用tiers.light
Execute Modelプラン実行とツール呼び出しに使用tiers.medium + アクティブレガシモデル
Review Model結果レビューと品質評価に使用tiers.high + レガシー review_model

/config は有効なローカルモデルライブラリエントリからのみロールを割り当てます。割り当てフローでのモデル名、Base URL、API Key の手動入力は許可されていません。

API Key の管理

API Key は以下の方法で提供されます：

  1. 環境変数（推奨）— プロバイダー設定で api_key_env を指定（例：BIGMODEL_API_KEY）
  2. インタラクティブ入力 — /model または /init の追加フローで直接入力（プレーンテキスト、貼り付け対応）

保存後、API Key はセッション出力やモデル詳細には表示されません。/init でのモデル取得が成功すると、API Key はアクティブなランタイム設定にも書き込まれ、バイパス/チャットモードで api_key が不足していると報告されないようにします。

設定の変更

インタラクティブ設定

ワークスペース内でスラッシュコマンドを使用：

/config          # 設定センターを開く（モデル/言語/Soul）
/model           # モデルプールマネージャーを開く
/init            # 初期化ウィザードを再実行

すべての設定操作は即時反映され、保存ボタンは不要です。

コマンドライン

alius config show        # 現在の設定を表示
alius config validate    # 設定の整合性を検証
alius config credential  # 認証情報を管理

グローバルパラメータ

alius --model gpt-4o-mini --provider openai

設定の読み込み

Alius の設定読み込みプロセス：

  1. 現在のディレクトリから上方向に .alius/ を検索してプロジェクトルートを発見
  2. .alius/config/ から設定ファイルを読み込み
  3. 不足ファイルはデフォルト値を使用
  4. ProjectConfigSnapshot を生成
  5. ランタイムビュー RuntimeConfigView を構築（プロバイダー、ツール、権限、Shell Gate、ログ、セッション、Soul 設定を含む）

セキュリティノート

  • API Key は環境変数を通じて参照され、設定ファイルにプレーンテキストで保存されることはありません
  • config show コマンドは機密値をマスクします
  • ファイル書き込みとシェル操作は permissions.toml と Shell Gate で制御されます