用途:在同一 PostHog 组织内,将源项目的功能开关复制到一个或多个目标项目。适用于复制开关、在项目间同步、把开关从测试项目推广到生产项目,或在用项目充当环境时复制配置并保留队列依赖。
主要能力:单个开关复制,一次调用最多支持 50 个目标项目,按目标分别返回成功与失败;复制前可预览开关定义与依赖;自动重映射队列引用;保留加密负载(在目标项目密钥下重新加密);可选择是否复制计划变更;可设置复制后在目标项目默认禁用。
使用方式:先确定源开关的 key 和源项目 id,再调用 posthog:projects-get 确认目标项目与同组织成员身份。之后调用 posthog:feature-flag-get-definition 预览,并始终先调用 posthog:feature-flags-copy-dependencies-check(键、源项目、目标项目列表)检查依赖。向用户确认选项后,调用 posthog:feature-flags-copy-flags-create,需提供 feature_flag_key、from_project、target_project_ids,可选 disable_copied_flag、copy_schedule、copy_dependencies。默认最安全组合为 disable_copied_flag=true、copy_schedule=false、copy_dependencies=false。最后按目标汇报成功(新开关 id、目标状态)与失败原因。
关键限制:不支持跨组织复制;不批量复制项目内全部开关,需逐个循环;清理旧开关请用其他技能。权限上 API 密钥需显式含 feature_flag:write 或 feature_flag:*,仅 * 的密钥会被拒;需组织级或非团队级密钥;源团队需编辑器级权限;不可见的目标会被静默丢弃,可见但无编辑权的目标会报权限错误。复制无撤销,会在目标新建开关或覆盖同 key 开关,建议生产目标先确认。副本强制为手动上传,不支持自动/定时执行;平台可用性、收费或价格信息暂未提供。
依赖检查说明:can_copy_dependencies 为 false 不一定代表被阻止,没有可复制项时也为 false;仅当 warnings 非空时报问题。