AionClaw需对接支持标准分页参数（page、pageSize）及动态筛选的后端接口，通过「数字专家」配置API列表处理器，绑定分页与筛选逻辑，并注入分页控件实现无刷新数据加载与实时联动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让AionClaw对接后端列表接口时，既能按页加载数据，又能根据关键词、状态等条件动态筛选，避免前端手动拼接URL或反复刷新页面。
确认接口是否支持标准分页参数
在浏览器地址栏或Postman中访问目标接口，例如https://api.example.com/v1/items，手动追加?page=1&pageSize=10并发送请求。观察返回数据结构中是否包含data数组和pagination或total字段。若返回400错误或无分页信息，说明该接口未启用分页逻辑，需先联系后端补全DRF的PageNumberPagination配置或Koa/Express中间件。
这一步不能跳过——AionClaw所有自动化分页行为都依赖接口原生响应中的total或count值来计算总页数，它不会自己去请求全部数据再本地切片。
用「数字专家」绑定分页与筛选逻辑
第一步：创建新专家
点击左侧导航栏「数字专家」→「新建专家」→ 选择「API列表处理器」模板。
第二步：配置基础请求
在「请求设置」中填入完整接口URL；HTTP方法选GET；勾选「启用分页」→ 自动展开分页配置区 → 将页码参数名设为page，每页条数参数名设为pageSize；【必须确保这两个字段名与接口文档完全一致，大小写敏感】。
第三步：添加筛选条件
点击「+ 添加筛选项」→ 输入字段名（如status）、类型（下拉选“字符串”或“数字”）、默认值（如active）；可重复添加多个筛选项，AionClaw会自动拼接为&status=active&category=web格式。
第四步：启用实时联动
开启「筛选变更时自动刷新列表」开关。此时只要在专家面板中修改任一筛选下拉值，AionClaw就会立即重发带新参数的请求，并复用上一步的分页上下文（例如当前在第3页，筛选后仍从第3页开始加载）。
在网页中注入分页控件（无需后端改代码）
方法一：使用内置分页器技能
打开含列表的网页 → 点击右上角「技能市场」→ 搜索“网页分页增强”→ 安装并启用 → 返回页面，按下Cmd+Shift+P（Mac）或Ctrl+Shift+P（Win）唤出命令面板 → 输入“插入分页控件”→ 回车执行。它会在列表底部自动插入带页码跳转、每页数量切换的UI，所有请求均由AionClaw代理发出，不暴露真实接口地址。
方法二：手动注入JS脚本（适合调试）
按F12打开DevTools → 切换到Console → 粘贴以下代码并回车：
fetch("https://api.example.com/v1/items?page=1&pageSize=10").then(r => r.json()).then(d => { const container = document.querySelector(".list-container"); container.innerHTML = d.data.map(i => `<div>${i.title}</div>`).join(""); });
注意：此方式需你自行替换URL和DOM选择器，且不带错误处理，仅用于快速验证接口可用性。
处理筛选后总页数变化的边界情况
当用户选择一个极窄的筛选条件（如status=canceled），可能导致返回数据量骤减，原第5页变成无效页码。AionClaw默认行为是：收到404或空数组响应时，自动将当前页码重置为1并重新请求。你可以在「数字专家」的「高级设置」中关闭该自动重置，改为显示“无匹配结果”提示。
若后端返回的total字段未随筛选参数动态更新（例如始终返回全量总数），则必须在专家配置中勾选「忽略接口total，由AionClaw动态计算」——它会根据本次响应的data.length和pageSize反推真实页数，但要求后端至少返回data数组和pageSize值。
