Repository navigation
v3.2.1
这是 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
- 两个窗口同时开着同一处设置,后存的一边不再把另一边刚存的改回去(剩下的十处) by @Trasperioooooon in #30
Full Changelog: v3.2.0...v3.2.1