PvZ MCP 0.3.5

更新内容

• 支持发现并接入已打开的原版游戏，安装时无需选择游戏路径，接入保留当前棋盘。
• 新增桌面控制面板：连接游戏、开始冒险、运行、暂停、定时推进、倍速及观战设置。
• 新增彩色文字棋盘，自动展示植物、僵尸位置及状态，点击可查看血量；僵尸标签保持在所属行内，啃咬时变红。
• 新增 pvz_observe，可在游戏运行时读取 JSON 状态，不中断推进；现共提供 26 个 MCP 工具。
• 修复切到控制台后游戏自动暂停的问题，运行时自动解除失焦暂停，手动设置菜单仍保持有效。
• 修复接入已有进程时观战提示无法找到桥接地址的问题。

使用

运行下方 EXE 安装或更新工具，打开自己的兼容游戏，再从面板连接。AI 客户端导入安装目录的 mcp-config.json 并重新连接即可。

当前仅支持 README 中列出的特定 1.2.0.1073 构建；其他版本不会启用游戏控制。安装包不含游戏文件、资源或存档。

完整说明

验证与已知问题

115/116 项 Python 测试、全部 13 项更新测试及 26 工具 MCP 检查通过。原有的 Windows 文件并发替换压力测试仍存在拒绝访问问题；进程接入、后台运行、定时推进与拾取扩展共存已实机验证。

安装包 SHA-256：

ecb1fe8b47b2e9c991b1515fe1539837e6b5021d5be2339e344039baab03bdbe

PvZ MCP 0.3.4-preview.1

本版新增无视觉来信读取，并修复 AI 决策暂停时无法点击菜单的问题。

新增

• pvz_collect 支持僵尸来信（15）、奖励钱袋（18）和钻石袋（20），走原生领取和结算流程。
• pvz_read_letter 返回当前来信的中文文字、摘要和转录来源；地上信纸和已打开的信件页都可读取，读取不会领取或关闭信件。
• 状态增加奖励及信件信息，工具总数为 23 个。

修复

• AI 暂停战斗时继续更新菜单按钮，可打开菜单、切换全屏；植物、僵尸、阳光生产和冷却保持冻结。
• 新版可连接升级前仍在运行的受支持旧桥接，保留当前局面并领取奖励。菜单修复需要重新通过 MCP 启动游戏后生效。

验证与范围

• 已实机完成冒险 1-9 来信领取、信件展示与 JSON 文字读取。
• 已实机验证暂停中打开菜单和切换全屏，战斗更新计数不变。
• 钱袋、钻石袋通过原生调用路径与 x86 仿真测试，尚未单独完成实机领奖验证。
• 信件文字来自受支持中文版图片的人工转录，并非实时 OCR；4-9 个别模糊字已标记待确认。
• 继续仅支持 README 标明的原版 1.2.0.1073 精确构建，不扩大其他游戏版本的兼容承诺。

安装

Release 附件仅提供 EXE 安装器，不含游戏。安装后重新连接 MCP 客户端；涉及桥接的修复需重启游戏。

PvZ MCP 0.3.3-preview.3

新增

• 支持冒险 1-5 的戴夫对话、铲子教学和坚果保龄球传送带。
• 新增 pvz_help、pvz_continue_dialogue 和 pvz_shovel，状态中提供下一步操作及用法提示。
• 读取滚动坚果的方向、位置和反弹状态。

修复

• 暂停决策时，戴夫对话、教程和铲除动画仍按原速正常刷新。
• 传送带卡牌露出至少 20% 后才返回并允许使用，避免在观众看见之前出牌。
• 保留原生卡槽编号，并校验传送带状态，防止误用移动后的卡牌。

已在兼容的 1.2.0.1073 构建上，以 1 倍速、逐轮 MCP 操作完成 1-5 实机通关。74 项回归测试、13 项更新模块测试及真实 MCP 连接检查通过。其他游戏构建的兼容性未扩大。

下载下方 EXE 安装器，选择原工具目录即可更新。项目不包含游戏文件或存档；工具代码采用 GPL-3.0-only。

PvZ MCP 0.3.2-preview.1

新增 GitHub 自动更新检查，并从本版开始采用 GPL-3.0-only。

本版变化

• 连接 MCP 后后台检查 ZhangAo1999/pvz-mcp 的 Release，默认每 24 小时一次。预览版会检查正式版和预览版；支持切换为只检查正式版，也可关闭自动检查。
• 新增 pvz_check_update 工具，现共 19 个 MCP 工具。pvz_status.update 返回最新检查结果，包含版本、Release 页面、EXE 下载地址和 GitHub 提供的 SHA-256。
• 安装目录可运行 Manage.ps1 -Action CheckUpdate 手动检查。网络失败、限流会保留状态并稍后重试；后台检查不阻塞 MCP 连接或游戏操作。
• 检查只获取版本元数据，不自动下载、安装或重启；升级继续使用 EXE 安装器，配置和备份保留。
• 许可证改为 GPL-3.0-only，作者 ZhangAo1999。二次分发需保留适用的作者版权和许可声明，标明修改，并按 GPL 要求提供对应源码。已发布的 0.3.1-preview.1 保留 MIT 许可。

安装与兼容性

下载下面的 EXE，选择原安装目录即可升级。0.3.1-preview.1 及更早版本需先手动升级一次，才具备自动检查功能。升级前关闭游戏并断开 MCP，安装后重新连接。

游戏支持范围未扩大：仅支持 Windows x64 上运行的特定 1.2.0.1073 构建，游戏 EXE SHA-256：

e1511201ec2ae9a7e30259f04bc2ec7272badb2574a2e9b405d0e916ae5c082c

不包含游戏文件、资源或存档，不改写游戏 EXE。1.0.0.1051 不支持；其他构建未验证。

使用说明 · 更新频道、代理和开关配置 · 作者与来源

验证

新增更新模块 13 项测试通过；源码与安装后的真实 MCP 联调、EXE 自检、0.3.1 → 0.3.2 升级、配置和备份保留、版本回退均通过。

完整 Python 回归 48 项中，46 项通过、1 项跳过、1 项失败。失败为已有观战文件的并发读写压力测试（WinError 5），已在 0.3.1 上复现；本版未修改该观战模块。

EXE SHA-256

fe529fa0f06fa914598c886e8ebdddd69a82c762a7c393bb4663d0403c28a443

手动附件仅上传 EXE；对应源码使用本 Release 的 GitHub 自动源码下载。

PvZ MCP 0.3.1-preview.1

首个公开预览版，通过本地 stdio MCP 让 AI 读取游戏状态并操作《植物大战僵尸》。

• 18 个 MCP 工具：JSON 状态读取、暂停、按时长推进、倍速、种植、选卡、模式与关卡操作、存档进度管理和观战提示。
• 离线 EXE 安装器内置 Node.js、Python 和依赖，可选择工具安装位置与游戏路径，并校验游戏兼容性。
• 支持在原目录升级与回退；不包含游戏文件、资源或用户存档，不改写游戏 EXE。

兼容性

仅支持 Windows x64 上运行的特定 1.2.0.1073 构建。游戏 EXE 的 SHA-256 必须为：

e1511201ec2ae9a7e30259f04bc2ec7272badb2574a2e9b405d0e916ae5c082c

1.0.0.1051 不支持；其他构建尚未验证。选择不支持的游戏时可以安装工具，但游戏控制保持禁用。当前基础实机验证覆盖冒险 1-4 等操作，尚未覆盖全部关卡与模式。

安装与连接

下载下面的 PvZ-MCP-0.3.1-preview.1-Setup.exe，运行后选择安装目录和游戏 EXE。将安装目录生成的 mcp-config.json 按客户端要求加入 MCP 配置，再由 AI 调用 pvz_launch_game 启动游戏。

详细说明：README · 工具调用说明

安装器校验

SHA-256：

bd5689e04b5791418b275ae389ef3a654223f4431afc85bf8dd13f01d4dca2fd

本次手动发布的附件仅包含 EXE 安装器；源码可直接浏览仓库或下载 GitHub 自动生成的源码归档。