环境与密钥
pinset env set
向加密环境档案写入或更新一个变量，项目文件只保存密文。
在 GitHub 查看源文档 ↗什么时候用
新增 API token、数据库地址或轮换变量值时使用。先用 env init 创建档案。
示例
pinset env set API_TOKEN --profile dev
终端提示 API_TOKEN:，输入隐藏。结果只确认 profile、variable、set，不回显值；可用 env list --profile dev 查看名称。
行为细节
读取后重新加密，事务写密文及状态，不联网。密文和公开授权可提交，私钥不能提交。不能覆盖工具链与 Pinset 控制变量；执行时与进程已有变量冲突也报错。
修改要求档案明确记录 owner_recipients。旧档案仍可读；维护者需确认公开 owner 和 grant，使 recipients 等于二者并集，再重新信任。配置中不能保存私钥。
参数、退出码与常见错误
| 参数 | 含义 |
|---|---|
<name> | 变量名。 |
--profile <profile> | 必填，目标档案。 |
--stdin | 从 stdin 读取，去除末尾换行，最大 1 MiB。 |
成功返回 0，失败返回 1。PINSET_ENV_INPUT_LIMIT 表示输入过大；PINSET_PROFILE_MISSING 表示档案不存在。不要把秘密直接写进命令行或日志。
/docs/commands/env-set适用版本 · Pinset 3.1.0