0.1.1-alpha 之后的开发进展,发布版本号与日期待定。
instance 工具本轮新增下列动作,均复用 HMCL 原生的对应实现(不另写一套逻辑),权限按动作细分(只读 / 受控写入 / 危险写入)。
set_java:设置实例的 Java 运行时选择(mode = auto / version / detected / custom)。set_window:游戏窗口模式与尺寸(windowed / fullscreen / maximized,窗口模式附 width / height)。set_launch_behavior:启动前后行为(启动器可见性、进程优先级、自动 agent、是否禁用自动 game options、日志窗口、调试日志、跳过完整性检查)。set_graphics:图形后端与渲染器(default / opengl / vulkan,不带参数先报告本机支持的渲染器)。set_launch_args:每实例启动参数覆盖(游戏命令行参数、环境变量、默认 / 优化 JVM 参数开关、JVM 校验开关)。list_presets(只读):列出全局游戏设置预设。set_memory:修复自动 / 固定内存切换未正确写入 overrideProperties、导致设置值被预设静默继承的问题。
mods_rollback:把模组回滚到归档的旧版本(不带 version 则列出可回滚版本)。resourcepacks_check_updates:列出有新版本的资源包(apply=true 下载替换;未设 apply 时只读)。worlds_export:把世界存档打包为 zip(不覆盖已存在文件)。worlds_duplicate:把世界复制到新的存档文件夹。datapacks_toggle/datapacks_remove:单个数据包的启停 / 删除(删除为危险动作,优先进回收站)。install_local_content:把本地已有文件(mod / 资源包 / 光影)按类型装进实例对应目录,尊重版本隔离;类型不符即拒绝。
instance_maintenance:对应原生「版本管理」菜单(clean_junk / redownload_assets / clear_resources / clear_libraries);后两者为危险动作,需 confirm 且游戏运行时拒绝;不带 scope 时只报告可回收空间。java_manage:管理 HMCL 的 Java 运行时注册表(refresh 重扫 / add 登记已有 Java / uninstall 删除托管运行时);uninstall 只删 HMCL 自己下载的运行时,不碰系统或用户自装 JDK。generate_launch_script:生成可在启动器外运行的启动脚本(.bat/.sh/.command),需已选账户。set_instance_icon:设置实例图标,复用 HMCL 原生图标系统(内置图标名、auto,或自定义图片)。schematics_list/import/delete/reveal:管理实例schematics/下的 Litematica 投影文件。
launch新增testMode:复用原生「测试游戏」入口,本次启动强制保留窗口并显示日志,不改动持久化设置。mods_install支持ids数组一次安装多个已知项目(不自动装依赖,逐项回执)。mods_update支持all=true或mods数组一次更新多个模组。- 实例列表富化:每个实例附带检测到的加载器与本地模组数(纯本地)。
知识库(RAG)相关能力仍不成熟,发布版中隐藏其设置与实现:AI 设置的「知识库」分区、模型的「嵌入」能力勾选、以及 kb_search 工具在发布构建中不出现,提示词也不会提及它。代码与已保存配置保留不动,由构建标志 KNOWLEDGE_BASE_UI_ENABLED 控制(开发构建可见,或 -Dhmcl.experimental.ai.kb=true 强制开启)。
知识库关闭时保证有下位替代:AI 仍可用搜索 / 联网搜索 / 内置知识作答;开启时 kb_search 与它们并存,不冲突。
- AI 助手 — 工具编码修复(Windows)Shell 工具在 Windows + JDK 21 下按控制台编码(
sun.jnu.encoding,通常 GBK)解码输出,修复中文乱码;文件读取改为先严格 UTF-8、失败再回退本地编码,修复非 UTF-8 文件读取崩溃。 - AI 助手 — 搜索结果透出兼容信息模组 / 资源包 / 光影搜索结果补充各条目支持的游戏版本与加载器(来自 Modrinth / CurseForge 响应),便于按用户实际需要选择,减少装错构建。
- AI 助手 — 工具增强
grep支持上下文行(-B / -A,重叠窗口去重);web_fetch在正则抽取前对不可信响应体加输入大小上限,消除多 MB 页面上的 O(n²) 回溯风险。 - 界面 — 图标统一AI 界面改用 HMCL 原生的 Material Symbols 图标,导航采用未选中 fill=0 / 选中 fill=1 的填充切换。
- 界面 — 对话工具调用卡片恢复分组摘要(工具名 + 「+N」折叠)并配 SVG 图标;Markdown 代码块复制按钮改为图标式(悬停涟漪 + 提示,成功时短暂切为对钩)。
- 测试新增 Monocle 离屏运行 TestFX 的
-PmonocleTest,UI 测试可真实执行且不弹窗抢焦点;修复受工具卡片改动影响的相关 UI 测试。