lark-switch 是一个用于切换 lark-cli 飞书账号配置的工具。每个 profile 对应一个飞书应用(App ID + Secret),通过替换 ~/.lark-cli/config.json 实现切换,Token 随 config 文件保存,切换后无需重新授权。触发词包括 lark-switch、切换飞书账号、switch feishu account、飞书切换。
主要用法:预检查可运行 bash <SKILL_DIR>/scripts/helper.sh preflight,检查 lark-cli 是否安装、config 目录及可用 profiles。切换账号使用 source ~/.lark-cli/switch.sh <profile>,如 source ~/.lark-cli/switch.sh personal;不带参数可查看所有可用 profiles。验证切换结果用 lark-cli auth status,应返回 tokenStatus: "valid" 和正确 userName。
新增 Profile 的步骤:先用 lark-cli config init --app-id <app-id> --app-secret-stdin --brand feishu 配置应用,再 lark-cli auth login --domain docs,wiki,drive 登录,然后 cp ~/.lark-cli/config.json ~/.lark-cli/config-<name>.json 保存,保存 secret 到 .<name>.secret 并 chmod 600,最后 source ~/.lark-cli/switch.sh <previous-profile> 恢复之前的活跃 profile。注意 config init 是破坏性操作,会覆盖当前 config.json,操作前须确认当前 profile 已保存。
Token 有效期约 2 小时,refresh token 7 天。若切换后状态显示过期,可重新登录并保存 profile。常见问题包括 keychain entry not found、client secret is invalid、app is pending approval、切换后需重新授权等,资料中给出了对应原因与解决方式。