AG Kit版本迁移从旧版升级到Antigravity-native的完整指南【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kitAG Kit是一款模块化AI代理工具包Modular AI Agent Toolkit本指南将帮助你安全、高效地从AG Kit旧版升级到Antigravity-native版本解锁全新的AI代理运行时能力。为什么需要升级到Antigravity-native版本Antigravity-native版本为AG Kit带来了革命性的运行时架构新增了安全策略、MCP同步和插件构建系统。升级后你将获得:更强大的工具调用安全防护与MCP服务器的无缝集成能力原生的Antigravity工作流支持升级前的准备工作在开始升级前请确保完成以下步骤提交或暂存所有项目工作避免升级过程中丢失数据验证当前AG Kit安装状态是否健康npm run check:agents预览更新计划了解将要发生的变化ag-kit update --dry-run仔细检查预览结果中显示的所有本地修改的.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工作区打开验证以下功能确认.agents/rules/、.agents/skills/和.agents/workflows/目录被正确发现检查/coordinate和/orchestrate接口是否可用测试普通命令如npm test是否被允许执行验证安全钩子能阻止模拟的破坏性命令printf %s {tool_args:{CommandLine:rm -rf /}} \ | node .agents/hooks/validate-tool-call.mjs警告不要执行真实的破坏性命令来测试安全钩子MCP配置迁移指南仓库中的.agents/mcp_config.json是工作区的配置源包含示例占位符不会自动复制到主目录。迁移步骤首先检查配置node .agents/hooks/sync-mcp.mjs --check node .agents/hooks/sync-mcp.mjs --print替换占位符后显式应用到目标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-*备份文件。兼容性总结表领域迁移影响代理、技能、工作流名称无破坏性重命名内存模式无破坏性变更CLI初始化/更新/回滚保留现有的合并感知行为Antigravity钩子新增且默认启用MCP主目录配置从不自动更改插件新增可选打包路径其他AI运行时Markdown可能仍可用但不保证生产环境支持通过以上步骤你已成功将AG Kit升级到Antigravity-native版本享受更安全、更强大的AI代理开发体验如有任何迁移问题可查阅项目中的MIGRATION.md获取更多细节。【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考