docs(api): api-client → v0.56（协同 A2/G2/G3/G4 契约 + 三个环境变量 + 修正两处错误陈述）

- A2：interrupt 新增 scope（{"","all","current"}），三态语义 + 非法值定向 bad_request；
  session_interrupted 形状零变化但 dropped 恒为真丢弃数
- G2：stream:true 直达编排器；响应面补 202 {queued} / 409 chat_busy / 503 chat_dispatch_failed；
  未接 loop 由 200 改 500 chat_unavailable（行为变更已写明兼容性）
- G3：image 解码后 5 MiB 上限 → 400 image_too_large（指路上传）；**如实写明 WS 侧到不了这条判定**
  （wsReadLimit=4096 传输层直接断连，发真实图片必须「上传 + URL」）
- G4：新增可选 clientMsgId（两端）⇒ 幂等；REST 200 {duplicate:true,messageId}、WS 新帧 chat_duplicate
  （owner+admin，fail-closed）；键回填进 message_persisted/channel_persisted/读接口；迁移 0013
- .env.example + api-client 新增三个环境变量：OWNER_IDENTITY_INJECTION(owner_only 默认) /
  CONTEXT_MAX_TOKENS(32768；0/负 = 关) / GUARDRAIL_KEYWORDS(留空 = 不挂)
- 修正两处错误陈述：api-reference §6.2 与 §6.6 的「OnStream 只填 seq、不带 turnId」（v0.36 起即带
  sessionId+turnId，v0.50 起带 streamId）；上传上限 50MB → 5 MiB

.env.example

@@ -178,6 +178,12 @@ CONTEXT_MAX_TOKENS=32768
 # 内定的安全默认值，不对外开放配置（见 cmd/cyrene/wire_guardrail.go）。
 # GUARDRAIL_KEYWORDS=
 
+# ---- 主人身份说明书注入范围（design/11 §0 红线） ----
+# 主人身份说明书（owner.yaml identityFile）注入范围：owner_only(默认，仅主人会话) | always(所有会话，含群聊/陌生人，仅自测) | off。
+# owner_only 按渠道层强类型 actor 元数据判定；非法值回退 owner_only 并记 WARN（绝不静默放行）。
+# 它只决定那段知识进不进该会话的上下文，不参与任何身份/权限判定（身份始终看 actor 元数据 + 白名单）。
+OWNER_IDENTITY_INJECTION=owner_only
+
 # ---- 推送出口（D1，主动推送的两级投递）----
 # 主动消息在 WS/IM 投递之外，异步镜像到「主人自建统一推送服务」（主通道）。
 # 该服务不可达/未配时，日志注明「个推(Getui)回退待接入」——当前无 Getui SDK，不伪造投递。