nuqs

用途：本技能为 nuqs（类型安全的 URL 查询状态）提供社区最佳实践，适用于在 Next.js、React Router、TanStack Router、Remix 及纯 React 中实现、审查或重构基于 URL 的状态代码，涵盖 nuqs v2.5–v2.9。主要能力：内容按 8 个类别、39 条规则组织，并按影响优先级排列——解析器配置（CRITICAL，如类型化解析器、withDefault、枚举校验、数组格式、JSON 校验、日期格式、parseAsIndex）、适配器与初始化（CRITICAL，如 NuqsAdapter 包裹应用、use client 指令、从 nuqs/server 导入服务端工具、Next.js 版本兼容、共享解析器文件、应用级默认选项）、状态管理（HIGH，如 useQueryStates、用 null 清除参数、用 withOptions 继承配置、Standard Schema 跨库校验）、服务端集成（HIGH，如 createSearchParamsCache、shallow:false、useTransition、parse 先于 get、Next.js 15+ 异步 searchParams）、性能优化（MEDIUM，如 limitUrlUpdates 节流与防抖、clearOnDefault、键隔离、createSerializer）、历史与导航、调试与测试、高级模式（自定义解析器、urlKeys、eq 函数、框架适配器、processUrlSearchParams）。使用方式：按需查阅对应参考文件（如 AGENTS.md 为完整汇编、references/_sections.md 为类别定义、assets/templates/_template.md 为规则模板、metadata.json 为版本信息），在具体规则文件中查看详细说明与代码示例。限制：资料未提供具体命令、安装方式、收费或价格信息；不同特性有版本要求（v2.5+、v2.6+），需注意兼容性。