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

docs: use full 26-char Crockford Base32 ULIDs for thread IDs

Browse Source
This commit is contained in:
小橘
2026-05-18 07:03:40 +00:00
parent 6d94d9c85a
commit a8024e6d42
1 changed files with 10 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/wf-stateless-design.md
+10 -10
View File
@@ -38,7 +38,7 @@ uwf thread start <workflow> -p "Fix the login bug described in issue #42"
```jsonc ```jsonc
{ {
"workflow": "4KNM2PXR3B1QW", // workflow CAS hash (XXH64, 13-char Crockford Base32) "workflow": "4KNM2PXR3B1QW", // workflow CAS hash (XXH64, 13-char Crockford Base32)
"thread": "01J7K9M2XN..." // ULID "thread": "01J7K9M2XNPQR5VWBCDF8G3H4T" // ULID
} }
``` ```
@@ -53,8 +53,8 @@ uwf thread start <workflow> -p "Fix the login bug described in issue #42"
### 1.3 `uwf thread step` ### 1.3 `uwf thread step`
```bash ```bash
uwf thread step 01J7K9M2XN... uwf thread step 01J7K9M2XNPQR5VWBCDF8G3H4T
uwf thread step 01J7K9M2XN... --agent "bunx uwf-cursor" uwf thread step 01J7K9M2XNPQR5VWBCDF8G3H4T --agent "bunx uwf-cursor"
``` ```
**输出（JSON to stdout）：** **输出（JSON to stdout）：**
@@ -63,7 +63,7 @@ uwf thread step 01J7K9M2XN... --agent "bunx uwf-cursor"
// 正常 step // 正常 step
{ {
"workflow": "4KNM2PXR3B1QW", "workflow": "4KNM2PXR3B1QW",
"thread": "01J7K9M2XN...", "thread": "01J7K9M2XNPQR5VWBCDF8G3H4T",
"progress": { "progress": {
"role": "developer", "role": "developer",
"meta": { "filesChanged": ["src/auth.ts"], "summary": "Fixed redirect" }, "meta": { "filesChanged": ["src/auth.ts"], "summary": "Fixed redirect" },
@@ -75,7 +75,7 @@ uwf thread step 01J7K9M2XN... --agent "bunx uwf-cursor"
// thread 结束 // thread 结束
{ {
"workflow": "4KNM2PXR3B1QW", "workflow": "4KNM2PXR3B1QW",
"thread": "01J7K9M2XN...", "thread": "01J7K9M2XNPQR5VWBCDF8G3H4T",
"progress": null "progress": null
} }
``` ```
@@ -96,8 +96,8 @@ uwf thread step 01J7K9M2XN... --agent "bunx uwf-cursor"
### 1.4 `uwf thread show` ### 1.4 `uwf thread show`
```bash ```bash
uwf thread show 01J7K9M2XN... # 当前状态（最新 StepNode） uwf thread show 01J7K9M2XNPQR5VWBCDF8G3H4T # 当前状态（最新 StepNode）
uwf thread show 01J7K9M2XN... --full # 遍历链，打印完整 step 历史 uwf thread show 01J7K9M2XNPQR5VWBCDF8G3H4T --full # 遍历链，打印完整 step 历史
``` ```
纯读操作，不改状态。CAS 节点查看用 `json-cas get <hash>`。 纯读操作，不改状态。CAS 节点查看用 `json-cas get <hash>`。
@@ -295,7 +295,7 @@ payload:
### 2.4 链式结构 ### 2.4 链式结构
``` ```
threads.json: { "01J7K9M2XN...": "8FWKR3TN5V1QA" } threads.json: { "01J7K9M2XNPQR5VWBCDF8G3H4T": "8FWKR3TN5V1QA" }
│ │
▼ ▼
StepNode (step 3) StepNode (step 3)
@@ -322,8 +322,8 @@ threads.json: { "01J7K9M2XN...": "8FWKR3TN5V1QA" }
```jsonc ```jsonc
// ~/.uncaged/workflow/threads.json // ~/.uncaged/workflow/threads.json
{ {
"01J7K9M2XN...": "8FWKR3TN5V1QA", // active thread → 链头 "01J7K9M2XNPQR5VWBCDF8G3H4T": "8FWKR3TN5V1QA", // active thread → 链头
"01J8AB3QRM...": "3CNWT9KR6D2HV" "01J8AB3QRMSTV6WKXZ2C4DF7GN": "3CNWT9KR6D2HV"
} }
``` ```