launchdarkly-flag-targeting 是做什么的？
控制 LaunchDarkly 特性标志的目标定位，包括开关标志、百分比发布、定位规则、个体目标以及跨环境复制标志配置。适用于用户想修改标志的可见范围、按百分比逐步发布、添加定位规则或在不同环境间提升配置的场景。
功能简介
该技能通过 LaunchDarkly 的 REST API 提供对特性标志目标定位的全面控制，包括：
- 开关标志：一键开启或关闭某个标志。
- 百分比发布：为目标受众的特定百分比启用标志。
- 定位规则：根据用户属性（如电子邮件域名、国家、计划类型）定义复杂的定位规则。
- 个体目标：为特定用户或用户组（通过 key）启用或禁用标志。
- 跨环境复制：将标志的完整目标定位配置从一个环境复制到另一个环境。
先决条件
使用此技能前，您必须设置以下环境变量：
LAUNCHDARKLY_PROJECT_KEY：您的 LaunchDarkly 项目 key。LAUNCHDARKLY_API_KEY：您的 LaunchDarkly API 访问令牌（需具有目标定位管理权限）。
用法示例
示范 1：开启标志
为“my-feature-flag”开启目标定位：
{
"action": "toggle-flag",
"parameters": {
"flagKey": "my-feature-flag",
"environmentKey": "production",
"on": true
}
}
示范 2：设置百分比发布
将“new-checkout-flow”标志逐步发布给 25% 的用户：
{
"action": "set-percentage-rollout",
"parameters": {
"flagKey": "new-checkout-flow",
"environmentKey": "production",
"percentage": 25
}
}
示范 3：添加定位规则
为“premium-users”标志添加一条规则，仅对计划类型为“premium”的用户启用：
{
"action": "add-targeting-rule",
"parameters": {
"flagKey": "premium-users",
"environmentKey": "production",
"rule": {
"clauses": [
{
"attribute": "planType",
"op": "in",
"values": ["premium"],
"negate": false
}
],
"variation": 0
}
}
}
示范 4：为特定用户启用标志
为指定用户的 key 启用“beta-feature”标志：
{
"action": "add-individual-target",
"parameters": {
"flagKey": "beta-feature",
"environmentKey": "staging",
"users": [
{
"key": "user-abc-123",
"variation": 0
}
]
}
}
示范 5：跨环境复制配置
将“dark-launch”标志从“staging”环境复制到“production”环境：
{
"action": "copy-flag-config",
"parameters": {
"flagKey": "dark-launch",
"sourceEnvironmentKey": "staging",
"targetEnvironmentKey": "production"
}
}
注意事项
- 所有操作均通过你的 LaunchDarkly API 密钥进行身份验证。
- 确保你的 API 令牌具有相关环境的目标定位管理权限。
- 百分比发布采用基于用户 key 的哈希算法，确保同一用户始终处于同一受众组。
- 跨环境复制会覆盖目标环境中的现有目标定位配置。
支持平台
- Claude Code
- Cursor
- CopyCat
- Codex
- 其他通过 MCP 协议集成的 AI 代理工具