在hey-api/openapi-ts项目中实现自定义分页参数配置

当开发者使用hey-api/openapi-ts项目中的react-query插件时，可能会遇到API分页参数与默认配置不匹配的情况。例如某些API采用nextToken而非传统page/offset参数实现分页，此时需要手动配置分页参数识别规则。

该项目的分页配置模块提供了灵活的解决方案。通过项目配置文件，开发者可以自定义分页参数的识别方式。对于使用nextToken的API，只需在配置中明确指定该参数作为分页标识即可。

实现原理上，该配置系统会：

1. 解析开发者提供的分页参数映射规则
2. 在生成react-query查询代码时自动应用这些规则
3. 确保无限查询(infinite query)能正确识别和使用自定义分页参数

典型配置示例应包含：

• 分页参数名称映射（如将nextToken映射为标准分页参数）
• 响应数据结构中分页标记的路径定义
• 分页参数在请求中的传递方式声明

这种设计既保持了插件的开箱即用性，又为特殊分页逻辑提供了扩展能力。开发者无需修改核心代码，仅通过声明式配置即可适配各类分页API规范。

对于更复杂的分页场景，建议：

1. 仔细检查API文档确定分页参数传递机制
2. 在配置中完整定义请求参数和响应字段的对应关系
3. 必要时可组合多个分页参数实现复合分页逻辑

该方案已在实际项目中验证可行性，能有效解决包括token-based分页在内的各类分页场景适配问题。