上下文窗口管理
保持 AI 上下文聚焦：含什么、丢什么、何时压缩。
智能体开发进阶
为什么
MCP 参考服务器仓库约有 9 万 GitHub star，代理 AI 基金会成员从 2025 年 12 月的 49 个创始成员增长到 2026 年 8 月的 247 个，显示多智能体生态快速增长。每模型上下文窗口有限。
塞入无关文件、过期错误与聊天历史会稀释对真实任务的注意力。管理上下文是长会话输出质量的最大杠杆。
何时使用
会话 >30 消息、大仓库、或会话中途输出质量下降时主动管理上下文。 单步任务不必多智能体编排——单次智能体调用更简单、更便宜、更可靠。
如何做
1. 仅含答案依赖的文件；其余按名引用。
2. 修复后丢弃过期错误日志；勿让残留历史。
3. 上下文增长时用 /compact（Claude Code）或新会话。
4. 用 @file/@folder（Cursor）或 --scope（Claude Code）限定。
5. 长输出喂回前先摘要。
示例
之前：60 消息聊天含 8 完整文件 + 5 过期堆栈 → 回答退化。
之后：/compact，然后"@file src/api/router.ts 仅此；当前错误：<粘贴>"。
回答质量恢复，因注意力聚焦于活问题。
常见问题
- ⚠错误：智能体在同一工具调用上死循环 → 加最大迭代守卫和最近 N 步动作去重检查。
- ⚠Error: Cannot find module '@modelcontextprotocol/sdk' → `npm install @modelcontextprotocol/sdk`；智能体需 SDK 调用 MCP 工具。
- ⚠错误："Tool timed out after 30000ms" → 调大超时配置或将任务拆成智能体可增量完成的小子任务。
最佳实践
- ✓将上下文视为稀缺资源；含解决任务的最小集。
- ✓约 50 消息时主动压缩，而非质量下降后。
- ✓用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。
常见问题解答
什么是上下文窗口管理？
保持 AI 上下文聚焦：含什么、丢什么、何时压缩。 它可帮助开发者快速理解 上下文窗口管理 的核心价值与适用场景。
如何开始使用上下文窗口管理？
开始使用 上下文窗口管理，建议先掌握以下要点：仅含答案依赖的文件；其余按名引用。
上下文窗口管理 的常见误区有哪些？
使用 上下文窗口管理 时常遇到的问题包括：错误：智能体在同一工具调用上死循环 → 加最大迭代守卫和最近 N 步动作去重检查。；Error: Cannot find module '@modelcontextprotocol/sdk' → `npm install @modelcontextprotocol/sdk`；智能体需 SDK 调用 MCP 工具。；错误："Tool timed out after 30000ms" → 调大超时配置或将任务拆成智能体可增量完成的小子任务。。
上下文窗口管理 的最佳实践是什么？
上下文窗口管理 的最佳实践包括：将上下文视为稀缺资源；含解决任务的最小集。；约 50 消息时主动压缩，而非质量下降后。；用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。。
如何深入学习上下文窗口管理？
从官方文档入手，再在 GitHub 上搜索真实示例；先在小实验仓库验证模式，再应用到生产代码。