From c42ca9ecd78095434a464e1b28a729f22f4f7e48 Mon Sep 17 00:00:00 2001 From: Codex Date: Thu, 16 Jul 2026 07:49:43 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20AgentRun=20?= =?UTF-8?q?=E5=88=86=E9=A1=B5=E5=BF=AB=E7=85=A7=E9=AA=8C=E6=94=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/skills/unidesk-agentrun/SKILL.md | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/.agents/skills/unidesk-agentrun/SKILL.md b/.agents/skills/unidesk-agentrun/SKILL.md index 82755cec..9e5ee98e 100644 --- a/.agents/skills/unidesk-agentrun/SKILL.md +++ b/.agents/skills/unidesk-agentrun/SKILL.md @@ -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= 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 规则：