Releases: Mai-with-u/MaiBot
Releases · Mai-with-u/MaiBot
1.0.5
1.0.4
[1.0.4] - 2026-6-15
修复
- Docker无法使用playwright的问题
- 调整了webui log 列宽默认值以适配更多浏览器情况
存储优化
- 大幅优化数据库存储膨胀现象
1.0.3
[1.0.3] - 2026-6-14
用户感知功能侧
Maisaka
- 新增聊天配置“自身消息特殊标注”，会在上下文中更明确标出麦麦自己发送的消息，减少模型把自己说过的话认成其他用户发言的情况。
- 优化中期记忆与 Maisaka 上下文处理，减少无关历史消息进入回复链路，让长对话中的上下文引用更稳定。
- 优化行为学习的场景匹配、反馈沉淀与行为参考表达，让麦麦更容易复用有效经验，并降低行为参考对回复风格的干扰。
WebUI / Dashboard
- 聊天页新增头像缓存与展示支持，聊天列表、顶部栏和消息流会更稳定地显示用户与聊天对象头像。
- 推理过程页面增强记录筛选、动作筛选、结构化 prompt 展示、工具调用折叠和消息头像映射，排查回复过程时更容易定位关键上下文。
- 插件详情页 README 加载体验优化，切换插件时内容刷新更稳定；复古主题底纹显示效果也做了微调。
开发侧 / 修复
WebUI 架构
- WebUI 多个页面继续下沉页面状态与数据请求逻辑，统一 API 抛错契约，并补充关键页面的特征化测试；这部分主要是内部架构整理，对用户功能入口影响较小。
调试与实验
- 新增行为学习相关离线 abtest 脚本，用于对比场景 embedding 匹配、学习合并与摘要字段效果，方便后续继续调优行为系统。
1.0.2
[1.0.2] - 2026-6-13
用户感知功能侧
Maisaka
- 多重表达选择现在不会破坏缓存
插件 / 兼容性
- 插件市场兼容性筛选、详情页和安装 / 更新入口同步支持同主版本小版本兼容，避免市场误判可兼容插件。
1.0.1
[1.0.1] - 2026-6-13
用户感知功能侧
WebUI
- 插件安装与更新进度展示更完整，现在会显示当前使用的镜像源、镜像源序号、重试次数和切换镜像源状态，安装失败或切换源时更容易判断卡在哪一步。
- 配置页、模型厂商列表、插件配置页、首页版本卡片、表达学习页和黑话管理页继续优化布局与交互。
- 插件配置页新增“设置 / 详情”分区，插件详情中可以查看 manifest 信息，并直达主页、仓库、文档和问题反馈链接。
- 推理过程嵌入模式下的工具栏布局优化，浏览控制与刷新按钮在嵌入场景中更稳定。
Maisaka
- 裁切历史触发的表达、行为、黑话和高频词学习改为后台执行，减少长对话上下文裁切时对当前聊天流程的阻塞。
插件 / 兼容性
- 插件 manifest 的 Host 版本兼容策略放宽：同一主版本内，插件声明的最大支持版本低于当前小版本时会以兼容模式加载并输出警告，而不是直接拒绝加载。
- 插件运行时握手和 Runner 环境变量会传递主程序实际版本号，方便插件侧根据真实 Host 版本做兼容判断。
稳定性
- 统计数据输出间隔从 5 分钟放缓到 15 分钟，减少日志刷屏和周期性统计开销。
开发侧 / 修复
WebUI API / 前端架构
- 新增统一请求客户端
createApiClient，集中处理 base URL、Cookie 认证、JSON/FormData 编码、响应解析、ApiError和路由未命中诊断。 - 新增
backendApi、statsApi、authApi三类请求实例，分别服务主后端、统计服务和认证流程，认证检查中的 401 不再触发整页跳转。 - 引入 TanStack Query 作为服务端状态管理基础，人物管理页率先迁移到
useQuery/useMutation，查询失败局部展示，写操作失败统一 toast。 - 迁移多处 dashboard API 模块与页面内联请求，删除旧的
fetch-with-auth、api-helpers、lib/api等请求入口，并补充请求客户端单元测试。
1.0.0
更新日志
测试版更新日志见 changelog_dev.md。
[1.0.0] - 2026-6-12
功能更新简报
关于更详细的功能，可以访问 changelog_dev.md 查看各个预发布版本的细则。
Maisaka
- 核心回复机制升级，麦麦现在和一个Agent一样工作，但是仍保有优秀的回复质量。
- 群聊、私聊和 其他聊天的回复链路统一，体验更加稳定。
- 原生支持多模态上下文，图片、转发消息、复杂消息和工具返回的媒体内容能更稳定地进入后续对话。
- 新增中期记忆能力，长对话会被压缩成可继续引用的摘要，减少上下文变长后“忘前文”的情况。
- 支持 prompt 模板和配置热重载，调整提示词或部分配置后更容易即时生效。
A_Memorix / 记忆
- A_Memorix 记忆系统主线化，支持段落、实体、关系、来源、向量和图谱统一存储，替代旧长期记忆链路。
- 长期记忆检索融合向量、图关系、BM25、PageRank、后验图检索和阈值过滤，提升召回质量和可解释性。
- 支持历史聊天总结导入长期记忆。
- 人物画像功能，支持人物事实写回证据、画像自动注入、证据查看与纠错闭环。
- 长期记忆控制台体验增强，可以查看知识图谱、证据链、导入状态、纠错历史和审计时间线，更容易知道麦麦“为什么记得这些”。
- 支持知识来源删除、重新导入、失效清理和批量网页导入优化，长期记忆与知识库维护更可靠。
WebUI / Dashboard
- 完成新界面体系升级，将聊天、配置、插件、记忆、知识库、统计、监控、日志、推理过程和系统设置等核心能力整体交互体验持续打磨
- 配置管理能力显著增强，支持动态表单、数字草稿输入、列表、JSON、extra params、模型任务配置、插件原始 TOML 编辑，以及动态发言频率的可视化时间轴配置。
- 插件与资源管理更完整，插件市场支持安装、启停、配置、更新、运行状态、README、分类、图标、评价和随机推荐；表情包、图片缓存、日志、数据库和 data 目录也可以在 WebUI 中查看与清理。
- 调试与观测能力集中增强，首页状态、存储概览、详细统计、日志查看器和推理过程工作区可以展示缓存命中、资源占用、请求模型、推理耗时、工具调用、prompt 预览和动作摘要。
- 聊天与内容管理体验升级，聊天页支持图片消息、复杂消息查看、用户模拟、平台模拟和更稳定的 WebSocket 通信；表达学习、黑话、快速审核和聊天流筛选也会优先展示真实聊天流名称。
- 新增人设生成器测试功能，可把文段、角色卡或设定说明生成可注入的麦麦人格、表达风格和聊天提示词配置块。
插件 / MCP / 工具
- 插件系统重构为独立
plugin_runtime，支持插件独立启动、停止、重载、运行状态追踪、组件注册、事件分发、Hook、API 和 RPC。 - 插件可访问宿主消息、聊天流、配置、运行时数据、embedding 能力和 LLM provider 适配能力，插件开发面更完整。
- MCP 能力主线化，支持加载 MCP 工具、Prompt、Resource，并可通过 Host LLM Bridge 反向调用主程序模型。
- 插件市场体验增强，支持排除已安装插件、随机推荐、分类与兼容性筛选、README 展示和更完整的插件信息。
- 插件管理页支持更丰富的操作入口，可以更方便地配置、重启、更新、查看运行状态和定位插件错误。
- 插件超时熔断和默认超时时间优化，单个插件响应异常时更不容易拖慢主程序。
表情包 / 图片 / 多模态
- 表情包管理升级，支持认识、不认识、据为己用、丢弃等状态视角。
- 图片缓存新增自动清理、分页浏览、预览、按日期筛选、单个删除和批量删除能力。
- 入站图片支持过大图片压缩或丢弃，图片、工具返回媒体和转发消息在上下文中保留更稳定。
- 新增
send_image能力，能够通过上下文消息或工具媒体索引更稳定地发送图片。 - WebUI 聊天支持发送图片消息，图片文件在一键包和 WebSocket 场景下处理更可靠。
- 表情包支持按状态、格式和 tag 管理，重复上传、识别失败、取消注册、替换和删除流程更稳。
- 表情包发送成功后再计数，减少使用次数统计偏差。
- 图片缓存支持恢复已清理文件的识别记录，老图片再次出现时能重新保存并继续使用既有识别结果。
性能、稳定性与安全
- 启动流程优化，延后非关键服务初始化并减少阻塞步骤，提升启动速度。
- 统计系统改为聚合服务，降低大数据量统计的内存占用，并新增缓存率等统计信息。
- WebUI 安全加固，增强认证、路径校验、URL 校验、反爬中间件和静态资源访问防护。
- 日志系统增加上限和清理能力，减少长期运行时的磁盘压力。
- 回复分割、Timing Gate、Planner 配合和空白消息过滤持续优化，减少无效行动、空回复和供应商格式错误。
- Docker、依赖、默认镜像源和开发容器配置同步更新，部署与更新过程更顺滑。
开发侧 / SDK / API 改动
架构与数据
- 更新了版本号
- 核心运行结构重构，新增
src/services服务层，统一 LLM、生成器、发送、消息、数据库、记忆、HTML 渲染和 Embedding 等能力。 - 新增统一
platform_io消息平台抽象，入站消息、出站消息、去重、回执更新、插件驱动和旧适配器兼容走同一套链路。
插件 SDK / Runtime
- 插件运行时新增能力注册、组件注册、事件分发、Hook 分发、API 注册、Supervisor、Runner、RPC Server/Client 等基础设施。
- 插件 Action、Command、Tool、API 和插件平台驱动支持组件元数据
timeout_ms，也可由能力 API 设置超时时间覆盖。 - 插件 manifest 校验更严格，支持插件类型、图标、核心工具能力、模型 provider、配置入口、README 和市场信息展示。
WebUI API / 调试
- WebUI 后端拆分为 app、依赖、中间件、routers、schemas、services、utils 等结构，并统一 API 响应模型与错误格式。
- 新增或增强聊天、配置、插件、表情包、表达方式、黑话、记忆、知识库、统计、系统、本地缓存、推理过程、人设生成器等 API。
Prompt / 模型调用 / 测试
- Prompt 模板继续按中文、英文、日文同步维护，新增或拆分表情包选择、中期记忆摘要、timing gate、replyer 等模板。
- LLM 服务层支持任务模型选择、单次指定模型、模型缓存、视觉能力判断、工具调用兼容和 Host LLM Bridge。
- 补充动态发言频率、本地缓存写入、插件更新、A_Memorix 导入、人物画像纠错、上下文工具、Planner 快照、prompt fallback、图片处理等回归测试。
- 开发容器、Docker、依赖锁定、Crowdin、多语言资源、CodeRabbit、PR 模板和调试脚本等工程设施同步更新。
实验性功能
- 新增行为表现学习，麦麦会从场景、行为和结果中沉淀经验，并根据反馈强化更合适的行为模式。
- 新增 Focus 模式和跨聊天流信息交流能力，麦麦在特定场景下可以更主动地关注重点对话或关联信息。
1.0.0-rc.4
1.0.0-rc.4
插件
- 修改插件分类，并且放宽分类类别校验
- 修改默认rpc超时时间为60
- 允许能力api设置超时时间覆盖
- 修复部分hook未采用超时时间参数问题
WebUI / 主题、布局与基础交互
- 修复初始引导无法滚动的问题
启动器一键包下载地址：https://github.com/Mai-with-u/MaiBotOneKey/releases
1.0.0-rc.3
1.0.0-rc.3
功能
性能与稳定性
- 大幅优化启动流程，延后非关键服务初始化并减少阻塞步骤，提升启动速度。
WebUI / 主题、布局与基础交互
- 调整未来复古主题强调色，优化主题视觉一致性。
- 首页快捷入口卡片支持自定义显示项目，可添加或移除常用入口，并支持直达模型管理标签页、设置标签页、插件配置页和插件配置标签页。
- 修复首页统计概览切换日期时间无效的问题
- 模型厂商配置页支持自定义客户端类型
- 优化移动端适配，修复一些页面的显示和展示问题
- 优化日志查看器的展示效果，更加紧凑，可阅读，非常棒！支持调整列宽，便于在不同屏幕尺寸下查看较长日志内容。
- 日志查看器与推理过程整合到同一个工作区，可在“终端 / 推理过程”标签间切换；
- 插件配置编辑页在离开前会提示未保存更改。
- 修复部分插件readme渲染问题
- 修复快速审核自动加载计数异常问题，审核列表继续加载时计数展示更准确。
- 模型任务配置的默认
max_tokens提升到4096。 - 修复外观设置中切换到原版 Dashboard 后刷新页面又回到未来复古的问题。
- 修复一些显示问题。
- 修复聊天室引用消息错误问题和无法选择用户新建聊天的问题
记忆系统
- 完善人物事实写回证据与人物绑定
Maisaka
- 优化回复频率逻辑，减少不必要的频率计算与状态处理开销。
- 修复空白文本片段可能进入 OpenAI 请求或上下文消息的问题，纯空白片段会被跳过，避免部分供应商格式出错。
- MaiSaka 重启时会重新加载上下文，加载量为上下文长度一半
- 优化部分模块的prompt,移除无用prompt模板
- 过滤timing gate非可用工具
- 优化回复分割器
- LLM 请求失败时的快照提示精简
插件
- 插件现在支持设置“插件类型”和“插件图标”（详情见文档）
- 丰富内置插件/pm的功能
统计
- 统计信息现在记录缓存率统计
其他
- 新增统计遥测内容，修改用户协议和隐私协议
1.0.0-rc.2
1.0.0-rc.2
用户感知功能侧
WebUI / 主题、布局与基础交互
- WebUI 主题系统对齐一键包视觉风格，统一按钮、卡片、弹窗、输入框、下拉框、徽章、进度条、侧边栏与导航项的默认样式；外观设置页同步重整，主题预览、颜色配置与持久化逻辑更稳定。
- 优化移动端滚动与部分页面的紧凑布局，修复部分卡片、弹窗、表单控件在窄屏下滚动或溢出异常的问题。
- 新增通用数字草稿输入控件，配置页中的数字字段在输入
0.、空值、临时小数等中间状态时不会被立即格式化覆盖，适合连续编辑阈值、频率、权重等数值。 - 麦麦观察页布局更精简，减少重复入口和过多说明；Maisaka 运行状态面板新增回复频率展示，便于直接观察当前聊天节奏配置是否生效。
WebUI / 动态发言频率配置
- 动态发言频率规则新增可视化时间轴编辑：每个
platform + 聊天流 ID + 聊天类型组合会形成一个聊天区域，区域内可以叠加多条时间段轨道。 - 时间段轨道支持拖动左右边界修改起止时间，并支持上下拖动调整同组内时间段规则顺序；兜底轨道固定在最下面，
*强制全天轨道和兜底轨道不参与上下排序。 - 新增规则时不再直接创建全局空规则，而是先弹窗要求填写平台、聊天流 ID 和聊天类型；确认后创建该聊天区域的默认时间段轨道，降低误配成全局规则的风险。
- 同一
platform + 聊天流 ID + 聊天类型组内只允许一个兜底规则和一个*强制全天规则；重复创建或切换时会自动规范为普通时间段，避免多个最高优先级规则互相覆盖。 - 时间字段新增专用编辑控件：留空表示兜底，
HH:MM-HH:MM表示指定时间段，*表示强制全天覆盖；跨夜时间段会在时间轴上拆分展示。 - 修正动态发言频率匹配语义：平台或聊天流 ID 单独填写时表示对应维度的默认值；平台与聊天流 ID 都填写时为精确规则；
*为通配覆盖；时间优先级为*高于命中时间段，高于留空兜底。
Maisaka / 回复、上下文与调试
- Replyer 支持格式化输出片段，模型可以把回复拆成更清晰的片段结构，运行时上下文工具也能展开这些片段，方便后续工具和调试页面读取。
- 格式化输出场景下隐藏媒体发送相关内置工具，减少模型在只需要结构化文本片段时误调用图片、表情等媒体发送工具。
- 表情包选择改为使用独立 Prompt 模板，并同步中文、英文、日文模板，便于后续按模板维护选择逻辑。
- 修复 Planner 调试快照保存问题，视觉模式下的聊天循环调试快照能够正确落盘，便于排查 Planner 行为。
- 修复中期记忆摘要 JSON 解析不稳的问题，摘要 prompt 明确输出约束，解析链路对模型返回的非标准 JSON 更稳健。
WebUI / 插件市场与插件管理
- 插件更新支持无独立
.git的本地插件目录：更新时会备份旧目录、重新克隆目标插件，并在失败时清理临时目录和恢复旧目录，减少本地插件被更新流程破坏的风险。 - 插件评价支持“仅评论不评分”，用户可以只留下文字反馈；插件统计代理和前端展示同步兼容无评分评论。
WebUI / 表情包与资源管理
- 修复表情包无法注册的问题，表情包维护流程会更可靠地处理重复文件、注册状态和前端提示。
- 表情缓存写入改为串行化，减少并发写入导致缓存文件损坏或状态不一致的概率。
WebUI / 本地缓存与系统统计
- 本地缓存统计接口性能优化，系统页读取数据库、图片缓存、日志等本地缓存占用时更快，避免统计过程阻塞页面。
- 本地存储写入可靠性提升，写入过程使用更安全的临时文件与替换流程，并补充异常写入测试，降低配置或状态文件半写入的风险。
A_Memorix / 记忆与知识导入
- 人物画像证据新增纠错闭环：WebUI 可以查看画像证据并提交纠错，后端会把纠错信息写入 A_Memorix 运行时，便于后续画像更新和检索修正。
- Web Import 并发导入流程优化，支持配置并发能力，导入任务在批量网页、长文档场景下吞吐更高，并减少无效等待。
- A_Memorix 元数据表新增常用索引，提升人物画像、段落、关系、导入状态等查询性能。
- 完善 paragraph ngram 与向量写入容错，避免 ngram 回填或向量写入异常阻塞检索链路。
- 补充 A_Memorix 配置文档和快速开始说明，新增 Web Import 并发配置项和相关 schema。
Full Changelog: 1.0.0-rc.1...1.0.0-rc.2
启动器一键包下载地址：https://github.com/Mai-with-u/MaiBotOneKey/releases
1.0.0-rc.1
1.0.0-rc.1
用户感知功能侧
WebUI / 资源与插件市场
- 插件市场推荐排序新增“惊喜随意”展示区，会展示较新的随机插件
- 优化插件市场工具栏与加载提示布局，搜索、分类、排序和兼容性筛选。
- 表情包资源卡片新增描述展示，并把图片格式和使用次数叠加到缩略图上。
- 修复长期记忆为空时“前往长期记忆控制台”按钮跳转错误的问题。
WebUI / 表达学习与黑话
- 表达方式 AI 审核记录支持按聊天流筛选，并优化审核状态展示，区分“AI 预检通过”“人工通过”和普通通过状态。
- 优化表达方式审核记录表格与移动端卡片布局，修复表格无法滚动、快捷审核卡片内容溢出等问题。
- 修复黑话管理检索结果异常：搜索范围收敛到黑话内容本身，聊天流筛选改为精确匹配真实
session_id，并优化分页统计与聊天流名称解析。
WebUI / 推理过程与统计
- 推理过程列表、详情页和 Prompt 预览新增请求模型与推理耗时展示，并支持按模型名和耗时搜索。
- Prompt HTML 预览新增“上一份 / 下一份”导航，连续排查推理过程时不需要反复回到列表。
Maisaka / 聊天与多模态
- 回复频率支持设置为 0；该状态下会静默接收消息并维护历史，不再进入 Timing Gate / Planner 生成回复。
- 新增独立
timing_gate模型任务配置；未配置时继续回退到 planner 模型。 - 中期记忆摘要新增独立
mid_memory模型任务配置，并支持在视觉模型下带图生成摘要。 - 多模态请求新增最大图片数量限制，默认只保留最新 128 张图片，超出部分会在 Prompt 中替换为
[图片]，降低长对话图片上下文压力。
图片缓存
- 新增图片缓存自动清理任务，支持按配置周期清理长期未使用的图片文件、孤立缓存文件和已无文件的旧识别记录。
- 图片文件被清理后会先保留识别结果；相同图片再次出现时可重新保存文件并恢复数据库记录状态。
开发侧 / 修复 / SDK 与 API 改动
Maisaka / Hook 与模型调用
- 新增
maisaka.replyer.before_model_requestHook，插件可在 replyer 构建完模型请求消息后改写实际发送的messages，并获取任务名、请求类型、候选模型、重试次数和 reply 工具参数等上下文。 - LLM 消息工厂支持异步返回，并可接收
model_info后再构建消息，便于按当前模型能力决定是否携带视觉内容。 - Prompt 预览保存模型名与耗时元数据，WebUI 推理过程接口会从 txt / html 预览中解析并返回这些字段。
插件 SDK / Runtime
- 插件 Action、Command、Tool、API 和插件平台驱动支持通过组件元数据声明
timeout_ms，未声明时统一使用默认 RPC 超时。
A_memorix / 知识导入
- 删除知识来源后会同步清理 Web 导入清单，避免已删除来源仍被 manifest 命中而跳过重新导入。
- 导入清单命中时会校验对应来源是否仍有 live 段落；没有实际段落时会清理失效清单并继续导入。
- 导入流程记录实际写入的来源列表，便于后续按来源精确失效。
开发容器 / 工程
- 新增
.devcontainer/Dockerfile，基于 Python 3.13 的 Microsoft devcontainers 镜像，预装 uv 并修复 Yarn APT 仓库 GPG 密钥过期问题。 - 重构
.devcontainer/devcontainer.json：改为从 Dockerfile 构建，引入 docker-outside-of-docker 支持，新增 WebUI 8001 端口转发，预配置开发环境变量（语言、时区、协议确认等），postCreateCommand改用uv sync安装依赖，postStartCommand自动配置 git safe.directory 和 docker-config/data 目录权限。 - VS Code 开发容器预装 Copilot、DeepSeek V4、OAI Compatible 等智能体相关插件，并配置 ruff 作为 Python 默认格式化和自动 import 整理工具。
- 重整
.gitignore：按模块分类组织条目，新增docker-config/忽略规则，统一.venv为目录匹配语义，消除重复条目。 - 新增
.devcontainer/setup-dood-override.sh脚本：自动检测宿主机项目路径并生成docker-compose.devcontainer.yml，配合remoteEnv.COMPOSE_FILE仅于 devcontainer 内加载，修复 Docker-outside-of-Docker 场景下 bind mount 路径解析错误导致重启后数据丢失的问题。方案不修改项目docker-compose.yml，容器外docker compose不受任何影响。