# 运行历史查询规则

两列表都要求路径工作区与X-Workspace-ID一致。ID不能是空字符串，不能有首尾空白、超过128字节或含斜线/反斜线；任务路径ID不等于运行ID。

| 条件 | 已核实现 |
| --- | --- |
| 任务范围 | 由任务历史路径的automation_task_id给出；工作区列表不读取同名query参数。 |
| 状态 | queued、running、input_required、pending_approval、succeeded、failed、canceled、expired；非空无效值400。 |
| 时间 | created_at>=created_from且created_at<created_to；RFC3339并按URL编码保留时区偏移。 |
| 区间顺序 | 当前未单独检查from<to；倒置/相等区间不能当参数校验成功的业务证明。 |
| 页大小 | 普通常规输入下，省略/0/负值默认50，大于200封顶200。 |
| 偏移 | 省略默认0、负数归0；不是cursor。 |
| 排序 | created_at降序、id升序；运行事件则是时间正序，不混用。 |
| 未匹配 | items=[]、total=0。任务路径不先验证父任务存在，未匹配也可200。 |

整数转换的错误当前未被handler检查。普通非整数字符串可能归零，但溢出依赖Go整型转换结果，不能统一承诺所有无效数字都归默认值或都400；正式调用只传范围内整数。未知query参数不形成筛选。

按生效offset+limit继续分页，以空页或达到total停止；即使某页少于limit也不要仅凭页条数推全量结束。并发写入/状态变化时，按运行ID去重并根据业务窗口重新核对；这不是固定快照查询。
