shazhou/united-workforce
8
0
Fork 0
Code Issues 8 Pull Requests 2 Actions Packages Projects Releases Wiki Activity

docs: step on ended thread is an error, not null head

Browse Source
This commit is contained in:
小橘
2026-05-18 07:11:50 +00:00
parent 8f9a925179
commit 77f2060e6b
1 changed files with 4 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/wf-stateless-design.md
+4 -9
View File
@@ -60,28 +60,23 @@ uwf thread step 01J7K9M2XNPQR5VWBCDF8G3H4T --agent "bunx uwf-cursor"
**输出（JSON to stdout）：** **输出（JSON to stdout）：**
```jsonc ```jsonc
// 正常 step
{ {
"workflow": "4KNM2PXR3B1QW", "workflow": "4KNM2PXR3B1QW",
"thread": "01J7K9M2XNPQR5VWBCDF8G3H4T", "thread": "01J7K9M2XNPQR5VWBCDF8G3H4T",
"head": "8FWKR3TN5V1QA" // 新链头 StepNode 的 CAS hash "head": "8FWKR3TN5V1QA" // 新链头 StepNode 的 CAS hash
} }
// thread 结束
{
"workflow": "4KNM2PXR3B1QW",
"thread": "01J7K9M2XNPQR5VWBCDF8G3H4T",
"head": null // null = moderator 返回 END，thread 已归档
}
``` ```
若 moderator 返回 END，thread 归档（从 threads.json 移除），本次 step 不产生新 StepNode，输出中 head 为归档前的最后一个链头。
对已结束或不存在的 thread 调用 step 会报错（非 active thread）。
详细信息通过 `uwf thread show <thread-id>` 或 `json-cas get <head>` 查看。 详细信息通过 `uwf thread show <thread-id>` 或 `json-cas get <head>` 查看。
**做的事：** **做的事：**
1. 读链头 → 当前 StepNode（或 StartNode） 1. 读链头 → 当前 StepNode（或 StartNode）
2. 收集 thread 历史（遍历链） 2. 收集 thread 历史（遍历链）
3. 调 moderator：评估 JSONata conditions → 得到下一个 role（或 END） 3. 调 moderator：评估 JSONata conditions → 得到下一个 role（或 END）
4. 若 END → 归档 thread，输出 `progress: null` 4. 若 END → 归档 thread，输出最后链头，退出
5. 确定 agent command（`--agent` override > thread binding > global default） 5. 确定 agent command（`--agent` override > thread binding > global default）
6. 构建 prompt（role.systemPrompt + thread context + user prompt） 6. 构建 prompt（role.systemPrompt + thread context + user prompt）
7. 调用：`<agent-cmd> <thread-id>`，捕获 stdout 7. 调用：`<agent-cmd> <thread-id>`，捕获 stdout