用途
react-syntax-hooks-advanced 是一份关于 React 进阶 Hooks 的使用参考，重点覆盖 React 18 与 React 19 引入的高级 Hooks。文档以速查表、决策树、关键警告和代码示例的形式，帮助开发者判断在特定场景下应该使用哪个 Hook，以及哪些用法属于必须避免的错误做法。
主要能力
文档先以速查表列出各 Hook 的版本、用途与返回值，包括：
- useId（18+）：为可访问性生成 SSR 安全的唯一 ID，返回 string。
- useTransition（18+）：将状态更新标记为非阻塞，返回 [isPending, startTransition]。
- useDeferredValue（18+）：延迟昂贵的重新渲染，返回延迟后的值。
- useSyncExternalStore（18+）：订阅外部 store，返回 store 快照。
- useInsertionEffect（18+）：在 DOM 变更前注入样式，返回 void。
- useDebugValue（18+）：在 DevTools 中为自定义 Hook 添加标签，返回 void。
- use（19+）：读取 Promise（触发 Suspense）或按条件读取 context，返回对应值。
- useActionState（19+）：管理带 pending 标记的异步 action 状态，返回 [state, dispatch, isPending]。
- useOptimistic（19+）：在异步 action 期间显示乐观 UI，返回 [optimisticState, setOptimistic]。
- useFormStatus（19+）：读取父级表单提交状态，返回 {pending, data, method, action}。
文档还提供一棵决策树，按需求（唯一 ID、响应性、外部状态、样式注入、Promise 读取、条件 context、表单 action、乐观 UI、表单提交状态）指向相应 Hook。
使用方式
文档为每个 Hook 给出 TypeScript 示例代码，并附有具体约束说明。例如：
- useId：生成多个关联 ID 时应以 useId 作为前缀；同一页面运行多个 React 应用时应向根节点传入 identifierPrefix。
- useTransition：startTransition 会立即执行回调，变为可中断的是其中的状态更新；在异步 startTransition 中 await 之后的状态更新需要嵌套一次 startTransition；不要在 startTransition 中包裹受控文本输入的更新。
- useDeferredValue：应传入原始值或在渲染函数外创建的对象；React 19+ 新增可选的 initialValue 参数。
- useSyncExternalStore：subscribe 函数应声明在组件外或用 useCallback 包裹；getSnapshot 必须返回不可变数据，否则会导致无限重渲染。
- useInsertionEffect：仅面向 CSS-in-JS 库作者；其中不能调用 setState，ref 尚未挂载，SSR 期间不运行。
- useDebugValue：昂贵的格式化应传入 formatter 函数。
- use：不能在 try/catch 中调用，错误处理应使用 Error Boundary；promise 应在 Server Component 中创建并传给 Client Component，消费组件需用 Suspense 和 Error Boundary 包裹。
- useActionState：取代已废弃的 useFormState；多次 dispatch 会按顺序排队，每个接收上一个 action 的返回值；错误会取消所有排队 action 并触发最近的 Error Boundary。
- useOptimistic：setOptimistic 必须在 startTransition 或 Action prop 中调用；reducer 必须是纯函数。
- useFormStatus：从 react-dom 导入；必须在渲染 form 的子组件中调用；在 form 外或渲染 form 的同一组件中调用时 pending 始终为 false。
文档还列出关键警告，例如：绝不用 useId 生成列表 key；绝不在应用代码中使用 useInsertionEffect；绝不在渲染 form 的同一组件调用 useFormStatus；绝不在 try/catch 中调用 use()；绝不把受控文本输入更新包裹在 startTransition 中。
适用场景
该文档适用于需要处理 SSR 安全唯一 ID、非阻塞状态更新、昂贵渲染延迟、外部 store 订阅、CSS-in-JS 样式注入、Promise 读取与 Suspense、异步表单 action 状态、乐观 UI、表单提交状态读取等 React 进阶场景的开发者。
限制
文档未说明该技能的具体安装或集成步骤（安装命令暂未提供），也未提供收费、价格或平台信息。参考链接包括 references/examples.md、references/api-table.md、references/anti-patterns.md，以及 react.dev 上各 Hook 的官方文档地址。