vault backup: 2026-06-09 23:15:17

2026-06-09 23:15:17 +08:00
parent 31fd89aafe
commit e92c0327d9
111 changed files with 7276 additions and 8846 deletions
@@ -1,12 +1,22 @@
+---
+tags: [GrowthBook, feature-flag, 门控, 启用计划, 配置]
+create time: 2026-06-09 22:30
+---
+
 # GrowthBook 功能启用计划

+## 概述
+
+Claude Code 使用三层门控系统控制功能启用：编译时 feature flag、GrowthBook 远程开关和运行时环境变量。本文档汇总所有被 GrowthBook 门控的功能，按优先级排列实施计划。
+
+> [!info]
 > 编制日期: 2026-04-06
 > 基于: feature-flags-codex-review.md + 4 个并行研究代理的深度分析
 > 前提: 我们是付费订阅用户，拥有有效的 Anthropic API key

---
+## 正文

-## 背景
+### 背景

 Claude Code 使用三层门控系统：
 1. **编译时 feature flag** — `feature('FLAG_NAME')` from `bun:bundle`
@@ -15,16 +25,17 @@ Claude Code 使用三层门控系统：

 在我们的反编译版本中，GrowthBook 不启动（analytics 链空实现），导致所有 `tengu_*` 检查默认返回 `false`。

-**核心发现：所有被 GrowthBook 门控的功能代码都是真实现，没有 stub。**
+> [!warning]
+> **核心发现：所有被 GrowthBook 门控的功能代码都是真实现，没有 stub。**

---
+### 启用方式说明

-## 启用方式说明
+#### 方式 1：硬编码绕过（推荐先用）

-### 方式 1：硬编码绕过（推荐先用）
 在 `src/services/analytics/growthbook.ts` 的 `getFeatureValueInternal()` 函数中添加默认值映射。

-### 方式 2：自建 GrowthBook 服务器
+#### 方式 2：自建 GrowthBook 服务器
+
 ```bash
 docker run -p 3100:3100 growthbook/growthbook
 # 设置环境变量
@@ -32,229 +43,64 @@ CLAUDE_GB_ADAPTER_URL=http://localhost:3100
 CLAUDE_GB_ADAPTER_KEY=sdk-xxx
 ```

-### 方式 3：恢复原生 1P 连接
+#### 方式 3：恢复原生 1P 连接
+
 让 `is1PEventLoggingEnabled()` 返回 `true`，连接 Anthropic 的 GrowthBook 服务端。
-注意：会发送使用统计（不含代码/对话内容）。

---
+> [!warning]
+> 会发送使用统计（不含代码/对话内容）。

-## 优先级 P0：纯本地功能（零外部依赖，立即可用）
+### 优先级 P0：纯本地功能（零外部依赖，立即可用）

 这些功能不需要 API 调用，开启 gate 即可工作。

-### P0-1. 自定义快捷键
- **Gate**: `tengu_keybinding_customization_release` → `true`
- **编译 flag**: 无（已内置）
- **代码量**: 473 行，完整实现
- **功能**: 加载 `~/.claude/keybindings.json`，支持热重载、重复键检测、结构验证
- **效果**: 用户可自定义所有快捷键
- **风险**: 无
+| 功能 | Gate | 代码量 | 效果 | 风险 |
+|------|------|--------|------|------|
+| P0-1 自定义快捷键 | `tengu_keybinding_customization_release` | 473 行 | 用户可自定义所有快捷键 | 无 |
+| P0-2 流式工具执行 | `tengu_streaming_tool_execution2` | 577 行 | 显著提升交互速度 | 低 |
+| P0-3 定时任务系统 | `tengu_kairos_cron` | 1025 行 | 可设置定时执行的 Claude 任务 | 低 |
+| P0-4 Agent 团队 / Swarm | `tengu_amber_flint` | 45 行 | 允许创建和管理 agent 团队 | 无 |
+| P0-5 Token 高效 JSON 工具格式 | `tengu_amber_json_tools` | 几行 | 省钱（减少约 4.5% 输出 token） | 低 |
+| P0-6 Ultrathink 扩展思考 | `tengu_turtle_carbon` | — | 已默认启用，确保不被远程关闭 | 无 |
+| P0-7 即时模型切换 | `tengu_immediate_model_command` | — | 无需等当前任务完成就能切换 | 低 |

-### P0-2. 流式工具执行
- **Gate**: `tengu_streaming_tool_execution2` → `true`
- **编译 flag**: 无（已内置）
- **代码量**: 577 行（StreamingToolExecutor），完整实现
- **功能**: API 响应还在流式返回时就开始执行工具，减少等待时间
- **效果**: 显著提升交互速度
- **风险**: 低（生产级代码，有错误处理）
-
-### P0-3. 定时任务系统
- **Gate**: `tengu_kairos_cron` → `true`（额外：`tengu_kairos_cron_durable` 默认 `true`）
- **编译 flag**: `AGENT_TRIGGERS`（需新增）或 `AGENT_TRIGGERS_REMOTE`（已启用）
- **代码量**: 1025 行（cronTasks + cronScheduler），完整实现
- **功能**: 本地 cron 调度，支持一次性/周期性任务、防雷群效应 jitter、自动过期
- **效果**: 可设置定时执行的 Claude 任务
- **风险**: 低
-
-### P0-4. Agent 团队 / Swarm
- **Gate**: `tengu_amber_flint` → `true`（这是 kill switch，默认已 `true`）
- **编译 flag**: 无（已内置）
- **代码量**: 45 行（gate 层），实际 swarm 实现在 teammate tools 中
- **功能**: 多 agent 协作，需额外设置 `--agent-teams` 或 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`
- **效果**: 允许创建和管理 agent 团队
- **风险**: 无（kill switch 默认就是 true）
-
-### P0-5. Token 高效 JSON 工具格式
- **Gate**: `tengu_amber_json_tools` → `true`
- **编译 flag**: 无（已内置）
- **代码量**: betas.ts 中几行 gate 检查
- **功能**: 启用 FC v3 格式，减少约 4.5% 的输出 token
- **效果**: 省钱
- **风险**: 低（需要模型支持该 beta header）
-
-### P0-6. Ultrathink 扩展思考
- **Gate**: `tengu_turtle_carbon` → `true`（默认已 `true`，kill switch）
- **编译 flag**: 无
- **功能**: 通过关键词触发扩展思考模式
- **效果**: 已默认启用，确保不被远程关闭即可
- **风险**: 无
-
-### P0-7. 即时模型切换
- **Gate**: `tengu_immediate_model_command` → `true`
- **编译 flag**: 无
- **功能**: 在 query 运行过程中即时执行 `/model`、`/fast`、`/effort` 命令
- **效果**: 无需等当前任务完成就能切换
- **风险**: 低
-
---
-
-## 优先级 P1：需要 Claude API 的功能（有 API key 即可用）
+### 优先级 P1：需要 Claude API 的功能（有 API key 即可用）

 这些功能需要调用 Claude API（使用 forked subagent 或 queryModel），有订阅即可。

-### P1-1. 会话记忆
- **Gate**: `tengu_session_memory` → `true`（配置：`tengu_sm_config` → `{}`）
- **编译 flag**: 无（已内置）
- **代码量**: 1127 行，完整实现
- **功能**: 跨会话上下文持久化。用 forked agent 定期提取会话笔记到 markdown 文件
- **效果**: Claude 记住跨会话的工作上下文
- **依赖**: Claude API（forked subagent）
- **风险**: 低（额外 API token 消耗）
+| 功能 | Gate | 代码量 | 效果 | 依赖 |
+|------|------|--------|------|------|
+| P1-1 会话记忆 | `tengu_session_memory` | 1127 行 | Claude 记住跨会话的工作上下文 | Claude API |
+| P1-2 自动记忆提取 | `tengu_passport_quail` | 616 行 | 自动构建项目知识库 | Claude API |
+| P1-3 提示建议 | `tengu_chomp_inflection` | 525 行 | 更流畅的交互体验 | Claude API |
+| P1-4 验证代理 | `tengu_hive_evidence` | 153 行 | 自动化代码验证 | Claude API |
+| P1-5 Brief 模式 | `tengu_kairos_brief` | 335 行 | 减少冗余输出 | Claude API |
+| P1-6 离开摘要 | `tengu_sedge_lantern` | 176 行 | 快速恢复上下文 | Claude API + 终端焦点 |
+| P1-7 自动梦境 | `tengu_onyx_plover` | 349 行 | 记忆自动保持整洁有序 | Claude API + auto-memory |
+| P1-8 空闲返回提示 | `tengu_willow_mode` | — | 避免在过期缓存上浪费 token | — |

-### P1-2. 自动记忆提取
- **Gate**: `tengu_passport_quail` → `true`（相关：`tengu_moth_copse`、`tengu_coral_fern`）
- **编译 flag**: `EXTRACT_MEMORIES`（需新增）
- **代码量**: 616 行，完整实现
- **功能**: 对话中自动提取持久记忆到 `~/.claude/projects/<path>/memory/`
- **效果**: 自动构建项目知识库
- **依赖**: Claude API（forked subagent）
- **风险**: 低
+### 优先级 P2：增强型功能（提升体验但非必须）

-### P1-3. 提示建议
- **Gate**: `tengu_chomp_inflection` → `true`
- **编译 flag**: 无（已内置）
- **代码量**: 525 行，完整实现
- **功能**: 自动生成下一步操作建议，带投机预取（speculation prefetch）
- **效果**: 更流畅的交互体验
- **依赖**: Claude API（forked subagent）
- **风险**: 低（额外 API 消耗，但有缓存感知）
+| 功能 | Gate | 效果 |
+|------|------|------|
+| P2-1 MCP 指令增量传输 | `tengu_basalt_3kr` | 减少 token 消耗 |
+| P2-2 叶剪枝优化 | `tengu_pebble_leaf_prune` | 减少存储和加载时间 |
+| P2-3 消息合并 | `tengu_chair_sermon` | 减少 token 消耗 |
+| P2-4 深度链接 | `tengu_lodestone_enabled` | 可从浏览器直接打开 Claude Code |
+| P2-5 Agent 自动转后台 | `tengu_auto_background_agents` | 不再阻塞主交互 |
+| P2-6 细粒度工具状态 | `tengu_fgts` | 模型更好地理解工具可用性 |
+| P2-7 文件操作 git diff | `tengu_quartz_lantern` | 更好的变更追踪 |

-### P1-4. 验证代理
- **Gate**: `tengu_hive_evidence` → `true`
- **编译 flag**: `VERIFICATION_AGENT`（需新增）
- **代码量**: 153 行（agent 定义），完整实现
- **功能**: 对抗性验证 agent，主动尝试打破你的实现（只读模式）
- **效果**: 自动化代码验证
- **依赖**: Claude API（subagent）
- **风险**: 低（只读，不修改代码）
+### 优先级 P3：需要自建服务或 Anthropic OAuth

-### P1-5. Brief 模式
- **Gate**: `tengu_kairos_brief` → `true`
- **编译 flag**: `KAIROS` 或 `KAIROS_BRIEF`（需新增）
- **代码量**: 335 行，完整实现
- **功能**: `/brief` 命令切换精简输出模式
- **效果**: 减少冗余输出
- **依赖**: Claude API
- **风险**: 低
+| 功能 | Gate | 依赖 | 可行性 |
+|------|------|------|--------|
+| P3-1 团队记忆 | `tengu_herring_clock` | Anthropic OAuth + GitHub remote | 需要自建兼容 API |
+| P3-2 设置同步 | `tengu_enable_settings_sync_push` | Anthropic OAuth | 需要自建兼容 API |
+| P3-3 Bridge 远程控制 | `tengu_ccr_bridge` | claude.ai 订阅 + WebSocket 后端 | 需要 Anthropic CCR 后端 |
+| P3-4 远程定时 Agent | `tengu_surreal_dali` | Anthropic CCR 基础设施 | 需要远程服务 |

-### P1-6. 离开摘要
- **Gate**: `tengu_sedge_lantern` → `true`
- **编译 flag**: `AWAY_SUMMARY`（需新增）
- **代码量**: 176 行，完整实现
- **功能**: 离开终端 5 分钟后返回时自动总结期间发生了什么
- **效果**: 快速恢复上下文
- **依赖**: Claude API + 终端焦点事件支持
- **风险**: 低
-
-### P1-7. 自动梦境
- **Gate**: `tengu_onyx_plover` → `{"enabled": true}`
- **编译 flag**: 无（已内置，但检查 auto-memory 是否启用）
- **代码量**: 349 行，完整实现
- **功能**: 后台自动整理/巩固记忆（等同于自动执行 `/dream`）
- **效果**: 记忆自动保持整洁有序
- **依赖**: Claude API（forked subagent）+ auto-memory 启用
- **风险**: 低
-
-### P1-8. 空闲返回提示
- **Gate**: `tengu_willow_mode` → `"dialog"` 或 `"hint"`
- **编译 flag**: 无
- **功能**: 对话太大且缓存过期时，提示用户开新会话
- **效果**: 避免在过期缓存上浪费 token
- **风险**: 无
-
---
-
-## 优先级 P2：增强型功能（提升体验但非必须）
-
-### P2-1. MCP 指令增量传输
- **Gate**: `tengu_basalt_3kr` → `true`
- **功能**: 只发送变化的 MCP 指令而非全量
- **效果**: 减少 token 消耗
- **风险**: 低
-
-### P2-2. 叶剪枝优化
- **Gate**: `tengu_pebble_leaf_prune` → `true`
- **功能**: 会话存储中移除死胡同消息分支
- **效果**: 减少存储和加载时间
- **风险**: 低
-
-### P2-3. 消息合并
- **Gate**: `tengu_chair_sermon` → `true`
- **功能**: 合并相邻的 tool_result + text 块
- **效果**: 减少 token 消耗
- **风险**: 低
-
-### P2-4. 深度链接
- **Gate**: `tengu_lodestone_enabled` → `true`
- **功能**: 注册 `claude://` URL 协议处理器
- **效果**: 可从浏览器直接打开 Claude Code
- **风险**: 低
-
-### P2-5. Agent 自动转后台
- **Gate**: `tengu_auto_background_agents` → `true`
- **功能**: Agent 任务运行 120s 后自动转为后台
- **效果**: 不再阻塞主交互
- **风险**: 低
-
-### P2-6. 细粒度工具状态
- **Gate**: `tengu_fgts` → `true`
- **功能**: 系统提示中包含细粒度工具状态信息
- **效果**: 模型更好地理解工具可用性
- **风险**: 低
-
-### P2-7. 文件操作 git diff
- **Gate**: `tengu_quartz_lantern` → `true`
- **功能**: 文件写入/编辑时计算 git diff（仅远程会话）
- **效果**: 更好的变更追踪
- **风险**: 低
-
---
-
-## 优先级 P3：需要自建服务或 Anthropic OAuth
-
-### P3-1. 团队记忆
- **Gate**: `tengu_herring_clock` → `true`
- **编译 flag**: `TEAMMEM`（需新增）
- **代码量**: 1180+ 行，完整实现
- **功能**: 跨 agent 共享记忆，同步到 Anthropic API
- **依赖**: Anthropic OAuth + GitHub remote
- **状态**: 需要 Anthropic 的 `/api/claude_code/team_memory` 端点
- **可行性**: 除非自建兼容 API，否则无法使用
-
-### P3-2. 设置同步
- **Gate**: `tengu_enable_settings_sync_push` + `tengu_strap_foyer` → `true`
- **编译 flag**: `UPLOAD_USER_SETTINGS` / `DOWNLOAD_USER_SETTINGS`（需新增）
- **代码量**: 582 行，完整实现
- **功能**: 跨设备设置同步
- **依赖**: Anthropic OAuth + `/api/claude_code/user_settings`
- **可行性**: 同上
-
-### P3-3. Bridge 远程控制
- **Gate**: `tengu_ccr_bridge` → `true`（已有编译 flag `BRIDGE_MODE` dev 模式启用）
- **代码量**: 12,619 行，完整实现
- **功能**: claude.ai 网页端远程控制 CLI
- **依赖**: claude.ai 订阅 + WebSocket 后端
- **可行性**: 需要 Anthropic 的 CCR 后端
-
-### P3-4. 远程定时 Agent
- **Gate**: `tengu_surreal_dali` → `true`
- **功能**: 创建在远程执行的定时 agent
- **依赖**: Anthropic CCR 基础设施
- **可行性**: 需要远程服务
-
---
-
-## Kill Switch 清单（确保不被远程关闭）
+### Kill Switch 清单（确保不被远程关闭）

 这些 gate 默认为 `true`，是 kill switch。应确保它们保持 `true`：

@@ -271,9 +117,7 @@ CLAUDE_GB_ADAPTER_KEY=sdk-xxx
 | `tengu_attribution_header` | `true` | API 请求署名 |
 | `tengu_slate_prism` | `true` | Agent 进度摘要 |

---
-
-## 需要新增的编译 flag
+### 需要新增的编译 flag

 以下编译时 flag 尚未在 `build.ts` / `scripts/dev.ts` 中启用，但功能代码完整：

@@ -286,49 +130,57 @@ CLAUDE_GB_ADAPTER_KEY=sdk-xxx
 | `AWAY_SUMMARY` | 离开摘要（P1-6） | P1 |
 | `TEAMMEM` | 团队记忆（P3-1） | P3 |

---
+### 实施路线图

-## 实施路线图
+#### Phase 1：硬编码 P0 纯本地 gate（最快见效）

-### Phase 1：硬编码 P0 纯本地 gate（最快见效）
 1. 在 growthbook.ts 添加默认值映射
 2. 在 build.ts / dev.ts 添加 `AGENT_TRIGGERS` 编译 flag
 3. 验证 7 个 P0 功能正常工作
 4. 预计工作量：1-2 小时

-### Phase 2：启用 P1 API 依赖功能
+#### Phase 2：启用 P1 API 依赖功能
+
 1. 添加编译 flag：`EXTRACT_MEMORIES`、`VERIFICATION_AGENT`、`KAIROS_BRIEF`、`AWAY_SUMMARY`
 2. 添加 P1 gate 默认值
 3. 验证 8 个 P1 功能正常工作
 4. 预计工作量：2-3 小时

-### Phase 3：评估自建 GrowthBook（可选）
+#### Phase 3：评估自建 GrowthBook（可选）
+
 1. Docker 部署 GrowthBook 服务器
 2. 迁移硬编码值到 GrowthBook 后台管理
 3. 获得 Web UI 管理所有 flag 的能力
 4. 预计工作量：半天

-### Phase 4：评估远程功能（可选）
+#### Phase 4：评估远程功能（可选）
+
 1. 研究是否可以使用 Anthropic OAuth
 2. 评估团队记忆、设置同步的自建可行性
 3. 预计工作量：待评估

---
+### 隐私说明

-## 隐私说明
+#### 硬编码绕过（方案 A）

-### 硬编码绕过（方案 A）
 - **零数据外发**
 - GrowthBook SDK 不启动
 - 完全离线运行

-### 自建 GrowthBook（方案 B）
+#### 自建 GrowthBook（方案 B）
+
 - 数据仅发送到你自己的服务器
 - Anthropic 无法获取任何数据
 - 可通过 Web UI 实时管理所有 flag

-### 恢复原生 1P（方案 C）
+#### 恢复原生 1P（方案 C）
+
 - 会发送使用统计到 `api.anthropic.com`
 - **不发送**：代码、对话内容、API key
 - **会发送**：邮箱、设备 ID、机器指纹、仓库哈希、订阅类型
 - 可用 `DISABLE_TELEMETRY=1` 关闭遥测（但同时关闭 GrowthBook）
+
+## 关联笔记
+
+- [[claude-code-best/docs/features/kairos]]
+- [[claude-code-best/docs/features/proactive]]