-
内部样式表必须放在<head>里，不能塞进<body>；浏览器自上而下解析HTML，<style>置于<body>会导致样式延迟应用、FOUC闪屏或被忽略，W3C规范明确要求其属于元数据内容，仅允许出现在<head>中。
-
HTML本身不支持动画，手风琴平滑过渡必须用CSS的max-height+transition或JavaScript；因height:auto不可过渡，故max-height是最佳纯CSS方案，关键在设定合理临界值（如240px）并配合opacity和overflow:hidden实现流畅收展。
-
单选按钮组实现唯一选择需满足四点：name属性严格一致、value值合法且不重复、label正确关联提升可点击性、JS读取时判空处理；缺一不可。
-
DockerCompose是部署HermesAgent的首选方式，可规避Python环境冲突与依赖问题，提供基础单节点、生产持久化、WebUI集成、AppleSilicon适配及国产信创环境五种经实测验证的部署方案。
-
应根据线稿类型选择匹配的ControlNet控制模式并优化参数：Canny适用于高对比度线稿，需调节阈值与启用GuessMode；Lineart适合手绘稿，应选lineart_realistic、设权重0.85并开启PixelPerfect；复杂场景可叠加Lineart、Canny、Depth三单元协同控制；预处理分辨率须与上传图及输出尺寸严格一致。
-
align-items-stretch在.row上无效是因为Bootstrap4的.row默认display:block，非Flex容器；需手动加d-flex类或升级至Bootstrap5并确保display未被覆盖。
-
RytrAI本身不支持图表生成，需通过导出文本至可视化工具、API桥接前端渲染、结合NotionAI与Charticulator、或生成Markdown嵌入ObservableNotebook四条路径实现交互式图表。
-
ClawBot本身不能直接翻译英文文章，需结合浏览器翻译功能、在线API或Python脚本实现：一、用Chrome等浏览器右键“翻译成中文”；二、ClawBot提取文本后送入DeepL/GoogleTranslate；三、CLI导出文本+Python调用NLLB模型本地翻译。
-
defer属性仅对外部脚本（含src属性）生效，执行于DOM构建完成之后、DOMContentLoaded事件触发之前，且按HTML顺序依次执行。
-
Double.isNaN仅检测结果是否为NaN，不捕获计算异常；典型NaN来源包括0.0/0.0、Math.sqrt(-1.0)等；需配合Double.isInfinite判断无穷大，并注意Double包装类null导致NPE。
-
必须在任何I/O操作前设置Header与超时：先setConnectTimeout/setReadTimeout（单位毫秒），再setRequestProperty/addRequestProperty（中文值需URLEncoder编码），最后调用getInputStream等；顺序错乱将导致配置失效或抛异常。
-
即梦AI视频添加字幕有四种方法：一、启用“AI对口型”自动生成同步字幕；二、用“智能画布”手动添加可动画文字图层；三、通过“故事模式”按语义分镜生成双语字幕；四、导出后用“即梦星号”工具校准并烧录SRT字幕。
-
在Go中重命名文件无需预先打开文件；若因业务需要必须先读写文件，则应显式关闭再重命名，避免defer重复关闭或重命名失败——关键在于合理安排Close()调用时机，而非绕弯封装。在Go中重命名文件无需预先打开文件；若因业务需要必须先读写文件，则应显式关闭再重命名，避免defer重复关闭或重命名失败——关键在于合理安排Close()调用时机，而非绕弯封装。Go的os.Rename()是一个纯路径操作函数，它仅接收两个字符串参数（
-
RLock允许同一线程多次acquire，Lock不行；RLock内部维护线程ID和计数器，支持递归调用，但不可用于跨线程等待，也不能与Lock混用acquire/release。
-
使用zap实现结构化日志，支持多通道输出至控制台、文件及远程服务，结合lumberjack实现日志轮转，通过request_id实现上下文追踪，提升系统可观测性。
