diff --git a/docs/internals/ant-only-world.mdx b/docs/internals/ant-only-world.mdx
index ecf242bba..e84608441 100644
--- a/docs/internals/ant-only-world.mdx
+++ b/docs/internals/ant-only-world.mdx
@@ -1,53 +1,31 @@
---
-title: "Ant 特权世界 - Anthropic 员工专属功能"
-description: "完整记录 Claude Code 身份门控层：USER_TYPE === 'ant' 时解锁的专属工具、命令、API 和代号体系，揭示内外部构建的差异。"
-keywords: ["Ant 特权", "USER_TYPE", "身份门控", "内部功能", "Anthropic 员工"]
+title: "Ant 特权世界"
+description: "Anthropic 内部构建与公开发布版本的差异。理解身份门控机制、Ant-Only 工具/命令和 Beta Header 的分层设计。"
+keywords: ["Ant 特权", "USER_TYPE", "身份门控", "内部功能"]
---
-{/* 本章目标：完整记录身份门控层——ant 构建独享的一切 */}
-
## 什么是 Ant
-`USER_TYPE` 是一个构建时常量，通过 Bun 打包器的 `--define` 注入。在 Anthropic 的内部构建中它被设为 `'ant'`，在公开发布的版本中是 `'external'`：
+Claude Code 有两种构建：Anthropic 员工使用的内部构建（`USER_TYPE === 'ant'`）和公开发布的外部构建（`USER_TYPE === 'external'`）。
-```typescript
-// 反编译版本（src/types/global.d.ts 第 63 行）
-// Build-time constants BUILD_TARGET/BUILD_ENV/INTERFACE_TYPE — removed (zero runtime usage)
-```
+`USER_TYPE` 是构建时常量，通过 Bun 的 `--define` 注入。外部构建中，所有 `process.env.USER_TYPE === 'ant'` 判断被编译器折叠为 `false`，后续代码被死代码消除（DCE）移除。
-`BUILD_TARGET` 等构建时常量在反编译版本中已被移除。`USER_TYPE` 通过 Bun 的 `--define` 或环境变量注入，Bun 会进行**常量折叠**——所有 `process.env.USER_TYPE === 'ant'` 在外部构建中直接变为 `false`，后续代码被 DCE 移除。但在反编译版本中，这些代码保留完整。
-
-`USER_TYPE === 'ant'` 在代码库中出现 **351+ 次**（跨 163 个文件），另有 `!== 'ant'` 59 次（跨 38 个文件），总计 **410+ 处引用**，控制着工具、命令、API、UI 等方方面面。
+这个门控在代码库中出现 410+ 处，控制着工具、命令、API、UI 等方方面面。
## Ant-Only 工具
-以下工具仅在内部构建中被加载到工具注册表：
+| 工具 | 用途 |
+|------|------|
+| **REPLTool** | 高级 REPL 模式——在 VM 中包装其他工具 |
+| **ConfigTool** | 交互式配置编辑器，包含 Gates 标签页覆盖 feature flags |
+| **SuggestBackgroundPRTool** | 建议在后台创建 PR |
+| **TungstenTool** | 基于 tmux 的终端面板工具 |
-| 工具 | 代码位置 | 用途 |
-|------|---------|------|
-| **REPLTool** | `packages/builtin-tools/src/tools/REPLTool/` | 高级 REPL 模式——在 VM 中包装 Bash/Read/Edit/Glob/Grep/Agent 等工具 |
-| **SuggestBackgroundPRTool** | `packages/builtin-tools/src/tools/SuggestBackgroundPRTool/` | 建议在后台创建 PR |
-| **ConfigTool** | `packages/builtin-tools/src/tools/ConfigTool/` | 交互式配置编辑器，包含 Gates 标签页用于覆盖 GrowthBook flags |
-| **TungstenTool** | `packages/builtin-tools/src/tools/TungstenTool/` | 基于 tmux 的终端面板工具（反编译版中已 stub） |
-
-```typescript
-// src/tools.ts 第 14-24 行——条件导入 + Dead Code Elimination 标记
-// Dead code elimination: conditional import for ant-only tools
-/* eslint-disable custom-rules/no-process-env-top-level, @typescript-eslint/no-require-imports */
-const REPLTool =
- process.env.USER_TYPE === 'ant'
- ? require('@claude-code-best/builtin-tools/tools/REPLTool/REPLTool.js').REPLTool
- : null
-const SuggestBackgroundPRTool =
- process.env.USER_TYPE === 'ant'
- ? require('@claude-code-best/builtin-tools/tools/SuggestBackgroundPRTool/SuggestBackgroundPRTool.js')
- .SuggestBackgroundPRTool
- : null
-```
+**设计考量**：这些工具要么涉及内部基础设施（如 GrowthBook flag 覆盖），要么需要 Anthropic 特有的 API 支持。对外部用户暴露它们没有意义——甚至可能引起混淆。
## Ant-Only 命令
-`src/commands.ts` 注册了 **24+** 个仅在内部构建中可用的斜杠命令（`INTERNAL_ONLY_COMMANDS`，lines 267-295），在 `USER_TYPE === 'ant' && !IS_DEMO` 时才加载（line 400-401）：
+内部构建注册了 24+ 个额外的斜杠命令，覆盖调试、实验、工作流和基础设施：
@@ -56,14 +34,6 @@ const SuggestBackgroundPRTool =
- `debugToolCall` — 调试工具调用
- `env` — 显示环境变量
- `mockLimits` — 模拟速率限制
- - `resetLimits` — 重置速率限制
- - `resetLimitsNonInteractive` — 重置速率限制（非交互式）
-
-
- - `bughunter` — Bug 猎人模式
- - `goodClaude` — 质量评估工具
- - `antTrace` — 追踪分析
- - `perfIssue` — 性能问题诊断
- `commit` — 快速提交
@@ -72,139 +42,75 @@ const SuggestBackgroundPRTool =
- `autofixPr` — 自动修复 PR 中的问题
- `share` — 分享会话
- `summary` — 生成摘要
- - `subscribePr` — 订阅 PR（需要 `KAIROS_GITHUB_WEBHOOKS` feature flag）
- - `forceSnip` — 强制截断历史（需要 `HISTORY_SNIP` feature flag）
- - `ultraplan` — 超级规划（需要 `ULTRAPLAN` feature flag，单独注册于 `commands.ts:396`）
- `backfillSessions` — 回填会话数据
- `bridgeKick` — 重启 Bridge 连接
- `oauthRefresh` — 刷新 OAuth Token
- - `teleport` — 传送到指定上下文
- - `onboarding` — 新手引导
- - `agentsPlatform` — Agents 平台管理
- - `version` — 内部版本详情
- - `initVerifiers` — 初始化验证器
-
-这些命令在 `IS_DEMO` 模式下也会被隐藏，防止在演示环境中暴露内部功能。
-
+这些命令在演示模式（`IS_DEMO`）下也被隐藏，防止在公开演示中暴露内部功能。
-## Beta API Headers
+## Beta API Headers 的分层
-Claude Code 向 API 发送的 beta headers 分布在 `src/constants/betas.ts`（主注册表）和其他文件中，按可见性分为以下几类：
+Claude Code 向 API 发送的 beta headers 按可见性分为多层：
-### 公开 Headers（所有构建均发送）
+### 公开 Headers（所有构建）
-| Header | 功能 | 额外条件 |
-|--------|------|----------|
-| `claude-code-20250219` | Claude Code 标识 | 非 Haiku 时始终发送；Haiku 在 agentic 模式下也发送 |
-| `effort-2025-11-24` | 推理强度控制 | 动态注入 |
-| `task-budgets-2026-03-13` | 任务预算 | 始终通过 `addAgenticBetas()` 注入 |
-| `fast-mode-2026-02-01` | 快速模式 | 通过 sticky-on latch 动态注入 |
-| `advisor-tool-2026-03-01` | 顾问工具 | 启用 advisor 时动态注入 |
-| `advanced-tool-use-2025-11-20` | 工具搜索（1P） | Claude API / Foundry |
-| `tool-search-tool-2025-10-19` | 工具搜索（3P） | Vertex / Bedrock |
-
-### 模型能力相关（有条件发送）
-
-| Header | 功能 | 条件 |
-|--------|------|------|
-| `interleaved-thinking-2025-05-14` | 交错思考模式 | 模型支持 ISP 且未禁用 |
-| `context-1m-2025-08-07` | 1M 上下文窗口 | 模型支持 1M context |
-| `context-management-2025-06-27` | 上下文管理 | Claude 4+ 或 ant 手动启用 |
-| `structured-outputs-2025-12-15` | 结构化输出 | Claude 4.5/4.6 + GrowthBook `tengu_tool_pear` |
-| `web-search-2025-03-05` | 网页搜索 | Vertex (Claude 4+) / Foundry |
-| `redact-thinking-2026-02-12` | 思维摘要/脱敏 | ISP 模型 + 非交互 + 未强制显示思维 |
-| `prompt-caching-scope-2026-01-05` | 提示缓存作用域 | firstParty/foundry + 全局缓存 |
+| Header | 功能 |
+|--------|------|
+| `claude-code-20250219` | Claude Code 标识 |
+| `effort-2025-11-24` | 推理强度控制 |
+| `interleaved-thinking-2025-05-14` | 交错思考模式 |
+| `context-1m-2025-08-07` | 1M 上下文窗口 |
### Ant-Only Headers
-| Header | 功能 | 条件 |
-|--------|------|------|
-| **`cli-internal-2026-02-09`** | 内部 CLI 功能 | `USER_TYPE === 'ant'` + CLI 入口 |
-| **`token-efficient-tools-2026-03-28`** | Token 高效工具 | `USER_TYPE === 'ant'` + GrowthBook `tengu_amber_json_tools` |
+| Header | 功能 |
+|--------|------|
+| `cli-internal-2026-02-09` | 内部 CLI 功能 |
+| `token-efficient-tools-2026-03-28` | Token 高效工具 |
-### Feature Flag Gated
-
-| Header | 功能 | 条件 |
-|--------|------|------|
-| **`afk-mode-2026-01-31`** | AFK 模式（离开键盘自动审批） | `feature('TRANSCRIPT_CLASSIFIER')` |
-
-### 其他特殊 Headers
-
-| Header | 功能 | 来源 |
-|--------|------|------|
-| `oauth-2025-04-20` | OAuth 订阅者标识 | `src/constants/oauth.ts`，Pro/Max/Team/Enterprise |
-| `environments-2025-11-01` | Bridge 环境 API | `src/bridge/bridgeApi.ts`，仅 Bridge 模式 |
-
-```typescript
-// src/constants/betas.ts — 常量定义
-export const TOKEN_EFFICIENT_TOOLS_BETA_HEADER =
- 'token-efficient-tools-2026-03-28'
-export const CLI_INTERNAL_BETA_HEADER =
- process.env.USER_TYPE === 'ant' ? 'cli-internal-2026-02-09' : ''
-```
-
-```typescript
-// src/utils/betas.ts 第 315-321 行——TOKEN_EFFICIENT_TOOLS 的实际门控逻辑
-if (
- process.env.USER_TYPE === 'ant' &&
- includeFirstPartyOnlyBetas &&
- tokenEfficientToolsEnabled // GrowthBook 'tengu_amber_json_tools' flag
-) {
- betaHeaders.push(TOKEN_EFFICIENT_TOOLS_BETA_HEADER)
-}
-```
-
-`cli-internal` header 意味着 Anthropic 的 API 服务端也维护着一套 ant-only 的服务端行为——这不仅仅是客户端的门控。`token-efficient-tools` 进一步需要 GrowthBook flag 开启，说明 Ant 员工内部也有分层灰度。
+**设计洞察**：`cli-internal` header 说明 Anthropic 的 API 服务端也维护着 ant-only 的行为——这不只是客户端门控，而是端到端的功能隔离。
## 内部代号体系
-Anthropic 有浓厚的"动物命名"文化：
+Anthropic 有"动物命名"文化：
-| 代号 | 身份 | 出处 |
-|------|------|------|
-| **Tengu**（天狗） | Claude Code 项目代号 | 所有 GrowthBook flags 的 `tengu_` 前缀、分析事件名称 |
-| **Capybara**（水豚） | 模型代号 | `src/constants/prompts.ts` 中被 Undercover Mode 屏蔽的名称 |
-| **Fennec**（耳廓狐） | 已退役模型别名 | `src/migrations/migrateFennecToOpus.ts`——曾用名已迁移到 Opus |
+| 代号 | 身份 |
+|------|------|
+| **Tengu**（天狗） | Claude Code 项目代号（所有内部 flag 的 `tengu_` 前缀） |
+| **Capybara**（水豚） | 模型代号 |
+| **Fennec**（耳廓狐） | 已退役模型别名（已迁移到 Opus） |
-这些代号通过 Undercover Mode 在公开仓库的 commit 中被严格过滤。
+这些代号通过 Undercover Mode 在公开仓库的 commit 中被过滤。
## 环境变量开关
-除了 `USER_TYPE`，还有一系列精细的环境变量控制各项功能：
-
- `CLAUDE_CODE_SIMPLE` — 简化模式（禁用高级功能）
- `CLAUDE_CODE_DISABLE_THINKING` — 禁用 thinking
- - `DISABLE_INTERLEAVED_THINKING` — 禁用交错思考
- - `DISABLE_COMPACT` — 禁用消息压缩
- `DISABLE_AUTO_COMPACT` — 禁用自动压缩
- `CLAUDE_CODE_DISABLE_AUTO_MEMORY` — 禁用自动记忆
- - `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` — 禁用后台任务
- `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` — 禁用实验性 beta headers
- - `USE_API_CONTEXT_MANAGEMENT` — 上下文管理工具清除（需 ant）
- `CLAUDE_CODE_VERIFY_PLAN` — 启用 VerifyPlanExecutionTool
- - `ENABLE_LSP_TOOL` — 启用 LSP 语言服务器工具
+ - `ENABLE_LSP_TOOL` — 启用 LSP 工具
- `CLAUDE_CODE_UNDERCOVER` — 强制启用 Undercover Mode
- - `CLAUDE_CODE_TERMINAL_RECORDING` — 启用终端录制（asciicast）
- - `CLAUDE_CODE_ABLATION_BASELINE` — 启用基线对照模式
- - `CLAUDE_CODE_REMOTE` — 远程执行模式（自动增加堆内存限制）
+ - `CLAUDE_CODE_REMOTE` — 远程执行模式
- `CLAUDE_CODE_COORDINATOR_MODE` — 启用 Coordinator 模式
- - `CLAUDE_INTERNAL_FC_OVERRIDES` — GrowthBook flag 覆盖（ant-only）
- `IS_DEMO` — 演示模式（隐藏内部命令和敏感信息）
- - `CLAUDE_CODE_ENTRYPOINT` — 入口类型标识（`cli` | 其他）
-
-`ABLATION_BASELINE` 特别有趣——它同时关闭 thinking、compaction、auto-memory 和 background tasks，用于测量这些高级功能对 AI 表现的**因果影响**。这是一个严肃的"科学对照实验"工具。
-
+`CLAUDE_CODE_ABLATION_BASELINE` 特别有趣——它同时关闭 thinking、compaction、auto-memory 和 background tasks，用于测量这些高级功能对 AI 表现的**因果影响**。这是一个严肃的"科学对照实验"工具。
+
+## 接下来
+
+- **Feature Flags** — 理解功能开关的设计
+- **权限模型** — 理解身份门控与权限的协作