Skip to content

HMCL-AE 0.2.0-beta

Pre-release
Pre-release

Choose a tag to compare

View all tags
@LeeWikie LeeWikie released this 29 Jun 16:12
v0.2.0-beta
b65741f

⚠️ 测试阶段 / 内测版,自负风险。 HMCL 的 AI 智能体增强分支(HMCL-AE),基于 HMCL 3.16-SNAPSHOT,遵循 GPLv3。与上游 HMCL 无关,请勿向上游反馈本分支问题。

相比 0.1.0-beta,这一版是一次大幅扩充(38 次提交)。完整改动如下。

⚡ 非阻塞后台任务(本版重点·新)

  • 新增 AiJobManager 异步任务引擎(线程安全、守护线程池、FX 外完成通知、可取消、按会话路由)。
  • 安装 / 下载 / 整合包导出 / 备份 等长任务默认在后台运行,聊天不再被卡住;可用 background=true/false 显式控制。
  • 新增 list_jobs / check_job / cancel_job 三个工具,模型可查询进度、取消任务;提示词已教模型"拿到任务号别声称完成、用 check_job 轮询"。
  • 实时安装进度条:把 HMCL 原生 Task 进度桥接到聊天气泡(有 Content-Length 时显示真实百分比,否则不确定动画)。

🤖 新增大量原生工具(尽量复用 HMCL 自身能力)

  • 账号:list_accounts / add_offline_account / select_account / microsoft_login(走 HMCL 原生登录对话框)。
  • Java / 实例:list_java / download_java / set_instance_memory / instance_details / clean_logs / open_game_folder;修复 list_game_versions(改走 DownloadProviders 多源/镜像回退)。
  • Mod:list_mods / toggle_mod / get_mod_info / check_mod_updates / export_modpack。
  • 世界 / 存档:list_worlds / delete_world / import_world / read_world_info / read_game_options / set_game_option。
  • 服务器 / 资源:list_servers(读 servers.dat)/ ping_server / list_resourcepacks / list_datapacks / install_datapack / list_screenshots。
  • 诊断 / 杂项:system_info(硬件)/ read_clipboard / copy_to_clipboard / export_conversation / prompt_library。

💾 存档 NBT 编辑 + 世界备份

  • NBT 编辑套件:read_nbt / get_nbt / set_nbt / copy_player_data / transfer_inventory / compute_offline_uuid / read_world_info(复用内置 NBT 库;写入前自动逐文件备份、路径限定、原子写、保留压缩、世界锁检查)。典型场景:换账号 / 联机找回存档。
  • 世界备份引擎 WorldBackupManager:版本化时间戳快照 + 保留最新 N 份 + 恢复前自动安全备份;工具 create / list / restore_world_backup(恢复属高危,红色确认)。
  • 新增总开关 nbtToolsEnabled(谨慎用户可整组禁用 NBT 编辑)。

🔒 安全

  • 两级确认:普通危险确认 + 红色高危二次确认(CriticalOperations 分类删存档/删实例/改NBT等灾难操作,YOLO 下也会拦)。
  • shell 等危险工具调用强制带 description(大白话说明,小白看得懂再批)。
  • 新增 「高级选项」「开发者选项」 两个设置区:审批模式(安全/询问/YOLO,选 YOLO 弹测试期警告)、dangerouslySkipPermissions(危险跳过所有确认,开启需红色强警告并可撤销)。
  • 开关:criticalConfirmEnabled、memoryEnabled、fileWriteConfirm 等。

🖼️ OCR(截图转文字)

  • AiOcrConfig + 9 家预置提供商(5 家可用:OCR.space / 视觉大模型 / 百度 / Google Vision / Umi-OCR)+ 独立 OCR 设置页 + ocr_image 工具。

🧠 记忆 + 提示词工程

  • 跨会话全局记忆(纯文件存储,不依赖向量 / embedding 模型):remember / recall 工具 + 自动召回注入。
  • 系统提示词大幅重写:结构化人设 + 工具使用纪律(工具失败不要退化成 shell、减少冗余调用、正确处理 Error 结果)+ 首要原则(优先用原生工具、明确的禁 shell 清单)。
  • 4 个场景 skill:诊断崩溃 / 优化性能 / 管理账号 / 安装与装 mod。
  • 修复 PLAYBOOKS 死代码(此前所有操作手册从未真正喂给模型)。

⌨️ 交互体验

  • 斜杠命令:/new /sessions /skills /help /compact /plan /model。
  • /compact 上下文压缩、计划模式 /plan(只读分析+批准前禁写)、可见 TODO 卡。
  • 对话自动命名(首轮后让模型生成简短标题,替代截首句)。
  • 智能体循环鲁棒性:重复调用拦截 + 末轮强制文字收尾(不再空回复)。
  • 修复小窗口顶栏/输入框被挤压。

⚙️ 设置

  • 端到端接好 10+ 全局选项(Agent 行为 / 安全 / 界面,折叠卡 + 开关 + 滑块)。
  • 补完所有"开发中"项:数据备份 / 恢复 / 导出、清缓存、知识库目录、记忆标签页(列真实条目)。
  • 每模型可设输入/输出模态 + 能力(工具/视觉/推理)。

🐛 修复(尤其弱模型稳健性)

  • 整数参数被当小数解析(Gson Double → int,容忍 "4096.0"):修好 set_instance_memory / clean_logs / download_java 等静默失败。
  • 卡死:SetInstanceMemoryTool 无界 latch → 10s 超时;适配器 catch(Exception)→catch(Throwable)(OCR 等的 NoClassDefFoundError 不再卡死停止按钮)。
  • 会话存盘并发丢失(CME)修复。
  • web_search / web_fetch 现遵循 HMCL 代理(此前 JDK HttpClient 绕过代理,国内常失败);搜索工具加超时+取消;模型测试显示延迟 ms。

📦 文档 / 打包

  • README 重写为完整介绍页;Debian 包改名 hmcl-ae(GPLv3 §7c)。

已知限制 / 尚未完成

  • 后台任务"完成自动续轮"与"可视任务列表 UI"未完成 —— 本版为轮询式(AI 主动 check_job 查)。
  • 多语言(i18n)、隐私同意提示、成本上限/计量、拼音输入法回车误发 尚未处理。
  • 微软登录在分支构建中可能不可用(缺官方 auth id);可用离线账号。
  • 默认模型尚未内置,需自行在设置里配置 API 服务商与 Key。

怎么用

  • Windows:HMCL-AE-0.2.0-beta.exe 双击(未签名,SmartScreen 可能拦,选"仍要运行")。
  • 任意平台:需 Java 17+,java -jar HMCL-AE-0.2.0-beta.jar。
  • Linux:HMCL-AE-0.2.0-beta.sh。

可用 .sha256 校验文件完整性。

Assets 7
Loading