feature() 是 Bun 编译期的死代码消除机制,来自 bun:bundle 内置模块。值为 true 的代码路径会在打包时保留,为 false 的会被完全剥离,产生零运行时开销的条件编译。
import { feature } from 'bun:bundle'
const voiceCommand = feature('VOICE_MODE')
? require('./commands/voice/index.js').default
: null
平台/构建模式 (Platform / Build Target)
| Flag | 说明 |
|---|
IS_LIBC_GLIBC | 运行在 glibc Linux 环境 |
IS_LIBC_MUSL | 运行在 musl libc Linux 环境(如 Alpine) |
NATIVE_CLIENT_ATTESTATION | 原生客户端硬件 attestation |
DAEMON | 守护进程模式(后台常驻) |
BYOC_ENVIRONMENT_RUNNER | BYOC (Bring Your Own Cloud) 环境运行器 |
会话与远程 (Session / Remote)
| Flag | 说明 |
|---|
SSH_REMOTE | SSH 远程会话支持 (claude ssh) |
DIRECT_CONNECT | cc:// URL 直连会话 |
CCR_AUTO_CONNECT | CCR (Claude Code Remote) 自动连接 |
CCR_MIRROR | CCR 镜像模式 |
CCR_REMOTE_SETUP | CCR 远程设置命令 |
BG_SESSIONS | 后台会话 |
BRIDGE_MODE | IDE 桥接模式(VS Code / JetBrains 集成) |
DAEMON | 守护进程模式 |
订阅源 / 渠道 (Channel / Distribution)
| Flag | 说明 |
|---|
ALLOW_TEST_VERSIONS | 允许安装/使用测试版本 |
AUTO_THEME | 自动主题切换(跟随系统) |
FILE_PERSISTENCE | 文件持久化存储 |
STREAMLINED_OUTPUT | 精简输出模式 |
COMPACTION_REMINDERS | 会话压缩提醒 |
NEW_INIT | 新的初始化流程 |
DOWNLOAD_USER_SETTINGS | 下载用户远程设置 |
UPLOAD_USER_SETTINGS | 上传用户远程设置 |
SLOW_OPERATION_LOGGING | 慢操作日志 |
PERFETTO_TRACING | Perfetto 性能追踪 |
AI 模式 (Kairos / Assistant)
Kairos 是 Anthropic 内部的项目代号,代表 Claude 的 AI 主导交互模式。
| Flag | 说明 |
|---|
KAIROS | 核心 AI/Assistant 模式(Claude 主动引导交互) |
KAIROS_BRIEF | 简报模式(Kairos 的简洁版本) |
KAIROS_CHANNELS | 频道/通道系统 |
KAIROS_DREAM | Claude 主动发起行为("做梦"机制) |
KAIROS_PUSH_NOTIFICATION | 推送通知 |
KAIROS_GITHUB_WEBHOOKS | GitHub Webhook 集成(如订阅 PR) |
PROACTIVE | 主动模式(Claude 不等待输入主动行动,Kairos 的旧称) |
静默模式/非交互 (Non-Interactive / Automation)
| Flag | 说明 |
|---|
UNATTENDED_RETRY | 无人值守模式下的重试机制 |
HARD_FAIL | 严格失败模式(遇到错误直接终止而非降级) |
多 Agent 与协作 (Multi-Agent / Teammates)
| Flag | 说明 |
|---|
COORDINATOR_MODE | 协调器模式(多 agent 编排) |
TEAMMEM | 团队记忆(共享 memory) |
FORK_SUBAGENT | Fork 子 agent 机制 |
QUICK_SEARCH | 快速搜索(子 agent 搜索模式) |
BUILTIN_EXPLORE_PLAN_AGENTS | 内置的 Explore / Plan 专用 agent 类型 |
COWORKER_TYPE_TELEMETRY | coworker 类型遥测 |
AGENT_TRIGGERS | Agent 触发器(CronCreate 等定时触发) |
AGENT_TRIGGERS_REMOTE | Agent 远程触发器 |
AGENT_MEMORY_SNAPSHOT | Agent 内存快照 |
BASH_CLASSIFIER | Bash 命令分类器(判断安全风险) |
TRANSCRIPT_CLASSIFIER | 对话记录分类器(判断 handoff 需求) |
VERIFICATION_AGENT | 验证 agent(审查另一个 agent 的输出) |
VOICE_MODE | 语音交互模式 |
内存与上下文 (Memory / Context)
| Flag | 说明 |
|---|
EXTRACT_MEMORIES | 自动记忆提取(从对话中提取持久记忆) |
MEMORY_SHAPE_TELEMETRY | 记忆形状遥测 |
CACHED_MICROCOMPACT | 缓存微压缩 |
CONTEXT_COLLAPSE | 上下文折叠(长上下文压缩) |
REACTIVE_COMPACT | 响应式压缩 |
HISTORY_SNIP | 历史裁剪(精简历史记录) |
HISTORY_PICKER | 历史拾取器 |
BREAK_CACHE_COMMAND | 缓存击穿命令 |
PROMPT_CACHE_BREAK_DETECTION | 提示缓存断裂检测 |
REVIEW_ARTIFACT | 审查产物 |
MCP 与工具系统 (MCP / Tools)
| Flag | 说明 |
|---|
MCP_RICH_OUTPUT | MCP 富输出(结构化结果显示) |
MCP_SKILLS | MCP 技能集成 |
CHICAGO_MCP | "Chicago" MCP 服务器(项目代号) |
WEB_BROWSER_TOOL | 网页浏览器工具 |
MONITOR_TOOL | 监控工具 |
OVERFLOW_TEST_TOOL | 溢出测试工具 |
TERMINAL_PANEL | 终端面板工具 |
UDS_INBOX | Unix Domain Socket 收件箱(点对点通信) |
BUDDY | Buddy 彩蛋(陪伴精灵) |
TREE_SITTER_BASH | Tree-sitter Bash 解析(语法分析) |
TREE_SITTER_BASH_SHADOW | Tree-sitter Bash 影子模式(并行验证) |
技能与模板 (Skills / Templates)
| Flag | 说明 |
|---|
SKILL_IMPROVEMENT | 技能改进(自动优化 skill) |
EXPERIMENTAL_SKILL_SEARCH | 实验性技能搜索 |
RUN_SKILL_GENERATOR | 技能生成器运行 |
TEMPLATES | 模板系统 |
WORKFLOW_SCRIPTS | 工作流脚本 |
HOOK_PROMPTS | Hook 提示词系统 |
MESSAGE_ACTIONS | 消息操作 |
自托管 / 企业 (Self-Hosted / Enterprise)
| Flag | 说明 |
|---|
SELF_HOSTED_RUNNER | 自托管运行器 |
SHOT_STATS | 命中统计数据 |
ABLATION_BASELINE | 消融实验基线(A/B 测试对照) |
ENHANCED_TELEMETRY_BETA | 增强遥测 Beta |
ANTI_DISTILLATION_CC | 反蒸馏保护(Claude Code) |
COMMIT_ATTRIBUTION | 提交归属追踪 |
TOKEN_BUDGET | Token 预算控制 |
NATIVE_CLIPBOARD_IMAGE | 原生剪贴板图片支持 |
构建与集成 (Build / Integration)
| Flag | 说明 |
|---|
LODESTONE | Lodestone 集成(应用程序协议注册/深度链接) |
BUILDING_CLAUDE_APPS | 构建 Claude Apps 模式 |
ULTRA PLAN (ULTRAPLAN) | 超长步骤规划模式 |
ULTRATHINK | 超长思考模式 |
BASH_CLASSIFIER | Bash 命令分类器 |
POWERSHELL_AUTO_MODE | PowerShell 自动模式 |
TORCH | Torch 命令(Claude Code 诊断/调试工具) |
CONNECTOR_TEXT | 连接器文本模式 |
AWAY_SUMMARY | 离开摘要(用户不在时生成摘要) |
使用模式分布
这些 flag 在代码库中按以下模式使用:
1. 条件导入(最常用)
const someModule = feature('SOME_FLAG')
? require('./path/to/module.js').default
: null
2. 条件注册
if (feature('SOME_FLAG')) {
commands.register(someCommand)
tools.register(someTool)
}
3. 条件执行
if (feature('SOME_FLAG') && condition) {
}
4. 组合表达式
feature('KAIROS') || feature('KAIROS_BRIEF')
feature('DAEMON') && feature('BRIDGE_MODE')
当前构建中实际激活的 flag
从代码行为反推,当前公开发布的 CLI 版本中大概率激活的 flag:
| 激活状态 | Flag |
|---|
| ✅ 激活 | SSH_REMOTE(claude ssh 子命令可见) |
| ✅ 激活 | FORK_SUBAGENT(fork 子命令可见) |
| ✅ 激活 | AGENT_TRIGGERS(cron 工具可用) |
| ✅ 激活 | TRANSCRIPT_CLASSIFIER(自动模式切换) |
| ✅ 激活 | MCP_RICH_OUTPUT |
| ✅ 激活 | AUTO_THEME |
| ❌ 未激活 | KAIROS / PROACTIVE(公开版无主动模式) |
| ❌ 未激活 | BRIDGE_MODE |
| ❌ 未激活 | DAEMON(外部无守护进程模式) |
| ❌ 未激活 | VOICE_MODE |
| ❌ 未激活 | COORDINATOR_MODE |
注:确切激活状态由 Anthropic 的构建配置决定,以上是基于代码行为的推断。
参考
- 定义位置:
bun:bundle(Bun 内置,非项目内实现)
- 使用文件:
src/main.tsx, src/commands.ts, src/tools.ts, src/QueryEngine.ts, src/setup.ts, src/context.ts
- 构建时完全消除死代码,零运行时开销