用途:主动管理 Claude Code 的上下文窗口,避免达到上限后才被动恢复。通过令牌监控、上下文提取与选择性重注入,在压缩前保留关键内容并按需恢复。
主要能力:使用 context_manager 工具进行状态检查、创建快照、重注入和列出快照。检查状态返回使用百分比、阈值状态(ok/consider/recommended/urgent)与建议。创建快照支持命名,保存到 ~/.amplihack/.claude/runtime/context-snapshots/。重注入支持 essential(约250令牌,仅需求与当前状态)、standard(约800,含关键决策与待办)、comprehensive(约1250,含完整决策、工具与元数据)三级。
v3.0 增强:预测性预算监控估算达到阈值的时间与工具次数;令牌消耗速率跟踪按速率调整检查频率(低<1K/工具每50次,中1-5K每10次,高>5K每3次,70%以上每次);优先级保留,始终保留原始需求、架构决策、实现状态与阻塞项,日志等低优先级仅进入 comprehensive;提供 [CTX:OK]/[CTX:WATCH]/[CTX:WARN]/[CTX:CRITICAL] 状态指示供状态栏集成。
使用方式:从 context_manager 导入 check_context_status、create_context_snapshot、rehydrate_from_snapshot、list_context_snapshots 等函数调用。全程通过 post_tool_use hook 自动运行,按阈值(如 1M 模型在 30%、40%、50%)创建快照,检测令牌下降超 30% 的压缩并自动重注入。
适用场景:长会话、复杂任务、上下文切换、团队交接、预测性规划与状态监控。限制:需要用 Claude Code 并存在相应工具文件,其他模型或工具不一定适用;快照与日志写入本地目录,快照 ID 需自行保存;自动功能依赖 hook 配置;工具具体依赖与完整 API 参考以工具文档为准。