2.8 KiB
apps env
前置条件： 先阅读
../lark-shared/SKILL.md（认证 / 全局参数 / 安全）。
管理妙搭应用环境变量。查看用 +env-list，设置用 +env-set，删除用 +env-delete。没有单变量 get 命令；要确认某个 key 是否存在，使用 list 后用 --jq 过滤。
环境 flag 使用 --environment；不要使用旧的 --env，也不要使用短选项。
查看
+env-list 默认查 dev，且默认不返回 value。只有显式传 --include-values 后，响应中才可能出现变量值；不要在公开日志里展示带值输出。
接口契约：list 使用 POST env_vars，body 固定包含 env 和 CLI 场景 scene=2；set 使用 POST create_or_update_env_var；delete 使用 POST delete_env_vars。--include-values 只控制 CLI 输出是否展示 value，不作为服务端查询参数发送。
lark-cli apps +env-list --app-id <app_id>
lark-cli apps +env-list --app-id <app_id> --environment online
lark-cli apps +env-list --app-id <app_id> --include-values --jq '.data.items[] | select(.key == "FOO")'
设置
dev 环境设置不需要 --yes。设置 online 环境需要人类确认并显式传 --yes；如果用户在同一轮已经明确说“确认/直接执行”，视为已确认，直接带 --yes，不要再次追问。--dry-run 可用于预览请求且不需要 --yes。变量值支持直接传 <value>，也支持 @file 或 stdin 输入。
回复中只说明 app/env/key 和执行结果；不要回显真实 value。需要举例时使用 <value>、@file 或 stdin。
lark-cli apps +env-set --app-id <app_id> --key FOO --value <value>
lark-cli apps +env-set --app-id <app_id> --key FOO --value @./secret.txt
lark-cli apps +env-set --app-id <app_id> --environment online --key FOO --value <value> --dry-run
lark-cli apps +env-set --app-id <app_id> --environment online --key FOO --value <value> --yes
删除
+env-delete 是 high-risk-write。尊重 exit 10 confirmation protocol：先让用户确认 app/env/key 和删除后果，再传 --yes。不要自动补 --yes。如果只是认证失败后让用户重登，重登完成不等于删除确认；继续删除前仍需确认。
lark-cli apps +env-delete --app-id <app_id> --key FOO --dry-run
lark-cli apps +env-delete --app-id <app_id> --key FOO --yes
lark-cli apps +env-delete --app-id <app_id> --environment online --key FOO --yes
反模式
- 不要把
+env-pull当成环境变量管理命令；它只是刷新本地.env.local的兜底工具。 - 不要为了看一个变量臆造名为 env-get 的 apps shortcut；用
+env-list --include-values加--jq。 - 不要把真实 secret 写进示例或对话输出；需要示例时使用
<value>、@file或 stdin。