diff --git a/docs/container_command_docker_json.md b/docs/container_command_docker_json.md
index ff10fbf..9e1042c 100644
--- a/docs/container_command_docker_json.md
+++ b/docs/container_command_docker_json.md
@@ -363,6 +363,8 @@ Body = iolist_to_binary(json:encode(Options))
 
 ### Healthcheck
 
+该字段由 iot 校验后下发。`test` 必须是 binary list，`interval_ns`、`timeout_ns` 和 `retries` 必须是非负整数；efka 只按收到的中间 map 转成 Docker JSON 字段。
+
 输入：
 
 ```erlang
diff --git a/docs/efka_iot_protocol.md b/docs/efka_iot_protocol.md
index f5e3472..76204bf 100644
--- a/docs/efka_iot_protocol.md
+++ b/docs/efka_iot_protocol.md
@@ -82,6 +82,7 @@
 
 - `activate`：如果 `efka` 已经是 `activated`，直接回复 `ok`；否则重新发送 `auth_request`，等待鉴权结果后再回复该 command。
 - `deactivate`：`efka` 进入 `restricted` 状态，并回复 `ok`。
+- `iot` 侧会异步提交 auth command 并等待对应 `Ref` 的 `command_response`，再向 `/host/activate` HTTP 调用方返回结果；等待超时为 10 秒，超时返回 `timeout`，无效响应返回 `invalid response`。
 
 ## 容器管理命令