a1540d7e1703bef48566906ec7a3bebc904deec7
在 A_Memorix 中强制更严格的检索语义,并改进错误传播与删除结果报告。 强制/校验受支持的搜索模式(search/time/hybrid/episode/aggregate);移除 semantic 模式,并对不支持的模式返回明确错误。将 kernel 和 plugin 构造函数中的默认值从 hybrid 改为 search。(plugins/A_memorix/core/runtime/sdk_memory_kernel.py, plugins/A_memorix/plugin.py) 对 time/hybrid 模式要求必须提供 time_start/time_end,并在文档、快速开始和 README 中体现该语义。(plugins/A_memorix/QUICK_START.md, plugins/A_memorix/README.md) 改进删除预览/执行语义:跟踪“请求的来源”与“匹配的来源”,基于匹配/删除项计算成功状态,并返回详细计数(requested_source_count、matched_source_count、deleted_paragraph_count、error)。修复来源删除逻辑,使其基于匹配到的来源执行删除。(plugins/A_memorix/core/runtime/sdk_memory_kernel.py) 在搜索执行中移除遗留的 semantic 映射,并规范化 query_type 处理。(plugins/A_memorix/core/utils/search_execution_service.py) 向调用方传播后端搜索错误:为 MemorySearchResult 增加 success/error 字段,兼容多种运行时响应封装,并在异常时返回失败结果。更新调用方以处理并报告搜索失败。(src/services/memory_service.py, src/plugin_runtime/capabilities/data.py, src/chat/brain_chat/PFC/pfc_KnowledgeFetcher.py, src/memory_system/retrieval_tools/query_long_term_memory.py)
🎉 介绍
🍔 MaiCore 是一个基于大语言模型的可交互智能体
MaiBot 不仅仅是一个机器人,她致力于成为一个活跃在 QQ 群聊中的“生命体”。她不追求完美,但追求真实。
- 💭 拟人构建:使用自然语言风格构建 Prompt,回复贴近人类习惯。
- 🎭 行为规划:懂得在合适的时间说话,使用合适的动作。
- 🧠 表达学习:模仿群友的说话风格,学习黑话,不断进化。
- 🔌 插件系统:提供强大的 API 和事件系统,无限扩展可能。
- 💝 情感表达:拥有独立的情绪系统和表情包互动能力。
🚀 快速导航
🌟 演示视频 | 📦 快速入门 | 📃 核心文档 | 💬 加入社区
🔥 更新和安装
最新版本: v0.12.2 (📄 更新日志)
- 下载: 前往 Release 页面下载最新版本
- 启动器: Mailauncher (仅支持 MacOS, 早期开发中)
| 分支 | 说明 |
|---|---|
main |
✅ 稳定发布版本 (推荐) |
dev |
🚧 开发测试版本 (不稳定) |
classical |
🛑 经典版本 (停止维护) |
📚 部署教程
👉 🚀 最新版本部署教程
(注意:MaiCore 新版本部署方式与旧版本不兼容)
Warning
- ⚠️ 项目处于活跃开发阶段,API 可能随时调整。
- ⚠️ QQ 机器人存在风控风险,请谨慎使用。
- ⚠️ AI 模型运行可能消耗较多 Token。
💬 讨论与社区
我们欢迎所有对 MaiBot 感兴趣的朋友加入!
| 类别 | 群组 | 说明 |
|---|---|---|
| 技术交流 | 麦麦脑电图 | 技术交流/答疑 |
| 技术交流 | 麦麦大脑磁共振 | 技术交流/答疑 |
| 技术交流 | 麦麦要当VTB | 技术交流/答疑 |
| 闲聊吹水 | 麦麦之闲聊群 | 仅限闲聊,不答疑 |
| 插件开发 | 插件开发群 | 进阶开发与测试 |
📚 文档
Note
部分内容可能更新不够及时,请注意版本对应。
- 📚 核心 Wiki 文档: 最全面的文档中心,了解麦麦的一切。
🧩 衍生项目
💡 设计理念 (原始时代的火花)
千石可乐说:
- 这个项目最初只是为了给牛牛 bot 添加一点额外的功能,但是功能越写越多,最后决定重写。其目的是为了创造一个活跃在 QQ 群聊的"生命体"。目的并不是为了写一个功能齐全的机器人,而是一个尽可能让人感知到真实的类人存在。
- 程序的功能设计理念基于一个核心的原则:"最像而不是好"。
- 如果人类真的需要一个 AI 来陪伴自己,并不是所有人都需要一个完美的,能解决所有问题的"helpful assistant",而是一个会犯错的,拥有自己感知和想法的"生命形式"。
- 代码会保持开源和开放,但个人希望 MaiMbot 的运行时数据保持封闭,尽量避免以显式命令来对其进行控制和调试。我认为一个你无法完全掌控的个体才更能让你感觉到它的自主性,而视其成为一个对话机器。
- SengokuCola
纯编程外行,面向 cursor 编程,很多代码写得不好多多包涵已得到大脑升级。 Code is open, but the soul is yours.
🙋 贡献和致谢
欢迎参与贡献!请先阅读 贡献指南。
🌟 贡献者
❤️ 特别致谢
📊 仓库状态
Star 趋势
📌 注意事项 & License
Important
使用前请阅读 用户协议 (EULA) 和 隐私协议。AI 生成内容请仔细甄别。
License: GPL-3.0
Description
Languages
Python
68.2%
TypeScript
30.9%
Shell
0.5%
CSS
0.2%
JavaScript
0.2%