新闻详情

新闻详情

首页 / 资讯中心 / 详情

从v3到v4:Godot AI升级迁移指南与签名自更新系统原理

发布时间:2026/10/1 22:16:55来源:尧图网络
从v3到v4:Godot AI升级迁移指南与签名自更新系统原理
从v3到v4Godot AI升级迁移指南与签名自更新系统原理【免费下载链接】godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.项目地址: https://gitcode.com/gh_mirrors/go/godot-aiGodot AI 是一款为 Godot 引擎打造的 MCP 服务器与 AI 工具集可以让 Claude Code、Codex、Cursor 等 AI 客户端直接操作实时编辑器。本文带你完成一次Godot AI v3 到 v4 的升级迁移并讲清背后签名自更新系统的工作原理——一次点击自动验签、原子替换、失败可回滚无需手动替换文件。为什么 v4 是一次破坏性升级v4 是一次主版本跨越官方称之为 breaking release它不再保留永久性的 v3 运行时分支且要求Godot 4.7 及以上的 4.x 版本。主要变化包括客户端连接方式v4 使用godot-ai attach经 stdio 连接裸的http://127.0.0.1:8000/mcp地址无法完成认证也不再被接受端口与能力轮换跨版本更新会预先选定一对空闲的本地回环端口并写入原子化的端点覆盖项老桥接进程无法再向 v4 认证Cherry Studio 不再支持其 MCP 条目存放在内部数据库中官方无法安全读写需你在应用内自行删除旧的 v3 条目客户端配置自动重钉受支持的客户端条目Claude Code、Codex、Cursor、VS Code 等会被自动迁移更新。一键升级v3 到 v4 的完整步骤整个迁移正常只需三步全程在编辑器内完成无需下载发布文件、运行校验器或手动重启 Godot备份项目像对待任何大版本更新一样提交或备份你的项目确认uvx可用Python 服务器由uvx运行需已安装并在 PATH 中点击一次 Update用 Godot 4.7 打开项目在 Godot AI dock 中点击Update。迁移期间请保持 Godot 打开。插件会准备好并认证 v4、替换整个 add-on 目录树、更新受支持的客户端条目然后自动重启一次匹配的受管服务器。若某个 AI 客户端没有察觉配置变化只需重开那一个客户端——重启所有客户端不是迁移的必要步骤。⚠️ 如果你的 AI 客户端运行在另一台机器或容器里通过裸 URL 访问 v3 的 8000 端口请先按 client-configuration.md 搭建 SSH 启动的桥接再执行升级。迁移胶囊跨版本的关键设计v4 稳定版发布恰好6 个资产正式的 v4 三件套godot-ai-v4-plugin.zip、.manifest.json清单、.manifest.sig清单签名旧命名的迁移胶囊三件套godot-ai-plugin.zip、.sha256、.sha256.sig供 v3 的更新器消费。胶囊不是第二份 v4 发行物而是一个小型桥接插件内部嵌着上面三份正式资产。v3 的签名更新器像处理任何 v3 版本一样认证并解包胶囊桥接随后在编辑器内运行自带的 v4 安装器完成校验内嵌的清单签名、发行身份、压缩包哈希和库存中的每一个文件将校验通过的树暂存到addons/.godot_ai_update/stage/并重新哈希移除 v3 的game_helperautoload把整个旧 add-on含桥接重命名到addons/.godot_ai_update/backup/旧版本/再把新树重命名到位——两次重命名绝不做逐文件覆盖持久化 v4 插件启用状态重启 Godot。首次以 v4 启动时插件会先把活动目录树与签名库存逐一哈希比对通过后才记录success、重钉客户端条目并启动受管服务器。签名自更新系统原理它防住了什么v4 的自更新路径由 update_installer.gd 实现全部步骤在编辑器内执行核心是校验 → 暂存 → 交换 → 再校验 → 激活五段式流程信任根RSA-4096 公钥内嵌于 update_manager.gdRELEASE_SIGNING_PUBLIC_KEY_PEM私钥只存在于发布签名环境中。外层 v3 签名防止被篡改的胶囊被执行内层 v4 签名绑定仓库、通道、tag、版本、源提交、正式压缩包哈希与完整文件库存恶意压缩包防护清单校验会拒绝绝对路径、..穿越、符号链接、重复或大小写冲突的路径、超量文件等畸形内容原子交换 可恢复旧树始终完整保留在 backup 目录。若交换后哈希不匹配替换树被隔离到 quarantine、备份被换回dock 会显示原因rolled_back状态进程锁lock.json通过 PID 和进程指纹识别编辑器另一个打开的编辑器发起更新会被拒绝状态可见addons/.godot_ai_update/pending.json标记记录 from/to 版本、清单哈希、预期树哈希与备份路径任何中断都留下可读的状态而不是静默损坏。它不防什么诚实地说文档明确列出了边界签名密钥或签名环境被攻破、两次重命名之间的瞬间断电备份与标记让它成为可见且可恢复而非静默失败、同用户下已存在的恶意代码以及两个编辑器绕过进程锁的竞态。GitHub 发布说明是可变的不构成信任锚点——信任根只有签名密钥与发布审查。迁移中断了怎么办重新用 Godot 4.7 打开同一项目即可pending.json标记和旁边的目录树决定后续走向——不要手动删除addons/.godot_ai_update/或 add-on 目录标记状态含义处理success活动树与签名库存匹配旧版本保留在 backup等下次成功更新时清理rolled_back哈希不匹配已回滚到旧版本dock 会显示原因可直接重试repair_required不匹配且无备份可用从版本控制恢复addons/godot_ai/或用关闭编辑器时的安装器重装其他注意事项Godot 4.5/4.6只能加载桥接到说明要求的程度不会激活 v4——升级引擎后重新打开项目点击Retry migration4.0.0/4.0.1报告download failed (302)时重试无法修复其重定向缺陷需按 releasing.md 中的恢复流程做关闭编辑器的安装切勿手工覆盖 add-on 文件非常老的无签名更新器代次在自动迁移的安全边界之外请先升级到最新 v3 版本。写在最后Godot AI 的 v4 升级把大版本迁移做成了普通用户一次点击的事签名验证保证你装到的字节与发布审查过的字节一致两次重命名保证活动目录要么是旧树要么是新树备份与标记保证任何意外都停在可见且可恢复的状态。对新手来说只需记住一句话备份项目、确认 uvx、点击 Update然后让 Godot 自己重启一次。更多细节可查阅官方文档v4-migration.md、self-update.md、packaging-distribution.md 与 releasing.md。【免费下载链接】godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.项目地址: https://gitcode.com/gh_mirrors/go/godot-ai创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

AI-Native项目评估层与数据飞轮实战:从架构设计到落地闭环 2026/10/1 23:14:34

AI-Native项目评估层与数据飞轮实战:从架构设计到落地闭环

1. 为什么AI-Native项目必须把评估层当作一等公民做AI应用最让人头疼的一件事,不是模型调不通,而是你根本不知道它到底有没有变好。上个月我接手一个智能客服项目,产品经理说“感觉回答质量下降了”,工程师说“我明明换了更好的模…

阅读更多 →
开源模型替代闭源API的三天实战:从成本诱惑到架构重构 2026/10/1 23:14:34

开源模型替代闭源API的三天实战:从成本诱惑到架构重构

上周五下午,我把 Jev 的模型权重拉下来部署进测试环境,通过一层 OpenAI 兼容代理把它接进了公司那个一直在烧 GPT 额度的大模型服务。当时几个技术群里都在聊 Jev,说它是"便宜版 GPT",甚至有人拿它构建数据系统的演示视…

阅读更多 →
大模型切换的代价:从Jev替代GPT踩坑到混合路由架构 2026/10/1 23:14:34

大模型切换的代价:从Jev替代GPT踩坑到混合路由架构

1. 一开始的算盘打得挺响:把 Jev 当省钱平替的动机事情是这样的,我们内部有个工单智能回复系统,每天要处理几千条渠道进来的重复咨询,之前一直用的是 GPT 接口。模型能力强是真的强,但账单数字也一路往上飙。月初财务把…

阅读更多 →
Windows上用Docker跑Apache Doris:从环境准备到数据导入全流程 2026/10/1 23:14:14

Windows上用Docker跑Apache Doris:从环境准备到数据导入全流程

Windows上直接用Docker跑Apache Doris,是我本地做数据分析实验时摸索出的方案。Doris这个MPP分析型数据库,查大宽表确实快,但官方常规部署方式一直以Linux为主,对只用Windows当开发机的程序员来说,第一步就容易被劝退。…

阅读更多 →
HarmonyOS找次品动画演示:算法+交互+Canvas实战 2026/10/1 23:14:14

HarmonyOS找次品动画演示:算法+交互+Canvas实战

在HarmonyOS的学习路径上,翻来覆去都是登录、打卡、图表这类业务型Demo,真正能把一个“算法 交互 动画”完整串起来的例子其实不多。我最近在整理《HarmonyOS应用实例》系列时,挑中了“找次品动画演示”这个题目,做完之后发现它…

阅读更多 →
事件触发机制下的孤岛微电网二次电压与频率协同控制Simulink仿真 2026/10/1 23:14:14

事件触发机制下的孤岛微电网二次电压与频率协同控制Simulink仿真

最近在梳理孤岛微电网的二次控制方案,手头这个基于事件触发机制的Simulink仿真模型值得好好聊一聊。孤岛微电网在脱离主网后,电压幅值和频率很容易偏移,传统的一次控制只能靠下垂特性硬扛,想要做到无差调节就必须上二次控制。但二…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉