📝 clarify async runtime json snapshot semantics

This commit is contained in:
Nanaloveyuki
2026-06-14 10:11:41 +08:00
parent d46e90fcf5
commit 64dfc36931
+4
View File
@@ -38,6 +38,8 @@ Detailed rules explaining key parameters and behaviors
- The compact serialized shape is `{"mode":"native_worker|compatibility","background_worker":true|false}`.
- This helper focuses on runtime capabilities rather than queue counters or logger lifecycle flags.
- The exported JSON is suitable for diagnostics endpoints and startup environment checks.
- This helper serializes the provided `AsyncRuntimeState` exactly as given; it does not call `async_runtime_state()` or recheck backend capability by itself.
- That means manually constructed runtime snapshots are exported unchanged, with `mode` relabeled through `async_runtime_mode_label(...)` and `background_worker` kept exactly as supplied.
### How to Use
@@ -68,6 +70,8 @@ e.g.:
- If the runtime is in compatibility mode, the helper still serializes normally using the matching mode label.
- If callers need the current backend-derived runtime rather than an older or synthetic snapshot, they must capture a fresh `async_runtime_state()` first.
### Notes
1. The output field names are fixed as `mode` and `background_worker`.