Releases: Mai-with-u/MaiBotOneKey
Releases · Mai-with-u/MaiBotOneKey
0.4.8
0.4.6
0.4.6 - 2026-05-28
本版本把 QQ 后端组件升级纳入一键包更新流程：启动器升级后会用新安装包内置的 NapCat / SnowLuma 程序文件刷新本地组件，同时保护用户配置、登录数据、运行数据和日志。SnowLuma 预置包同步到官方 v1.9.2，并继续收紧 Windows 打包内容，减少把本地运行痕迹带入安装包的风险。
NapCat / SnowLuma 组件升级
- 一键包版本变化后首次启动会自动同步 NapCat 与 SnowLuma 程序文件，并记录当前启动器版本，避免每次启动重复覆盖。
- 设置中心新增“升级 NapCat / SnowLuma”入口，可在停止 MaiBot Core 和 QQ 后端后手动刷新两个组件。
- 组件升级会强制覆盖程序文件，但会保留 NapCat 的
config/data/logs、napcat/config/napcat/data/napcat/logs、版本资源中的 NapCat 配置、根目录config.json、数据库与日志文件。 - SnowLuma 升级会保留
config、data和logs，避免清空 WebUI、OneBot、账号登录、消息数据库和运行日志。 - 升级流程失败时会尽量把已临时移出的受保护文件恢复回原目录，降低半途中断造成配置丢失的概率。
SnowLuma
- 内置 SnowLuma 预置包更新到官方 v1.9.2 Windows x64 包。
- SnowLuma 预置包继续作为干净程序模板使用，运行时配置、数据和日志不再随安装包模板一起分发。
打包与更新
- Windows 打包排除 SnowLuma 的
config、data、logs，避免把本地账号、WebUI、OneBot、数据库和日志带入安装包。 - Windows 打包补充排除 NapCat 根目录的
config.json、数据库文件和日志文件，进一步清理内置模板。 - 重置启动器设置时会清理组件自动升级记录，后续重新初始化时可按当前版本重新同步组件。
0.4.5
0.4.5 - 2026-05-27
本版本继续收紧 0.4.x 的更新与启动流程：一键包自更新能看到下载进度，消息平台未配置时不会误启动 QQ 后端，NapCat 打包和运行目录也进一步清理，减少把本地配置、缓存或旧框架内容带进安装包的概率。
启动器更新
- 启动器更新源切换到
Mai-with-u/MaiBotOneKey，首页更新入口、发布页跳转和后台检查都会指向新的官方仓库。 - 下载一键包更新时会实时回传检查、下载、启动安装器和完成状态，并显示接收字节数与百分比。
- 更新安装包改为流式写入临时文件，下载完成后再替换为正式安装包，失败时会清理残留的
.download文件。 - 启动时会自动清理上次留下的更新安装包缓存，并在日志里记录清理结果或暂时无法清理的文件。
服务启动与消息平台
- 未配置 QQ 账号时，“启动全部服务”只启动 MaiBot，不再直接拉起 NapCat / SnowLuma。
- 手动启动 NapCat / SnowLuma 前会检查消息平台配置，未配置时给出明确提示，避免后端在缺少账号信息时空跑。
- 切换 QQ 后端或重新写入消息平台配置时，会同步刷新所选后端和备用后端的适配器配置，减少旧端口、旧 token 残留。
NapCat 打包与运行目录
- Windows 打包排除 NapCat 运行时配置目录，避免把本地账号、WebUI 配置、数据和缓存带入安装包。
- 移除旧
napcatframework目录的复制、校验和路径重定位逻辑，NapCat 运行目录来源更单一。 - NapCat WebUI 配置查找只关注当前
napcat/config，降低旧版本目录或框架目录干扰配置识别的概率。
界面细节
- 顶部主服务按钮会根据当前状态在“启动全部服务”和“停止全部服务”之间切换，运行中时直接显示停止按钮。
- 首页消息平台配置卡片提示更明确，随便聊聊快捷发送按钮改为图标按钮，减少窄布局文字拥挤。
- 终端页顶部去掉重复标题区域，保留更紧凑的标签栏和操作入口。
- 未来复古标题字体继续调整，按钮和信息卡的视觉层级更集中。
0.4.4
0.4.4 - 2026-05-27
本版本主要继续打磨 0.4.x 的日常使用体验：启动器更新说明更完整，WebUI 与随便聊聊的等待/断线状态更清楚，插件市场交互更顺手，设置中心也更像一个集中管理面板。
启动器更新
- 首页的一键包更新入口新增详情弹窗，可查看当前版本、最新版本、安装包名称、大小、来源和发布说明。
- 更新入口继续保留黄点提示，并可直接重新检查、打开发布页面或下载安装包。
MaiBot WebUI 与随便聊聊
- MaiBot Core 启动后 WebUI 还没就绪时，不再只留下空白页，会显示“等待 WebUI 启动 / 暂不可访问”的状态页，并提供启动入口。
- WebUI 在服务真正就绪后会自动重新加载，减少“进程已经启动但页面没刷出来”的情况。
- WebUI 工具栏会跟踪当前实际地址，刷新或在浏览器打开时使用当前页面地址，而不是固定使用初始地址。
- 随便聊聊在未连接且没有消息时会显示清晰的离线状态，可直接启动 MaiBot Core 或重新连接聊天服务。
插件市场与插件编写
- 插件市场卡片现在可以直接点击打开详情；卡片内的安装、启用、评分、评论等按钮不会误触打开详情。
- 插件市场会批量加载当前用户的点赞、点踩、评分和评论状态，列表打开后的状态同步更快。
- 评分和评论可分开提交；只想补一句评论或只改评分时，不必重复填写另一项。
- 插件更新支持处理非 Git 方式安装的插件：会先备份旧目录、克隆新版并保留原有
config.toml/config_back，失败时自动恢复旧插件。
设置、窗口与外观
- 设置中心新增更集中的通用体验：关闭行为、终端模式、终端字号、插件编写器、主题、字体、圆角和 QQ 后端都能在同一处调整。
- 未来复古外观继续打磨：默认保持浅色呈现，滚动条、顶部标签分隔线、徽标和按钮视觉更统一。
- 窗口圆角改为按外观模式分别记忆，未来复古模式支持调到更方正的 0px 圆角。
- 移除未稳定的液态玻璃层，旧的
future/ 液态玻璃设置会迁移到现代外观，减少透明窗口带来的阅读和兼容问题。 - 无边框窗口的最大化 / 还原逻辑更稳定，最大化会贴合当前屏幕工作区，还原时会回到合理尺寸与位置。
- 悬浮模式拖动和展开收起更稳，和主窗口最大化状态之间的切换更少出现尺寸错乱。
初始化、更新与打包
- 首次启动引导中，如果依赖下载卡住或需要重来，可以直接重新发起依赖下载 / 重启 MaiBot Core，不必退出引导重开。
- 重启 MaiBot Core 时会等待正在进行的 Python 依赖安装收尾，减少依赖安装和服务重启互相打架。
- MaiBot 模块更新选择指定分支或 tag 时会明确切到目标版本；远端拉取或子模块更新失败时，会尽量恢复到更新前的分支、提交和远端配置。
- MaiBot WebUI 端口读取更稳，只读取配置中的
[webui]段，降低其他 TOML 内容影响 WebUI 地址识别的概率。 - NapCat WebUI 快捷入口会使用新的登录地址并带上 token，减少打开后还要重新找登录入口的情况。
- Windows 打包进一步清理内置模块内容：用户插件目录整体从主模块复制中排除，NapCat / SnowLuma 适配器作为干净快照单独打包，避免把配置、数据、日志、数据库或缓存带进安装包。
终端与细节修复
- 终端页顶部改为更清晰的标签栏，可看到服务终端和手动 Shell 的状态，并可关闭用户打开的 Shell。
- 终端、设置页和未来复古界面的滚动条样式更一致，减少圆角 / 主题混用导致的突兀感。
- 插件市场、更新弹窗等 Markdown 内容支持分隔线，发布说明和 README 阅读更清楚。
0.4.3
0.4.3 - 2026-05-27
外观与主题
- 重构外观模式与首页设置体验，统一外观设置入口、主题状态和页面呈现。
- 新增未来复古外观风格，并移除旧应用图标选项，减少过时配置入口。
- 补充外观架构维护说明，方便后续扩展主题、透明效果和窗口样式。
首页与界面
- 优化首页、设置中心和插件市场中的冗余信息展示，让常用操作更集中。
- 调整首页后端服务控制入口，启动、停止和重启操作更贴近当前服务卡片。
- 优化部分按钮、徽标和页面层次，提升不同外观模式下的可读性。
0.4.1
Changelog
0.4.1 - 2026-05-25
随便聊聊
- 支持解析 MaiBot WebUI 富文本消息段，机器人发送的图片、表情、语音和文件不再只显示为占位文本。
- 会读取 MaiBot 配置中的 WebUI port，适配非默认端口启动webui。
MaiBot 更新
- 首页 MaiBot 更新入口支持选择正式版、测试版，以及自定义分支或 tag。
- 首页更新按钮改为上箭头图标，有可用新版本时会显示黄点提示。
首页
- 添加首页角落形象介绍彩蛋。
0.4.0 - 2026-05-24
插件编写器
- 内置了opencode，并提供插件编写指导，你可以直接编写插件
插件市场
- 完善插件市场互动体验，强化插件详情、用户状态、评分、点赞/点踩与下载记录等交互入口。
桌面外观与首页
- 添加多种图标可选
- 添加不好看的apple液态玻璃样式
- 优化桌面外观、标题栏和首页体验。
- 设置中心扩展外观选项，支持更细的界面风格、透明度和窗口圆角调整。
启动器更新
- 新增启动器更新检查和下载安装入口，可在首页发现新版本并触发安装流程。
- MaiBot 更新不再单列“最新旧版”，非预发布 tag 统一归入正式版。
运行状态
- 修正运行时文案、依赖安装提示和服务状态显示，让初始化、终端和托管服务反馈更准确。
0.3.4 - 2026-05-20
SnowLuma
- 更新版本到1.9.0，更新适配器版本到1.2.0，支持表情包正确识别，修复at重复识别，支持转发消息部分正确识别
插件管理
- 插件配置在 MaiBot Core 未启动时也会尝试读取本地
config.toml和插件配置声明，提前显示中文配置名与字段说明。 - MaiBot Core 仍在加载插件系统时，插件状态显示为“加载中”，不再误判为加载失败。
启动器设置
- 设置中心新增简化的本机网络代理开关，可配置
127.0.0.1:<端口>以对接 Clash / Mihomo 等代理软件。 - 网络代理会应用到启动器网络请求、Git / pip 更新，以及之后启动的托管服务环境变量。
初始化与终端
- 初始化与修复 MaiBot 配置时不再写入旧的
onekey-local-chat本地聊天平台账号。 - 稳定内嵌 PTY 终端尺寸同步，减少启动和切换时的尺寸错位。
窗口
- 修复无边框透明窗口无法拖动边缘缩放的问题。
- 退出悬浮模式时会恢复普通窗口的可缩放状态，避免窗口卡在不可缩放。
0.3.3
Merge desktop updates Merge modular desktop shell, local chat, settings, and home overview updates.