diff --git a/docs/api/gateway-api.md b/docs/api/gateway-api.md
index 15244c2..cff2280 100644
--- a/docs/api/gateway-api.md
+++ b/docs/api/gateway-api.md
@@ -265,7 +265,7 @@ ws://<gateway>/ws/chat?token=<jwt>&session_id=<optional>&client_id=<optional>&de
 >
 > `msg_type` 可选值：
 > - `chat` — 普通聊天消息
-> - `action` — 动作/旁白消息（如 `(昔涟轻轻推开窗户)`），前端以斜体灰色样式渲染
+> - `action` — 动作/旁白消息（如 `<action>昔涟轻轻推开窗户</action>`），前端以斜体灰色样式渲染
 > - `markdown` — Markdown 格式消息，前端使用安全渲染器转换后显示（支持标题、列表、表格、代码块、链接等）
 > - `code` — 独立代码块消息，前端以深色背景 + 语言标签渲染，可包含 `metadata.language` 指明编程语言
 > - `thinking` — 后台思考过程，前端显示为可折叠详情块
@@ -276,7 +276,7 @@ ws://<gateway>/ws/chat?token=<jwt>&session_id=<optional>&client_id=<optional>&de
 >
 > 当 AI 回复包含多种格式内容（如工具调用结果中的 Markdown 文档或代码片段）时，后端解析器将回复拆分为多条 `review_messages`，每条独立指定 `type` 和 `content`：
 >
-> - `action` — 动作/旁白文本，不做 Markdown 渲染，禁止断句拆分
+> - `action` — 动作/旁白文本，由 `<action>...</action>` XML 标签标记（向后兼容旧括号 `()` 和 `（）` 格式），不做 Markdown 渲染，禁止断句拆分
 > - `chat` — 普通聊天文本，可按句长断句
 > - `markdown` — Markdown 格式文本，禁止断句拆分，前端使用安全渲染器（先 HTML 转义再转换 Markdown 语法）
 > - `code` — 代码块，禁止断句拆分，前端深色背景渲染，`metadata.language` 字段携带语言标识