codex分页响应必须采用data+pagination双字段顶层结构，data为纯净业务数组，pagination含page、limit、total、pages四字段且total须来自数据库count。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex设计分页查询的返回结构需明确区分数据主体与分页元信息，避免将total、page、limit等字段混入data数组内部，否则前端解析时会因结构不一致导致渲染错误或空列表。
定义顶层响应结构
返回对象必须包含data、pagination两个一级字段。data为数组类型，仅承载当前页业务数据；pagination为对象，封装分页控制参数。
这一步不可跳过——若把page、total直接挂在根层级（如{ "page": 1, "total": 120, "items": [...] }），后续增加status、message等通用字段时会破坏接口契约稳定性。
填充pagination对象字段
pagination对象必须包含以下四个字段：
• page：当前页码，从1开始计数；
• limit：每页条数，与请求参数一致；
• total：符合条件的总记录数，非当前页长度；
• pages：总页数，由total和limit向上取整计算得出（Math.ceil(total / limit)）。
【total必须是真实数据库COUNT结果，不能用data.length估算】 否则在limit=10、实际查出8条时，前端会误判为最后一页而禁用下一页按钮。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
组织data数组内容
data数组中每个元素为纯净业务对象，字段与数据库行或领域模型严格对齐，不额外添加index、isLast等渲染辅助字段。
例如用户列表接口，data应为[ { "id": 101, "name": "张三", "email": "zhang@example.com" }, ... ]，而非[ { "index": 0, "item": { ... } } ]。
这一步操作起来很简单，直接把查询结果映射成POJO列表后赋值给data字段即可。
处理边界情况的返回示例
方法一：空数据页返回空数组+有效pagination
{ "data": [], "pagination": { "page": 5, "limit": 20, "total": 83, "pages": 5 } }
方法二：total为0时pages必须为0
{ "data": [], "pagination": { "page": 1, "limit": 10, "total": 0, "pages": 0 } }
方法三：page超出pages范围时，仍返回空data，但pagination中page保持原请求值（不自动修正），由调用方自行校验。
