# gdharness 中文文档 规范地址：https://npmcn.com/package/gdharness/ 版本：1\.3\.69 npm 元数据更新时间：2026-11-03T16:46:58.953Z 中文译文更新时间：2026-11-03T18:13:38.349Z 软件包许可：MIT 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/gdharness 原文对照：https://npmcn.com/package/gdharness/?lang=original 项目主页：https://github.com/Aureliolo/gdharness#readme 源码仓库：https://github.com/Aureliolo/gdharness ## 关键信息（来自 npm 元数据） - 包体积（解压后）：5.1 MB，192 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22\.0\.0 - 运行依赖：0 个 - 首次发布：2026-09-13T18:42:10.571Z - 最新版本发布：2026-11-03T16:46:58.662Z - 已发布版本数：311（近 12 个月 311 个） ## 中文简介 用于从代理驱动Godot 4项目的工具: 编辑器插件，运行游戏的运行时桥，它们前面的MCP服务器以及安装和诊断Godot端的CLI。 ## 安装 ```sh npm install gdharness ``` 也可以使用：`pnpm add gdharness`、`yarn add gdharness`、`bun add gdharness` ## README # gdharness [![CI](https://github.com/Aureliolo/gdharness/actions/workflows/ci.yml/badge.svg)](https://github.com/Aureliolo/gdharness/actions/workflows/ci.yml) [![Scorecard](https://api.scorecard.dev/projects/github.com/Aureliolo/gdharness/badge)](https://scorecard.dev/viewer/?uri=github.com/Aureliolo/gdharness) [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/14619/badge)](https://www.bestpractices.dev/projects/14619) [![OpenSSF Baseline](https://www.bestpractices.dev/projects/14619/baseline)](https://www.bestpractices.dev/projects/14619) [![SLSA Build 3](https://img.shields.io/badge/SLSA-Build%20L3-2f6f4e?style=flat)](https://npmcn.com/package/gdharness/.github/release-process.md#slsa) [![SBOM](https://img.shields.io/badge/SBOM-SPDX-2f6f4e?style=flat)](https://npmcn.com/package/gdharness/.github/release-process.md#what-a-release-carries) [![Signed releases](https://img.shields.io/badge/releases-Sigstore%20signed-2f6f4e?style=flat)](https://npmcn.com/package/gdharness/.github/release-process.md#verifying-a-release) [![npm](https://img.shields.io/npm/v/gdharness?logo=npm&logoColor=white&label=npm&color=cb3837)](https://www.npmjs.com/package/gdharness) [![Release](https://img.shields.io/github/v/release/Aureliolo/gdharness?display_name=tag&sort=semver)](https://github.com/Aureliolo/gdharness/releases) [![MCP server](https://badge.mcpx.dev/?type=server "MCP Server")](https://modelcontextprotocol.io/introduction) [![MCP 2026-07-28](https://img.shields.io/badge/MCP-2026--07--28-2f6f4e?style=flat)](https://modelcontextprotocol.io/specification/2026-07-28) [![Made for Godot 4.7+](https://img.shields.io/badge/Made%20for-Godot%204.7%2B-478CBF?style=flat&logo=godot%20engine&logoColor=white)](https://godotengine.org/) [![Node](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2FAureliolo%2Fgdharness%2Fmain%2Fpackage.json&query=%24.engines.node&label=node&color=5fa04e&logo=node.js&logoColor=white)](https://nodejs.org/) [![Bun](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2FAureliolo%2Fgdharness%2Fmain%2Fpackage.json&query=%24.engines.bun&label=bun&color=f9f1e1&logo=bun&logoColor=black)](https://bun.sh/) [![Licence](https://img.shields.io/github/license/Aureliolo/gdharness)](https://npmcn.com/package/gdharness/LICENSE) 代理看不到正在运行的游戏。它会读取你的脚本并猜测其余部分：是否 按钮是否在屏幕上，面板是否更新，那个错误是否重要。 gdharness是一个MCP服务器和四个Godot插件。通过他们，代理要求开放的编辑器和 跑步游戏的屏幕显示和控制在哪里。它还可以询问属性包含什么 现在，控制台打印了什么，哪条线坏了。 ## 安装 把这个交给你的经纪人： ```text 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](https://aureliolo.github.io/gdharness)。 ## 它存在的循环 ```jsonc 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_verb`4 `godot://` 资源和3个提示 | | 到达 | 打开的编辑器，正在玩的游戏以及磁盘上的项目 | | 利用 | 35，写在项目内部，只要线束有项目配置 | | 技能 | 写入 `.agents/skills`,带有Claude代码，Kiro和Cline的副本 | | 安装 | 或带有SBOM的sigstore签名归档文件，SLSA Build Level 3 | | 已证实 | 每个工具在CI中针对Godot 4.7.2驱动，在Windows， Linux和macOS上 | | 状态 | 1.x: 每个版本都是一个补丁。 [隆起是什么意思](https://npmcn.com/package/gdharness/.github/CONTRIBUTING.md#versions) | 4.7之前的Godot没有经过测试。 ## 文档 [aureliolo.github.io/gdharness](https://aureliolo.github.io/gdharness): 安装它，如何 零件连接，每一个工具，op和参数。 [SECURITY.md](https://npmcn.com/package/gdharness/.github/SECURITY.md) 是如何报告安全故障。 [CONTRIBUTING.md](https://npmcn.com/package/gdharness/.github/CONTRIBUTING.md) 是改变必须清除的东西。 ## 项目 的叉子 [GoPeak](https://github.com/HaD0Yun/Doyunha-Gopeak) v2.3.9，2026年9月，麻省理工学院。这个 原MCP服务器是 [戈多-mcp](https://github.com/Coding-Solo/godot-mcp) 通过 [所罗门伊莱亚斯](https://github.com/Coding-Solo),而GoPeak是由 [HaD0Yun](https://github.com/HaD0Yun)。 不隶属于戈多基金会。 ## 常见问题 ### 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 和提交记录判断。