Skip to content

24-growthbook-analytics-and-feature-control.md

Latest commit

 

History

History
120 lines (81 loc) · 4.28 KB

24-growthbook-analytics-and-feature-control.md

File metadata and controls

120 lines (81 loc) · 4.28 KB

24. GrowthBook、Analytics 与 Feature Control

所属专题簇：控制、扩展与灰度治理

建议前读：18. Settings、Policy 与托管配置

建议后读：25. Hooks 与 Runtime Extensibility

研究问题

为什么 Claude Code 源码里出现的功能，不等于当前用户就一定能看到或使用？

一句话结论

Claude Code 的功能面不仅受本地代码决定，还受 feature(...) 静态裁剪、GrowthBook 远程灰度、analytics 元数据和可信状态影响；它把“功能是否存在”和“功能是否可见/可用”拆成了多层控制。

这篇讲什么

这一章解释 Claude Code 如何通过静态 feature gate、GrowthBook、实验分流、事件日志和 kill switch 控制产品行为。

如果你不看源码，只看这一章，应该记住什么

  • 看到源码并不等于看到功能。
  • Claude Code 同时使用静态编译期开关和动态远程特性控制。
  • analytics 在这里只是日志系统的一部分，更重要的是它为灰度、实验和产品治理提供上下文。

Claude Code 在这里想解决什么

一个持续演化的 agent 产品很难把所有能力一次性对所有人开启。Claude Code 显然需要：

  • 按用户类型灰度能力
  • 紧急关闭某些功能
  • 让实验和正式能力共存
  • 让外部观测知道某个功能为什么生效或不生效

这就是 feature control 层存在的原因。

源码依据

Mermaid 图：功能可见性决策图

flowchart TD
    A["源码中存在某功能"] --> B["bun:bundle feature gate"]
    B --> C["GrowthBook 远程特性"]
    C --> D["auth / trust / user attributes"]
    D --> E["最终是否注册 / 是否可见 / 是否可执行"]
    E --> F["analytics / exposure logging"]
Loading

GrowthBook 层会读取用户属性

src/services/analytics/growthbook.ts 里可直接看到 GrowthBookUserAttributes，其中包括：

  • sessionId
  • deviceID
  • platform
  • organizationUUID
  • accountUUID
  • userType
  • subscriptionType
  • rateLimitTier

这说明远程特性控制不是单纯“开 / 关”开关，而是会根据用户和环境属性做定向灰度。

静态 feature 和动态 feature 是两回事

源码里大量使用 feature('...')。这类开关偏向：

  • 编译产物裁剪
  • 外部构建差异
  • 某些字符串和路径在 bundle 阶段被消除

而 GrowthBook 则更像：

  • 运行时实验
  • 远程 kill switch
  • 功能可见性控制

两者叠加后，读源码时必须区分“编译时不存在”和“运行时没开给你”。

analytics 不只是埋点

src/services/analytics/ 下的：

  • firstPartyEventLogger.ts
  • datadog.ts
  • metadata.ts
  • sink.ts

说明这层不只是简单记录点击，而是在支撑实验曝光、运行时元数据和系统可观测性。

voice 是一个很直观的样本

src/voice/voiceModeEnabled.ts 直接显示：

  • 需要 VOICE_MODE feature
  • 还要检查 GrowthBook kill switch
  • 还要检查 Anthropic OAuth token

这很好地展示了 Claude Code 的典型能力控制方式：静态开关、远程开关和鉴权条件三层同时成立才真正可用。

你真正应该记住的点

  • “源码存在”只是第一层事实。
  • Claude Code 用 feature gate + GrowthBook + auth/state 共同决定功能面。
  • 研究某个能力是否真实存在时，必须同时看注册点、feature 判断和远程特性控制。

延伸阅读