From 6ac214366e5d5f9f047d6f046390a6350a11a52d Mon Sep 17 00:00:00 2001 From: AskaEth Date: Wed, 7 Oct 2026 17:20:47 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E5=A5=91=E7=BA=A6):=20br=20=E6=94=B9?= =?UTF-8?q?=E4=B8=BA=E3=80=8C=E6=B0=94=E6=B3=A1/=E6=B6=88=E6=81=AF?= =?UTF-8?q?=E5=88=86=E9=9A=94=E7=AC=A6=E3=80=8D=EF=BC=88=E4=B8=BB=E4=BA=BA?= =?UTF-8?q?=E5=8F=A3=E5=BE=84=EF=BC=89=EF=BC=8C=E8=A1=8C=E5=86=85=E7=99=BD?= =?UTF-8?q?=E5=90=8D=E5=8D=95=E6=94=B6=E7=AA=84=E5=88=B0=E4=BA=94=E9=A1=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 主人 2026-10-07：「对消息内的
始终处理为多条消息隔断」。 - br 语义与 p 同级：两边文本成为两条独立消息（IM）/ 两个独立气泡（Web）， 而不是同一气泡内的换行；
/
/
三种写法等价 - 行内白名单据此收窄为五项（b/strong/i/em/code），br 移出白名单 - 明确影响面：含 br 的回复在 IM 上会变成多条消息（受既有气泡间隔节流） - 标注「实现跟进中」：Web 端 2dae469 当时把 br 当行内换行、IM 出站当时 连行内标签都还没剥，两侧都在改；以契约为准，不以当日实现为准 - IM 出口那节补一句：br 不按行内标签处理，按切分走 --- Docs/api-client.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/Docs/api-client.md b/Docs/api-client.md index 2c4c94f..b868819 100644 --- a/Docs/api-client.md +++ b/Docs/api-client.md @@ -1493,14 +1493,20 @@ curl -s -X POST -H "X-API-Key: $KEY" \ - 🔴 **背景（实测）**：她输出的**不是 Markdown**（最近 12 条 assistant 消息里 `**` 记号 0 个、列表行 0 个），而是**有限的一小组 HTML 标签**：`

` 96 次、`` 34 次、**`` 6 次**。`

` / `` 各端早已处理，**`` 此前没有任何一端处理 ⇒ 用户直接看到裸标签**。 - **新增渲染口径（跨端一致）**：助手消息正文里，以下**行内标签**应被渲染成对应样式，而**不是**按字面显示： - `b` / `strong`（粗）· `i` / `em`（斜）· `code`（等宽）· `br`（换行，`
`/`
`/`
` 按 HTML5 口径等价）。 - ⚠️ **同日晚修订：白名单由八项收窄为上面六项**（去掉 `u`/`s`）—— 它们在她 100 条输出里 0 命中，不值得让各端为它们返工；各端**可以**额外容错渲染别的行内标签，但**契约只承诺这六项**。 + `b` / `strong`（粗）· `i` / `em`（斜）· `code`（等宽）。 + ⚠️ **同日晚修订：白名单由八项收窄为上面五项**（去掉 `u`/`s`/`br`）—— `u`/`s` 在她 100 条输出里 0 命中，不值得让各端为它们返工；`br` 见下一节（它不是行内标签）。 +- **🔴 `
` 是「气泡/消息分隔符」，不是行内标签（同日追加，主人口径）**：主人原话「**对消息内的 `
` 始终处理为多条消息隔断**」。 + - **语义与 `

` 同级**：`
` 两边的文本**必须成为两条独立的消息**（IM 侧）/ **两个独立的气泡**（Web 侧），**而不是**同一条消息里的一个换行。 + - `
` / `
` / `
` 三种写法**等价**（HTML5 口径）。 + - **空气泡照旧丢弃**（与既有 `

` 空气泡口径一致）；`
` 两侧都是空白 ⇒ 不产生多余空气泡。 + - ⚠️ **影响面（各端须知）**：一条含 `
` 的回复在 IM 上会变成**多条消息**（与 `

` 一样受既有的气泡间隔节流约束）。 + - ⚠️ **实现状态**：本条发出时**实现跟进中**（Web 侧 `2dae469` 当时把 `
` 当行内换行，正在改；IM 出站侧当时连行内标签都还没剥，正在改）。**以本契约为准，不以当日实现为准。** - **🔴 三条硬口径（各端必须照此实现，否则跨端显示不一致）**： 1. **白名单外一律按纯文本原样显示** —— `