context-optimization

上下文优化中心

适用场景

• 阈值警报：当上下文使用量接近窗口容量的 50% 时。
• 复杂任务：需要分析多个文件或调用较长工具链的操作。

不适用场景

• 上下文使用量较低的简单单步任务
• 已在使用 mcp-code-execution 处理工具链

中心的核心职责

1. 评估上下文压力和 MECW 合规性。
2. 路由至适当的专用模块。
3. 协调基于子 Agent 的工作流。
4. 管理各模块的令牌预算分配。
5. 汇总模块化执行的结果。

模块选择策略

def select_optimal_modules(context_situation, task_complexity):
    if context_situation == "CRITICAL":
        return ["mecw-assessment", "subagent-coordination"]
    elif task_complexity == "high":
        return ["mecw-principles", "subagent-coordination"]
    else:
        return ["mecw-assessment"]

上下文分类

使用率	状态	操作
< 30%	LOW	正常继续
30-50%	MODERATE	监控并应用相关原则
> 50%	CRITICAL	立即进行优化

大型输出处理（Claude Code 2.1.2+）

行为变更：大型 bash 命令和工具输出会保存到磁盘，而不是被截断；系统会提供文件引用以供访问。

对上下文优化的影响

场景	2.1.2 之前	2.1.2 之后
大型测试输出	被截断，仅有部分数据	通过文件引用获取完整输出
冗长的构建日志	超过 30K 字符后丢失	完整保存，可按需访问
上下文压力	因截断而降低	不变——仅在读取时加载

最佳实践

• 避免预先读取：大型输出会以引用形式提供，不会自动加载到上下文中。
• 选择性读取：对文件引用使用 head、tail 或 grep。
• 使用完整数据：质量关卡可通过文件访问完整测试结果。
• 监控增长：文件引用占用空间很小，但读取完整文件会增加上下文用量。

集成点

• 令牌节省：接收用量策略，并返回符合 MECW 的优化方案。
• CPU/GPU 性能：使上下文优化与资源限制保持一致。
• MCP Code Execution：将复杂模式委托给专用 MCP 模块。

资源

• MECW 理论：参见 modules/mecw-principles.md，了解核心概念、50% 规则和快速入门代码示例。
• 上下文分析：参见 modules/mecw-assessment.md，了解风险识别。
• 工作流委托：参见 modules/subagent-coordination.md，了解分解模式。
• 上下文等待：参见 modules/context-waiting.md，了解延迟加载策略。
• 缓存对齐：参见 modules/cache-aligned-prefixes.md，了解如何排列上下文以命中提供商的 KV 缓存（稳定前缀在前，易变部分在后）。
• 压缩方案选择：参见 modules/compression-strategies.md，选择 /clear 和 /catchup、续接 Agent、归档并总结或委托，并了解各自的节省效果和风险。
• 大型工具输出：参见 modules/reversible-compression.md，了解如何将超大输出归档为可检索的句柄。
• 粘贴的日志：参见 modules/log-debugging-hygiene.md，了解如何在压缩前筛选日志。/filter-log 以此为准。

故障排查

常见问题

如果优化后上下文使用量仍然很高，请检查是否有大型文件被整体读取，而不是选择性读取。如果 MECW 评估失败，请确认环境提供了准确的令牌计数元数据。如果向 /tmp 写入输出日志时遇到权限错误，请确认项目的临时目录可写。

退出条件

• 已依据 MECW 50% 规则评估上下文压力
• 已记录当前状态对应的记忆层级或路由决策
• 大型输出通过文件或句柄引用，而非完整读取
• 当请求控制提供商负载时，已根据 modules/cache-aligned-prefixes.md 检查前缀顺序（稳定内容在前，易变内容在后）
• 当运行环境已缓存时，优化已降级为建议（对于不会重复的前缀，写入缓存的成本高于节省的成本）