用途：为使用 nuqs（类型安全的 URL 查询状态库）的项目提供最佳实践参考，适用于编写、审查或重构代码时，在 Next.js、React Router、TanStack Router、Remix 及纯 React 中实现基于 URL 的状态管理。
主要能力：按优先级组织 8 类共 39 条规则。解析器配置（CRITICAL）：使用类型化解析器、withDefault、枚举校验、数组格式、JSON 校验、日期格式、parseAsIndex。适配器与初始化（CRITICAL）：NuqsAdapter 包裹应用、hooks 加 'use client'、从 nuqs/server 导入服务端工具、Next.js 版本兼容、共享解析器文件、NuqsAdapter 全局默认选项（v2.5+）。状态管理（HIGH）：useQueryStates、用 null 清除参数、避免派生状态、withOptions、setter 返回值、Standard Schema 跨库校验（v2.5+）。服务端集成（HIGH）：createSearchParamsCache 或 createLoader、shallow:false、useTransition、先 parse() 后 get()、Next.js 15+ 异步 searchParams。性能优化（MEDIUM）：limitUrlUpdates 节流、搜索防抖、clearOnDefault、记忆化组件、key 隔离（v2.5+）、createSerializer。历史与导航（MEDIUM）：history:push 与 replace、滚动行为。调试与测试（LOW-MEDIUM）：调试日志、URL 状态组件测试。高级模式（LOW）：自定义解析器、urlKeys、eq 函数、框架适配器、processUrlSearchParams（v2.6+）。
使用方式：按需阅读各参考文件获取详细说明与代码示例，包括 compiled.md（完整规则合集）、references/_sections.md（分类定义）、assets/templates/_template.md（新增规则模板）、metadata.json（版本信息）。
适用场景：实现 URL 状态、项目初始化、解析器配置、与服务端组件集成、优化 URL 更新性能、通过 Standard Schema 与 tRPC/TanStack Router/表单共享解析器、排查 nuqs 问题。
限制：资料未提供具体安装命令、收费与价格信息；与 ahooks-v3（分组/本地状态）和 tanstack-query-v5（异步服务端数据）互补，状态选择原则为：可分享的 UI 状态用 nuqs，分组临时 UI 用 ahooks，异步数据用 TanStack Query。