Skip to content

v3.1.1

Choose a tag to compare

@github-actions github-actions released this 13 Nov 01:41
· 398 commits to main since this release

这是 MineDeck v3.1.1,修了 v3.1.0 里的几个问题,另外收紧了几处安全上的细节,没有新功能。

怎么升级

用着 v3.1.0、v3.0.0 或者 3.1.0 测试版的,打开「设置 → 更新与关于」,点「检查更新」就能升到 3.1.1。服务器、Java、设置和 AI Key 都会接着用。更新前先停掉正在运行的服务器。

有一件事要先知道:点了更新以后,换程序的是旧版本自己带的更新脚本。v3.1.0 和以前的这个脚本有毛病,有两种情况换不了程序(见最后「已知情况」第一条),从这些版本升到 3.1.1 时还可能碰上,照那里的办法处理就行。3.1.1 自己的更新脚本已经修好,以后从 3.1.1 往后升级就不会了。

修了什么

  • 点了更新换不了程序:以前的更新脚本把程序所在的文件夹直接写进脚本,中文系统读这份脚本时,中文路径会变成乱码;开机自动启动的 MineDeck,当前目录又不在自己的文件夹里,于是程序换不了,关掉以后也不会再打开。文件夹名字里有 % 也会这样。电脑的 PATH 里要是有别的 find 程序排在系统自带的前面,脚本不等旧程序退出就去换,同样换不成。现在这几种情况都能换好。实在换不成(比如杀毒软件一直锁着文件),会把旧版本重新打开,不会什么都没有;旧程序一直没退出的话,也不会再打开第二个。
  • 窗口版里的外部链接用你自己的浏览器打开:以前点 EULA、申请 CurseForge Key、openfrp.net 这些链接,弹出来的是 WebView2 自带的简易窗口,用不了自己浏览器里的密码管理器、扩展和登录状态。现在交给系统默认浏览器,Ctrl 点、中键点也一样。从局域网用浏览器打开 MineDeck 时照旧。
  • 窗口版里把文件或链接拖进窗口,不会再另开小窗:以前把文件或网页链接拖到窗口里(待装清单以外的地方),WebView2 会另开一个自带的简易窗口把它打开,和以前点外部链接时弹出来的是同一种小窗。现在没地方接的拖放一律不让放,松手没有反应。待装清单的「从电脑添加」照旧能把 jar 拖进去,输入框照旧能拖进文字。
  • 端口被占着时马上提示:以前别的程序只占着 0.0.0.0、127.0.0.1 这类地址上的同一个端口时,MineDeck 查不出来,点「启动」照样起服务器,要等服务器自己报错。现在照服务端绑端口的办法查,被占着就直接说「端口 25565 被别的程序占着」。崩溃自动重启和定时重启碰上端口还没放开,会先等几秒,不再连着撞三次。
  • 自定义 frps 的凭据能清掉:存过 token 的自定义 frps 隧道,卡片上多了「清除凭据」,清掉以后启动不带 token。以前只能删掉隧道重建。
  • run.bat 里的感叹号:有人在注册表里给 cmd 全局打开了延迟展开的话,手动双击 run.bat 时,名字和参数里成对的感叹号之间的字会被换掉。现在不会了。

几处安全加固

都是 v3.1.0 正式版前检查时记下、说好下个版本收掉的,前提都比较少见。

  • 读写配置不会顺着目录联接跑到服务器文件夹外面:服务器文件夹里有指到外面的目录联接或符号链接时,经过它的配置文件,在 MineDeck 里读不了也改不了。以前这一步查不清就放行了。
  • 换 AI 服务商时写盘失败,不会把旧 Key 发到新地址:设置和 Key 要么一起生效,要么都不生效。
  • 局域网登录的设备看不到完整的 Webhook 地址:只显示地址的开头,后面常带着令牌的部分藏起来了,要改就整个重填。本机照旧看完整的地址。
  • 导入时统一检查 Windows 文件名:现成服务端压缩包、整合包和交接包里,CON.txt、COM1.log 这类设备名,结尾是点或空格的名字,不再收下。只差大小写的两个文件在 Windows 上是同一个,以前后一个悄悄盖掉前一个,现在会写进任务日志。

首次启动协议的两处措辞

第一次打开 MineDeck 时看到的《用户协议与免责声明》改了两处说法:开头的「开源、非营利」改成「开源、免费」;「非官方产品」一条里的「本工具由社区独立开发」改成「本工具为独立开源项目(由随迹提供维护支持)」。别的内容没有动,已经同意过的不会再弹出来。

升级以后要留意的

  • 服务器文件夹里用目录联接把 config 或 world 挪到了别的盘的,经过联接的配置文件在 MineDeck 里读不了也改不了,要直接去那个文件夹里改。
  • 交接包里有 CON.txt 这类名字的,整个包导入不进来。这类名字在 Windows 11 上建得出来,3.1.0 在这种电脑上导出的包里可能有。在原来的电脑上把那个文件改个名字,再导出一次就行;3.1.1 导出时会把这类文件留在包外,写进剔除清单。
  • 从局域网打开「通知与集成」时,Webhook 地址只显示开头。
  • 端口被占着时,「启动」直接报错,不再先起服务器。

下载哪个文件

文件 给谁
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 校验和,自动更新会用到,一般不用管

伙伴模组和 v3.1.0 的是同一份,已经装过的不用换。

这一版实际试过的

  • 自动测试:Go 测试在 Windows 上全部通过,界面交互测试全部走通。每一处修复都反着验过:把修复改回去,对应的测试会失败。
  • 更新:用这一版的代码编了一个「3.0.9」,放在名字带中文和 % 的文件夹里,从 System32 启动(和开机自启一样),PATH 里放着 Git 自带的 find,点更新,换成了线上的 v3.1.0 并自己打开;更新脚本在 936 代码页下也换得成。从 v3.1.0 点更新到 3.1.1 这条路,发版以后再实测。
  • 端口检查:和 Java 17 实际绑端口的结果对照了六种占法,都一致。
  • 窗口版:用发版那条命令编出来的程序打开真窗口,照手测清单用脚本走了一遍。鼠标点击和拖放是通过 WebView2 的调试端口送进窗口的,不是人手点的。
    • 外部链接:openfrp.net 用左键、Ctrl 点、Shift 点、中键各点一次,加上新建向导里的 EULA、CurseForge 的「免费申请」和添加隧道时 OpenFrp 的链接,每一次都由系统默认浏览器(Chrome)打开,没有弹小窗。字体许可的两个文件是 MineDeck 自己的地址,照旧在小窗里显示。
    • 「清除凭据」:先弹确认框,点取消什么都不变,确认以后凭据清掉、按钮消失。
    • 端口:别的程序占着 127.0.0.1 上的同一个端口时,点「启动」马上报错,服务器没有起来;放开以后服务器正常起来,再停掉。
    • 拖放:和正式版 3.1.0 做了对照。3.1.0 上链接和文件拖进来会另开小窗,这一版松手没有反应;jar 照旧能拖进待装清单,文字照旧能拖进输入框。
    • 没做的:没有用鼠标从资源管理器或浏览器里真的拖一次,拖着的时候光标是什么样子也没有看;右键点链接没有试。
    • 协议的措辞是最后才合进来的。合进来以后重新编了一次,在全新的文件夹里打开窗口看过首次启动的协议,是新措辞;端口、清除凭据、拖放和一个外部链接也在这份程序上重跑了一遍。
  • 复审:更新脚本、外部链接、端口检查和四处加固,另请 Gemini 4 Argon 分五份做了只读复审,它提的意见里站得住的都改了,其余几条记在交接说明里;清除凭据由 Claude 逐行审过。

已知情况

  • 从 3.1.0 及以前的版本升级时,可能换不了程序:换程序的是旧版本的更新脚本,它在两种情况下换不成。一种是 MineDeck 装在名字里有中文(或者别的非英文字符)的文件夹里,而这次的 MineDeck 是开机自动启动的:点了更新以后程序关掉,就不会再打开,也没有提示。另一种是电脑的 PATH 里有别的 find 程序排在系统自带的前面(装过 MSYS2、Cygwin 一类工具的电脑可能这样):程序会重新打开,但还是旧版本。两种情况下,新版本都已经下载好、校验过,放在 MineDeck.exe 旁边,叫 MineDeck.new.exe,服务器和设置都不受影响。第一种情况,双击 MineDeck.exe 打开,再点一次更新就行。两种情况都可以手动换:先退出 MineDeck(在托盘图标上右键退出),把 MineDeck.exe 删掉,再把 MineDeck.new.exe 改名成 MineDeck.exe。
  • 和 v3.1.0 相同的几条(交接包和整合包的大小上限、客户端整合包、待决文件只在这次运行里有效、没有数字签名等)见 v3.1.0 的发布说明。

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

What's Changed

Full Changelog: v3.1.0...v3.1.1