uncaged/workflow
10
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: uwf thread subcommands, simplify start output

Browse Source
This commit is contained in:
小橘
2026-05-18 06:58:35 +00:00
parent f49e014f41
commit d5773369af
1 changed files with 16 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/wf-stateless-design.md
+16 -16
View File
@@ -10,22 +10,23 @@
``` ```
# thread 组 # thread 组
uwf start <workflow> -p <prompt> # 创建 thread，不执行 uwf thread start <workflow> -p <prompt> # 创建 thread，不执行
uwf step <thread-id> [--agent <cmd>] # 单步执行 uwf thread step <thread-id> [--agent] # 单步执行
uwf show <thread-id> [--full] # 查看状态（--full 展开完整历史） uwf thread show <thread-id> [--full] # 查看状态（--full 展开完整历史）
uwf thread list # 列出活跃 threads
# workflow 组 # workflow 组
uwf workflow put <file.yaml> # 注册 workflow（YAML → CAS） uwf workflow put <file.yaml> # 注册 workflow（YAML → CAS）
uwf workflow show <workflow-id> # 查看 workflow 定义 uwf workflow show <workflow-id> # 查看 workflow 定义
uwf workflow list # 列出已注册 workflows uwf workflow list # 列出已注册 workflows
``` ```
6 个命令。CAS 操作交给 `json-cas` CLI，不在 `uwf` 中重复。 两组对称，各 3-4 个子命令。CAS 操作交给 `json-cas` CLI，不在 `uwf` 中重复。
### 1.2 `uwf start` ### 1.2 `uwf thread start`
```bash ```bash
uwf start <workflow> -p "Fix the login bug described in issue #42" uwf thread start <workflow> -p "Fix the login bug described in issue #42"
``` ```
- `<workflow>` — workflow 名或 CAS hash - `<workflow>` — workflow 名或 CAS hash
@@ -36,8 +37,7 @@ uwf start <workflow> -p "Fix the login bug described in issue #42"
```jsonc ```jsonc
{ {
"workflow": "0R3KFM8N2P1QW", // workflow CAS hash "workflow": "0R3KFM8N2P1QW", // workflow CAS hash
"thread": "01J7K9M2XN...", // ULID "thread": "01J7K9M2XN..." // ULID
"progress": null // null = 还没执行任何 step
} }
``` ```
@@ -49,11 +49,11 @@ uwf start <workflow> -p "Fix the login bug described in issue #42"
5. 在 threads 索引中记录链头 → StartNode hash 5. 在 threads 索引中记录链头 → StartNode hash
6. 输出 JSON 6. 输出 JSON
### 1.3 `uwf step` ### 1.3 `uwf thread step`
```bash ```bash
uwf step 01J7K9M2XN... uwf thread step 01J7K9M2XN...
uwf step 01J7K9M2XN... --agent "bunx uwf-cursor" uwf thread step 01J7K9M2XN... --agent "bunx uwf-cursor"
``` ```
**输出（JSON to stdout）：** **输出（JSON to stdout）：**
@@ -92,11 +92,11 @@ uwf step 01J7K9M2XN... --agent "bunx uwf-cursor"
10. 更新链头指针 10. 更新链头指针
11. 输出 JSON 11. 输出 JSON
### 1.4 `uwf show` ### 1.4 `uwf thread show`
```bash ```bash
uwf show 01J7K9M2XN... # 当前状态（最新 StepNode） uwf thread show 01J7K9M2XN... # 当前状态（最新 StepNode）
uwf show 01J7K9M2XN... --full # 遍历链，打印完整 step 历史 uwf thread show 01J7K9M2XN... --full # 遍历链，打印完整 step 历史
``` ```
纯读操作，不改状态。CAS 节点查看用 `json-cas get <hash>`。 纯读操作，不改状态。CAS 节点查看用 `json-cas get <hash>`。