跳到主要内容

Pokemon Player

通过无头模拟器 + RAM 读取来玩 Pokemon。

技能元数据​

来源可选 — 使用 hermes skills install official/gaming/pokemon-player 安装
路径optional-skills/gaming/pokemon-player
平台linux, macos, windows

参考：完整 SKILL.md​

信息

以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理看到的指令。

Pokemon Player

使用 pokemon-agent 包通过无头模拟玩 Pokemon 游戏。

何时使用​

  • 用户说“play pokemon”、“start pokemon”、“pokemon game”
  • 用户询问关于 Pokemon Red、Blue、Yellow、FireRed 等的问题
  • 用户希望观看 AI 玩 Pokemon
  • 用户引用 ROM 文件（.gb、.gbc、.gba）

启动流程​

1. 首次设置（克隆、虚拟环境、安装）​

GitHub 上的仓库是 NousResearch/pokemon-agent。克隆它，然后 设置一个 Python 3.10+ 虚拟环境。使用 uv（速度更快，首选） 创建虚拟环境并以可编辑模式安装带有 pyboy 额外依赖的包。如果 uv 不可用，则回退到 python3 -m venv + pip。

在此机器上，它已在 /home/teknium/pokemon-agent 设置好， 并准备好了虚拟环境 — 只需 cd 进入该目录并执行 source .venv/bin/activate。

你还需要一个 ROM 文件。向用户索取他们的 ROM 文件。在此机器上， 该目录下存在一个 roms/pokemon_red.gb。 切勿下载或提供 ROM 文件 — 始终向用户索取。

2. 启动游戏服务器​

在激活虚拟环境的情况下，从 pokemon-agent 目录内部，运行 pokemon-agent serve，使用 --rom 指向 ROM 文件，并使用 --port 9876。 使用 & 在后台运行。 要从保存的游戏恢复，添加 --load-state 及保存名称。 等待 4 秒以完成启动，然后通过 GET /health 进行验证。

3. 为用户设置实时仪表板以便观看​

使用 localhost.run 通过 SSH 反向隧道，以便用户可以在浏览器中查看 仪表板。使用 ssh 连接，将本地端口 9876 转发到 nokey@localhost.run 上的远程端口 80。将输出重定向 到日志文件，等待 10 秒，然后在日志中 grep 查找 .lhr.life URL。将附加了 /dashboard/ 的 URL 提供给用户。 隧道 URL 每次都会更改 — 如果重新启动，请给用户新的 URL。

保存和加载​

何时保存​

  • 每 gameplay 15-20 回合
  • 始终在道馆战、劲敌遭遇或高风险战斗之前
  • 在进入新城镇或地下城之前
  • 在任何你不确定的行动之前

如何保存​

POST /save 并附带描述性名称。良好的示例： before_brock、route1_start、mt_moon_entrance、got_cut

如何加载​

POST /load 并附带保存名称。

列出可用保存​

GET /saves 返回所有已保存的状态。

服务器启动时加载​

启动服务器时使用 --load-state 标志以自动加载保存。 这比启动后通过 API 加载更快。

游戏循环​

步骤 1：观察 (OBSERVE) — 检查状态并截图​

GET /state 获取位置、HP、战斗、对话信息。 GET /screenshot 并保存到 /tmp/pokemon.png，然后使用 vision_analyze。 务必执行两者 — RAM 状态提供数值，视觉提供空间感知。

步骤 2：定位 (ORIENT)​

  • 屏幕上有对话/文本 → 推进它
  • 战斗中 → 战斗或逃跑
  • 队伍受伤 → 前往 Pokemon 中心
  • 靠近目标 → 小心导航

步骤 3：决策 (DECIDE)​

优先级：对话 > 战斗 > 治疗 > 故事目标 > 训练 > 探索

步骤 4：行动 (ACT) — 最多移动 2-4 步，然后重新检查​

POST /action 并附带简短的动作列表（2-4 个动作，而非 10-15 个）。

步骤 5：验证 (VERIFY) — 每个移动序列后截图​

截图并使用 vision_analyze 确认你已移动到预期位置。这是最重要的步骤。没有视觉反馈，你一定会迷路。

步骤 6：记录进度到记忆，使用前缀 PKM:​

步骤 7：定期保存​

动作参考​

  • press_a — 确认、交谈、选择
  • press_b — 取消、关闭菜单
  • press_start — 打开游戏菜单
  • walk_up/down/left/right — 移动一格
  • hold_b_N — 按住 B 键 N 帧（用于快速跳过文本）
  • wait_60 — 等待约 1 秒（60 帧）
  • a_until_dialog_end — 重复按 A 直到对话结束

来自经验的关键提示​

持续使用视觉​

  • 每 2-4 个移动步骤截一次图
  • RAM 状态告诉你位置和 HP，但不告诉你周围有什么
  • 悬崖边缘、栅栏、标志、建筑门、NPC — 仅通过截图可见
  • 向视觉模型提出具体问题：“我北边一格是什么？”
  • 当卡住时，在尝试随机方向之前务必截图

传送过渡需要额外等待时间​

当穿过门或楼梯时，屏幕会在地图过渡期间淡出至黑色。你必须等待其完成。在任何门/楼梯传送后添加 2-3 个 wait_60 动作。如果不等待，位置读数会过时，你会以为你还在旧地图中。

建筑出口陷阱​

当你走出建筑时，你会直接出现在门正前方。 如果你向北走，你会直接走回去。务必先侧身移动， 向左或向右走 2 格，然后朝预期方向前进。

对话处理​

第一代（Gen 1）文本逐字母缓慢滚动。若要快速跳过对话，按住 B 键 120 帧，然后按 A 键。根据需要重复此操作。按住 B 键可使文本以最大速度显示。然后按 A 键进入下一行。 a_until_dialog_end 动作会检查 RAM 中的对话标志位，但该标志位无法捕获所有文本状态。如果对话似乎卡住，请改用手动“按住 B + 按 A”的模式，并通过截图进行验证。

ledge（悬崖边缘）是单向的​

Ledge（小悬崖边缘）只能向下（向南）跳下，绝不能向上（向北）攀爬。如果因向北的 ledge 受阻，必须向左或向右移动以找到绕过它的缺口。使用视觉能力识别缺口所在的方向。明确询问视觉模型。

  • 每次移动 2-4 步，然后截图检查位置
  • 进入新区域时，立即截图以确定方向
  • 询问视觉模型：“去 [目的地] 该往哪个方向？”
  • 如果尝试 3 次以上仍被困住，请截图并重新全面评估
  • 不要连续发送 10-15 个移动指令——你会越过目标或被困住

从野生战斗中逃跑​

在战斗菜单中，“RUN”（逃跑）位于右下角。要从默认光标位置（“FIGHT”，左上角）到达该选项：先按下键，再按右键将光标移至“RUN”，然后按 A 键。使用 hold_b 包裹操作以加速跳过文本/动画。

战斗（FIGHT）​

在战斗菜单中，“FIGHT”（战斗）位于左上角（默认光标位置）。 按 A 键进入招式选择，再次按 A 键使用第一个招式。 然后按住 B 键以加速跳过攻击动画和文本。

战斗策略​

决策树​

  1. 想要捕捉？→ 削弱对方然后投掷精灵球
  2. 不需要的野生宝可梦？→ 逃跑（RUN）
  3. 有属性优势？→ 使用效果绝佳（super-effective）的招式
  4. 无优势？→ 使用最强的同属性加成（STAB）招式
  5. HP 较低？→ 切换宝可梦或使用伤药

第一代属性克制表（关键对阵）​

  • 水系克制火系、地面系、岩石系
  • 火系克制草系、虫系、冰系
  • 草系克制水系、地面系、岩石系
  • 电系克制水系、飞行系
  • 地面系克制火系、电系、岩石系、毒系
  • 超能力系克制格斗系、毒系（在第一代中占据主导地位！）

第一代特性​

  • 特殊（Special）数值同时决定特殊招式的攻击力和防御力
  • 超能力系过于强大（幽灵系招式存在漏洞）
  • 暴击率基于速度（Speed）数值
  • 紧束（Wrap）/绑紧（Bind）防止对手行动
  • 聚气（Focus Energy）漏洞：降低暴击率而非提高

记忆约定​

前缀用途示例
PKM:OBJECTIVE当前目标从常磐超市获取包裹
PKM:MAP导航知识常磐市：超市在东北方向
PKM:STRATEGY战斗/队伍计划在挑战莉佳之前需要草系宝可梦
PKM:PROGRESS里程碑追踪器击败劲敌，前往常磐市
PKM:STUCK被困情况y=28 处的 ledge，向右走以绕过
PKM:TEAM队伍备注杰尼龟 Lv6，撞击 + 摇尾巴

进度里程碑​

  • 选择初始宝可梦
  • 交付来自常磐超市的包裹，获得宝可梦图鉴
  • 灰色徽章 — 小刚（岩石系）→ 使用水系/草系
  • 蓝色徽章 — 莉佳（水系）→ 使用草系/电系
  • 金色徽章 — 马志士（电系）→ 使用地面系
  • 彩虹徽章 — 莉佳（草系）→ 使用火系/冰系/飞行系
  • 深红徽章 — 阿桔（毒系）→ 使用地面系/超能力系
  • 黄金徽章 — 娜姿（超能力系）→ 最难的道馆
  • 火山徽章 — 夏伯（火系）→ 使用水系/地面系
  • 地球徽章 — 坂木（地面系）→ 使用水系/草系/冰系
  • 四天王 → 冠军！

停止游戏​

  1. 通过 POST /save 使用描述性名称保存游戏
  2. 使用 PKM:PROGRESS 更新记忆
  3. 告知用户：“游戏已保存为 [name]！说‘play pokemon’以继续。”
  4. 终止服务器和隧道后台进程

陷阱​

  • 切勿下载或提供 ROM 文件
  • 在不检查视觉的情况下，不要发送超过 4-5 个动作
  • 离开建筑物后，在向北走之前务必先向侧面移动
  • 在门/楼梯传送后，务必添加 wait_60 x2-3
  • 通过 RAM 检测对话不可靠 — 需通过截图验证
  • 在进行高风险遭遇战之前保存游戏
  • 每次重启隧道时，隧道 URL 都会更改