用途：在实现、审查、调试或升级 htmx 应用时使用。接触既有代码先看迁移说明，再按任务打开对应主题参考。
主要能力与主题：迁移与配置（扩展打包、发行构建、已移除 API、Shadow DOM、维护策略）；事件与 JavaScript（触发源与过滤器、轮询、异步确认、继承）；历史与缓存（历史恢复、快照安全、缓存变体与绕过）；请求与校验（请求默认值、URL 校验、CORS、表单校验、boosted CSRF 令牌）；交换与响应（滚动、字面文本、带外内容、状态处理、重定向）；扩展与安全（CSP nonce、属性变更、URL 参数、JSON 表单）。
必要用法要点：扩展不再与核心包共享版本号，需独立审计并升级，SSE 扩展需升级，已移除的 hx-sse、hx-ws 属性由对应扩展提供的属性替代。按模块系统加载构建：浏览器脚本 /dist/htmx.js，ESM /dist/htmx.esm.js，AMD /dist/htmx.amd.js，CommonJS /dist/htmx.cjs.js；ESM 有默认导出：import htmx from "htmx.org/dist/htmx.esm.js";。默认值变更：请求默认仅同源，DELETE 值用 URL 参数，交换滚动为即时；如需旧行为可设置 htmx.config.methodsThatUseUrlParams = ["get"];、htmx.config.selfRequestsOnly = false;、htmx.config.scrollBehavior = "smooth";。跨源需显式 htmx:validateUrl 允许列表并配置 CORS。已移除 API：每个内联处理器用一个 hx-on:<event> 属性，多事件 hx-on 形式已移除；用公开 htmx.swap() 替代已移除的内部 selectAndSwap()。
适用场景：htmx 应用的升级迁移、请求与响应行为调优、历史缓存安全、扩展选择与安全加固。
限制：资料未提供具体版本号、价格、平台支持范围或效果数据；部分配置项与扩展的完整参数、兼容性细节暂未提供。