跳到主要内容

Pokemon Player

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

Skill 元数据​

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

参考:完整 SKILL.md​

信息

以下是触发此 skill 时 Kopi Agent 加载的完整 skill 定义。这就是 skill 处于激活状态时 agent 所看到的指令内容。

Pokemon Player

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

使用时机​

  • 用户说出 "play pokemon"、"start pokemon"、"pokemon game" 之类的话
  • 用户询问 Pokemon Red、Blue、Yellow、FireRed 等游戏
  • 用户想观看 AI 玩 Pokemon
  • 用户提到 ROM 文件(.gb、.gbc、.gba)

启动流程​

1. 首次设置(克隆、venv、安装)​

该仓库位于 GitHub 上的 Kopi Ai Agent Pte Ltd/pokemon-agent。先克隆它,然后 设置一个 Python 3.10+ 虚拟环境。优先使用 uv(速度更快) 创建 venv,并以可编辑模式安装该包,同时带上 pyboy extra。如果没有 uv,则回退到 python3 -m venv + pip。

在这台机器上,它已经设置在 /home/teknium/pokemon-agent 且 venv 已就绪 —— 只需 cd 到那里并执行 source .venv/bin/activate。

你还需要一个 ROM 文件。向用户索取他们的 ROM。在这台机器上, 该目录下的 roms/pokemon_red.gb 已存在一个 ROM。 绝对不要下载或提供 ROM 文件 —— 始终向用户索取。

2. 启动游戏服务器​

在 pokemon-agent 目录中并激活 venv 后,运行 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。将该 URL 加上 /dashboard/ 后缀后提供给用户。 隧道 URL 每次都会变化 —— 如果重启,请把新的 URL 给用户。

存档与读档​

何时存档​

  • 每进行 15-20 回合游戏时
  • 在道馆战、宿敌遭遇战或有风险的战斗之前务必存档
  • 进入新城镇或地牢之前
  • 在执行任何你不确定的操作之前

如何存档​

使用描述性名称调用 POST /save。好的示例: before_brock、route1_start、mt_moon_entrance、got_cut

如何读档​

使用存档名称调用 POST /load。

列出可用存档​

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

服务器启动时读档​

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

游戏循环​

第 1 步:观察 —— 检查状态并截图​

用 GET /state 获取位置、HP、战斗和对话信息。 用 GET /screenshot 获取截图并保存到 /tmp/pokemon.png,然后使用 vision_analyze。 始终两步都做 —— RAM 状态提供数值,视觉分析提供空间感知。

第 2 步:判断​

  • 屏幕上有对话/文字 → 推进它
  • 战斗中 → 战斗或逃跑
  • 队伍受伤 → 前往宝可梦中心(Pokemon Center)
  • 接近目标 → 谨慎导航

第 3 步:决策​

优先级:对话 > 战斗 > 治疗 > 剧情目标 > 练级 > 探索

第 4 步:行动 —— 最多移动 2-4 步,然后重新检查​

使用 POST /action 并传入简短的动作列表(2-4 个动作,而不是 10-15 个)。

第 5 步:验证 —— 每次移动序列后截图​

截图并使用 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 格,然后再朝你想要的方向前进。

对话处理​

第 1 世代的文字是逐字缓慢滚动的。要快速跳过对话,先按住 B 120 帧,然后按 A。按需重复。按住 B 会让文字以最快速度显示,然后按 A 进入下一行。a_until_dialog_end 动作会检查 RAM 的对话标志位,但该标志无法捕捉所有文字状态。如果对话似乎卡住了,请改用手动的 hold_b + press_a 模式,并通过截图确认。

崖边是单向的​

崖边(小悬崖边缘)只能向(南)下跳,永远不能向(北)上爬。如果向北时被崖边挡住,你必须向左或向右走,找到绕过它的缺口。用视觉能力确认缺口在哪个方向。明确地询问视觉模型。

导航策略​

  • 每次移动 2-4 步,然后截图检查位置
  • 进入新区域时,立即截图以确定方位
  • 询问视觉模型"去[目的地]该往哪个方向走?"
  • 如果尝试 3 次以上仍卡住,截图并彻底重新评估
  • 不要连续刷 10-15 个移动动作 —— 你会走过头或卡住

从野外战斗逃跑​

在战斗菜单中,RUN(逃跑)位于右下角。从默认光标位置(左上角的 FIGHT)移动到它:先按"下"再按"右",将光标移到 RUN,然后按 A。用 hold_b 包裹以快速跳过文字/动画。

战斗(FIGHT)​

战斗菜单中 FIGHT 位于左上角(默认光标位置)。按 A 进入招式选择,再按 A 使用第一个招式。然后按住 B 快速跳过攻击动画和文字。

战斗策略​

决策树​

  1. 想要捕捉?→ 先削弱对方,再投掷精灵球
  2. 不需要的野生宝可梦?→ RUN(逃跑)
  3. 有属性克制?→ 使用效果绝佳的招式
  4. 没有克制?→ 使用威力最高的本系(STAB)招式
  5. HP 较低?→ 换人或使用伤药

第 1 世代属性克制表(关键对局)​

  • 水 克制 火、地面、岩石
  • 火 克制 草、虫、冰
  • 草 克制 水、地面、岩石
  • 电 克制 水、飞行
  • 地面 克制 火、电、岩石、毒
  • 超能力 克制 格斗、毒(在第 1 世代中是霸主!)

第 1 世代的怪异设定​

  • 特殊种族值 = 特殊招式的攻击与防御共用一个数值
  • 超能力属性过于强势(幽灵系招式存在 bug)
  • 击中要害的概率基于速度种族值
  • 缠绕/绑住会让对手无法行动
  • 聚气 bug:反而降低击中要害率,而不是提高

记忆约定​

前缀用途示例
PKM:OBJECTIVE当前目标从常磐商店取回包裹
PKM:MAP导航知识常磐:商店在东北方
PKM:STRATEGY战斗/队伍计划在小霞之前需要草属性
PKM:PROGRESS里程碑追踪击败对手,前往常磐
PKM:STUCK卡住的情况y=28 处有崖边,向右绕过
PKM:TEAM队伍备注杰尼龟 Lv6,撞击 + 摇尾巴

进程里程碑​

  • 选择初始宝可梦
  • 从常磐商店送达包裹,获得宝可梦图鉴
  • 灰色徽章 —— 小刚(岩石)→ 使用 水/草
  • 蓝色徽章 —— 小霞(水)→ 使用 草/电
  • 橙色徽章 —— 马志士(电)→ 使用 地面
  • 彩虹徽章 —— 莉佳(草)→ 使用 火/冰/飞行
  • 粉红徽章 —— 阿桔(毒)→ 使用 地面/超能力
  • 金色徽章 —— 娜姿(超能力)→ 最难的道馆
  • 红色徽章 —— 夏伯(火)→ 使用 水/地面
  • 绿色徽章 —— 坂木(地面)→ 使用 水/草/冰
  • 四天王 → 冠军!

结束游玩​

  1. 通过 POST /save 保存游戏,并使用有描述性的名称
  2. 用 PKM:PROGRESS 更新记忆
  3. 告知用户:"游戏已保存为 [name]!说 'play pokemon' 即可继续。"
  4. 终止服务器和隧道后台进程

注意事项​

  • 绝对不要下载或提供 ROM 文件
  • 在检查视觉之前,不要发送超过 4-5 个动作
  • 走出建筑后,向北走之前永远先侧移
  • 门/楼梯传送后务必添加 wait_60 x2-3
  • 通过 RAM 检测对话并不可靠 —— 请用截图确认
  • 在有风险的遭遇战之前先存档
  • 每次重启隧道后 URL 都会变化