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 快速跳过攻击动画和文字。
战斗策略
决策树
- 想要捕捉?→ 先削弱对方,再投掷精灵球
- 不需要的野生宝可梦?→ RUN(逃跑)
- 有属性克制?→ 使用效果绝佳的招式
- 没有克制?→ 使用威力最高的本系(STAB)招式
- HP 较低?→ 换人或使用伤药
第 1 世代属性克制表(关键对局)
- 水 克制 火、地面、岩石
- 火 克制 草、虫、冰
- 草 克制 水、地面、岩石
- 电 克制 水、飞行
- 地面 克制 火、电、岩石、毒
- 超能力 克制 格斗、毒(在第 1 世代中是霸主!)
第 1 世代的怪异设定
- 特殊种族值 = 特殊招式的攻击与防御共用一个数值
- 超能力属性过于强势(幽灵系招式存在 bug)
- 击中要害的概率基于速度种族值
- 缠绕/绑住会让对手无法行动
- 聚气 bug:反而降低击中要害率,而不是提高
记忆约定
| 前缀 | 用途 | 示例 |
|---|---|---|
| PKM:OBJECTIVE | 当前目标 | 从常磐商店取回包裹 |
| PKM:MAP | 导航知识 | 常磐:商店在东北方 |
| PKM:STRATEGY | 战斗/队伍计划 | 在小霞之前需要草属性 |
| PKM:PROGRESS | 里程碑追踪 | 击败对手,前往常磐 |
| PKM:STUCK | 卡住的情况 | y=28 处有崖边,向右绕过 |
| PKM:TEAM | 队伍备注 | 杰尼龟 Lv6,撞击 + 摇尾巴 |
进程里程碑
- 选择初始宝可梦
- 从常磐商店送达包裹,获得宝可梦图鉴
- 灰色徽章 —— 小刚(岩石)→ 使用 水/草
- 蓝色徽章 —— 小霞(水)→ 使用 草/电
- 橙色徽章 —— 马志士(电)→ 使用 地面
- 彩虹徽章 —— 莉佳(草)→ 使用 火/冰/飞行
- 粉红徽章 —— 阿桔(毒)→ 使用 地面/超能力
- 金色徽章 —— 娜姿(超能力)→ 最难的道馆
- 红色徽章 —— 夏伯(火)→ 使用 水/地面
- 绿色徽章 —— 坂木(地面)→ 使用 水/草/冰
- 四天王 → 冠军!
结束游玩
- 通过 POST /save 保存游戏,并使用有描述性的名称
- 用 PKM:PROGRESS 更新记忆
- 告知用户:"游戏已保存为 [name]!说 'play pokemon' 即可继续。"
- 终止服务器和隧道后台进程
注意事项
- 绝对不要下载或提供 ROM 文件
- 在检查视觉之前,不要发送超过 4-5 个动作
- 走出建筑后,向北走之前永远先侧移
- 门/楼梯传送后务必添加 wait_60 x2-3
- 通过 RAM 检测对话并不可靠 —— 请用截图确认
- 在有风险的遭遇战之前先存档
- 每次重启隧道后 URL 都会变化