https://synodriver.github.io/tags/asyncio/Recent content in Asyncio on syno blogHugolocaleFri, 05 Jun 2026 00:41:47 +0800https://synodriver.github.io/post/homeassistant_architecture/Fri, 05 Jun 2026 00:41:47 +0800https://synodriver.github.io/post/homeassistant_architecture/<h1 id="home-assistant-核心架构与实现深度解析">Home Assistant 核心架构与实现深度解析</h1> <blockquote> <p>基于源码版本 2026.7.0.dev0，Python 3.14.2+</p> </blockquote> <h2 id="目录">目录</h2> <ul> <li><a href="#1-%E9%A1%B9%E7%9B%AE%E6%80%BB%E4%BD%93%E7%BB%93%E6%9E%84">1. 项目总体结构</a></li> <li><a href="#2-%E6%A0%B8%E5%BF%83%E7%B1%BB%E4%B8%8E%E5%9F%BA%E7%B1%BB%E4%BD%93%E7%B3%BB">2. 核心类与基类体系</a></li> <li><a href="#3-%E5%90%AF%E5%8A%A8%E6%B5%81%E7%A8%8B%E8%AF%A6%E8%A7%A3">3. 启动流程详解</a></li> <li><a href="#4-%E9%9B%86%E6%88%90%E5%8A%A0%E8%BD%BD%E6%9C%BA%E5%88%B6">4. 集成加载机制</a></li> <li><a href="#5-%E9%85%8D%E7%BD%AE%E6%B5%81configflow%E6%9C%BA%E5%88%B6">5. 配置流(ConfigFlow)机制</a></li> <li><a href="#6-%E5%AE%9E%E4%BD%93entity%E4%BD%93%E7%B3%BB">6. 实体(Entity)体系</a></li> <li><a href="#7-%E6%9C%8D%E5%8A%A1service%E6%9C%BA%E5%88%B6">7. 服务(Service)机制</a></li> <li><a href="#8-%E5%B9%B3%E5%8F%B0platform%E4%B8%8E-entitycomponent-%E7%BC%96%E6%8E%92">8. 平台(Platform)与 EntityComponent 编排</a></li> <li><a href="#9-%E9%9B%86%E6%88%90%E5%AE%9E%E7%8E%B0%E5%AE%8C%E6%95%B4%E7%A4%BA%E4%BE%8Bhue">9. 集成实现完整示例：Hue</a></li> <li><a href="#10-%E5%A6%82%E4%BD%95%E5%AE%9E%E7%8E%B0%E8%87%AA%E5%B7%B1%E7%9A%84%E9%9B%86%E6%88%90">10. 如何实现自己的集成</a></li> <li><a href="#11-%E5%85%B3%E9%94%AE%E8%AE%BE%E8%AE%A1%E6%A8%A1%E5%BC%8F%E6%80%BB%E7%BB%93">11. 关键设计模式总结</a></li> </ul> <hr> <h2 id="1-项目总体结构">1. 项目总体结构</h2> <h3 id="11-顶层目录">1.1 顶层目录</h3> <div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt"> 1 </span><span class="lnt"> 2 </span><span class="lnt"> 3 </span><span class="lnt"> 4 </span><span class="lnt"> 5 </span><span class="lnt"> 6 </span><span class="lnt"> 7 </span><span class="lnt"> 8 </span><span class="lnt"> 9 </span><span class="lnt">10 </span><span class="lnt">11 </span><span class="lnt">12 </span><span class="lnt">13 </span><span class="lnt">14 </span><span class="lnt">15 </span><span class="lnt">16 </span><span class="lnt">17 </span><span class="lnt">18 </span><span class="lnt">19 </span><span class="lnt">20 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-gdscript3" data-lang="gdscript3"><span class="line"><span class="cl"><span class="n">E</span><span class="p">:</span>\<span class="n">pyproject</span>\<span class="n">core</span>\ </span></span><span class="line"><span class="cl"><span class="err">├──</span> <span class="n">homeassistant</span><span class="o">/</span> <span class="c1"># 核心源代码主目录</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">core</span><span class="o">.</span><span class="n">py</span> <span class="c1"># HomeAssistant 主类、EventBus、StateMachine、ServiceRegistry</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">config_entries</span><span class="o">.</span><span class="n">py</span> <span class="c1"># ConfigEntry、ConfigFlow、ConfigEntries 管理器</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">bootstrap</span><span class="o">.</span><span class="n">py</span> <span class="c1"># 启动引导，分阶段加载</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">loader</span><span class="o">.</span><span class="n">py</span> <span class="c1"># Integration 类，manifest 解析，自定义集成管理</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">setup</span><span class="o">.</span><span class="n">py</span> <span class="c1"># async_setup_component，依赖解析</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">data_entry_flow</span><span class="o">.</span><span class="n">py</span> <span class="c1"># FlowHandler/FlowManager 基类</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">config</span><span class="o">.</span><span class="n">py</span> <span class="c1"># 配置文件处理</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="k">const</span><span class="o">.</span><span class="n">py</span> <span class="c1"># 全局常量、Platform 枚举</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">runner</span><span class="o">.</span><span class="n">py</span> <span class="c1"># 运行器，事件循环设置</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">__main__</span><span class="o">.</span><span class="n">py</span> <span class="c1"># CLI 入口</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">auth</span><span class="o">/</span> <span class="c1"># 认证系统</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">components</span><span class="o">/</span> <span class="c1"># 所有内置集成（2000+个）</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">generated</span><span class="o">/</span> <span class="c1"># 自动生成的代码（蓝牙、DHCP、SSDP 数据等）</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">├──</span> <span class="n">helpers</span><span class="o">/</span> <span class="c1"># 辅助模块（entity、entity_registry、template 等）</span> </span></span><span class="line"><span class="cl"><span class="err">│</span> <span class="err">└──</span> <span class="n">util</span><span class="o">/</span> <span class="c1"># 工具模块</span> </span></span><span class="line"><span class="cl"><span class="err">├──</span> <span class="n">tests</span><span class="o">/</span> <span class="c1"># 测试代码</span> </span></span><span class="line"><span class="cl"><span class="err">├──</span> <span class="n">custom_components</span><span class="o">/</span> <span class="c1"># 自定义集成目录</span> </span></span><span class="line"><span class="cl"><span class="err">└──</span> <span class="n">pyproject</span><span class="o">.</span><span class="n">toml</span> <span class="c1"># 项目配置</span> </span></span></code></pre></td></tr></table> </div> </div><h3 id="12-集成组织方式">1.2 集成组织方式</h3> <p>所有集成都以子目录形式存放在 <code>homeassistant/components/</code> 下，目录名即域名。每个集成至少包含：</p>https://synodriver.github.io/post/async_bugs/Sat, 25 Apr 2026 03:11:51 +0800https://synodriver.github.io/post/async_bugs/<h1 id="异步三坑">异步三坑</h1> <h3 id="1-论cancel">1. 论cancel</h3> <p><em>asyncio.CancelledError</em> 简直是神出鬼没，任何await的地方都可能冒出来，对他们的恰当处理是重中之重</p> <h3 id="2-论future">2. 论Future</h3> <p><em>Future.set_result()</em> 和 <em>Future.set_exception()</em> 这两个方法是Future的核心，然而，调用的时候是否判断了他的状态？ 如果Future已经完成了，再调用<em>set_result()<em>或者</em>set_exception()</em>，就会抛出<em>InvalidStateError</em>， 与上一个坑结合起来，<em>await future</em>的时候被cancel了，抛出CancelledError，future的状态已经是cancelled，这时候就不能再对future搞事了。</p>