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

55 lines
1.9 KiB
Markdown

# 针对上下文过载和截断的 Antigravity 恢复
当 Antigravity 为当前任务加载了太多技能并开始出现截断、上下文或轨迹转换错误时,请使用本指南。
典型症状:
- 代理仅当存在大型技能文件夹时崩溃
- 错误提到截断、上下文转换或无法转换的轨迹/消息
- 问题在大型仓库或长时间运行的任务中更频繁出现
## Linux 和 macOS 快速路径
使用激活脚本保持完整库归档,同时在实时 Antigravity 目录中仅暴露您需要的包或技能。
1. 完全关闭 Antigravity。
2. 如果您还没有克隆此仓库,请在本地某处克隆。
3. 从克隆的仓库运行激活脚本。
示例:
```bash
./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` 首先归档当前活动目录,然后恢复选定的集合
可选的环境覆盖:
```bash
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 特定的恢复指南:
- [windows-truncation-recovery.md](windows-truncation-recovery.md)
该指南涵盖了当主机不断重新打开相同损坏会话时所需的浏览器/应用存储清理。
## 预防提示
- 从包中的 3-5 个技能开始,而不是一次暴露整个库
- 在打开非常大的仓库之前使用包激活
- 保持特定于角色的栈活动,归档其余部分
- 如果主机存储了损坏的会话状态,请在恢复较小的活动集之前清除该主机状态