跳转至

Reference: DCE Product Matrix

目的:速查 DCE feature flag 矩阵(商业版 vs ANT-ONLY) 关联:topics/dce-deep-dive.md、docs/FEATURE_FLAGS.md


1. 总览

维度 数字
已知 feature flag 19+
推测 30+
ANT-ONLY 字符串引用 50+
商业版节省代码 ~25000 行

4 指标。


2. 19+ Feature Flag 矩阵

Flag 类别 商业版 ANT 版 影响文件
COORDINATOR_MODE AI ❌ ✅ coordinator/, services/swarm/
KAIROS AI ❌ ✅ assistant/, kairosGate
PROACTIVE AI ❌ ✅ proactive/, useProactive
AGENT_TRIGGERS AI ❌ ✅ hooks/useScheduledTasks
TRANSCRIPT_CLASSIFIER AI ❌ ✅ autoModeState
DIRECT_CONNECT 集成 ✅ ✅ bridge/, server/
LODESTONE 集成 ❌ ✅ utils/deepLink/
SSH_REMOTE 集成 ❌ ✅ services/ssh/
BUDDY 集成 ❌ ✅ buddy/, CompanionSprite
VOICE_MODE 集成 ❌ ✅ voice/, useVoiceIntegration
MCP_SKILLS 工具 ❌ ✅ services/mcp/skills/
CHICAGO_MCP 工具 ❌ ✅ computerUseWrapper
WEB_BROWSER_TOOL 工具 ❌ ✅ tools/WebBrowserTool/
MESSAGE_ACTIONS 工具 ❌ ✅ hooks/useMessageActions
BASH_MODE_PROGRESS 工具 ❌ ✅ components/BashModeProgress
COMPACTION_REMINDERS 性能 ❌ ✅ getCompactionReminder
HISTORY_SNIP 性能 ❌ ✅ getContextEfficiency
UPLOAD_USER_SETTINGS 性能 ❌ ✅ services/settingsSync/
EXPERIMENTAL_SKILL_SEARCH 实验 ❌ ✅ skillSearchModules

19 个。


3. ANT-ONLY 双版本差异

3.1 11+ ANT-ONLY CLI 选项

选项 描述 商业版
--delegate-permissions alias for --permission-mode auto ❌
--afk deprecated alias ❌
--dangerously-skip-permissions-with-classifiers deprecated alias ❌
--tasks [id] tasks mode ❌
--agent-teams 强制 multi-agent ❌
--enable-auto-mode opt in auto mode ❌
--proactive proactive 模式 ❌
--brief SendUserMessage 工具 ❌
--assistant 强制 assistant ❌
--channels <servers...> MCP 频道通知 ❌
--dangerously-load-development-channels dev channels ❌
--hard-fail 崩溃 on logError ❌

12+。

3.2 4+ ANT-ONLY 组件

组件 商业版 ANT 版
AntModelSwitchCallout ❌ ✅
UndercoverAutoCallout ❌ ✅
AntModelSwitch ❌ ✅
Buddy 桌宠 ❌ ✅

4 个。


4. 商业版 vs ANT 版总差异

类别 商业版 ANT 版
COORDINATOR_MODE ❌ ✅
KAIROS ❌ ✅
PROACTIVE ❌ ✅
AGENT_TRIGGERS ❌ ✅
TRANSCRIPT_CLASSIFIER ❌ ✅
BUDDY ❌ ✅
VOICE_MODE ❌ ✅
WEB_BROWSER_TOOL ❌ ✅
CHICAGO_MCP ❌ ✅
MCP_SKILLS ❌ ✅
MESSAGE_ACTIONS ❌ ✅
BASH_MODE_PROGRESS ❌ ✅
COMPACTION_REMINDERS ❌ ✅
HISTORY_SNIP ❌ ✅
UPLOAD_USER_SETTINGS ❌ ✅
EXPERIMENTAL_SKILL_SEARCH ❌ ✅
LODESTONE ❌ ✅
SSH_REMOTE ❌ ✅
反调试 ✅ ❌
商业版选项 ✅ ❌(11+ ANT-ONLY)
商业版组件 ✅ ❌(4+ ANT-ONLY)

20+ 差异。


5. DCE 影响估算

5.1 代码量

类别 行数 节省
KAIROS + assistant ~5000 5000
COORDINATOR_MODE ~3000 3000
PROACTIVE ~2000 2000
BUDDY ~1000 1000
VOICE_MODE ~2000 2000
WEB_BROWSER ~3000 3000
AGENT_TRIGGERS ~500 500
TRANSCRIPT_CLASSIFIER ~500 500
CHICAGO_MCP ~1000 1000
MCP_SKILLS ~1000 1000
MESSAGE_ACTIONS ~500 500
其他 ANT-ONLY ~5000 5000
总计 ~25000 ~25000

~25000 行。

5.2 体积

  • 商业版:~480K 行
  • ANT 版:~505K 行
  • 节省:~5%

5% 体积节省。

5.3 启动

  • 商业版:~500ms
  • ANT 版:~600ms(推测)
  • 节省:~100ms

~100ms 启动节省。


6. 3 种 DCE 模式

6.1 feature gate + lazy require

const x = feature('X') ? require('./X.js') : null

最常见。

6.2 getter 包 require

const getX = () => require('./X.js')

循环依赖。

6.3 dynamic import

const { x } = await import('./X.js')

async。


7. 25+ lazy require 完整列表

Module Flag 用途
coordinatorModeModule COORDINATOR_MODE 协调器
assistantModule KAIROS assistant
kairosGate KAIROS 门控
autoModeStateModule TRANSCRIPT_CLASSIFIER auto mode
proactiveModule PROACTIVE/KAIROS proactive
useProactive PROACTIVE/KAIROS hook
useScheduledTasks AGENT_TRIGGERS hook
useVoiceIntegration VOICE_MODE hook
VoiceKeybindingHandler VOICE_MODE handler
AntModelSwitchCallout ant ANT 组件
shouldShowAntModelSwitch ant ANT helper
UndercoverAutoCallout ant ANT 组件
WebBrowserPanelModule WEB_BROWSER_TOOL web
computerUseWrapper CHICAGO_MCP computer use
isComputerUseMCPServer CHICAGO_MCP check
fetchMcpSkillsForClient MCP_SKILLS skill
skillSearchModules EXPERIMENTAL_SKILL_SEARCH search
getTeammateUtils (循环) teammate
getTeammatePromptAddendum (循环) teammate
getTeammateModeSnapshot (循环) teammate
BriefTool prompt + tool (推测) brief
snipCompact (推测) compact
extractMemories (推测) memories
teamMemPaths (推测) team memory
contextCollapse/persist (推测) collapse
autoModeState TRANSCRIPT_CLASSIFIER state

25+。


8. 4 个 ANT-ONLY build 模式

8.1 默认商业版

bun build --production

商业。

8.2 内部 ANT 版

bun build --ant
# 或
bun build --features "KAIROS,COORDINATOR_MODE,..."

ANT。

8.3 全 feature 版

bun build --all-features

全。

8.4 单 feature 测试

bun build --features "BUDDY"

单测。


9. 5 个新 feature 流程

  1. 需求 —— 新功能要门控
  2. 写 flag —— feature('MY_FEATURE')
  3. lazy require —— require('./my-feature.js')
  4. null 兜底 —— 类型 + 运行时
  5. 测试两版 —— 商业 + ANT

5 步。


10. 5 个测试技巧

  1. grep feature —— 列所有
  2. type check —— null 兜底
  3. build 双版 —— 验证 DCE
  4. runtime check —— null 行为
  5. size check —— 体积

5 技巧。


11. 总结

维度 数字
已知 flag 19+
ANT-ONLY 选项 12+
ANT-ONLY 组件 4+
lazy require 25+
节省代码 ~25000 行

5 数字。


12. 速查

# 找所有 feature('X')
grep "feature('" src/ -r

# 找所有 lazy require
grep "require(" src/ -r | grep -v "node_modules"

# 找所有 ANT-ONLY
grep '"external" === .ant.' src/ -r

# 找所有 null 兜底
grep "module?\\." src/ -r

4 grep。


13. 总结

DCE 矩阵 = flag × 版本 × 影响。

核心: - 19+ flag - 商业版 vs ANT - 25+ lazy require - ~25000 行节省

下一步: - 看 dce-deep-dive.md - 看 FEATURE_FLAGS.md - 看 analysis/dce-dead-code-elimination.md