playbook/antigravity-awesome-skills/docs_zh-CN/users/agent-overload-recovery.md

1.9 KiB

针对上下文过载和截断的 Antigravity 恢复

当 Antigravity 为当前任务加载了太多技能并开始出现截断、上下文或轨迹转换错误时,请使用本指南。

典型症状:

  • 代理仅当存在大型技能文件夹时崩溃
  • 错误提到截断、上下文转换或无法转换的轨迹/消息
  • 问题在大型仓库或长时间运行的任务中更频繁出现

Linux 和 macOS 快速路径

使用激活脚本保持完整库归档,同时在实时 Antigravity 目录中仅暴露您需要的包或技能。

  1. 完全关闭 Antigravity。
  2. 如果您还没有克隆此仓库,请在本地某处克隆。
  3. 从克隆的仓库运行激活脚本。

示例:

./scripts/activate-skills.sh "Web Wizard" "Integration & APIs"
./scripts/activate-skills.sh --clear
./scripts/activate-skills.sh brainstorming systematic-debugging

脚本的作用:

  • 将仓库 skills/ 树同步到 ~/.agents/skills_library
  • 在后备存储中保留您的完整库
  • 仅将请求的包或技能 ID 激活到 ~/.agents/skills
  • --clear 首先归档当前活动目录,然后恢复选定的集合

可选的环境覆盖:

AG_BASE_DIR=/custom/antigravity ./scripts/activate-skills.sh --clear Essentials
AG_REPO_SKILLS_DIR=/path/to/repo/skills ./scripts/activate-skills.sh brainstorming

Windows 恢复

如果 Antigravity 在 Windows 上陷入重启循环,请使用 Windows 特定的恢复指南:

该指南涵盖了当主机不断重新打开相同损坏会话时所需的浏览器/应用存储清理。

预防提示

  • 从包中的 3-5 个技能开始,而不是一次暴露整个库
  • 在打开非常大的仓库之前使用包激活
  • 保持特定于角色的栈活动,归档其余部分
  • 如果主机存储了损坏的会话状态,请在恢复较小的活动集之前清除该主机状态