MineDeck

v3.2.1

StableSame day as the previous releaseMineDeck.exe · 17.1 MB

A newer Stable release, v3.2.2, is available →

Files

FileSizeSHA-256Download
MineDeck.exeWindows app 17.1 MB 02e93e0dbfdf…1c8511 MirrorGitHub (external link, may be slow in mainland China)
minedeck-companion-neoforge-1.21.1-0.2.1.jarAI companion client mod (NeoForge 1.21.1) 120 KB 6ea730abf361…8c690e MirrorGitHub (external link, may be slow in mainland China)
minedeck-companion-forge-1.20.1-0.2.1.jarAI companion client mod (Forge 1.20.1) 119 KB 06449d883601…014474 MirrorGitHub (external link, may be slow in mainland China)
SHA256SUMSSHA-256 list of all files 1 KB 2e0c1991f9e2…5b5df3 MirrorGitHub (external link, may be slow in mainland China)

Release notes

Release notes are written in Chinese.

这是 MineDeck v3.2.1,一个小版本。v3.2.0 的「已知情况」里写过:同一处设置在两个窗口里同时开着时(比如电脑上的 MineDeck 窗口和手机上的管理页),后保存的一边会把另一边刚存的改回原样,一共十处。这一版把这十处都修了,顺带修了同一轮复审记下的两个小问题。没有新功能。

怎么升级

用着 v3.2.0 的,打开「设置 → 更新与关于」,点「检查更新」就能升到 3.2.1。服务器、Java、设置、隧道和 AI Key 都会接着用。更新前先停掉正在运行的服务器。

用着 v3.1.1、v3.1.2 或者 3.2.0 测试版的,也能在程序里直接升到 3.2.1:3.2.0 的 beta.3 到 beta.5 不管更新渠道选的是哪个都查得到,beta.1、beta.2 和 3.1.x 只看正式版,3.2.1 就是正式版,也查得到。

从 v3.1.0 及更早的版本升级时,换程序的是旧版本自己带的更新脚本,它有两种情况换不成,新版本这时已经下载好、放在旁边。处理办法见 v3.2.0 的发布说明「已知情况 → 升级和更新」的第一条。

修了什么

两个窗口同时开着同一处设置时,现在只存这一页改过的那几项,后保存的一边不会再把另一边刚存的改回去。两边改了同一项的,以后存的为准。具体是这十处:

  • 服务器的「设置 → 启动与内存」:内存和 JVM 参数各存各的,只存这一页改过的那一样。
  • 服务器的「定时任务」:崩溃自动重启拨过才存;任务一条一条地加、删,另一边刚加的任务不会被删掉,刚删的也不会加回来。
  • 隧道的「编辑」:只存这次改过的名称、绑定的服务器、跟随启动;一样都没改就直接关掉。
  • 隧道的「清除凭据」:只清凭据,别的不动。
  • AI 伙伴的禁挖区域:一个一个地加、删、改,改就是删掉原来那个、再加上改好的。两边加了同名的区域,后加的一边会提示已经有了。
  • 工具箱「导出 Modrinth 整合包」的草稿:只存改过的几格。自动保存一次只发一个,前一次还没存完时又改的,等它存完再接着存;这时整页刷新或关掉页面,没来得及发的那份也会当场发出去。
  • 「设置 → 手机远程管理」改访问密码:只存密码,不再连开关一起存。以前另一边刚关掉了远程管理,这边一改密码,又会把它打开(重启 MineDeck 以后生效)。
  • 只能在这台电脑上改的三处,开着两个本机页面时也一样修了:
    • AI 设置里的自填单价:一条一条地加、删。
    • 游戏内 AI 的「能让 AI 执行命令的玩家」:一个一个地授权、收回。以前一边刚收回了谁,另一边给别人授权时会把那个人又授权回去。
    • AI 设置里的服务商:服务商、接口地址、模型、Key 这几项互相牵连,合不到一起,所以这一处不合并。别的窗口刚改过时,这一页保存会被拦下、什么都不改,弹窗请你重新读取最新的设置再改。

两个小问题:

  • 服务器「设置 → 常用」里原来文件里没有的项(比如资源包链接),在同一页里填上、保存,再清空、保存,以前提示已保存,文件里却还留着刚才填的值。现在清空也会存进去。
  • 添加隧道时凭据太短的那句提醒,原来写「6 个字符」,实际是按字节算的,改成了「不到 6 个字节(字母和数字一个算一个,汉字一个算三个)」。

给 AI 助手、MCP 和自己调接口的人

为了「只存改过的」,几个操作的参数跟着变了。界面不用管,AI 助手、MCP 客户端和自己写脚本调接口的请留意:

  • 改定时任务(instance.policies.set):crashRestart、schedules 不传就是不改。以前不传等于关掉崩溃重启、清空任务表。新加了 addSchedules、removeSchedules,按条加、删。
  • 修改隧道(tunnel.update):只改传了的项,没传的沿用存着的,不再收 publicAddr。以前是整份替换。
  • AI 服务商(ai.provider.set):读设置时 provider 里多了一个 rev。保存时带上它,别处改过就回 409、什么都不改;不带照旧不检查。
  • 自填单价(ai.prices.set)加了 addPrices、removePrices,prices 不再必填;伙伴设置(companion.settings.set)加了 addZones、removeZones;游戏内 AI(gameai.set)加了 addAllowed、removeAllowed;工具箱草稿(toolbox.mrpack.draft.save)只改传了的字段。原来整份传的写法(prices、zones、allowed、整份草稿)照旧能用。

接口的详细说明见 docs/设计与参考/API.md。

下载哪个文件

文件给谁
MineDeck.exe开服的人。放进一个单独的空文件夹,双击运行;已经在用旧版本的,换掉原来的那个。
minedeck-companion-neoforge-1.21.1-0.2.1.jar用了 AI 伙伴的 NeoForge 1.21.1 服上的好友:放进客户端的 mods 文件夹
minedeck-companion-forge-1.20.1-0.2.1.jar同上,Forge 1.20.1 的服
SHA256SUMS校验和,自动更新会用到,一般不用管

伙伴模组还是 0.2.1,和 v3.2.0 的是同一份,已经装过的好友不用换。

这一版实际试过的

  • 自动测试:在最终代码上,Go 测试 42 个包全部通过,代码检查(go vet)没有提醒;界面交互测试 263 条、界面原型自检 162 个场景全部走通。这一版新加的用例(「两个窗口」一组十几条,以及 Go 里的合并、加锁和过期拦下)逐条反着试过:把对应的代码改回去,它们都会失败。
  • 真窗口:用发版那条命令编出来的程序,在一份测试副本里打开真窗口,用脚本代替人手试了六处:手机远程管理改密码、启动与内存、定时任务、隧道的编辑、AI 服务商被拦下、工具箱草稿。每一处都是页面先打开,再用程序自己的接口模拟另一个窗口存一项,然后在页面上改另一项、保存,最后读回来:另一个窗口存的那项都还在。AI 服务商那一处被拦下、什么都没改,重新读取以后显示的是另一个窗口存的。窗口里没有脚本报错。只在一块 100% 缩放的屏幕上试过。
  • 复审:Codex(GPT-6-Astra,max 档,只读)看了三遍。前两遍看整支改动,指出的三处都改了:AI 服务商保存以后拿到的可能是另一个窗口的版本号;草稿第一次还没存完又改回原样,会漏存;排着没发的修改碰上整页刷新会丢。第三遍只看最后那处修改,结论是可以发,另记了三条草稿的边角情况,写在下面的「已知情况」里。

还没实测过的

  • 两台真的设备同时开着:真窗口那一轮是一个窗口加脚本,没拿手机和电脑两边真的同时点。
  • AI 伙伴的禁挖区域、游戏内 AI 的授权名单、自填单价、隧道的清除凭据这四处没在真窗口里试,只有自动测试。
  • 工具箱草稿「整页刷新时当场发出去」那一层只在测试用的 Chromium 里试过。程序被直接关掉时,本机的后端跟着退出,正在存的不一定存得上,这和 v3.2.0 一样。
  • 参数变了的那几个操作(定时任务、修改隧道等)没拿真的 MCP 客户端或 AI 提案走一遍,只有自动测试。
  • v3.2.0 发布说明里写的那些(真实账户、真实 AI Key、用游戏客户端进服等)照旧没实测,见 v3.2.0 的发布说明。

已知情况

  • 几处整段保存的单个输入框:AI 伙伴「攻击时不许打的生物」、游戏内 AI 触发前缀的别名、音乐共享的排除名单,以及第一次打开时的引导。它们本身就是一项,两个窗口都改了时,以后存的为准。
  • 点了保存、还没存完的那一两秒里接着输入的内容,可能被清掉:改访问密码、添加自填单价、隧道的编辑框、禁挖区域的编辑框、游戏内 AI 授权的输入框是这样。v3.2.0 就这样。
  • 工具箱的整合包草稿,保存还没完成时马上刷新或关掉页面:极少数时候,最后改的那一格没存上,或者被改回前一刻的样子;两个窗口同时改同一格时,也可能是先存的那边留下。v3.2.0 也有同类情况。
  • AI 助手改启动参数时,确认卡片里列的 JVM 参数不含 MineDeck 会自动补上的 log4shell 缓解参数,实际存进去的会带上。
  • v3.2.0 已知情况里的别的几条照旧,见 v3.2.0 的发布说明;其中「两个窗口同时改设置」那一节和「常用」里清空不生效那一条,这一版修了。
已经查到、下一版修的
  • 1.7 到 1.11.2 的服务器,log4shell 漏洞的防护可能没起作用:MineDeck 给这段版本用的是 Mojang 给 1.12 到 1.16.5 的那份日志配置,Mojang 给 1.7 到 1.11.2 的是另一份。我们推断这段版本自带的 log4j 太老,认不得现在加的防护,还没实测。在修好之前,开这段版本的服务器、又开了内网穿透让外人进来的,请只让信得过的人进。
  • 待装清单的文件在启动那一刻读不出来时(比如正被杀毒软件或同步盘占着),清单会被清空,暂存在 MineDeck 里的本地模组也会被删掉。这是读代码看出来的,还没复现过。电脑上原来那份模组文件不受影响,重新从电脑添加就行。
  • OpenFrp 的 frpc 解压到一半出错时(比如盘快满了),会留下半截的程序,以后启动这条隧道一直失败。碰上的话,删掉 MineDeck 旁边 runtimes\frpc\openfrp 文件夹里的 exe 和 cache\frpc 文件夹里的 openfrp-frpc.zip,再启动隧道,会重新下载。

遇到问题,欢迎在 GitHub 上提 Issue,写清楚做了什么、看到了什么。不要贴出 API Key 和各种令牌。

What's Changed

Full Changelog: https://github.com/Trasperioooooon/MineDeck/compare/v3.2.0...v3.2.1