用你的 AI 助手，
指挥你的世界。

选择你的接入方式。

已有网关？可单独下载 Skill 技能包. Skill 提供操作指引，仍需网关才能连接游戏。

SHA-256 · 同一角色只运行一个网关进程。两个版本使用同一套游戏命令。

几步完成安装。

需要电脑、Node.js 22 或更新版本（建议 24）、支持 MCP 的助手、网络连接，以及你自己的 Earth2037 帐号。助手使用的模型订阅或 API 费用另计。

下载 Node.js · 安装 Hermes

node --version
npm ci --omit=dev --ignore-scripts
node tools/doctor.mjs
node tools/setup.mjs --locale zh-CN

连接到你的助手。

npx @deepseek-ai/dsh web

Hermes Agent

打开生成的 ~/.earth2037-agent/hermes-mcp.yaml，把其中的 earth2037 条目合并到 ~/.hermes/config.yaml 的 mcp_servers 下。保留已有服务器配置，不要出现两个同名 mcp_servers 键。使用自定义 Hermes profile 时，请使用该 profile 对应的配置和技能目录。

mcp_servers:
  earth2037:
    command: "/absolute/path/to/node"
    args: ["/absolute/path/to/earth2037-agent/src/main.mjs"]
    timeout: 120
    connect_timeout: 30
    env:
      EARTH2037_CREDENTIAL_FILE: "/absolute/private/path/credentials.json"
      EARTH2037_STATE_DIR: "/absolute/private/path/state"
      EARTH2037_READ_ONLY: "1"
      EARTH2037_LOCALE: "zh-CN"

上面仅为格式示意，请使用生成文件中的真实绝对路径。将解压包里的 integrations/earth2037-hermes 文件夹复制到 ~/.hermes/skills/earth2037-hermes，然后重启 Hermes。

mkdir -p ~/.hermes/skills
cp -R integrations/earth2037-hermes ~/.hermes/skills/
hermes

以上复制命令适用于 macOS/Linux/WSL，也可以手动复制文件夹。已有自定义技能时先保留原文件。本配置不设置工具过滤，提供完整工具列表。

其他 MCP 助手

将生成的 mcp.json 条目合并到助手的本机 stdio MCP 配置中，使用其中的 command、args 和 env。部分助手使用表单或其他配置格式，请对应填写。重启后确认可以调用 earth2037_status。

配套 Skill：将 integrations/earth2037-agent 复制到助手支持的技能目录。Skill 和 MCP 配合使用；只装 Skill 不会自动建立连接。

{"tool":"earth2037_enter","arguments":{"serverId":"s1","acceptSessionTakeover":true,"bootstrap":false}}
{"tool":"earth2037_map_nearby","arguments":{"radius":5,"kind":"monster","maxLevel":3}}
{"tool":"earth2037_logout","arguments":{}}

export EARTH2037_CREDENTIAL_FILE="$HOME/.earth2037-agent/credentials.json"
export EARTH2037_STATE_DIR="$HOME/.earth2037-agent/state"
export EARTH2037_READ_ONLY=1
node src/cli.mjs run < inspect.ndjson

试一次真正的地图查询。

从这句话开始。助手应先列出角色，再进入你选择的服务器：

使用 Earth2037 技能，先列出我的服务器和角色。等我选定后，可以接管该角色当前的游戏登录，以只读方式进入。查看城市资源，查以当前城为中心、向四边各延伸 5 格的方形范围内、3 级以下（含 3 级）的野怪，不出征、不消耗资源。

典型顺序为 servers → enter → show → map_nearby。中文服 ID 为 s1，英文服为 en1；分服可用状态以实际列表为准，不同分服角色与进度可能不同。

earth2037_map_nearby
{"radius":5,"kind":"monster","maxLevel":3,"limit":20}

查询会给出坐标、地块 ID、等级和格距。地图返回的是内容点，未返回的格子不代表可通行空地。展示城市缓存时，助手应同时说明数据时间。

准备好后，再执行游戏操作。

只读查询正常后，可以开启游戏写操作。重新运行 setup，将重新生成的配置合并回助手配置并重启。已有凭据会保留。

node tools/setup.mjs --config-only --allow-writes --locale zh-CN

准备升级我等级最低的一块油田。先列出城市、当前与目标等级、资源消耗和队列条件，再决定提交。

操作流程为 prepare → 核对 → submit → plan_status。未提交的新计划有效期为 120 秒；提交后查询与重试要沿用原 planId。命令已接受，不代表计时队列已经完成。

已有准备流程覆盖升级、新建、取消建造、征兵、道具、行军、召回、空投、切城和聊天。其他清单内命令可通过具名工具或 earth2037_execute 调用。费用、前置条件和结算结果以游戏服务端为准。

恢复只读可运行 node tools/setup.mjs --config-only --locale zh-CN，再次合并生成的配置并重启。不要通过多个助手同时操作同一角色。

遇到问题时。

接入范围与验证边界。

已实服验证帐号登录、选服、查地图，以及部分自有城市建筑升级和单兵征召。这不代表全部命令、购买、攻击、联盟操作或所有平台都已完成实服测试。

Hermes 适配验证使用隔离的本机 Hermes 环境发现工具并调用离线查询，不等同于验证模型决策质量或完整 Hermes 游戏会话。

下载完整命令清单（JSON） · 覆盖明细

使用当前帐号中心与 WSS v2 登录。旧 SK-key 认证与 802 × 802 地图不再沿用。网站链接用于文档与下载，不是托管式 HTTP MCP 服务地址。

Hermes 接入格式依据官方 MCP / Skills 文档。