docs: 明确 AgentRun 分页总数口径

2026-07-16 08:57:40 +02:00
parent e14e4a19fa
commit c84501fb16
1 changed files with 3 additions and 0 deletions
@@ -46,6 +46,9 @@ bun tools/hwlab-cli/bin/hwlab-cli.ts client agent-observer list --page 2 --page-
  - `page`、`pageSize`、`total`、`totalPages` 和 `hasNextPage` 必须可见；
  - `items` 直接来自 AgentRun durable run、最新 command 和最新 runner job；
  - `taskId`、中文标题、workspace、lane、Agent/Profile、attempt、runner 和错误字段不得依赖 Kafka 历史 envelope 猜测；
+  - `total` 只表示 owning YAML 选中 manager 的 durable run 总数：
+    - 不得用旧 Kafka retention replay 的去重投影数作为预期总数；
+    - 不得把其他 lane 的历史投影混入当前 release 列表；
 - Web 首屏先读取同一分页快照，再连接 `hwlab.event.v1` live 流；
 - Kafka retention replay 只用于显式事件历史下钻，不得阻塞列表首屏；
 - 验收 Artificer 时使用中文标题搜索，并确认对应 `sessionId` 使用 `sess_artificer_` 前缀；