modify: call 构造信封协议（不修改调用方 payload）

2026-08-14 16:17:37 +08:00
parent a004a80a16
commit 3800d5fbb6
2 changed files with 16 additions and 3 deletions
@@ -42,10 +42,14 @@ async with Client(session=zenoh_session) as client:
 | `session`     | `zenoh.Session` | Zenoh 会话对象                   |
 | `worker_type` | `str`           | Worker 类型名（如 `"example"`）  |
 | `subject`     | `str`           | Zenoh 主题（如 `"example.add"`） |
-| `payload`     | `dict`          | 调用载荷                         |
+| `payload`     | `dict`          | 业务参数（自动封装为信封）       |
 | `method`      | `str`           | HTTP 方法（`"GET"` / `"POST"`）  |
 | `timeout`     | `float`         | 超时时间（秒）                   |

+> **信封协议**：`call()` 会把 `payload` 自动封装为
+> `{"meta": {"method": ...}, "data": payload}` 发送，**不再修改调用方传入的 dict**；
+> 若传入的 `payload` 已含 `meta`/`data` 结构则原样复用（仅补 `meta.method`）。
+
 ### 同步调用

 ```python