{"id":26395284,"url":"https://github.com/SengokuCola/MaiMBot","last_synced_at":"2025-03-17T11:05:08.143Z","repository":{"id":279542684,"uuid":"938859604","full_name":"SengokuCola/MaiMBot","owner":"SengokuCola","description":"麦麦bot，一款专注于 群组聊天 的赛博网友（非常专注）QQ BOT","archived":false,"fork":false,"pushed_at":"2025-03-12T13:43:57.000Z","size":1632,"stargazers_count":816,"open_issues_count":37,"forks_count":131,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-03-12T14:35:25.015Z","etag":null,"topics":["chat","deepseek","llm","napcat","nonebot","onebot","python","qq","qq-bot","qqbot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SengokuCola.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-25T16:05:07.000Z","updated_at":"2025-03-12T14:18:24.000Z","dependencies_parsed_at":"2025-02-26T05:30:50.220Z","dependency_job_id":"d4c166a6-d9be-46dd-9769-febe253b82eb","html_url":"https://github.com/SengokuCola/MaiMBot","commit_stats":null,"previous_names":["sengokucola/maimbot"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SengokuCola%2FMaiMBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SengokuCola%2FMaiMBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SengokuCola%2FMaiMBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SengokuCola%2FMaiMBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SengokuCola","download_url":"https://codeload.github.com/SengokuCola/MaiMBot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244022635,"owners_count":20385134,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chat","deepseek","llm","napcat","nonebot","onebot","python","qq","qq-bot","qqbot"],"created_at":"2025-03-17T11:02:58.057Z","updated_at":"2025-03-17T11:05:08.137Z","avatar_url":"https://github.com/SengokuCola.png","language":"Python","readme":"# 关于项目分支调整与贡献指南的重要通知\n\u003cdetails\u003e\n  \u003csummary\u003e\n      - 📂 致所有为麦麦提交过贡献，以及想要为麦麦提交贡献的朋友们！\u003c/summary\u003e\n\n---\n\n**📢 关于项目分支调整与贡献指南的重要通知**  \n**致所有关注MaiMBot的开发者与贡献者：**  \n\n首先，我们由衷感谢大家近期的热情参与！感谢大家对MaiMBot的喜欢，项目突然受到广泛关注让我们倍感惊喜，也深深感受到开源社区的温暖力量。为了保障项目长期健康发展，我们不得不对开发流程做出重要调整，恳请理解与支持。\n\n---\n\n### **📌 本次调整的核心原因**\n\n1. **维护团队精力有限**  \n   核心成员（包括我本人）均为在校学生/在职开发者，近期涌入的大量PR和意见已远超我们的处理能力。为确保本职工作与项目质量，我们必须优化协作流程。\n\n2. **重构核心架构的紧迫性**  \n   当前我们正与核心团队全力重构项目底层逻辑，这是为未来扩展性、性能提升打下的必要基础，需要高度专注。\n\n3. **保障现有用户的稳定性**  \n   我们深知许多用户已依赖当前版本，因此必须划分清晰的维护边界，确保生产环境可用性。\n\n---\n\n### **🌿 全新分支策略与贡献指南**\n\n为平衡上述目标，即日起启用以下分支结构：  \n\n| 分支       | 定位                         | 接受PR类型                                    | 提交对象         |\n| ---------- | ---------------------------- | --------------------------------------------- | ---------------- |\n| `main`     | **稳定版**（供下载使用）     | 仅接受来自`main-fix`的合并                    | 维护团队直接管理 |\n| `main-fix` | 生产环境紧急修复             | 明确的功能缺陷修复（需附带复现步骤/测试用例） | 所有开发者       |\n| `refactor` | 重构版（**不兼容当前main**） | 仅重构与相关Bug修复                           | 重构小组维护     |\n\n---\n\n### **⚠️ 对现有PR的处理说明**\n\n由于分支结构调整，**GitHub已自动关闭所有未合并的PR**，这并非否定您的贡献价值！如果您认为自己的PR符合以下条件：  \n\n- 属于`main-fix`明确的**功能性缺陷修复**（非功能增强） ，包括非预期行为和严重报错，需要发布issue讨论确定。\n- 属于`refactor`分支的**重构适配性修复**  \n\n**欢迎您重新提交到对应分支**，并在PR描述中标注`[Re-submit from closed PR]`，我们将优先审查。其他类型PR暂缓受理，但您的创意我们已记录在案，未来重构完成后将重新评估。\n\n---\n\n### **🙏 致谢与协作倡议**\n\n- 感谢每一位提交Issue、PR、参与讨论的开发者！您的每一行代码都是maim吃的  \n- 特别致敬在交流群中积极答疑的社区成员，你们自发维护的氛围令人感动❤️  ，maim哭了\n- **重构期间的非代码贡献同样珍贵**：文档改进、测试用例补充、用户反馈整理等，欢迎通过Issue认领任务！  \n\n---\n\n### **📬 高效协作小贴士**\n\n1. **提交前请先讨论**：创建Issue描述问题，确认是否符合`main-fix`修复范围    \n2. **对重构提出您的想法**：如果您对重构版有自己的想法，欢迎提交讨论issue亟需测试伙伴，欢迎邮件联系`team@xxx.org`报名  \n3. **部分main-fix的功能在issue讨论后，经过严格讨论，一致决定可以添加功能改动或修复的，可以提交pr**\n\n---\n\n**谢谢大家谢谢大家谢谢大家谢谢大家谢谢大家谢谢大家！**  \n虽然此刻不得不放缓脚步，但这一切都是为了跳得更高。期待在重构完成后与各位共建更强大的版本！  \n\n千石可乐 敬上  \n2025年3月14日  \n\n\u003c/details\u003e\n\n\n\n\n\n# 麦麦！MaiMBot (编辑中)\n\n\u003cdiv align=\"center\"\u003e\n\n![Python Version](https://img.shields.io/badge/Python-3.9+-blue)\n![License](https://img.shields.io/github/license/SengokuCola/MaiMBot)\n![Status](https://img.shields.io/badge/状态-开发中-yellow)\n\n\u003c/div\u003e\n\n## 📝 项目简介\n\n**🍔麦麦是一个基于大语言模型的智能QQ群聊机器人**\n\n- 基于 nonebot2 框架开发\n- LLM 提供对话能力\n- MongoDB 提供数据持久化支持\n- NapCat 作为QQ协议端支持\n\n**最新版本: v0.5.13**\n\u003e [!WARNING]\n\u003e 注意，3月12日的v0.5.13, 该版本更新较大，建议单独开文件夹部署，然后转移/data文件 和数据库，数据库可能需要删除messages下的内容（不需要删除记忆）\n\n\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://www.bilibili.com/video/BV1amAneGE3P\" target=\"_blank\"\u003e\n    \u003cimg src=\"docs/video.png\" width=\"300\" alt=\"麦麦演示视频\"\u003e\n    \u003cbr\u003e\n    👆 点击观看麦麦演示视频 👆\n\n\u003c/a\u003e\n\u003c/div\u003e\n\n\u003e [!WARNING]\n\u003e - 项目处于活跃开发阶段，代码可能随时更改\n\u003e - 文档未完善，有问题可以提交 Issue 或者 Discussion\n\u003e - QQ机器人存在被限制风险，请自行了解，谨慎使用\n\u003e - 由于持续迭代，可能存在一些已知或未知的bug\n\u003e - 由于开发中，可能消耗较多token\n\n## 💬交流群\n- [一群](https://qm.qq.com/q/VQ3XZrWgMs) 766798517 ，建议加下面的（开发和建议相关讨论）不一定有空回复，会优先写文档和代码\n- [二群](https://qm.qq.com/q/RzmCiRtHEW) 571780722 （开发和建议相关讨论）不一定有空回复，会优先写文档和代码\n- [三群](https://qm.qq.com/q/wlH5eT8OmQ) 1035228475（开发和建议相关讨论）不一定有空回复，会优先写文档和代码\n\n\n\n**📚 有热心网友创作的wiki:** https://maimbot.pages.dev/\n\n\n**😊 其他平台版本** \n\n- (由 [CabLate](https://github.com/cablate) 贡献) [Telegram 与其他平台(未来可能会有)的版本](https://github.com/cablate/MaiMBot/tree/telegram) - [集中讨论串](https://github.com/SengokuCola/MaiMBot/discussions/149)\n\n\u003cdiv align=\"left\"\u003e\n\u003ch2\u003e📚 文档        ⬇️ 快速开始使用麦麦 ⬇️\u003c/h2\u003e\n\u003c/div\u003e\n\n### 部署方式\n\n-  📦 **Windows 一键傻瓜式部署**：请运行项目根目录中的 `run.bat`，部署完成后请参照后续配置指南进行配置\n\n\n- [📦 Windows 手动部署指南 ](docs/manual_deploy_windows.md)\n\n- [📦 Linux 手动部署指南 ](docs/manual_deploy_linux.md)\n\n如果你不知道Docker是什么，建议寻找相关教程或使用手动部署 **（现在不建议使用docker，更新慢，可能不适配）**\n\n- [🐳 Docker部署指南](docs/docker_deploy.md)\n\n\n\n### 配置说明\n\n- [🎀 新手配置指南](docs/installation_cute.md) - 通俗易懂的配置教程，适合初次使用的猫娘\n- [⚙️ 标准配置指南](docs/installation_standard.md) - 简明专业的配置说明，适合有经验的用户\n\n\u003cdiv align=\"left\"\u003e\n\u003ch3\u003e了解麦麦 \u003c/h3\u003e\n\u003c/div\u003e\n\n- [项目架构说明](docs/doc1.md) - 项目结构和核心功能实现细节\n\n## 🎯 功能介绍\n\n### 💬 聊天功能\n\n- 支持关键词检索主动发言：对消息的话题topic进行识别，如果检测到麦麦存储过的话题就会主动进行发言\n- 支持bot名字呼唤发言：检测到\"麦麦\"会主动发言，可配置\n- 支持多模型，多厂商自定义配置\n- 动态的prompt构建器，更拟人\n- 支持图片，转发消息，回复消息的识别\n- 错别字和多条回复功能：麦麦可以随机生成错别字，会多条发送回复以及对消息进行reply\n\n### 😊 表情包功能\n\n- 支持根据发言内容发送对应情绪的表情包\n- 会自动偷群友的表情包\n\n### 📅 日程功能\n\n- 麦麦会自动生成一天的日程，实现更拟人的回复\n\n### 🧠 记忆功能\n\n- 对聊天记录进行概括存储，在需要时调用，待完善\n\n### 📚 知识库功能\n\n- 基于embedding模型的知识库，手动放入txt会自动识别，写完了，暂时禁用\n\n### 👥 关系功能\n\n- 针对每个用户创建\"关系\"，可以对不同用户进行个性化回复，目前只有极其简单的好感度（WIP）\n- 针对每个群创建\"群印象\"，可以对不同群进行个性化回复（WIP）\n\n## 开发计划TODO：LIST\n\n规划主线\n0.6.0：记忆系统更新\n0.7.0: 麦麦RunTime\n\n- 人格功能：WIP\n- 群氛围功能：WIP\n- 图片发送，转发功能：WIP\n- 幽默和meme功能：WIP的WIP\n- 让麦麦玩mc：WIP的WIP的WIP\n- 兼容gif的解析和保存\n- 小程序转发链接解析\n- 对思考链长度限制\n- 修复已知bug\n- ~~完善文档~~\n- 修复转发\n- ~~config自动生成和检测~~\n- ~~log别用print~~\n- ~~给发送消息写专门的类~~\n- 改进表情包发送逻辑\n- 自动生成的回复逻辑，例如自生成的回复方向，回复风格\n- 采用截断生成加快麦麦的反应速度\n- 改进发送消息的触发\n\n## 设计理念\n\n- **千石可乐说：**\n- 这个项目最初只是为了给牛牛bot添加一点额外的功能，但是功能越写越多，最后决定重写。其目的是为了创造一个活跃在QQ群聊的\"生命体\"。可以目的并不是为了写一个功能齐全的机器人，而是一个尽可能让人感知到真实的类人存在.\n- 程序的功能设计理念基于一个核心的原则：\"最像而不是好\"\n- 主打一个陪伴\n- 如果人类真的需要一个AI来陪伴自己，并不是所有人都需要一个完美的，能解决所有问题的helpful assistant，而是一个会犯错的，拥有自己感知和想法的\"生命形式\"。\n- 代码会保持开源和开放，但个人希望MaiMbot的运行时数据保持封闭，尽量避免以显式命令来对其进行控制和调试.我认为一个你无法完全掌控的个体才更能让你感觉到它的自主性，而视其成为一个对话机器.\n\n## 📌 注意事项\n\nSengokuCola~~纯编程外行，面向cursor编程，很多代码写得不好多多包涵~~已得到大脑升级\n\u003e [!WARNING]\n\u003e 本应用生成内容来自人工智能模型，由 AI 生成，请仔细甄别，请勿用于违反法律的用途，AI生成内容不代表本人观点和立场。\n\n## 致谢\n\n[nonebot2](https://github.com/nonebot/nonebot2): 跨平台 Python 异步聊天机器人框架  \n[NapCat](https://github.com/NapNeko/NapCatQQ): 现代化的基于 NTQQ 的 Bot 协议端实现  \n\n### 贡献者\n\n感谢各位大佬！\n\n\u003ca href=\"https://github.com/SengokuCola/MaiMBot/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=SengokuCola/MaiMBot\" /\u003e\n\u003c/a\u003e\n\n## Stargazers over time\n\n[![Stargazers over time](https://starchart.cc/SengokuCola/MaiMBot.svg?variant=adaptive)](https://starchart.cc/SengokuCola/MaiMBot)\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSengokuCola%2FMaiMBot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSengokuCola%2FMaiMBot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSengokuCola%2FMaiMBot/lists"}