用途:在 PostHog 的仓库中集中管理 GitHub Actions 密钥。所有密钥都建在 posthog 组织层,再把访问权授予需要它的具体仓库,即使当前只有一个工作流使用,也不要建在单个仓库里。
主要能力:通过 gh CLI 或 GitHub UI 创建、更新组织级密钥并控制仓库访问范围。规则是始终建在组织层,只授予需要的仓库;除非确实面向全组织共享,否则不要默认开放给所有仓库。
必要用法:用管道把密钥值传给带 --org posthog 的命令,避免出现在 shell 历史中,例如 pbpaste | gh secret set POSTHOGOS_PACKAGER_KEY --org posthog。也可从文件读取:gh secret set POSTHOGOS_PACKAGER_KEY --org posthog < secret.txt。创建时限定仓库:gh secret set POSTHOGOS_PACKAGER_KEY --org posthog --visibility selected --repos PostHog/posthog,PostHog/posthog-foss。修改已有密钥的可访问仓库时使用同样命令。验证:gh secret list --org posthog | grep POSTHOGOS_PACKAGER_KEY。UI 方式为打开组织密钥设置页,新建或编辑密钥,名称用 SCREAMING_SNAKE_CASE,填入值后在 Repository access 选择 Selected repositories 指定仓库。
限制与注意:不要省略 --org posthog,否则会按当前仓库创建仓库级密钥;不要到单仓库的 Settings → Secrets and variables → Actions 添加密钥,已有的仓库级密钥应迁移为组织级后再删除。不要把密钥值粘贴到聊天、PR 描述、提交信息或文件中,也不要回显到命令、日志或文件;若已泄露应立即轮换。用户问在哪里添加密钥时,默认回答是组织层并授权给具体仓库,仅在用户明确要求环境级密钥等不同机制时另行处理。