デフォルト作業ディレクトリの構成

Commanderは環境変数とコマンドラインパラメータを介した作業ディレクトリの柔軟な構成をサポートしており、XDGベースディレクトリ仕様にも完全対応しています。

本ページは現在作成中です。以下は機械翻訳となります。

概要

デフォルトでは、Commander はその構成およびログファイルを次に保存します ~/.keeper。システム全体の構成には環境変数を、セッション固有の上書きにはコマンドラインパラメータを使用してこの場所をカスタマイズできます。

サポートされている方法

コマンドラインパラメータ

使用法 --data-dir を使用して特定のセッションの作業ディレクトリを上書きします。

keeper shell --data-dir /tmp/keeper-session
# 使用先: /tmp/keeper-session/.keeper/

環境変数

KEEPER_DATA_HOME

すべてのセッションに対して Commander のカスタムデータディレクトリを設定します。

export KEEPER_DATA_HOME="/opt/keeper-data"
keeper shell
# 使用先: /opt/keeper-data/.keeper/

XDG_DATA_HOME(XDG準拠)

整理されたユーザーデータのために XDG ベースディレクトリ仕様に従います。

export XDG_DATA_HOME="$HOME/.local/share"
keeper shell
# 使用先: $HOME/.local/share/.keeper/

優先順位の順序

Commander は以下の優先順位(高い順から低い順)で作業ディレクトリを決定します:

  1. CLI パラメータ - --data-dir フラグ

  2. KEEPER_DATA_HOME - 環境変数

  3. XDG_DATA_HOME - XDG ベースディレクトリ仕様

  4. 既定値 - ~/.keeper (レガシー互換性)

スマートパス処理

Commander は必要に応じて自動的に .keeper をパスに付加します:

自動付加の動作

  • 入力: /Users/john → 出力: /Users/john/.keeper

  • 入力: /Users/john/.keeper → 出力: /Users/john/.keeper (変更なし)

これは CLI パラメータと KEEPER_DATA_HOME 環境変数の両方に適用されます。

XDG 準拠

使用時には XDG_DATA_HOME、Commander は常に .keeper:

  • XDG_DATA_HOME=/opt/data → 使用先 /opt/data/.keeper

使用例

基本的な環境変数の設定

# カスタムデータディレクトリを設定
export KEEPER_DATA_HOME="/opt/keeper"
keeper shell
# config.json の保存先: /opt/keeper/.keeper/

XDG ベースディレクトリ準拠

# XDG 仕様に従う
export XDG_DATA_HOME="$HOME/.local/share"
keeper shell
# config.json の保存先: $HOME/.local/share/.keeper/

セッション固有の上書き

# テスト用に特定のディレクトリを使用
keeper shell --data-dir /tmp/test-session
# config.json の保存先: /tmp/test-session/.keeper/

企業環境

# 企業全体の構成
export XDG_DATA_HOME="/mnt/userdata/$USER"
keeper shell
# config.json の保存先: /mnt/userdata/john/.keeper/

コマンドライン参照

グローバルオプション

keeper [command] --data-dir <path>

パラメータ:

  • --data-dir <path> - Commander のデータに使用するディレクトリ(環境変数を上書き)

例:

# カスタムディレクトリを使用
keeper shell --data-dir /custom/path

環境変数参照

変数
説明

KEEPER_DATA_HOME

カスタム Commander データディレクトリ

/opt/keeper

XDG_DATA_HOME

ユーザーデータの XDG ベースディレクトリ

$HOME/.local/share

トラブルシューティング

よくある問題

権限エラー

指定したディレクトリが書き込み可能であることを確認してください:

# パーミッションを確認
ls -la /path/to/parent/directory

# 必要に応じてパーミッションを修正
chmod 755 /path/to/parent/directory

パスが見つからない

Commander はディレクトリを自動生成しますが、親ディレクトリは存在している必要があります:

# 親ディレクトリを作成
mkdir -p /path/to/parent
keeper --data-dir /path/to/parent/keeper shell

環境変数が機能しない

環境変数が正しく設定されていることを確認してください:

# 現在の値を確認
echo $KEEPER_DATA_HOME
echo $XDG_DATA_HOME

互換性に関する注意

  • 後方互換性あり:既存の ~/.keeper インストールは引き続き動作します

  • 前方互換性あり:新しい環境変数は柔軟性を向上させます

  • クロスプラットフォーム:macOS、Linux、および Windows で動作します

  • XDG 準拠:データディレクトリの組織化に関する Unix 標準に従います

最終更新