用途：nuqs 是 React 的类型安全 URL 查询参数状态管理方案，可作为 React.useState 的替代，把组件状态与 URL 查询参数保持同步，适合需要可分享、可刷新保留的筛选、搜索、分页等界面状态。
主要能力：提供 useQueryState（单参数读写）与 useQueryStates（多参数批量同步）两个核心 Hook；内置解析器包括 parseAsString、parseAsInteger、parseAsBoolean、parseAsArrayOf 等，并支持用 createParser 自定义解析器；可配置 history、shallow、scroll、throttle、debounce、clearOnDefault、startTransition 等选项；服务端侧提供 createLoader、createSearchParamsCache 进行解析；工具函数包括 createSerializer、createStandardSchemaV1、inferParserType。
使用方式：资料以技能参考目录组织，按任务映射到 hooks、parsers、options、server、utilities、limits 等分类，先查对应分类的 README.md 定位页面，再读取具体 .md 获取细节；samples 目录提供基础查询状态、带解析器的类型化状态、多参数批量更新、搜索筛选防抖、服务端解析、搜索参数缓存、适配器设置、自定义解析器、URL 键重映射、数组参数、测试等示例；scripts 目录涉及安装、设置、测试与调试步骤。
适用场景：React / Next.js 应用中需要把 UI 状态反映到 URL 查询参数、并保证类型安全的场景。
限制：资料未提供具体安装命令、版本要求、收费与价格、性能数据及平台兼容性细节，这些内容暂未提供；URL 长度与浏览器限制相关说明位于 limits 分类，需查阅对应页面。