[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-RealDeco--xiaozhi-esphome":3,"tool-RealDeco--xiaozhi-esphome":65},[4,23,32,40,49,57],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":22},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",85013,2,"2026-04-06T11:09:19",[13,14,15,16,17,18,19,20,21],"图像","数据工具","视频","插件","Agent","其他","语言模型","开发框架","音频","ready",{"id":24,"name":25,"github_repo":26,"description_zh":27,"stars":28,"difficulty_score":29,"last_commit_at":30,"category_tags":31,"status":22},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,3,"2026-04-04T04:44:48",[17,13,20,19,18],{"id":33,"name":34,"github_repo":35,"description_zh":36,"stars":37,"difficulty_score":29,"last_commit_at":38,"category_tags":39,"status":22},519,"PaddleOCR","PaddlePaddle\u002FPaddleOCR","PaddleOCR 是一款基于百度飞桨框架开发的高性能开源光学字符识别工具包。它的核心能力是将图片、PDF 等文档中的文字提取出来，转换成计算机可读取的结构化数据，让机器真正“看懂”图文内容。\n\n面对海量纸质或电子文档，PaddleOCR 解决了人工录入效率低、数字化成本高的问题。尤其在人工智能领域，它扮演着连接图像与大型语言模型（LLM）的桥梁角色，能将视觉信息直接转化为文本输入，助力智能问答、文档分析等应用场景落地。\n\nPaddleOCR 适合开发者、算法研究人员以及有文档自动化需求的普通用户。其技术优势十分明显：不仅支持全球 100 多种语言的识别，还能在 Windows、Linux、macOS 等多个系统上运行，并灵活适配 CPU、GPU、NPU 等各类硬件。作为一个轻量级且社区活跃的开源项目，PaddleOCR 既能满足快速集成的需求，也能支撑前沿的视觉语言研究，是处理文字识别任务的理想选择。",74991,"2026-04-06T23:16:49",[19,13,20,18],{"id":41,"name":42,"github_repo":43,"description_zh":44,"stars":45,"difficulty_score":46,"last_commit_at":47,"category_tags":48,"status":22},3215,"awesome-machine-learning","josephmisiti\u002Fawesome-machine-learning","awesome-machine-learning 是一份精心整理的机器学习资源清单，汇集了全球优秀的机器学习框架、库和软件工具。面对机器学习领域技术迭代快、资源分散且难以甄选的痛点，这份清单按编程语言（如 Python、C++、Go 等）和应用场景（如计算机视觉、自然语言处理、深度学习等）进行了系统化分类，帮助使用者快速定位高质量项目。\n\n它特别适合开发者、数据科学家及研究人员使用。无论是初学者寻找入门库，还是资深工程师对比不同语言的技术选型，都能从中获得极具价值的参考。此外，清单还延伸提供了免费书籍、在线课程、行业会议、技术博客及线下聚会等丰富资源，构建了从学习到实践的全链路支持体系。\n\n其独特亮点在于严格的维护标准：明确标记已停止维护或长期未更新的项目，确保推荐内容的时效性与可靠性。作为机器学习领域的“导航图”，awesome-machine-learning 以开源协作的方式持续更新，旨在降低技术探索门槛，让每一位从业者都能高效地站在巨人的肩膀上创新。",72149,1,"2026-04-03T21:50:24",[20,18],{"id":50,"name":51,"github_repo":52,"description_zh":53,"stars":54,"difficulty_score":46,"last_commit_at":55,"category_tags":56,"status":22},2234,"scikit-learn","scikit-learn\u002Fscikit-learn","scikit-learn 是一个基于 Python 构建的开源机器学习库，依托于 SciPy、NumPy 等科学计算生态，旨在让机器学习变得简单高效。它提供了一套统一且简洁的接口，涵盖了从数据预处理、特征工程到模型训练、评估及选择的全流程工具，内置了包括线性回归、支持向量机、随机森林、聚类等在内的丰富经典算法。\n\n对于希望快速验证想法或构建原型的数据科学家、研究人员以及 Python 开发者而言，scikit-learn 是不可或缺的基础设施。它有效解决了机器学习入门门槛高、算法实现复杂以及不同模型间调用方式不统一的痛点，让用户无需重复造轮子，只需几行代码即可调用成熟的算法解决分类、回归、聚类等实际问题。\n\n其核心技术亮点在于高度一致的 API 设计风格，所有估算器（Estimator）均遵循相同的调用逻辑，极大地降低了学习成本并提升了代码的可读性与可维护性。此外，它还提供了强大的模型选择与评估工具，如交叉验证和网格搜索，帮助用户系统地优化模型性能。作为一个由全球志愿者共同维护的成熟项目，scikit-learn 以其稳定性、详尽的文档和活跃的社区支持，成为连接理论学习与工业级应用的最",65644,"2026-04-06T10:25:08",[20,18,14],{"id":58,"name":59,"github_repo":60,"description_zh":61,"stars":62,"difficulty_score":10,"last_commit_at":63,"category_tags":64,"status":22},3364,"keras","keras-team\u002Fkeras","Keras 是一个专为人类设计的深度学习框架，旨在让构建和训练神经网络变得简单直观。它解决了开发者在不同深度学习后端之间切换困难、模型开发效率低以及难以兼顾调试便捷性与运行性能的痛点。\n\n无论是刚入门的学生、专注算法的研究人员，还是需要快速落地产品的工程师，都能通过 Keras 轻松上手。它支持计算机视觉、自然语言处理、音频分析及时间序列预测等多种任务。\n\nKeras 3 的核心亮点在于其独特的“多后端”架构。用户只需编写一套代码，即可灵活选择 TensorFlow、JAX、PyTorch 或 OpenVINO 作为底层运行引擎。这一特性不仅保留了 Keras 一贯的高层易用性，还允许开发者根据需求自由选择：利用 JAX 或 PyTorch 的即时执行模式进行高效调试，或切换至速度最快的后端以获得最高 350% 的性能提升。此外，Keras 具备强大的扩展能力，能无缝从本地笔记本电脑扩展至大规模 GPU 或 TPU 集群，是连接原型开发与生产部署的理想桥梁。",63927,"2026-04-04T15:24:37",[20,14,18],{"id":66,"github_repo":67,"name":68,"description_en":69,"description_zh":70,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":77,"owner_avatar_url":78,"owner_bio":77,"owner_company":77,"owner_location":77,"owner_email":77,"owner_twitter":77,"owner_website":77,"owner_url":79,"languages":80,"stars":84,"forks":85,"last_commit_at":86,"license":87,"difficulty_score":88,"env_os":89,"env_gpu":90,"env_ram":89,"env_deps":91,"category_tags":96,"github_topics":77,"view_count":10,"oss_zip_url":77,"oss_zip_packed_at":77,"status":22,"created_at":97,"updated_at":98,"faqs":99,"releases":129},4756,"RealDeco\u002Fxiaozhi-esphome","xiaozhi-esphome","Alternative code to use xiaozhi ai devices in esphome\u002Fhome assistant.","xiaozhi-esphome 是一款开源固件项目，旨在让基于“小智”方案的智能硬件无缝接入 ESPHome 和 Home Assistant 生态。它解决了原本封闭或专用的小智语音设备难以直接融入主流智能家居系统的问题，用户无需更换硬件，只需刷入新固件，即可将这些小巧的设备变身为功能强大的本地语音助手卫星节点。\n\n该项目特别适合热爱动手的智能家居爱好者、ESPHome 用户以及希望实现高度自定义语音控制的开发者。其核心亮点在于广泛的硬件兼容性，不仅支持 Espressif EchoEar、Spotpear 系列球体与盒子等成品设备，还涵盖了 Waveshare、Guition 等多种开发板甚至 DIY 面包板方案。通过简单的网页端配置流程，用户即可完成无线部署，并在 Home Assistant 中直接调用设备的麦克风与扬声器，实现低延迟、高隐私的本地语音交互体验。对于希望打破品牌壁垒、构建统一智能家庭中枢的用户而言，xiaozhi-esphome 提供了一个低成本且灵活的解决方案。","\u003Cdiv align=\"center\">\n\n# XIAOZHI-ESPHOME\n\n**Use your Xiaozhi AI devices in ESPHome as voice assistant satellites for Home Assistant.**\n\n\u003Cimg width=\"400\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_a4c87770e62c.png\" \u002F>\n\u003Cimg width=\"400\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_ccd8a3af5bee.png\" \u002F>\n\n\n\u003Cimg width=\"300\" height=\"972\" alt=\"Screenshot 2025-09-14 at 13 38 39\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_8051e3ad91c0.png\" \u002F>\n\u003Cimg width=\"300\" height=\"972\" alt=\"c3c3c178-ab7e-494b-a0a2-6c03bb2b5155\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_17c01f9fb108.png\" \u002F>\n\n\u003C\u002Fdiv>\n\u003Cdiv align=\"center\">\n \n\u003Cimg width=\"300\" height=\"500\" alt=\"4inch500x500\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_c969dfa441b1.png\" \u002F>\n\u003Cimg width=\"300\" height=\"500\" alt=\"4inch500x500\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_1c16862d2049.png\" \u002F>\n\n\u003Cimg width=\"600\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_07c363d2a626.png\" \u002F>\n\n\u003C\u002Fdiv>\n\n\nBy request, this GitHub project provides a simple way to use Xiaozhi-based devices with ESPHome. These compact devices can serve as voice assistants integrated with Home Assistant.\n\n## 🚀 Quick Start Guide\n\n### Step-by-step Installation:\n\n1. **Connect your device** to your computer via USB. Open [ESPHome Web](https:\u002F\u002Fweb.esphome.io), click “**+ NEW DEVICE**”, and follow the prompts to set it up and connect it to Wi-Fi.\n2. In ESPHome Builder, **take over the newly discovered device**, edit the configuration, paste in the code for your device but keep the original device `name`. (You can customize the `friendly_name` as desired.)\n3. **Save and install** the configuration **wirelessly**. Wait for it to reboot and begin running your code.\n4. Once it’s online, go to **Home Assistant > Devices**, and **accept the new device**. This will start the voice assistant setup process.\n\n> **Note for Step 3:**\n> If wireless installation fails and you're prompted to use USB flashing:\n>\n> * Reconnect the device to your computer if needed.\n> * Save and install again, choose “Plug into this computer,” wait for the firmware to compile, download, and use ESPHome Web to install it via USB.\n>   This only happens the first time, when the partition table needs to be updated. Future updates can be done wirelessly.\n\nVideo going through the esphome install of device was removed by youtube and my account blocked. strange world we live in.\n\n[▶️ Download the install video](https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome\u002Fraw\u002Fmain\u002Finstall-xiaozhi-esphome.mp4?raw=true)\n\n\n## ✅ Supported Devices (so far)\n\n* Espressif EchoEar v1.0\n* Espressif EchoEar v1.2\n* Spotpear Ball v1\n* Spotpear Ball v2\n* Spotpear Muma Box v1\n* Spotpear Muma Box v2\n* Spotpear Muma Horse v1\n* Spotpear Muma Horse v2\n* Spotpear Puck\n* DIY (breadboard)\n* Guition 1.8\" Taichi pi (JC3636W518C) v1 (discontinued after july 2025)\n* Guition 1.8\" Taichi pi (JC3636W518C) v2\n* Xingzhi Cube 1.54\n* \"Breadboard Mini\", the $7 custom ESP32-S3 with everything onboard\n* Waveshare 2.06\" OLED Wrist Watch\n* Waveshare ESP32-S3-Touch-LCD-1.85C v1\n* Waveshare ESP32-S3-Touch-LCD-1.85C v2\n* Waveshare ESP32-S3-Touch-LCD-3.49\n* Waveshare ESP32-P4-86-Panel-ETH-2RO **NEW**\n* Waveshare Audio Board **NEW**\n* Guition 4.3C **NEW**\n* Guition 7.0 **NEW**\n* Freenove 2.8 **NEW**\n* Waveshare amoled 1.75 **NEW**\n* Xingzhi Cube 1.83 2-Mic **NEW**\n\n(New devices appear in the [modular version](devices\u002FUnder_Development\u002FModular)\n first during testing.)\n\n## 🛒 Where to Buy\n\nEchoEar: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009834934442.html\n\nBall v1 & v2: https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005008627679270.html\n\nalternative link: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009762104155.html\n\nMuma Box: https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005009043526078.html\n\nMuma Horse: https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005008884232596.html\n\nPuck: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009016529496.html\n\nGuition Taichi pi: https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005007420092928.html\n\nXingzhi Cube 1.54: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005008565082769.html\n\nBreadboard: Look in devices\u002FBreadboard: https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome\u002Ftree\u002Fmain\u002Fdevices\u002FBreadboard\n\nBreadboard Mini: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009448496585.html\n\nWaveshare 2.06\" OLED Wrist Watch: https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005009516438849.html\n\nWaveshare ESP32-S3-Touch-LCD-1.85C: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005008634826817.html\n\nWaveshare ESP32-S3-Touch-LCD-3.49: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009894437640.html\n\nWaveshare ESP32-P4-86-Panel-ETH-2RO: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009197112179.html\n\nWaveshare Audio Board: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009819735457.html\n\nGuition P4 4.3C: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009673625472.html\n\nGuition P4 7.0: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005010022828767.html\n\nFreenove 2.8\": https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009876628479.html\n\nXingzhi Cube 1.83 2-mic: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005010442374066.html\n\nWaveshare amoled 1.75: https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005008989323572.html\n\n## Accesories:\n\nBack side case for the 4\" (wall mount) nice for desktop use.\nhttps:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005006149480110.html\n\n3D file of \"Eggvenger\" figure used to hold the Ball in image above, use 115% for v2 since it's larger than v1.\nhttps:\u002F\u002Fmakerworld.com\u002Fen\u002Fmodels\u002F1238732-eggvenger-superhero-egg-holder\n\n3D file for Wireless charger stand for the Guition JC3636W518 display\nhttps:\u002F\u002Fmakerworld.com\u002Fen\u002Fmodels\u002F238543-wireless-charger-holder\n\nWireless charger for the Guition JC3636W518 display: https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005005066837741.html\n\nCurled audio cable for Guition JC3636W518 display: https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005007061609551.html\n\nCase for Freenove 2.8\" (remember to pick correct print profile) https:\u002F\u002Fmakerworld.com\u002Fen\u002Fmodels\u002F1382304-aura-smart-weather-forecast-display\n\nOther 3D files here: https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome\u002Ftree\u002Fmain\u002F3D_Files\n\n---EOF\n\n","\u003Cdiv align=\"center\">\n\n# XIAOZHI-ESPHOME\n\n**将你的小智AI设备在ESPHome中用作Home Assistant的语音助手卫星设备。**\n\n\u003Cimg width=\"400\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_a4c87770e62c.png\" \u002F>\n\u003Cimg width=\"400\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_ccd8a3af5bee.png\" \u002F>\n\n\n\u003Cimg width=\"300\" height=\"972\" alt=\"Screenshot 2025-09-14 at 13 38 39\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_8051e3ad91c0.png\" \u002F>\n\u003Cimg width=\"300\" height=\"972\" alt=\"c3c3c178-ab7e-494b-a0a2-6c03bb2b5155\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_17c01f9fb108.png\" \u002F>\n\n\u003C\u002Fdiv>\n\u003Cdiv align=\"center\">\n \n\u003Cimg width=\"300\" height=\"500\" alt=\"4inch500x500\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_c969dfa441b1.png\" \u002F>\n\u003Cimg width=\"300\" height=\"500\" alt=\"4inch500x500\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_1c16862d2049.png\" \u002F>\n\n\u003Cimg width=\"600\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_readme_07c363d2a626.png\" \u002F>\n\n\u003C\u002Fdiv>\n\n\n应大家要求，这个GitHub项目提供了一种简单的方法，可以将基于小智的设备与ESPHome结合使用。这些小巧的设备可以用作与Home Assistant集成的语音助手。\n\n## 🚀 快速入门指南\n\n### 逐步安装：\n\n1. **通过USB将设备连接到电脑**。打开[ESPHome Web](https:\u002F\u002Fweb.esphome.io)，点击“**+ 新设备**”，按照提示进行设置并连接到Wi‑Fi。\n2. 在ESPHome Builder中，**接管新发现的设备**，编辑配置文件，粘贴适用于你设备的代码，但保留原始设备的`name`。（你可以根据需要自定义`friendly_name`。）\n3. **保存并无线安装**配置文件。等待设备重启并开始运行你的代码。\n4. 设备上线后，前往**Home Assistant > 设备**，**接受新设备**。这将启动语音助手的设置流程。\n\n> **第3步注意事项：**\n> 如果无线安装失败，并提示你需要使用USB烧录：\n>\n> * 如有必要，请重新将设备连接到电脑。\n> * 再次保存并安装，选择“插入此电脑”，等待固件编译、下载，并使用ESPHome Web通过USB进行安装。\n>   这种情况只会在第一次发生，因为那时需要更新分区表。后续更新都可以通过无线方式进行。\n\n关于ESPHome安装设备的视频被YouTube删除，我的账号也被封禁了。真是个奇怪的世界啊。\n\n[▶️ 下载安装视频](https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome\u002Fraw\u002Fmain\u002Finstall-xiaozhi-esphome.mp4?raw=true)\n\n\n## ✅ 目前支持的设备\n\n* Espressif EchoEar v1.0\n* Espressif EchoEar v1.2\n* Spotpear Ball v1\n* Spotpear Ball v2\n* Spotpear Muma Box v1\n* Spotpear Muma Box v2\n* Spotpear Muma Horse v1\n* Spotpear Muma Horse v2\n* Spotpear Puck\n* DIY（面包板）\n* Guition 1.8\" Taichi pi (JC3636W518C) v1（已于2025年7月停产）\n* Guition 1.8\" Taichi pi (JC3636W518C) v2\n* Xingzhi Cube 1.54\n* “Breadboard Mini”，这款售价7美元的定制ESP32‑S3集成了所有组件\n* Waveshare 2.06\" OLED 腕表\n* Waveshare ESP32‑S3‑Touch‑LCD‑1.85C v1\n* Waveshare ESP32‑S3‑Touch‑LCD‑1.85C v2\n* Waveshare ESP32‑S3‑Touch‑LCD‑3.49\n* Waveshare ESP32‑P4‑86‑Panel‑ETH‑2RO **全新**\n* Waveshare 音频板 **全新**\n* Guition 4.3C **全新**\n* Guition 7.0 **全新**\n* Freenove 2.8 **全新**\n* Waveshare amoled 1.75 **全新**\n* Xingzhi Cube 1.83 2‑Mic **全新**\n\n（新设备会先出现在[模块化版本](devices\u002FUnder_Development\u002FModular)中进行测试。）\n\n## 🛒 购买渠道\n\nEchoEar：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009834934442.html\n\nBall v1 & v2：https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005008627679270.html\n\n替代链接：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009762104155.html\n\nMuma Box：https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005009043526078.html\n\nMuma Horse：https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005008884232596.html\n\nPuck：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009016529496.html\n\nGuition Taichi pi：https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005007420092928.html\n\nXingzhi Cube 1.54：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005008565082769.html\n\nBreadboard：请查看devices\u002FBreadboard：https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome\u002Ftree\u002Fmain\u002Fdevices\u002FBreadboard\n\nBreadboard Mini：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009448496585.html\n\nWaveshare 2.06\" OLED 腕表：https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005009516438849.html\n\nWaveshare ESP32‑S3‑Touch‑LCD‑1.85C：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005008634826817.html\n\nWaveshare ESP32‑S3‑Touch‑LCD‑3.49：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009894437640.html\n\nWaveshare ESP32‑P4‑86‑Panel‑ETH‑2RO：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009197112179.html\n\nWaveshare 音频板：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009819735457.html\n\nGuition P4 4.3C：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009673625472.html\n\nGuition P4 7.0：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005010022828767.html\n\nFreenove 2.8\"：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005009876628479.html\n\nXingzhi Cube 1.83 2‑Mic：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005010442374066.html\n\nWaveshare amoled 1.75：https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005008989323572.html\n\n## 配件：\n\n适用于4英寸设备的背面外壳（壁挂式），非常适合桌面使用。\nhttps:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005006149480110.html\n\n用于固定上方图片中Ball的“Eggvenger”人偶3D模型文件，v2比v1大，建议放大115%使用。\nhttps:\u002F\u002Fmakerworld.com\u002Fen\u002Fmodels\u002F1238732-eggvenger-superhero-egg-holder\n\n用于Guiton JC3636W518显示屏的无线充电器支架3D文件\nhttps:\u002F\u002Fmakerworld.com\u002Fen\u002Fmodels\u002F238543-wireless-charger-holder\n\nGuiton JC3636W518显示屏的无线充电器：https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005005066837741.html\n\nGuiton JC3636W518显示屏的卷曲音频线：https:\u002F\u002Fvi.aliexpress.com\u002Fitem\u002F1005007061609551.html\n\nFreenove 2.8\"的保护壳（记得选择正确的打印参数）：https:\u002F\u002Fmakerworld.com\u002Fen\u002Fmodels\u002F1382304-aura-smart-weather-forecast-display\n\n更多3D文件请见：https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome\u002Ftree\u002Fmain\u002F3D_Files\n\n---完---","# XIAOZHI-ESPHOME 快速上手指南\n\n本指南帮助中国开发者将基于“小智”（Xiaozhi）的开源硬件设备配置为 ESPHome 语音助手卫星，并接入 Home Assistant。\n\n## 环境准备\n\n在开始之前，请确保满足以下条件：\n\n*   **硬件设备**：支持的开发板（如 Espressif EchoEar, Spotpear Ball\u002FMuma 系列，Waveshare 微雪系列，Guition 系列等）。\n*   **连接线缆**：一根可用于数据传输的 USB 线（Type-C 或 Micro-USB，视具体设备而定）。\n*   **网络环境**：\n    *   稳定的 Wi-Fi 网络（设备需与 Home Assistant 在同一局域网）。\n    *   能够访问 [ESPHome Web](https:\u002F\u002Fweb.esphome.io) 的网络环境。\n*   **软件平台**：已部署并运行正常的 **Home Assistant**。\n*   **浏览器**：推荐使用最新版的 Chrome 或 Edge 浏览器（需支持 WebUSB 功能）。\n\n> **提示**：本项目主要依赖网页端工具进行烧录，无需在本地电脑安装复杂的 Python 环境或 ESPHome CLI，但在首次通过 USB 更新分区表时可能需要物理连接。\n\n## 安装步骤\n\n### 1. 连接设备并初始化\n将你的开发板通过 USB 线连接至电脑。打开浏览器访问 **[ESPHome Web](https:\u002F\u002Fweb.esphome.io)**。\n\n*   点击页面上的 **\"+ NEW DEVICE\"** 按钮。\n*   按照向导提示，选择你的设备类型（如果列表中没有特定型号，通常选择通用的 ESP32 选项即可，后续会替换配置）。\n*   完成设备的命名并将其连接到你的 Wi-Fi 网络。\n\n### 2. 接管设备并配置代码\n设备上线后，在 ESPHome Web 界面中找到该设备：\n\n*   点击 **\"TAKE OVER\"**（接管）按钮以获取编辑权限。\n*   进入配置编辑页面，删除原有内容。\n*   前往 [xiaozhi-esphome 项目仓库](https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome)，根据你的硬件型号找到对应的配置文件代码（通常在 `devices\u002F` 目录下）。\n*   **复制**该代码并**粘贴**到编辑器中。\n    *   **注意**：请务必保留原配置中的 `name:` 字段（这是 ESPHome 识别设备的唯一标识），你可以自由修改 `friendly_name:` 以便在 Home Assistant 中显示友好的名称。\n\n### 3. 保存并安装固件\n*   点击 **\"SAVE\"** 保存配置。\n*   点击 **\"INSTALL\"** 开始安装。\n    *   **无线安装 (Wireless)**：如果设备已联网且分区表兼容，可直接选择无线安装。\n    *   **USB 安装 (Plug into this computer)**：如果无线安装失败，或系统提示需要更新分区表（通常发生在首次刷入时），请选择此项。保持 USB 连接，等待固件编译完成后，浏览器会弹出窗口请求权限，确认后通过 USB 直接刷入。\n    *   *注：分区表更新仅需第一次通过 USB 完成，后续升级均可无线进行。*\n\n等待设备安装完成并自动重启。\n\n## 基本使用\n\n固件运行成功后，设备将自动尝试连接 Home Assistant。\n\n1.  **发现设备**：\n    打开你的 **Home Assistant** 仪表盘，进入 **“设置” (Settings) > “设备与服务” (Devices & Services)**。你应该能看到一个新的待处理设备被发现。\n\n2.  **配置语音助手**：\n    *   点击 **“配置” (Configure)** 接受新设备。\n    *   系统将自动启动语音助手设置流程。按照屏幕提示完成麦克风、扬声器及唤醒词的测试与配置。\n\n3.  **开始对话**：\n    配置完成后，对着设备说出唤醒词（默认通常为“小智”或配置文件中设定的词汇），即可通过该硬件控制 Home Assistant 中的智能设备、查询状态或执行自动化场景。\n\n---\n*更多支持的硬件型号列表及购买链接，请参考项目原文档的 \"Supported Devices\" 和 \"Where to Buy\" 章节。*","智能家居爱好者小明购买了几款廉价的“小智”语音开发板（如 Spotpear Ball），希望将它们改造为卧室和客厅的 Home Assistant 语音卫星，实现全屋语音控制。\n\n### 没有 xiaozhi-esphome 时\n- **固件封闭难定制**：设备原厂固件功能固定，无法深度集成到 Home Assistant 生态中，只能作为独立孤岛运行。\n- **开发门槛极高**：若想自行开发适配代码，需从零编写复杂的 ESPHome 配置文件，包括音频驱动、Wi-Fi 配网及 API 对接，耗时数天。\n- **硬件兼容性差**：市面上众多基于 ESP32-S3 的廉价语音屏或开发板缺乏现成支持，买来后往往因缺少驱动代码而变成“砖头”。\n- **部署流程繁琐**：每次更新功能都需要手动编译固件并通过 USB 线刷写，无法实现远程无线升级（OTA），维护成本高昂。\n\n### 使用 xiaozhi-esphome 后\n- **无缝接入 HA**：直接套用预设配置，几分钟内即可将小智设备转化为 Home Assistant 的原生语音卫星，完美联动家中灯光与传感器。\n- **开箱即用体验**：项目内置了数十种热门开发板（如 Waveshare 屏幕、EchoEar 等）的驱动模板，无需懂底层代码，复制粘贴即可编译。\n- **广泛硬件支持**：无论是 DIY 面包板还是成品语音屏，都能通过该方案快速激活，让低成本硬件瞬间拥有高端智能音箱的能力。\n- **便捷无线维护**：首次烧录后，后续所有配置修改均可通过 Wi-Fi 无线推送，坐在沙发上即可完成全屋语音节点的迭代升级。\n\nxiaozhi-esphome 的核心价值在于打破了专用语音助手的硬件壁垒，让开发者能以极低的成本和零代码基础，将任意兼容的 ESP32 设备变身为强大的 Home Assistant 语音终端。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRealDeco_xiaozhi-esphome_ccd8a3af.jpg","RealDeco",null,"https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FRealDeco_04db2d39.png","https:\u002F\u002Fgithub.com\u002FRealDeco",[81],{"name":82,"color":77,"percentage":83},"Rich Text Format",100,692,105,"2026-04-06T20:29:25","MIT",4,"未说明","不需要 GPU",{"notes":92,"python":89,"dependencies":93},"该工具是用于将小智 AI 设备作为 ESPHome 语音助手卫星接入 Home Assistant 的固件项目，而非本地运行的 AI 模型。运行环境主要依赖支持 ESPHome Web 的现代浏览器（Windows\u002FmacOS\u002FLinux 均可）用于烧录固件，以及已部署的 Home Assistant 服务器。硬件端需要特定的 ESP32 开发板（如 Espressif EchoEar, Spotpear, Waveshare 等列表中的设备）。首次烧录可能需要通过 USB 连接电脑，后续更新支持无线进行。",[94,95],"ESPHome","Home Assistant",[21,18],"2026-03-27T02:49:30.150509","2026-04-07T09:50:18.421264",[100,105,110,115,120,125],{"id":101,"question_zh":102,"answer_zh":103,"source_url":104},21607,"在 ESP32-S3 设备上构建时屏幕显示时间错误或滚动过快，如何解决？","这通常是因为 ESPHome Docker 实例运行在 UTC 时区导致的。解决方法是在 Docker 环境变量中添加 TZ 变量（例如 `-e TZ=Asia\u002FShanghai`），设置正确的时区后，屏幕显示即可恢复正常。","https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome\u002Fissues\u002F85",{"id":106,"question_zh":107,"answer_zh":108,"source_url":109},21608,"编译或更新固件时出现随机错误（如归档失败或红色报错），该怎么办？","这类错误通常是 GitHub 服务器繁忙引起的临时性问题（\"GitHub burps\"），并非代码错误。解决方法是直接重试编译或更新操作，通常第二次就能成功。日志中出现的部分红色错误如果是关于启动声音与麦克风争夺音频设备的，通常在后续步骤会自动清除，无需担心。","https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome\u002Fissues\u002F207",{"id":111,"question_zh":112,"answer_zh":113,"source_url":114},21609,"设备编译成功后无法连接，提示\"Unable to connect to the ESPHome device\"或缺少 api 部分，如何排查？","首先确认 YAML 配置文件中确实包含了 `api:` 部分。如果配置无误但仍报错，建议尝试清理构建文件（clean build files）后重新编译和烧录。此外，确保设备通过 USB 正常烧录，并且 Home Assistant 是通过主机名发现设备而非直接 IP（尽管最终会解析为 IP）。如果问题依旧，可能是特定版本的环境问题，可等待一段时间后再试。","https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome\u002Fissues\u002F213",{"id":116,"question_zh":117,"answer_zh":118,"source_url":119},21610,"Waveshare 3.49 蓝色版本设备没有声音、不响应唤醒词且无法调节音量，如何解决？","如果遇到此类问题（日志显示 I2C 模块或驱动异常），首要步骤是清理所有的构建文件（clean build files），然后重新编译和烧录固件。这通常能解决因缓存或构建残留导致的硬件驱动初始化失败问题。","https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome\u002Fissues\u002F163",{"id":121,"question_zh":122,"answer_zh":123,"source_url":124},21611,"是否可以通过 Home Assistant 的服务调用在设备上动态显示图片？","是的，这是可行的。基本思路是：在自动化行动中动态生成兼容的图片并保存到定义好的路径和文件名，该路径和文件名需在 ESPHome 配置中指定。虽然具体实现可能需要深入代码或使用 LVGL 等图形库进行适配，但项目维护者确认了将功能移植到其他设备或通过替代方法显示的可行性。","https:\u002F\u002Fgithub.com\u002FRealDeco\u002Fxiaozhi-esphome\u002Fissues\u002F66",{"id":126,"question_zh":127,"answer_zh":128,"source_url":104},21612,"使用 ESPHome 在线构建失败，但下载项目后本地烧录却成功，是什么原因？","这种情况可能与在线构建环境的配置（如时区设置）或临时网络问题有关。如果在线构建报错但本地下载项目后使用 `esphome` 命令或 IDE 编译烧录正常，建议优先采用本地编译方式。同时检查是否因环境缺少特定变量（如 TZ）导致显示或逻辑异常。",[]]