docs: 更新 AgentRun 分页快照验收
Pipelines as Code CI / hwlab-web-probe-sentinel-nc01- Success
Pipelines as Code CI / platform-infra-gitea-nc01- Success
Pipelines as Code CI / unidesk-host- Success

This commit is contained in:
Codex
2026-07-16 07:49:43 +02:00
parent 29648208d7
commit c42ca9ecd7
+12 -9
View File
@@ -32,22 +32,25 @@ bun scripts/cli.ts agentrun create task \
--prompt-stdin
```
HWLAB Agent Observer 全量投影验收使用目标 node/lane HWLAB workspace 内的 typed CLI
HWLAB Agent Observer 分页快照验收使用目标 node/lane HWLAB workspace 内的 typed CLI
```bash
export HWLAB_RUNTIME_WEB_URL=<selected-public-origin>
export HWLAB_RUNTIME_ENDPOINT_LOCKED=1
bun tools/hwlab-cli/bin/hwlab-cli.ts client agent-observer list --limit 100 --timeout-ms 45000
bun tools/hwlab-cli/bin/hwlab-cli.ts client agent-observer list --page 1 --page-size 25 --timeout-ms 30000
bun tools/hwlab-cli/bin/hwlab-cli.ts client agent-observer list --page 2 --page-size 25 --search <中文任务标题>
```
- `HWLAB_API_KEY` 必须从选中 node/lane 的受控 sourceRef 加载;
- 成功输出必须同时满足
- `phase=live`
- replay authority 为 `hwlab.event.v1`
- `runCount > 0`
- 验收 Artificer 时至少一个 `sessionId` 使用 `sess_artificer_` 前缀
- 该入口会在 retention-to-live handoff 后自动结束
- 禁止用无限 SSE 的 `client request GET /v1/agent-observer/events` 代替有界查询。
- 列表 authority 固定为 `agentrun-manager-durable-store`
- `page``pageSize``total``totalPages``hasNextPage` 必须可见
- `items` 直接来自 AgentRun durable run、最新 command 和最新 runner job
- `taskId`、中文标题、workspace、lane、Agent/Profile、attempt、runner 和错误字段不得依赖 Kafka 历史 envelope 猜测
- Web 首屏先读取同一分页快照,再连接 `hwlab.event.v1` live 流
- Kafka retention replay 只用于显式事件历史下钻,不得阻塞列表首屏
- 验收 Artificer 时使用中文标题搜索,并确认对应 `sessionId` 使用 `sess_artificer_` 前缀;
- `--limit` 只保留为旧 `--page-size` 别名,不再表示 Kafka replay 扫描上限;
- 禁止用无限 SSE 的 `client request GET /v1/agent-observer/events` 代替有界分页查询。
资源命令的 Target 规则: