Context Length Exceeded：上下文窗口超限排查与修复

请求返回 context_length_exceeded、maximum context length 或提示输入加最大输出超过模型窗口。长会话也可能不报错但出现压缩、遗忘或质量下降。

客户端界面只展示用户消息，实际请求还可能包含系统指令、仓库规则、MCP 工具 schema、附件、历史工具结果和预留输出 Token。

上下文超限既可能来自一次超大输入，也可能来自会话持续累积。切换更大窗口模型并不能替代上下文治理，还会改变成本和行为。

从新会话发送最小请求，确认模型与认证正常。随后按系统指令、必要文件、工具和历史逐类恢复，识别主要预算来源。

不要把敏感仓库内容上传第三方 Token 计算网站。优先使用客户端自身的 context/status 视图或本地 Token 工具。

删除无关历史与工具结果，用可审查摘要保留决策、文件和验证命令；大文件先本地过滤再提供必要片段。输出预算按任务需要设置，不要总是使用最大值。

在缩减后的新会话中重复原任务，确认请求不再超限且关键约束仍被正确执行。记录输入规模、输出上限、成本和质量变化。

不要为了计算 Token 把私有代码、密钥或用户数据粘贴到未知网站。压缩摘要也必须删除凭据，并避免把秘密从短期上下文持久化到仓库规则。