delegatesfocus必须在attachshadow时声明，因它是创建shadow root的一次性配置，创建后不可读写；后期赋值或重attach均无效。
必须在 attachShadow 时声明 delegatesFocus: true，否则无法生效；它不是开关，而是创建 shadow root 的一次性配置。
为什么 delegatesFocus 不能后期启用或修改
浏览器在调用 attachShadow() 时就锁定了焦点委托行为。一旦 shadow root 创建完成，delegatesFocus 就不可读、不可写，也不存在类似 shadowRoot.delegatesFocus = true 的赋值语法。试图在 connectedCallback 或其他生命周期中补设，只会被忽略。
常见错误现象：
- 组件已渲染，手动执行
host.shadowRoot.delegatesFocus = true—— 控制台无报错但无效果 - 先用
{ mode: 'open' }创建 shadow，再尝试重 attach —— 报错Failed to execute 'attachShadow' on 'Element': Shadow root has already been attached
正确做法：
- 确保首次 attach 时传入完整选项：
host.attachShadow({ mode: 'open', delegatesFocus: true }) - 若使用 React +
ReactShadow，需显式传参：<shadowroot delegatesfocus="{true}"></shadowroot> - 自定义元素构造函数中，
attachShadow必须是第一个 DOM 操作，避免被其他逻辑干扰
delegatesFocus 触发聚焦的条件和限制
开启后，外部点击或 Tab 导航能“穿透” shadow boundary 聚焦内部元素，但有明确前提：
- shadow 内必须存在至少一个可聚焦元素：原生
<input>、<button></button>、或带tabindex="0"的元素（tabindex="-1"不行） - 该元素不能被
disabled或hidden属性禁用 - 多个可聚焦元素共存时，浏览器按 DOM 顺序取第一个（非
autofocus元素）；不要依赖autofocus实现委托逻辑 - 不适用于
<input type="file">等受 UA 严格控制的元素，其内部 shadow 已固化，脚本无法干预
性能影响极小 —— 浏览器原生实现，无额外 JS 开销；但若 shadow 内部焦点逻辑复杂（如频繁同步宿主状态），需注意事件监听粒度。
Gateway Restart Profiler
下载
OpenClaw Gateway 重启性能分析工具：分析重启速度、定位启动慢原因、生成性能报告、诊断启动问题。支持 Windows (PowerShell) 与 Linux (Bash)。触发场景：分析 gateway 重启、检查启动时间、生成报告、诊断异常。
如何让宿主响应内部聚焦状态变化
delegatesFocus 只解决“能否聚焦”，不解决“是否感知聚焦”。宿主元素默认不会触发 focus 或 blur 事件，因为事件不穿透 shadow boundary。
必须手动桥接：
- 在 shadow 内部
<input>上监听focus和blur，而非宿主元素 - 在事件处理器中调用
this.setAttribute('focused', '')或this.toggleAttribute('focused')更新宿主属性 - 用 CSS
:host([focused])控制视觉反馈（如 outline、box-shadow），避免仅靠:focus-within—— 它在 shadow 中行为不稳定 - 禁止使用
focusin/focusout捕获宿主事件：它们不冒泡出 shadow boundary，永远收不到
示例关键片段：
const input = shadowRoot.querySelector('input');
input.addEventListener('focus', () => this.setAttribute('focused', ''));
input.addEventListener('blur', () => this.removeAttribute('focused'));
哪些场景下必须启用 delegatesFocus
不是所有 shadow 组件都需要它。重点看是否模拟原生表单控件行为：
- 自定义
<my-input></my-input>、<my-select></my-select>、<my-datepicker></my-datepicker>—— 必开，否则键盘用户 Tab 到组件即中断 - 带操作按钮的容器（如搜索框右侧清空图标）—— 必开，否则点击空白区无法聚焦输入框
- 模态框、下拉菜单、工具提示等浮层组件 —— 必开，否则键盘无法进入内容区，违反 WCAG 2.1 2.1.1 键盘可操作要求
- 纯展示型组件（如
<my-card></my-card>、<my-avatar></my-avatar>）—— 可不开，除非内部含可交互子元素且需统一焦点入口
容易被忽略的点：当组件同时支持鼠标点击和键盘 Tab 进入时，delegatesFocus 是唯一能让两者行为一致的机制；手动调用 input.focus() 会破坏 Tab 顺序，且屏幕阅读器无法识别上下文。
