デフォルト作業ディレクトリの構成
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 は以下の優先順位(高い順から低い順)で作業ディレクトリを決定します:
CLI パラメータ -
--data-dirフラグKEEPER_DATA_HOME - 環境変数
XDG_DATA_HOME - XDG ベースディレクトリ仕様
既定値 -
~/.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 標準に従います
最終更新

