企业官网建设流程全解析

AG Kit版本迁移：从旧版升级到Antigravity-native的完整指南

【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit

AG Kit是一款模块化AI代理工具包（Modular AI Agent Toolkit），本指南将帮助你安全、高效地从AG Kit旧版升级到Antigravity-native版本，解锁全新的AI代理运行时能力。

为什么需要升级到Antigravity-native版本？

Antigravity-native版本为AG Kit带来了革命性的运行时架构，新增了安全策略、MCP同步和插件构建系统。升级后，你将获得:

• 更强大的工具调用安全防护
• 与MCP服务器的无缝集成能力
• 原生的Antigravity工作流支持

升级前的准备工作

在开始升级前，请确保完成以下步骤：

1. 提交或暂存所有项目工作，避免升级过程中丢失数据
2. 验证当前AG Kit安装状态是否健康：

   npm run check:agents

3. 预览更新计划，了解将要发生的变化：

   ag-kit update --dry-run

4. 仔细检查预览结果中显示的所有本地修改的.agents文件

执行升级的简单步骤

完成准备工作后，执行以下命令开始升级：

ag-kit update

注意：AG Kit会在修改托管文件前自动创建备份，不会静默替换本地修改的文件。如有冲突，会生成冲突报告和传入副本供你手动处理。

升级后的验证与测试

升级完成后，务必进行以下验证步骤，确保系统正常工作：

npm run check:agents # 验证工具包完整性 npm run check:antigravity # 运行Antigravity诊断工具 npm run test:antigravity # 执行Antigravity回归测试 npm run build:antigravity-plugin # 构建Antigravity插件

预期结果：

• 工具包验证通过
• Antigravity诊断工具报告无错误
• 看到YOUR_API_KEY警告属于正常现象（配置MCP示例后消失）
• 所有Antigravity回归测试通过
• 成功创建dist/antigravity-plugin/目录

Antigravity工作区冒烟测试

将项目作为受信任的Antigravity工作区打开，验证以下功能：

1. 确认.agents/rules/、.agents/skills/和.agents/workflows/目录被正确发现
2. 检查/coordinate和/orchestrate接口是否可用
3. 测试普通命令如npm test是否被允许执行
4. 验证安全钩子能阻止模拟的破坏性命令：

   printf '%s' '{"tool_args":{"CommandLine":"rm -rf /"}}' \ | node .agents/hooks/validate-tool-call.mjs

警告：不要执行真实的破坏性命令来测试安全钩子！

MCP配置迁移指南

仓库中的.agents/mcp_config.json是工作区的配置源，包含示例占位符，不会自动复制到主目录。迁移步骤：

1. 首先检查配置：

   node .agents/hooks/sync-mcp.mjs --check node .agents/hooks/sync-mcp.mjs --print

2. 替换占位符后，显式应用到目标：

   node .agents/hooks/sync-mcp.mjs --apply --target suite node .agents/hooks/sync-mcp.mjs --apply --target cli

配置规则：

• 未解析的占位符会阻止--apply执行
• 除非提供--force，否则保留现有服务器名称
• 写入前会备份现有目标文件
• 凭据必须保持在版本控制之外

安全钩子兼容性处理

当Antigravity发送无效JSON或无法识别的命令负载时，钩子会"失败开放"（fail open），避免上游负载变化导致整个工作区被锁定。要临时禁用AG Kit钩子：

{ "enabled": false }

重要：请保持Antigravity的原生权限和工作区信任控制启用。如遇负载兼容性问题，请私下报告（日志可能包含敏感信息）。

可选：Antigravity插件迁移

插件安装是可选的，建议先构建并检查：

npm run build:antigravity-plugin agy plugin install ./dist/antigravity-plugin agy plugin list

提示：仓库原生的.agents/目录仍是项目的事实来源，避免同时编辑生成的插件内容和源.agents文件。

回滚方案：如何恢复到之前版本

如果需要回滚到升级前的状态，执行：

ag-kit rollback

回滚后，需重新打开Antigravity以重新加载之前的工作区配置。如果已显式同步全局MCP文件，需单独恢复其带时间戳的.ag-kit-backup-*备份文件。

兼容性总结表

通过以上步骤，你已成功将AG Kit升级到Antigravity-native版本，享受更安全、更强大的AI代理开发体验！如有任何迁移问题，可查阅项目中的MIGRATION.md获取更多细节。

【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit