gdharness

中文文档
1.3.69发布于 2026/11/04MITES Module零依赖构建来源已验证

用于从代理驱动Godot 4项目的工具: 编辑器插件,运行游戏的运行时桥,它们前面的MCP服务器以及安装和诊断Godot端的CLI。

中文使用文档
文档目录5 节
  1. 安装
  2. 它存在的循环
  3. 一目了然
  4. 文档
  5. 项目

gdharness

CI Scorecard OpenSSF Best Practices OpenSSF Baseline SLSA Build 3 SBOM Signed releases npm Release MCP server MCP 2026-07-28 Made for Godot 4.7+ Node Bun Licence

代理看不到正在运行的游戏。它会读取你的脚本并猜测其余部分:是否 按钮是否在屏幕上,面板是否更新,那个错误是否重要。

gdharness是一个MCP服务器和四个Godot插件。通过他们,代理要求开放的编辑器和 跑步游戏的屏幕显示和控制在哪里。它还可以询问属性包含什么 现在,控制台打印了什么,哪条线坏了。

安装

把这个交给你的经纪人:

Install gdharness here by following https://aureliolo.github.io/gdharness/agent.md,
then tell me what it asked you to recommend back to me.

或自己做,并选择你的线束: aureliolo.github.io/gdharness。

它存在的循环

editor_run      { "op": "start", "projectPath": "C:/games/shop" }
runtime_inspect { "op": "find", "says": "Buy" }              // the button, by the word on it
runtime_input   { "op": "click", "nodePath": "/root/Shop/Ledger/BuyButton" }
runtime_inspect { "op": "text", "nodePath": "/root/Shop/Ledger" }   // what the panel says now
editor_output   { "projectPath": "C:/games/shop" }           // errors and warnings, with backtraces

打开的编辑器播放游戏,所以你可以设置一个断点,并读取作用域中的变量 停止。

用引擎随后持有的内容写入答案,而不是请求的回声。一个工具 不能回答说它处于哪个状态,什么会改变它。

一目了然

需要Godot 4.7或更新,节点22或更新。也在面包1.4下运行。
表面31个工具命名 domain_verb4 godot:// 资源和3个提示
到达打开的编辑器,正在玩的游戏以及磁盘上的项目
利用35,写在项目内部,只要线束有项目配置
技能写入 .agents/skills,带有Claude代码,Kiro和Cline的副本
安装或带有SBOM的sigstore签名归档文件,SLSA Build Level 3
已证实每个工具在CI中针对Godot 4.7.2驱动,在Windows, Linux和macOS上
状态1.x: 每个版本都是一个补丁。 隆起是什么意思

4.7之前的Godot没有经过测试。

文档

aureliolo.github.io/gdharness: 安装它,如何 零件连接,每一个工具,op和参数。

SECURITY.md 是如何报告安全故障。 CONTRIBUTING.md 是改变必须清除的东西。

项目

的叉子 GoPeak v2.3.9,2026年9月,麻省理工学院。这个 原MCP服务器是 戈多-mcp 通过 所罗门伊莱亚斯,而GoPeak是由 HaD0Yun。

不隶属于戈多基金会。

版本与发布记录

gdharness 共发布 311 个版本,首次发布于 2026/09/14;过去 12 个月发布了 311 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.3.69latest2026/11/04今天
1.3.682026/11/03今天
1.3.672026/11/021 天前
1.3.662026/11/022 天前
1.3.652026/11/022 天前
1.3.642026/11/022 天前

关于 gdharness 的常见问题

gdharness 是什么?

用于从代理驱动Godot 4项目的工具: 编辑器插件,运行游戏的运行时桥,它们前面的MCP服务器以及安装和诊断Godot端的CLI。

如何安装 gdharness?

在项目目录运行 npm install gdharness,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gdharness,可以用 npx gdharness 直接运行。

gdharness 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gdharness 是否存在。

gdharness 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

gdharness 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

gdharness 可以商用吗?

gdharness 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

gdharness 还在维护吗?

最新版本 1.3.69 发布于 2026/11/04(今天);至今共发布 311 个版本,其中过去 12 个月发布了 311 个;首次发布于 2026/09/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。