-
role="timer"仅提供语义标注，不触发自动播报；必须配合aria-live="polite"（推荐）才能使屏幕阅读器播报倒计时变化，且需直接作用于动态文本元素，整段更新textContent，暂停时设aria-busy="true"，iOS需降级使用aria-label或aria-valuenow兜底。
-
getFacadeAccessor()必须返回服务容器中绑定时使用的键名（如'sms.service'或SmsService::class），而非类名或命名空间；该字符串需与singleton()或bind()的第一个参数严格一致，大小写、空格、标点均不能出错。
-
实现卡片背景渐变过渡需设置基础渐变背景，使用linear-gradient定义初始颜色并配置background-size与background-repeat；通过transition设定过渡动画；在:hover状态改变渐变方向或颜色，保持语法一致以避免跳变；优化transition时间和缓动函数为ease-in-out，并配合box-shadow变化增强视觉反馈，最终实现平滑自然的渐变效果。
-
可通过CustomEvent配合dynamicimport实现模块按需懒加载：1.点击等交互时dispatch带参数的自定义事件；2.全局监听并import()加载，用Map缓存避免重复；3.懒加载模块导出init等方法，不自动执行副作用；4.可结合IntersectionObserver自动触发。
-
HTML表单不支持长轮询，因其默认短连接提交机制与长轮询需持续持有连接的特性冲突；正确做法是禁用默认提交，提取表单数据后用fetch+AbortController手动实现循环请求。
-
手动定义serialVersionUID可确保序列化兼容性，避免因类结构变化导致反序列化失败。Java默认生成的ID依赖类名、字段等信息，编译环境或代码微小改动均使其改变，易引发InvalidClassException。显式声明后，可在兼容性变更时主动控制ID更新，保留原ID则允许旧版本读取新对象，提升系统稳定性。同时减少运行时反射计算开销，增强代码可读性与维护性。IDE通常提示添加，建议所有可序列化类均显式定义该字段，成本低且能有效防止分布式或持久化场景下的数据兼容问题。
-
HTML弹窗被拦截时浏览器静默失效，不抛错、不返回失败值、不触发回调；需在用户手势上下文（如click事件）中同步调用window.open()，或采用预留窗口（'about:blank'）再导航的合规方案。
-
Semaphore在低代码中不参与Java→JSON转换，仅限流并发转换任务；典型用于批量导出、嵌套序列化、脚本沙箱执行；应单例托管、acquire/release配对、避免脚本内操作。
-
Arrays.asList返回的列表是原数组的视图，非独立副本，不支持增删操作，修改会同步到原数组。
-
若OpenClaw与Notion数据库联动失败，原因可能为API权限未授、凭证未配、数据库未连或ToolProfile受限；可通过官方API双向同步、Webhook事件驱动、RSS反向拉取、Python脚本手动同步、Zapier无代码自动化五种路径解决。
-
Go1.6的goinstall命令在交叉编译时会自动将二进制文件放入$GOPATH/bin/<os>_<arch>/子目录（如linux_386），无法通过内置参数更改；需改用gobuild-o显式指定输出路径，实现跨平台编译与本地编译统一部署到$GOPATH/bin/。Go1.6的`goinstall`命令在交叉编译时会自动将二进制文件放入`$GOPATH/bin/_/`子目录（如`lin
-
background-color和color需分别设置transition并在:hover中显式声明目标值才能联动过渡；纯CSS无法实时反色，可用HSL变量+calc()模拟亮度互补，复杂场景需JavaScript计算对比度并动态设色。
-
execute()提交Runnable时异常会直接穿透至线程层面，触发默认UncaughtExceptionHandler打印堆栈并终止工作线程，线程池随后新建线程补位；因Runnable.run()不支持throws，unchecked异常未捕获即导致线程立即终止，这是ThreadPoolExecutor的主动设计而非bug。
-
-webkit-tap-highlight-color:transparent仅对可点击且可聚焦的元素自身生效，不继承、不全局作用；需显式写在目标节点（如button、[role="button"]）上，并确保viewport正确、语义完整，AndroidChrome62+已不支持。
-
嵌套字典是轻量级Trie实现，用dict键存字符、值为子节点，以'END'标记单词结尾；需注意键类型、终止标识设计、避免可变默认参数、空字符串处理及重叠前缀路径复用。
