[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-idootop--mi-gpt":3,"tool-idootop--mi-gpt":64},[4,17,27,35,43,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":44,"name":45,"github_repo":46,"description_zh":47,"stars":48,"difficulty_score":23,"last_commit_at":49,"category_tags":50,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,51,52,53,15,54,26,13,55],"数据工具","视频","插件","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":80,"owner_email":79,"owner_twitter":79,"owner_website":81,"owner_url":82,"languages":83,"stars":96,"forks":97,"last_commit_at":98,"license":99,"difficulty_score":23,"env_os":100,"env_gpu":101,"env_ram":101,"env_deps":102,"category_tags":108,"github_topics":79,"view_count":109,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":110,"updated_at":111,"faqs":112,"releases":148},1392,"idootop\u002Fmi-gpt","mi-gpt","🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。","MiGPT 是一款能将小爱音箱变身为你专属智能管家的开源工具。它通过连接 ChatGPT、豆包等大语言模型，赋予传统智能家居设备强大的理解与对话能力，解决了普通智能音箱回答生硬、缺乏情感互动及无法深度定制的问题。\n\n该项目非常适合希望提升家居体验的普通用户，同时也为前端开发者提供了基于 Node.js 和 Docker 的灵活部署方案。借助 MiGPT，小爱音箱不仅能上知天文下知地理地回答复杂问题，还能进行角色扮演，成为你的贴心伴侣或闺蜜。其核心技术亮点包括流式响应技术，让语音回复如真人般自然流畅；长短期记忆功能，使音箱能记住过往对话，越聊越默契；以及自定义 TTS 音色，让你可以解锁如“豆包”等更自然的语音风格。虽然部分高级自动化功能仍在演进中，但 MiGPT 已成功将冰冷的硬件转化为有温度、懂你心思的家庭成员，让智能家居真正服务于人的情感与生活需求。","# MiGPT：智能家居，从未如此贴心 ❤️\n\n[![npm version](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002Fmi-gpt.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmi-gpt) [![Docker Image Version](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fv\u002Fidootop\u002Fmi-gpt?color=%23086DCD&label=docker%20image)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fidootop\u002Fmi-gpt) [![Docker Pulls](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fpulls\u002Fidootop\u002Fmi-gpt)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fidootop\u002Fmi-gpt) \u003Ca href=\"https:\u002F\u002Fhellogithub.com\u002Frepository\u002Fe02e62fbb9c746cdb61c6559c186ac44\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fabroad.hellogithub.com\u002Fv1\u002Fwidgets\u002Frecommend.svg?rid=e02e62fbb9c746cdb61c6559c186ac44&claim_uid=LdwexZ8z7Ggu3lJ&theme=small\" alt=\"Featured｜HelloGitHub\" \u002F>\u003C\u002Fa>\n\n> 👉 查看完整演示视频：【[将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手～](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1N1421y7qn\u002F?share_source=copy_web&vd_source=5d4e78ff2a0dc6a661baa65f479199c1)】\n\n\u003Cvideo src='https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fassets\u002F35302658\u002Fdc336916-9087-418b-bc1b-04d5534dce8f'>\u003C\u002Fvideo>\n\n## 👋 项目简介\n\n> [!TIP]\n> 如果你是小爱音箱 Pro 用户，推荐使用 [Open-XiaoAI](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fopen-xiaoai) ✨ \n>\n> 即刻解锁**自定义唤醒词、连续对话、接入小智 AI** 等全新玩法\n\n> [!IMPORTANT]\n> 全新 [MiGPT-Next](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmigpt-next) 已发布，该项目已停止维护 ⚠️\n> \n> 新项目修复了一些已知问题，支持自定义消息回复，拥有更好的稳定性，建议尽早[迁移](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmigpt-next)\n\n在这个数字化的世界里，家已不仅仅是一个居住的地方，而是我们数字生活的延伸。\n\n`MiGPT` 通过将小爱音箱、米家智能设备，与 ChatGPT 的理解能力完美融合，让你的智能家居更懂你。\n\n`MiGPT` 不仅仅是关于设备自动化，而是关于：**打造一个懂你、有温度、与你共同进化的家**。\n\n未来，你的每个智能家居设备，从灯泡、插座，到扫地机器人、电视等，\n\n都可以作为一个个独立的智能体 (Agent)，更智能、更贴心的响应你的指令。\n\n这些独立的智能体，也可以彼此感知，彼此配合，构成一个更强大的协作网络。\n\n而小爱音箱就像是你的智能家居专属管家，全心全意为你服务，释放智能家居的真正潜力。\n\n## ✨ 功能亮点\n\n- **🎓 AI 问答**。想象一下，当小爱音箱接入大模型后，上知天文，下知地理，从“人工智障”秒变学霸。\n- **🎭 角色扮演**。一秒调教小爱，无论是成为你的完美伴侣，还是那个能听你倾诉心事的贴心闺蜜，都不在话下。\n- **💬 流式响应**。爱情来得太快就像龙卷风，而你的小爱音箱也是，对你的爱意秒回，爱你不会让你等太久。\n- **🧠 长短期记忆**。小爱音箱现在能记住你们之间的每一次对话，越聊越默契，就像是你身边的老朋友。\n- **🔊 自定义 TTS**。厌倦了小爱同学的语音？帮你解锁[「豆包」](https:\u002F\u002Fdoubao.com)同款音色，就像真人在回你的消息。\n- ~**🤖️ 智能家居 Agent**。心情不好？小爱立刻懂你，自动帮你播放喜欢的音乐，调节灯光，逗你开心。~\n\n## 🦄 Sponsors\n\n![302.AI](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fidootop_mi-gpt_readme_8e51ab6fd73f.jpg)\n\n> 302.AI 是一个按需付费的一站式 AI 应用平台，开放平台，开源生态。[官方网站](https:\u002F\u002F302.ai)｜[网站介绍](https:\u002F\u002Fhelp.302.ai)\n\n## ⚡️ 快速开始\n\n### 视频教程\n\n👉 [MiGPT 光速入门视频教程，手把手教你调教小爱音箱～](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1zb421H7cS)\n\n### 设备要求\n\n`MiGPT` 支持大部分的小爱音箱型号，推荐使用小爱音箱 Pro（完美运行）\n\n👉 [查看更多兼容的小爱音箱型号和配置参数](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fcompatibility.md)\n\n> 注意：本项目暂不支持小度音箱、天猫精灵、HomePod 等智能音箱设备，亦无相关适配计划。\n\n### 使用方式\n\n`MiGPT` 有两种启动方式: [Docker](#docker) 和 [Node.js](#nodejs)。\n\n启动成功后，你可以通过以下方式来召唤 AI 回答问题：\n\n- **小爱同学，请 xxx**。比如 `小爱同学，请问地球为什么是圆的？`\n- **小爱同学，你 xxx**。比如 `小爱同学，你喜欢我吗？`\n- **小爱同学，召唤 xxx**。比如 `小爱同学，召唤傻妞`\n\n### Docker\n\n[![Docker Image Version](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fv\u002Fidootop\u002Fmi-gpt?color=%23086DCD&label=docker%20image)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fidootop\u002Fmi-gpt)\n\n对于电脑小白或者不想自己配置代码运行环境（Node）的同学，可以使用 Docker 启动方式。\n\n请先按照 [⚙️ 参数设置](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fsettings.md) 相关说明，配置好你的 `.env` 和 `.migpt.js` 文件，然后使用以下命令启动 docker：\n\n```shell\ndocker run -d --env-file $(pwd)\u002F.env -v $(pwd)\u002F.migpt.js:\u002Fapp\u002F.migpt.js idootop\u002Fmi-gpt:latest\n```\n\n注意：在 Windows 终端下需要将配置文件路径 `$(pwd)` 替换为绝对路径。\n\n### Node.js\n\n[![npm version](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002Fmi-gpt.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmi-gpt)\n\n如果你是一名前端 (Node) 开发者，也可以通过 NPM 安装 `mi-gpt` 启动 `MiGPT`。\n\n```shell\nnpm install mi-gpt # 安装依赖\n```\n\n然后，创建并启动 `MiGPT` 实例。初始化参数的具体说明请到 [⚙️ 参数设置](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fsettings.md) 查看。\n\n```typescript\nimport { MiGPT } from \"mi-gpt\";\n\nasync function main() {\n  const client = MiGPT.create({\n    speaker: {\n      userId: \"987654321\", \u002F\u002F 注意：不是手机号或邮箱，请在「个人信息」-「小米 ID」查看\n      password: \"123456\", \u002F\u002F 账号密码\n      did: \"小爱音箱Pro\", \u002F\u002F 小爱音箱 ID 或在米家中设置的名称\n    },\n  });\n  await client.start();\n}\n\nmain();\n```\n\n注意：此模式下并不会主动读取 `.env` 和 `.migpt.js` 中的配置信息，你需要手动初始化 Node 环境变量，并将 `.migpt.js` 中的参数作为 `MiGPT.create` 的初始化参数传入。👉 [示例代码](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fexample\u002Findex.ts)\n\n## 📖 使用文档\n\n提示：大多数问题都可在 [💬 常见问题](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Ffaq.md) 中找到答案。\n\n- [🔥 官方视频教程](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1zb421H7cS)\n- [⚙️ 参数设置](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fsettings.md)\n- [💬 常见问题](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Ffaq.md)\n- [🔊 使用第三方 TTS](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Ftts.md)\n- [🛠️ 本地开发](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fdevelopment.md)\n- [💎 工作原理](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fhow-it-works.md)\n- [🦄 Sponsors](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fsponsors.md)\n- [✨ 更新日志](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fchangelog.md)\n- [🚀 Roadmap](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Froadmap.md)\n\n## 🔗 相关项目与教程\n\n| 项目链接                                                                                                                                                                                                                             | 简介                                                                                                                                                    | 来源                                                 |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |\n| **相关项目**                                                                                                                                                                                                                         |                                                                                                                                                         |                                                      |\n| [MiGPT GUI](https:\u002F\u002Fmigptgui.com\u002F)                                                                                                                                                                                                   | 通过图形化界面的方式创建并管理 MiGPT，支持运行多个账号                                                                                                  | [@lmk123](https:\u002F\u002Fgithub.com\u002Flmk123)                 |\n| [MiGPT 配置中心](https:\u002F\u002Fgithub.com\u002FLipapaSma\u002Fmi-gpt-vue)                                                                                                                                                                            | 基于 Vue 的 MiGPT 可视化配置界面，提供直观的服务管理和参数配置能力                                                                                      | [@LipapaSma](https:\u002F\u002Fgithub.com\u002FLipapaSma)           |\n| [@shinedlc\u002Fmi-gpt](https:\u002F\u002Fgithub.com\u002Fshinedlc\u002Fmi-gpt)                                                                                                                                                                               | 支持摄像头模块的 MiGPT 分支，让小爱同学可以看到和理解现实世界                                                                                           | [@shinedlc](https:\u002F\u002Fgithub.com\u002Fshinedlc)             |\n| **使用教程**                                                                                                                                                                                                                         |                                                                                                                                                         |                                                      |\n| [MiGPT 官方视频教程](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1zb421H7cS)                                                                                                                                                                    | 官方视频教程配套 PPT 文件 👉 [MiGPT 官方教程.pdf](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fassets\u002Fpdf\u002FMiGPT%E5%AE%98%E6%96%B9%E6%95%99%E7%A8%8B.pdf) | [@idootop](https:\u002F\u002Fgithub.com\u002Fidootop)               |\n| [MiGPT 接入豆包等大模型教程](https:\u002F\u002Fmigptgui.com\u002Fdocs\u002Fapply\u002F)                                                                                                                                                                       | 豆包、Moonshot（Kimi）等常见大模型的详细接入教程                                                                                                        | [@lmk123](https:\u002F\u002Fgithub.com\u002Flmk123)                 |\n| [通过 Docker 快速安装 MiGPT，手把手教你绕开异地登录风控](https:\u002F\u002Fwww.nodeseek.com\u002Fpost-264959-1)                                                                                                                                     | 适合小白的使用教程，全程几乎都是图形化页界面                                                                                                            | [@Jasonzhu1207](https:\u002F\u002Fgithub.com\u002FJasonzhu1207)     |\n| [小爱音箱 PRO 的 AI 模式使用说明](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fbbdb80e9bc38b7c40865e52cbd6517980a68615a\u002Fassets\u002Fpdf\u002F%E5%B0%8F%E7%88%B1%E9%9F%B3%E7%AE%B1PRO%20AI%E6%A8%A1%E5%BC%8F%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.pdf) | 这是一位老爸为家里的小朋友专门整理的贴心教程                                                                                                            | [@mxyblog](https:\u002F\u002Fgithub.com\u002Fmxyblog)               |\n| [使用 MiGPT 将你的小爱音箱接入 ChatGPT](https:\u002F\u002Fwww.iloli.love\u002Farchives\u002F1719073913220)                                                                                                                                               | 作者详细介绍了如何在 1Panel 上，通过 [OneAPI](https:\u002F\u002Fgithub.com\u002Fsongquanpeng\u002Fone-api) 来转换腾讯混元大模型，和讯飞星火大模型的 API 并成功接入 MiGPT    | [@miaowmint](https:\u002F\u002Fgithub.com\u002Fmiaowmint)           |\n| [Unraid 部署 MiGPT](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fadfdcc4ee51aef8d4f2d8996f18be716da19a0ad\u002Fassets\u002Fpdf\u002FUnraid%E9%83%A8%E7%BD%B2MiGPT.pdf)                                                                                    | 在 Unraid 上使用 Docker 部署 MiGPT 的详细教程                                                                                                           | [@ilovesouthpark](https:\u002F\u002Fgithub.com\u002Filovesouthpark) |\n\n## ❤️ 鸣谢\n\n特别感谢以下项目提供的实现参考：\n\n- https:\u002F\u002Fgithub.com\u002Fyihong0618\u002Fxiaogpt\n- https:\u002F\u002Fgithub.com\u002Fjialeicui\u002Fopen-lx01\n- https:\u002F\u002Fgithub.com\u002Finu1255\u002Fmi-service\n- https:\u002F\u002Fgithub.com\u002FYonsm\u002FMiService\n\n## 🚨 免责声明\n\n本项目仅供学习和研究目的，不得用于任何商业活动。用户在使用本项目时应遵守所在地区的法律法规，对于违法使用所导致的后果，本项目及作者不承担任何责任。\n本项目可能存在未知的缺陷和风险（包括但不限于设备损坏和账号封禁等），使用者应自行承担使用本项目所产生的所有风险及责任。\n作者不保证本项目的准确性、完整性、及时性、可靠性，也不承担任何因使用本项目而产生的任何损失或损害责任。\n使用本项目即表示您已阅读并同意本免责声明的全部内容。\n\n## License\n\n[MIT](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002FLICENSE) License © 2024-PRESENT Del Wang\n","# MiGPT：智能家居，从未如此贴心 ❤️\n\n[![npm 版本](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002Fmi-gpt.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmi-gpt) [![Docker 镜像版本](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fv\u002Fidootop\u002Fmi-gpt?color=%23086DCD&label=docker%20image)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fidootop\u002Fmi-gpt) [![Docker 拉取](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fpulls\u002Fidootop\u002Fmi-gpt)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fidootop\u002Fmi-gpt) \u003Ca href=\"https:\u002F\u002Fhellogithub.com\u002Frepository\u002Fe02e62fbb9c746cdb61c6559c186ac44\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fabroad.hellogithub.com\u002Fv1\u002Fwidgets\u002Frecommend.svg?rid=e02e62fbb9c746cdb61c6559c186ac44&claim_uid=LdwexZ8z7Ggu3lJ&theme=small\" alt=\"精选｜HelloGitHub\" \u002F>\u003C\u002Fa>\n\n> 👉 查看完整演示视频：【[将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手～](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1N1421y7qn\u002F?share_source=copy_web&vd_source=5d4e78ff2a0dc6a661baa65f479199c1)】\n\n\u003Cvideo src='https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fassets\u002F35302658\u002Fdc336916-9087-418b-bc1b-04d5534dce8f'>\u003C\u002Fvideo>\n\n## 👋 项目简介\n\n> [!TIP]\n> 如果你是小爱音箱 Pro 用户，推荐使用 [Open-XiaoAI](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fopen-xiaoai) ✨ \n>\n> 即刻解锁**自定义唤醒词、连续对话、接入小智 AI** 等全新玩法\n\n> [!IMPORTANT]\n> 全新 [MiGPT-Next](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmigpt-next) 已发布，该项目已停止维护 ⚠️\n> \n> 新项目修复了一些已知问题，支持自定义消息回复，拥有更好的稳定性，建议尽早[迁移](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmigpt-next)\n\n在这个数字化的世界里，家已不仅仅是一个居住的地方，而是我们数字生活的延伸。\n\n`MiGPT` 通过将小爱音箱、米家智能设备，与 ChatGPT 的理解能力完美融合，让你的智能家居更懂你。\n\n`MiGPT` 不仅仅是关于设备自动化，而是关于：**打造一个懂你、有温度、与你共同进化的家**。\n\n未来，你的每个智能家居设备，从灯泡、插座，到扫地机器人、电视等，\n\n都可以作为一个个独立的智能体 (Agent)，更智能、更贴心的响应你的指令。\n\n这些独立的智能体，也可以彼此感知，彼此配合，构成一个更强大的协作网络。\n\n而小爱音箱就像是你的智能家居专属管家，全心全意为你服务，释放智能家居的真正潜力。\n\n## ✨ 功能亮点\n\n- **🎓 AI 问答**。想象一下，当小爱音箱接入大模型后，上知天文，下知地理，从“人工智障”秒变学霸。\n- **🎭 角色扮演**。一秒调教小爱，无论是成为你的完美伴侣，还是那个能听你倾诉心事的贴心闺蜜，都不在话下。\n- **💬 流式响应**。爱情来得太快就像龙卷风，而你的小爱音箱也是，对你的爱意秒回，爱你不会让你等太久。\n- **🧠 长短期记忆**。小爱音箱现在能记住你们之间的每一次对话，越聊越默契，就像是你身边的老朋友。\n- **🔊 自定义 TTS**。厌倦了小爱同学的语音？帮你解锁[「豆包」](https:\u002F\u002Fdoubao.com)同款音色，就像真人在回你的消息。\n- ~**🤖️ 智能家居 Agent**。心情不好？小爱立刻懂你，自动帮你播放喜欢的音乐，调节灯光，逗你开心。~\n\n## 🦄 Sponsors\n\n![302.AI](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fidootop_mi-gpt_readme_8e51ab6fd73f.jpg)\n\n> 302.AI 是一个按需付费的一站式 AI 应用平台，开放平台，开源生态。[官方网站](https:\u002F\u002F302.ai)｜[网站介绍](https:\u002F\u002Fhelp.302.ai)\n\n## ⚡️ 快速开始\n\n### 视频教程\n\n👉 [MiGPT 光速入门视频教程，手把手教你调教小爱音箱～](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1zb421H7cS)\n\n### 设备要求\n\n`MiGPT` 支持大部分的小爱音箱型号，推荐使用小爱音箱 Pro（完美运行）\n\n👉 [查看更多兼容的小爱音箱型号和配置参数](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fcompatibility.md)\n\n> 注意：本项目暂不支持小度音箱、天猫精灵、HomePod 等智能音箱设备，亦无相关适配计划。\n\n### 使用方式\n\n`MiGPT` 有两种启动方式: [Docker](#docker) 和 [Node.js](#nodejs)。\n\n启动成功后，你可以通过以下方式来召唤 AI 回答问题：\n\n- **小爱同学，请 xxx**。比如 `小爱同学，请问地球为什么是圆的？`\n- **小爱同学，你 xxx**。比如 `小爱同学，你喜欢我吗？`\n- **小爱同学，召唤 xxx**。比如 `小爱同学，召唤傻妞`\n\n### Docker\n\n[![Docker Image Version](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fv\u002Fidootop\u002Fmi-gpt?color=%23086DCD&label=docker%20image)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fidootop\u002Fmi-gpt)\n\n对于电脑小白或者不想自己配置代码运行环境（Node）的同学，可以使用 Docker 启动方式。\n\n请先按照 [⚙️ 参数设置](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fsettings.md) 相关说明，配置好你的 `.env` 和 `.migpt.js` 文件，然后使用以下命令启动 docker：\n\n```shell\ndocker run -d --env-file $(pwd)\u002F.env -v $(pwd)\u002F.migpt.js:\u002Fapp\u002F.migpt.js idootop\u002Fmi-gpt:latest\n```\n\n注意：在 Windows 终端下需要将配置文件路径 `$(pwd)` 替换为绝对路径。\n\n### Node.js\n\n[![npm 版本](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002Fmi-gpt.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmi-gpt)\n\n如果你是一名前端 (Node) 开发者，也可以通过 NPM 安装 `mi-gpt` 启动 `MiGPT`。\n\n```shell\nnpm install mi-gpt # 安装依赖\n```\n\n然后，创建并启动 `MiGPT` 实例。初始化参数的具体说明请到 [⚙️ 参数设置](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fsettings.md) 查看。\n\n```typescript\nimport { MiGPT } from \"mi-gpt\";\n\nasync function main() {\n  const client = MiGPT.create({\n    speaker: {\n      userId: \"987654321\", \u002F\u002F 注意：不是手机号或邮箱，请在「个人信息」-「小米 ID」查看\n      password: \"123456\", \u002F\u002F 账号密码\n      did: \"小爱音箱Pro\", \u002F\u002F 小爱音箱 ID 或在米家中设置的名称\n    },\n  });\n  await client.start();\n}\n\nmain();\n```\n\n注意：此模式下并不会主动读取 `.env` 和 `.migpt.js` 中的配置信息，你需要手动初始化 Node 环境变量，并将 `.migpt.js` 中的参数作为 `MiGPT.create` 的初始化参数传入。👉 [示例代码](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fexample\u002Findex.ts)\n\n## 📖 使用文档\n\n提示：大多数问题都可在 [💬 常见问题](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Ffaq.md) 中找到答案。\n\n- [🔥 官方视频教程](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1zb421H7cS)\n- [⚙️ 参数设置](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fsettings.md)\n- [💬 常见问题](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Ffaq.md)\n- [🔊 使用第三方 TTS](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Ftts.md)\n- [🛠️ 本地开发](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fdevelopment.md)\n- [💎 工作原理](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fhow-it-works.md)\n- [🦄 Sponsors](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fsponsors.md)\n- [✨ 更新日志](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fchangelog.md)\n- [🚀 Roadmap](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Froadmap.md)\n\n## 🔗 相关项目与教程\n\n| 项目链接                                                                                                                                                                                                                             | 简介                                                                                                                                                    | 来源                                                 |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |\n| **相关项目**                                                                                                                                                                                                                         |                                                                                                                                                         |                                                      |\n| [MiGPT GUI](https:\u002F\u002Fmigptgui.com\u002F)                                                                                                                                                                                                   | 通过图形化界面的方式创建并管理 MiGPT，支持运行多个账号                                                                                                  | [@lmk123](https:\u002F\u002Fgithub.com\u002Flmk123)                 |\n| [MiGPT 配置中心](https:\u002F\u002Fgithub.com\u002FLipapaSma\u002Fmi-gpt-vue)                                                                                                                                                                            | 基于 Vue 的 MiGPT 可视化配置界面，提供直观的服务管理和参数配置能力                                                                                      | [@LipapaSma](https:\u002F\u002Fgithub.com\u002FLipapaSma)           |\n| [@shinedlc\u002Fmi-gpt](https:\u002F\u002Fgithub.com\u002Fshinedlc\u002Fmi-gpt)                                                                                                                                                                               | 支持摄像头模块的 MiGPT 分支，让小爱同学可以看到和理解现实世界                                                                                           | [@shinedlc](https:\u002F\u002Fgithub.com\u002Fshinedlc)             |\n| **使用教程**                                                                                                                                                                                                                         |                                                                                                                                                         |                                                      |\n| [MiGPT 官方视频教程](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1zb421H7cS)                                                                                                                                                                    | 官方视频教程配套 PPT 文件 👉 [MiGPT 官方教程.pdf](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fassets\u002Fpdf\u002FMiGPT%E5%AE%98%E6%96%B9%E6%95%99%E7%A8%8B.pdf) | [@idootop](https:\u002F\u002Fgithub.com\u002Fidootop)               |\n| [MiGPT 接入豆包等大模型教程](https:\u002F\u002Fmigptgui.com\u002Fdocs\u002Fapply\u002F)                                                                                                                                                                       | 豆包、Moonshot（Kimi）等常见大模型的详细接入教程                                                                                                        | [@lmk123](https:\u002F\u002Fgithub.com\u002Flmk123)                 |\n| [通过 Docker 快速安装 MiGPT，手把手教你绕开异地登录风控](https:\u002F\u002Fwww.nodeseek.com\u002Fpost-264959-1)                                                                                                                                     | 适合小白的使用教程，全程几乎都是图形化页界面                                                                                                            | [@Jasonzhu1207](https:\u002F\u002Fgithub.com\u002FJasonzhu1207)     |\n| [小爱音箱 PRO 的 AI 模式使用说明](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fbbdb80e9bc38b7c40865e52cbd6517980a68615a\u002Fassets\u002Fpdf\u002F%E5%B0%8F%E7%88%B1%E9%9F%B3%E7%AE%B1PRO%20AI%E6%A8%A1%E5%BC%8F%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.pdf) | 这是一位老爸为家里的小朋友专门整理的贴心教程                                                                                                            | [@mxyblog](https:\u002F\u002Fgithub.com\u002Fmxyblog)               |\n| [使用 MiGPT 将你的小爱音箱接入 ChatGPT](https:\u002F\u002Fwww.iloli.love\u002Farchives\u002F1719073913220)                                                                                                                                               | 作者详细介绍了如何在 1Panel 上，通过 [OneAPI](https:\u002F\u002Fgithub.com\u002Fsongquanpeng\u002Fone-api) 来转换腾讯混元大模型，和讯飞星火大模型的 API 并成功接入 MiGPT    | [@miaowmint](https:\u002F\u002Fgithub.com\u002Fmiaowmint)           |\n| [Unraid 部署 MiGPT](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fadfdcc4ee51aef8d4f2d8996f18be716da19a0ad\u002Fassets\u002Fpdf\u002FUnraid%E9%83%A8%E7%BD%B2MiGPT.pdf)                                                                                    | 在 Unraid 上使用 Docker 部署 MiGPT 的详细教程                                                                                                           | [@ilovesouthpark](https:\u002F\u002Fgithub.com\u002Filovesouthpark) |\n\n## ❤️ 鸣谢\n\n特别感谢以下项目提供的实现参考：\n\n- https:\u002F\u002Fgithub.com\u002Fyihong0618\u002Fxiaogpt\n- https:\u002F\u002Fgithub.com\u002Fjialeicui\u002Fopen-lx01\n- https:\u002F\u002Fgithub.com\u002Finu1255\u002Fmi-service\n- https:\u002F\u002Fgithub.com\u002FYonsm\u002FMiService\n\n## 🚨 免责声明\n\n本项目仅供学习和研究目的，不得用于任何商业活动。用户在使用本项目时应遵守所在地区的法律法规，对于违法使用所导致的后果，本项目及作者不承担任何责任。\n本项目可能存在未知的缺陷和风险（包括但不限于设备损坏和账号封禁等），使用者应自行承担使用本项目所产生的所有风险及责任。\n作者不保证本项目的准确性、完整性、及时性、可靠性，也不承担任何因使用本项目而产生的任何损失或损害责任。\n使用本项目即表示您已阅读并同意本免责声明的全部内容。\n\n## License\n\n[MIT](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002FLICENSE) License © 2024-PRESENT Del Wang","# MiGPT 快速上手指南\n\nMiGPT 是一款能将小爱音箱接入大模型（如 ChatGPT、豆包等）的开源工具，让你的智能家居拥有 AI 问答、角色扮演和流式对话能力。\n\n## 环境准备\n\n### 系统要求\n- **操作系统**：Windows \u002F macOS \u002F Linux\n- **运行方式**：支持 Docker 或 Node.js 环境\n- **硬件设备**：\n  - 推荐：**小爱音箱 Pro**（完美运行）\n  - 兼容：大部分小爱音箱型号（具体兼容列表请参考项目文档）\n  - ⚠️ 不支持：小度音箱、天猫精灵、HomePod 等非小米系设备\n\n### 前置依赖\n1. **小米账号**：需准备小米账号的 `userId`（非手机号\u002F邮箱，需在小米官网个人信息查看）、密码及设备名称（did）。\n2. **大模型 API**：需准备可用的大模型接口（如 OpenAI、豆包等）及 Key。\n3. **配置文件**：需提前准备好 `.env` (环境变量) 和 `.migpt.js` (应用配置) 文件。\n   > 💡 详细配置项说明请参考官方文档：[⚙️ 参数设置](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fblob\u002Fmain\u002Fdocs\u002Fsettings.md)\n\n---\n\n## 安装步骤\n\n你可以选择 **Docker**（推荐新手）或 **Node.js**（适合开发者）两种方式启动。\n\n### 方式一：Docker 启动（推荐）\n\n适合不想配置代码环境的用户。请确保已安装 Docker 并登录。\n\n1. 在当前目录准备好 `.env` 和 `.migpt.js` 配置文件。\n2. 执行以下命令启动容器：\n\n```shell\ndocker run -d --env-file $(pwd)\u002F.env -v $(pwd)\u002F.migpt.js:\u002Fapp\u002F.migpt.js idootop\u002Fmi-gpt:latest\n```\n\n> **注意**：在 Windows PowerShell 或 CMD 终端下，请将 `$(pwd)` 替换为配置文件的绝对路径（例如：`C:\\Users\\Name\\config\\.env`）。\n\n### 方式二：Node.js 启动\n\n适合前端开发者或需要二次开发的用户。\n\n1. 安装依赖包：\n\n```shell\nnpm install mi-gpt\n```\n\n2. 创建入口文件（如 `index.ts`），编写以下代码启动实例：\n\n```typescript\nimport { MiGPT } from \"mi-gpt\";\n\nasync function main() {\n  const client = MiGPT.create({\n    speaker: {\n      userId: \"987654321\", \u002F\u002F 替换为你的小米 ID\n      password: \"123456\", \u002F\u002F 替换为你的小米账号密码\n      did: \"小爱音箱 Pro\", \u002F\u002F 替换为你的设备名称或在米家中设置的昵称\n    },\n    \u002F\u002F 其他配置项（如大模型 API Key 等）需在此处传入或通过环境变量加载\n  });\n  await client.start();\n}\n\nmain();\n```\n\n> **提示**：Node.js 模式下不会自动读取 `.env` 和 `.migpt.js`，你需要手动将配置作为参数传入 `MiGPT.create`，或自行初始化环境变量。\n\n---\n\n## 基本使用\n\n启动成功后，无需额外操作，直接对小爱音箱说话即可触发 AI 功能。\n\n### 唤醒指令格式\n你可以通过以下几种自然语言方式召唤 AI：\n\n- **提问模式**：`小爱同学，请 xxx`\n  > 示例：“小爱同学，请问地球为什么是圆的？”\n- **对话模式**：`小爱同学，你 xxx`\n  > 示例：“小爱同学，你喜欢我吗？”\n- **角色模式**：`小爱同学，召唤 xxx`\n  > 示例：“小爱同学，召唤傻妞”\n\n### 进阶玩法\n- **角色扮演**：在配置文件中设定人设，让小爱变成你的专属伴侣或助手。\n- **自定义音色**：接入第三方 TTS（如豆包音色），让回复声音更自然。\n- **长短期记忆**：AI 会自动记录上下文，越聊越默契。\n\n> 🎬 **新手建议**：观看官方视频教程 [MiGPT 光速入门](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1zb421H7cS) 以获取更直观的操作演示。","独居的程序员小林下班回家，想通过语音与家中设备互动来缓解疲惫，却受限于传统音箱的刻板反应。\n\n### 没有 mi-gpt 时\n- **回答机械生硬**：询问“今天心情不好怎么办”，小爱只能回复预设的天气或新闻，无法提供情感慰藉。\n- **无法连续对话**：想多聊几句必须每次重复唤醒词“小爱同学”，打断交流兴致，像在对机器下指令。\n- **音色单调乏味**：标准的合成语音缺乏感情色彩，听起来冷冰冰，难以营造温馨的居家氛围。\n- **记忆能力缺失**：昨天提到的“喜欢听爵士乐”，今天再问推荐音乐时，它完全遗忘，需要重新输入偏好。\n- **角色单一固定**：无论怎么设置，它始终是那个只会执行命令的助手，无法扮演知心朋友或特定角色进行互动。\n\n### 使用 mi-gpt 后\n- **情感智能回应**：接入 ChatGPT 后，它能理解情绪并温柔建议：“要不要放首舒缓的爵士乐，再调暗灯光陪你坐会儿？”\n- **流畅连续交互**：支持自然连续对话，无需反复唤醒，小林可以像和老朋友聊天一样随意倾诉心事。\n- **定制真人音色**：解锁豆包同款拟人化 TTS 音色，回复语气抑扬顿挫，仿佛真人在耳边轻声细语。\n- **长短期记忆加持**：自动记住小林的喜好和过往对话细节，越聊越默契，主动推荐符合口味的音乐和内容。\n- **百变角色扮演**：一键切换为“贴心闺蜜”或“专属管家”模式，不仅能聊天，还能主动联动米家设备调节环境。\n\nmi-gpt 将原本冰冷的智能音箱升级为懂情感、有记忆、能进化的家庭专属伙伴，让智能家居真正拥有了“温度”。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fidootop_mi-gpt_1805db92.png","idootop","Del","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fidootop_f4b9f4f6.jpg","The best way to predict the future is to create it.",null,"Shanghai, China","https:\u002F\u002Fdel.wang","https:\u002F\u002Fgithub.com\u002Fidootop",[84,88,92],{"name":85,"color":86,"percentage":87},"TypeScript","#3178c6",93.1,{"name":89,"color":90,"percentage":91},"JavaScript","#f1e05a",6,{"name":93,"color":94,"percentage":95},"Dockerfile","#384d54",1,12316,1671,"2026-04-03T19:50:15","MIT","Linux, macOS, Windows","未说明",{"notes":103,"python":101,"dependencies":104},"本项目基于 Node.js 开发，非 Python 项目。支持通过 Docker 或 Node.js (npm) 两种方式运行。需要拥有小爱音箱设备（推荐小爱音箱 Pro）及小米账号。需配置 .env 和 .migpt.js 文件以设置小米账号信息及大模型 API 密钥。暂不支持小度、天猫精灵等其他品牌音箱。",[105,106,107],"Node.js","npm","Docker (可选)",[26,55,15],7,"2026-03-27T02:49:30.150509","2026-04-06T07:12:42.096622",[113,118,123,128,133,138,143],{"id":114,"question_zh":115,"answer_zh":116,"source_url":117},6384,"Docker 部署后无法登录 MiService 或找不到 .mi.json 配置文件怎么办？","在 Docker 部署时，需要确保将宿主机的配置文件正确挂载到容器内。通常需要将 `.mi.json` 文件放在配置目录（如 `Docker\u002Fmigpt\u002F` 根目录），并在启动命令中通过 `-v` 参数挂载。例如：\n`docker run -v \u002Fpath\u002Fto\u002Fyour\u002F.mi.json:\u002Fapp\u002F.mi.json ...`\n如果仍然无法登录，可能需要修改 `node_modules` 中的源码以适配登录逻辑，具体可参考相关依赖库的 Issues。","https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F22",{"id":119,"question_zh":120,"answer_zh":121,"source_url":122},6385,"哪些型号的小爱音箱支持 MiGPT 完美运行？","已知完美运行的型号包括：\n1. Xiaomi 智能音箱 Pro (OH2P)\n2. 小爱音箱 Pro (LX06)\n3. 小米 AI 音箱 (S12)\n4. 小米 AI 音箱第二代 (L15A)\n5. 小爱音箱万能遥控版 (LX5A)\n6. Redmi 小爱音箱 Play (L07A，但不支持连续对话)\n注意：连续对话是实验性功能，未刷机设备建议关闭 `streamResponse` 选项以获得更好体验。不同型号对应的 `ttsCommand` 和 `wakeUpCommand` 需在配置文件中指定。","https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F92",{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},6386,"Docker 启动时报错“找不到设备”或“初始化 Mi Services 失败”如何解决？","这通常是因为环境变量配置缺失或错误。请检查 Docker 启动命令或 compose 文件，确保所有必要的环境变量（如 `MI_USER`, `MI_PASS`, `DID` 等）已正确传入。\n建议在 Docker 管理界面（如 Portainer 或 NAS 的 Docker 插件）中，手动将环境变量一条条添加到容器的环境变量设置中，而不仅仅依赖 `.env` 文件，以确保容器能正确读取。","https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F30",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},6387,"接入自定义 TTS (mi-gpt-tts) 后，控制台有回复文本但音箱没有声音且无调用日志？","此问题通常由网络环境引起。解决办法是：\n1. 不要使用国外的 AI 服务节点，尽量切换至国内可用的 API 服务。\n2. 关闭全局代理或确保容器内的网络请求不经过导致超时的代理服务器。\n3. 开启 Debug 模式，仔细检查容器内实际读取到的 `TTS_BASE_URL` 环境变量是否与配置一致（有时环境变量未正确注入）。\n确保服务器到 TTS 接口的网络在全局范围内（特别是容器内部）是通畅的。","https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F107",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},6388,"OpenAI 返回内容过长时，小爱音箱无法读完或中途停止怎么办？","这通常是因为当前音箱型号不支持流式响应（Stream Response）或特定的播放状态检测。\n解决方法：\n1. 尝试在配置文件中注释掉或调整 `playingCommand` 参数，观察输出的 `playState` 状态值。\n2. 如果获取到的状态值始终为空（undefined），说明该机型硬件或固件不支持流式唤醒模式。\n3. 建议升级音箱固件至最新版本，若仍无效，则只能接受该限制或更换支持的音箱型号。","https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F14",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},6389,"运行时出现 'Network request failed: ECONNABORTED timeout of 10000ms exceeded' 错误？","该错误表示连接小米服务器超时。主要原因及解决方法：\n1. 网络问题：检查服务器是否能正常访问 `api2.mina.mi.com`，中国大陆用户可能需要检查 DNS 或网络连通性。\n2. 代理配置：如果开启了代理，尝试关闭代理或配置排除规则，确保直连小米服务。\n3. 账号安全：确认小米账号密码正确，且没有被小米风控限制。","https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F25",{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},6390,"如何获取项目交流群或更详细的刷机教程？","项目提供了 Telegram 交流群和 QQ 频道供用户交流。对于需要刷机以实现更高级功能（如完美连续对话）的用户，全套的小爱音箱刷机教程和解决方案已发布在项目 Issue #322 中，请移步查看。在群内交流时请注意保护个人隐私信息。","https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F78",[149,154,159,164,169,174,179],{"id":150,"version":151,"summary_zh":152,"released_at":153},79149,"v4.2.0","### ✨ 新功能\r\n\r\n- ✅ 新增对小爱音箱 LLM 消息的支持\r\n\r\n### 🐛 修复\r\n\r\n- ✅ 修复 LLM 返回值格式与预期不符的问题 by @yanyao2333\r\n\r\n### ❤️ 感谢\r\n\r\n- @yanyao2333 让 LLM 返回值的解析更加健壮 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fpull\u002F160\r\n- @LyCecilion 对小爱音箱丢消息问题的详细反馈 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F177\r\n- @Jasonzhu1207 在 telegram 群中帮忙解答问题","2024-08-26T14:04:05",{"id":155,"version":156,"summary_zh":157,"released_at":158},79150,"v4.1.0","### 🐛 修复\r\n\r\n- ✅ 修复部分机型连续对话异常的问题（比如小爱音箱 Play）\r\n- ✅ 修复第三方 TTS 发音人为 undefined 的问题\r\n- ✅ 修复默认网络超时时间过短的问题，上调为 5s\r\n\r\n### 💪 优化\r\n\r\n- ✅ 允许通过设置 systemTemplate 为空字符串来关闭系统消息\r\n- ✅ 优化关闭流式响应时不能使用连续对话模式的提示语\r\n- ✅ 优化 bot 个人简介默认模板\r\n\r\n### 📚 文档\r\n\r\n- ✅ 添加召唤 AI 回答问题的唤醒指令的说明\r\n- ✅ 添加如何提高 AI 回答反应速度的配置教程\r\n- ✅ 添加连续对话下和小爱音箱说话没有反应的说明\r\n- ✅ 添加如何快速打断 AI 的回答的说明\r\n- ✅ 添加 server 端异地登录失败，使用本地登录凭证的教程\r\n- ✅ 添加 TTS 和 OpenAI baseURL 示例和注意事项\r\n- ✅ 添加如何关闭系统 Prompt 和对话上下文的说明\r\n- ✅ 添加系统 Prompt 字符串变量的示例\r\n- ✅ 添加 timeout 参数说明\r\n\r\n### ❤️ 感谢\r\n\r\n- @lmk123 正在为 MiGPT 制作 [GUI](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F111) 和启动 [CLI](https:\u002F\u002Fgithub.com\u002Flmk123\u002Fmigpt-cli)，方便普通用户更简单的使用 MiGPT。\r\n- @mingtian886 提供了小爱音箱 Play 硬件，协助调试连续对话异常的问题\r\n- 以及 @uect 和 @miaowmint 等在微信交流群内帮助群友积极解答问题的可爱的人们 ❤️","2024-06-22T16:43:37",{"id":160,"version":161,"summary_zh":162,"released_at":163},79151,"v4.0.0","### ✨ 新功能\r\n\r\n- ✅ 新增自定义系统 Prompt 功能\r\n- ✅ 支持火山引擎 TTS 和音色切换能力\r\n- ✅ 支持使用 SOCKS 代理 by [@tluo-github](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fpull\u002F100)\r\n- ✅ 添加 MIT license\r\n\r\n### 💪 优化\r\n\r\n- ✅ 登录凭证过期后自动刷新 token https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F76\r\n- ✅ 优化网络请求错误重试策略（消息\u002F播放状态轮询）\r\n- ✅ 优化 db 路径查找方式与初始化脚本\r\n- ✅ 移除 TTS 不发音字符（emoji）\r\n- ✅ 优化切换音色默认语音指令\r\n\r\n### 📚 文档\r\n\r\n- ✅ 添加系统 Prompt 模板字符串变量的说明\r\n  - ✅ DAN 模式，猫娘等整活 prompt 的演示示例\r\n  - ✅ Awesome prompt 征集\r\n- ✅ 添加更新人设 Prompt 的使用说明（你是 xxx，你喜欢 xxx）\r\n- ✅ 添加对其他品牌音箱的支持情况的说明 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F83\r\n- ✅ 添加“小爱同学”唤醒词的相关说明 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F84\r\n- ✅ 添加进入唤醒模式时小爱莫名开始播放歌曲的说明 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F71\r\n- ✅ 添加部署和接入本地大语言模型的教程 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F82\r\n- ✅ 添加获取小爱音箱 did 的相关说明\r\n- ✅ 添加提示无法找到共享设备的相关说明\r\n- ✅ 添加常见小爱音箱型号的支持情况和参数列表\r\n- ✅ 添加 OpenAI 账号充值前可能无法使用 gpt-4 系列模型的相关说明\r\n- ✅ 添加无需和小爱音箱在同一局域网下运行的说明\r\n- ✅ 添加自定义 TTS 和音色的配置和使用教程\r\n- ✅ 添加切换音色使用教程\r\n\r\n### ❤️ 感谢\r\n\r\n- @tluo-github 添加了对 SOCKS 代理的支持 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fpull\u002F100\r\n- @shinedlc 实现了一个小爱音箱接入 [OpenGlass](https:\u002F\u002Fgithub.com\u002FBasedHardware\u002FOpenGlass) 摄像头硬件 + 本机搭建 [Ollama](https:\u002F\u002Fgithub.com\u002Follama\u002Follama) 模型的 [Fork](https:\u002F\u002Fgithub.com\u002Fshinedlc\u002Fmi-gpt)\r\n- @LycsHub 推荐了 [simple-one-api](https:\u002F\u002Fgithub.com\u002Ffruitbars\u002Fsimple-one-api) 将其他模型的接口统一成 OpenAI 的格式，支持 Coze\r\n- @lmk123 推荐了国内 docker 镜像设置与大模型服务申请配置教程\r\n- @laiquziru 协助调试小米 AI 音箱（第二代）\r\n- @wt666666、@mingtian886、@imlinhanchao、@HJ66 帮助网友解答常见问题（比如通义千问如何配置等）","2024-06-17T17:22:51",{"id":165,"version":166,"summary_zh":167,"released_at":168},79152,"v3.1.0","### 🔥 Hotfix\r\n\r\n- ✅ 修复对 Azure OpenAI Service 的支持\r\n- ✅ 修复 MIoT 和 Mina 接口查询到的设备名称不一致的问题。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F62\r\n- ✅ 提示语列表为空时，不播放提示音。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F30#issuecomment-2153786207\r\n- ✅ 唤醒模式下重新匹配唤醒词时，不再重复唤醒。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F25\r\n- ✅ 修复使用提示音链接时，小爱回答完毕后，仍然重复播放文字提示语的问题。\r\n\r\n### 💪 优化\r\n\r\n- ✅ 优化 unWakeUp 小爱流程，增加指令间的执行间隔，降低 ROM 端无响应问题的出现概率。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F32\r\n- ✅ 优化 debug 日志输出，添加 wakeUp、unWakeUp、env 等关键流程和核心数据的打印。\r\n\r\n### ❤️ 感谢\r\n\r\n- @shaoyi1991 补充的关于项目启动和国内配置 docker 镜像的说明。 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F28\r\n- @shog86 协助调试 Azure OpenAI Service 相关的配置参数 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fpull\u002F34\r\n- @otkHsiao 反馈 Azure OpenAI Service 配置 deployment 的问题 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fpull\u002F34#issuecomment-2156068725\r\n- @siseboy 提供群晖 docker 使用教程 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F41\r\n- @moffefei 提供的 Windows 下 docker 启动命令的示例 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F45\r\n- @imhsz 协助调试 MIoT 和 Mina 接口查询到的设备名称不一致的问题。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F62\r\n\r\n### 📚 其他\r\n\r\n- ✅ 优化关于小米账号安全验证相关的提示语和使用说明。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F22#issuecomment-2150535622\r\n- ✅ 优化关于 Azure OpenAI 配置的说明。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F7\r\n- ✅ 优化调用 AI 进行回复的相关说明和示例。\r\n- ✅ 优化找不到小爱设备的相关说明。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F28#issuecomment-2153645819\r\n- ✅ 添加关于 clone 项目本地运行的相关配置教程。\r\n- ✅ 添加关于本地构建本项目 docker 镜像的说明。\r\n- ✅ 添加关于 clone 项目本地运行提示找不到 bot 的相关说明。\r\n- ✅ 添加国内网络配置代理访问 OpenAI 服务的相关说明。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F29\r\n- ✅ 添加关于 OpenAI 401 账号 API_KEY 错误， 403 触发 IP 访问风控的说明。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F19, https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F33\r\n- ✅ 添加关于 Node 项目下 MiGPT.create 参数配置的说明。 https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F27\r\n- ✅ 添加关于 Widnows 下 docker 启动参数配置的说明。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F26\r\n- ✅ 添加对多账号\u002F设备支持的相关说明\r\n- ✅ 添加群晖 docker 使用教程\r\n- ✅ 添加国内使用 Docker 配置镜像代理的相关说明。https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F31\r\n- ✅ 添加关于 OpenAI gpt4 模型不存在的相关说明\r\n- ✅ 添加关于唤醒小爱、唤醒词、唤醒模式的说明和注意事项。\r\n- ✅ 添加关于 playingCommand 的详细说明，默认不需要配置。","2024-06-11T14:30:31",{"id":170,"version":171,"summary_zh":172,"released_at":173},79153,"v3.0.0","## ✨ 新功能 \r\n\r\n- 新增 ARMv7 Docker 镜像 #15\r\n- 新增 `playingCommand` 选项，修复小爱音箱回答戛然而止的问题 #14\r\n- 新增 `streamResponse` 流式响应控制开关，确保小爱的回复是完整的句子 #20\r\n- 添加对其他 LLM 的支持和配置教程（比如通义千问，moonshot 等）#11\r\n- 新增 [example](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Ftree\u002Fexample) 示例代码（node）#17\r\n- 添加小爱音箱支持型号的说明 #14\r\n- 新增 debug 开关，用于调试 #14\r\n\r\n\r\n## 🐛 修复\r\n\r\n- 修复小爱回复无法被终止的问题 #5\r\n- 修复 DB 初始化失败的问题 #17\r\n- 修复 AI 响应异常时未播放提示语\u002F音的问题\r\n- 修复提示音链接为空时自动播放音乐的问题\r\n\r\n## 💪 优化\r\n\r\n- 优化 Docker 镜像体积\r\n- 优化配置文件示例和使用教程 #22\r\n- 优化版本号读取方式（import 静态导入）\r\n\r\n## ❤️ 感谢\r\n\r\n- @lyddias 反馈并协助调试小米音箱 Play 增强版相关问题\r\n- @akring 优化小米账号相关的使用提示\r\n- @csjuXYZ 反馈 NPM 包无法正常使用的问题\r\n- @Ruiyuan-Zhang 反馈长回复无法被终止的问题\r\n","2024-06-05T03:08:25",{"id":175,"version":176,"summary_zh":177,"released_at":178},79154,"v2.0.0","## 🚨 Breaking changes\r\n\r\n- `callAIPrefix` 更名为 `callAIKeywords`\r\n- `wakeUpKeywords`、`exitKeywords` 匹配规则由包含(includes)变更为起始(startsWith)\r\n\r\n## ✨ 新功能 & 优化\r\n\r\n- 支持 Microsoft Azure OpenAI（[#7](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F7)）\r\n- 新增 LLM 响应完毕提示语：onAIReplied\r\n- 优化 `.mi.example.js` 配置参数实例\r\n- 优化唤醒模式下播放状态检测间隔，限制最低为 500 ms\r\n\r\n## 🐛 修复\r\n\r\n- 修复唤醒模式下 LLM 回复不发音或过短的问题（[#9](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F9)）\r\n- 修复部分场景下 LLM 返回数据格式异常的问题\r\n- 修复唤醒词配置格式，使其与原始文档行为一致（[#8](https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F8)）","2024-05-26T14:57:21",{"id":180,"version":181,"summary_zh":182,"released_at":183},79155,"v1.2.0","- 新增小爱音箱 TTS 与唤醒指令选项 (https:\u002F\u002Fgithub.com\u002Fidootop\u002Fmi-gpt\u002Fissues\u002F5)\r\n- 更新默认模型为 gpt-4o","2024-05-21T15:17:43"]