用单个 field 描述 URL key、decode、默认值、写回和相等性语义。

URL search params 的难点不是写入，而是把 URL 中的原始字符串安全地解析为业务值。

Search Fields 既描述 URL 字段，也推导出 values 类型，让 hook、codec 和业务代码共享同一份约束。

更新 URL 时只处理传入字段，保留 base 中未触碰的参数，适合筛选器和分页状态。

在 React Router 应用中把 search state 暴露为 hooks，并支持 optimistic URL update。

读取旧链接中的 legacy key，写回时统一使用 canonical key，帮助 URL 字段平滑演进。