Lark Switch

言語

ユーザーの言語に合わせる：ユーザーが使用している言語と同じ言語で応答してください。

概要

複数の lark-cli 飛書アカウント設定間を切り替えます。各 profile は 1 つの飛書アプリケーション（App ID + Secret）に対応し、~/.lark-cli/config.json を置き換えることで切り替えが実現されます。トークンは config ファイルとともに保存されるため、切り替え後に再度認証する必要はありません。

ランタイム

プレフライト

bash <SKILL_DIR>/scripts/helper.sh preflight

lark-cli がインストールされているか、config ディレクトリが存在するか、どの profile が利用可能かを確認します。

アカウント切り替え

source ~/.lark-cli/switch.sh <profile>

例：

source ~/.lark-cli/switch.sh personal   # 個人アカウントに切り替え
source ~/.lark-cli/switch.sh einsia     # Einsia 組織アカウントに切り替え
source ~/.lark-cli/switch.sh            # 利用可能なすべての profile を表示

切り替え結果の検証

lark-cli auth status

tokenStatus: "valid" と正しい userName が返されるはずです。

新規 Profile 追加

ユーザーが新しい飛書アカウントを追加する必要がある場合：

# 1. アプリケーションを設定
echo "<app-secret>" | lark-cli config init --app-id <app-id> --app-secret-stdin --brand feishu

# 2. ユーザー ID でログイン
lark-cli auth login --domain docs,wiki,drive

# 3. Profile を保存
cp ~/.lark-cli/config.json ~/.lark-cli/config-<name>.json

# 4. secret を保存（keychain 復元用）
echo -n "<app-secret>" > ~/.lark-cli/.<name>.secret
chmod 600 ~/.lark-cli/.<name>.secret

# 5. 以前のアクティブ profile を復元
source ~/.lark-cli/switch.sh <previous-profile>

注意：lark-cli config init は破壊的操作であり、現在の config.json を上書きします。新規 profile を追加する前に、必ず現在の profile が保存されていることを確認してください。

トークン期限切れ処理

トークンの有効期限は約 2 時間で、リフレッシュトークンは 7 日間です。切り替え後に auth status がトークン期限切れを表示する場合：

lark-cli auth login --domain docs,wiki,drive
# ログイン後、profile を再度保存
cp ~/.lark-cli/config.json ~/.lark-cli/config-<current-profile>.json

トラブルシューティング

症状	原因	解決
keychain entry not found	keychain 内のその appId の secret が削除されている	.<profile>.secret ファイルから復元するか、再度 config init を実行
client secret is invalid	飛書バックエンドの secret が更新されている	新しい secret を取得し、再度 config init を実行して保存
app is pending approval	組織アプリケーションが承認待ち状態	管理者に承認を依頼
切り替え後に再認証が必要	config ファイル内のトークンが失われている	ログイン後の完全な config が保存されていることを確認

<!-- Keep this file under 200 lines. Move detailed docs to references/. -->