能力可见性
能力可见性(Feature Visibility)控制 Argus 各产品能力对组织的对外可见性——它决定”哪些组织能看到 某个新能力入口”,区别于控制业务代码行为的 Feature Flags。
可见性 vs Feature Flag:能力可见性管的是”Argus 平台能力对客户组织可不可见”(平台侧灰度放量); Feature Flag 管的是”你的应用里某段代码走不走新分支”(业务侧开关)。两者机制相似但用途不同。
核心概念
每个能力以 vis_* 前缀的键(capability_key)标识。平台运营配置三个受众维度(OR 关系,命中任一):
| 维度 | 说明 |
|---|---|
| 组织白名单 | 列出的 org_id 直接可见 |
| 套餐过滤 | 命中指定套餐档位的组织可见 |
| 哈希放量百分比 | 按组织哈希放量,逐步扩大可见面 |
受众命中仍须满足阶段未停用、Kill Switch 未开启以及父能力可见等条件。套餐取自服务端的组织订阅, 客户不能通过 query 参数切换或自报更高套餐。依赖不可确认时受控能力失败关闭,不把故障当成已开放。
Console 使用
打开 Console → Settings → Capabilities(/settings/capabilities):
- 只有组织 OWNER / ADMIN 可查看本组织的能力求值清单;MEMBER / VIEWER 显示权限说明,服务端同样拒绝敏感清单读取。
- 客户页面只读,不提供套餐伪造预览、组织白名单、全局放量或 Kill Switch 配置。
- 加载失败时先按页面提示重试;不要把错误或无权限状态理解为“本组织没有任何能力”。
全局能力策略与 Kill Switch 属于平台运营职责,只能通过获授权的运营入口管理。 客户的 OWNER 身份或项目 PAT 不等于平台运营身份。组织级自定义覆盖尚未开放。
常见问题
Q:能力可见性和套餐额度有关系吗? 可见性的”套餐过滤”维度可以让某能力只对特定档位可见,但它控制的是”看不看得到入口”,不是”用量额度”。 额度见 套餐、配额与计费。
Q:为什么我看不到某个新能力? 可能该能力还在灰度阶段、你的组织不在白名单 / 放量范围、或该能力被 Kill Switch 关闭。
Q:这和运营后台(console-admin)是一回事吗? 不是。获授权运营人员在 console-admin 管理全局策略;客户 Console 仅提供本组织的只读查看。 权限与权威套餐边界见仓库 ADR-0043 。