docs: split inbox test plans into case files

2026-03-19 11:29:17 +08:00
parent 9beb7e93eb
commit 5f59350577
70 changed files with 1820 additions and 1606 deletions
@@ -0,0 +1,27 @@
+# case: show-mark-read-advances-read-cursor
+
+### 用例意义
+
+验证 `show --mark-read` 会推进调用 agent 的 read cursor，并影响后续 unread 查询。
+
+### 前置条件
+
+- `worker-e` 有一个未读线程 `THREAD_ID`
+
+### 输入
+
+```bash
+inbox --db TMPDIR/coord.db --agent worker-e --json show --thread THREAD_ID --mark-read
+inbox --db TMPDIR/coord.db --json fetch --agent worker-e --status pending --unread
+```
+
+### 预期输出
+
+- `show` 成功
+- 随后的 `fetch --unread` 对该线程不再返回结果
+
+### 断言结论
+
+- `mark-read` 的副作用是推进该 agent 的 `last_read_message_id`
+- 使用 `--mark-read` 时必须提供 agent 身份，可通过根级 `--agent` 或命令参数传入
+