README

上下文管理是 Claude Code 的核心挑战之一。在 200K token 预算限制下，需要激进的压缩策略。

五层压缩策略

Claude Code 采用分层的上下文压缩机制：

Layer 1: Tool Result Budget (限制单个工具结果)
  ↓
Layer 2: Snip (智能裁剪文件内容)
  ↓
Layer 3: Microcompact (压缩工具调用历史)
  ↓
Layer 4: Context Collapse (折叠旧对话)
  ↓
Layer 5: Auto Compact (自动触发压缩)

章节内容

• Tool Result Budget - 工具结果大小限制

• Microcompact - 工具调用历史压缩

• Context Collapse - 对话历史折叠

• Auto Compact - 自动压缩触发

Token 预算分配

const TOKEN_BUDGET = {
  total: 200000,           // Claude API 限制
  systemPrompt: 20000,     // System Prompt
  conversation: 150000,    // 对话历史
  toolResults: 20000,      // 工具结果
  reserved: 10000,         // 保留缓冲
};

压缩触发条件

function shouldCompress(tokenCount: number): CompressionLevel {
  if (tokenCount > 180000) {
    return 'aggressive';  // 激进压缩
  } else if (tokenCount > 150000) {
    return 'standard';    // 标准压缩
  } else if (tokenCount > 120000) {
    return 'light';       // 轻度压缩
  }
  return 'none';
}

压缩效果

典型的压缩效果：

压缩层级	压缩前	压缩后	压缩率
Tool Result Budget	100K	50K	50%
Microcompact	50K	30K	40%
Context Collapse	30K	15K	50%
Auto Compact	15K	8K	47%

下一步

• 了解 Tool Result Budget 的实现

• 探索 Microcompact 的压缩算法

• 查看 Auto Compact 的触发机制