Skip to content

# 蓝鲸行内富文本 ​

版本要求

自 v2.1.4-beta.6 起，AI 消息 Markdown 渲染支持「蓝鲸行内富文本」语法，用于在不开启 HTML 的前提下安全展示颜色、加粗、背景高亮、字号等行内样式。

AI 回复默认走 Markdown 渲染，且不解析任意 HTML 标签（`html: true` 已关闭）。若希望模型输出带颜色的标题、重点强调等副本文本，请在 AIDev 平台 Agent 的系统提示词 / 指令 中约定使用下文语法，而不是要求模型输出 `<span>`、`<font>` 等 HTML。

## 语法 ​

    ::bk{ 属性列表 }正文内容:/bk::

规则 | 说明
--- | ---
开始标记 | 固定为 `::bk{`，属性写在紧随其后的 `{}` 内
属性分隔 | 多个属性用 `;` 分隔；每项为 `键=值` 或 `键:值`（等号与冒号等价）
正文 | 支持行内 Markdown（`**加粗**`、链接、行内代码等）
结束标记 | 固定为 `:/bk::`，正文中不要出现该字面量

### 支持的属性 ​

键 | 说明 | 示例
--- | --- | ---
`color` / `c` | 文字颜色（`#rgb` / `#rrggbb` 或 CSS 命名色） | `color=red`、`c:#c00`
`background-color` | 背景色，规则同 `color` | `background-color=yellow`
`font-size` | 字号，仅支持 `1px`–`72px` | `font-size=16px`
`bold` | 加粗（无值，单独写键名即可） | `bold`
`italic` | 斜体（无值） | `italic`

可组合多个属性，例如：`::bk{color=red; bold}标题:/bk::`

### 渲染示例 ​

markdown

    ::bk{color=red; bold}紧急撤离通知:/bk::

    各位同事：

    经评估，现启动 **应急撤离**。请按以下要求执行：

    - 撤离原因：::bk{background-color=yellow}机房电力异常:/bk::
    - 撤离时间：::bk{font-size=16px; bold}今日 18:00 前:/bk::
    - 集合路线：A 栋大厅 → 北门停车场

    发布单位：行政与安全部
    联系方式：内线 8888

## 与 HTML 的关系 ​

方式 | v2.1.4-beta.6 行为
--- | ---
蓝鲸行内富文本 `::bk{...}...:/bk::` | ✅ 支持，样式经白名单校验后写入 `<span class="bk-md-inline-style">`
任意 HTML 标签（`<span style="...">` 等） | ❌ 不解析，按纯文本或 Markdown 规则处理
标准 Markdown | ✅ 继续支持（标题、列表、表格、代码块、Mermaid、LaTeX 等）

因此：请引导 LLM 使用 `::bk::` 语法，不要引导其输出 HTML 片段或完整 HTML 页面。

## 配置 LLM / 系统提示词（AIDev） ​

在 AIDev 平台编辑 Agent 时，将下列约定写入系统提示词或角色指令（可按业务改写场景与字段）。前端小鲸组件无需额外 prop，只要模型按语法输出，消息区即可正确渲染。

### 推荐写入系统提示词的要点 ​

1. 标题或关键句使用蓝鲸行内富文本，禁止使用 HTML 标签。
2. 正文仍用 Markdown 组织段落与列表；重点信息可用 `::bk::` 叠加强调。
3. 结束标记必须是 `:/bk::`；正文内容中不得包含该字面量。
4. 直接输出可展示的正文，不要包裹 `<html>`、`<body>` 等页面结构。

### 示例：撤离通知类内容 ​

可将以下内容作为系统提示词片段，或作为 AIDev「提示词」列表中的一条用户快捷模板（用户点击后发给模型）：

text

    请帮我生成【撤离通知】类内容，要求：

    1. 标题使用红色加粗样式，使用蓝鲸行内富文本语法（不要用 HTML 标签）：
       ::bk{color=red; bold}标题内容:/bk::

    2. 正文贴合实际场景，须包含：撤离原因、范围、时间、路线、注意事项、发布单位、联系方式等核心信息；表述正式、清晰，重点信息可适当突出。

    3. 重点突出可使用同一语法，例如：
       - 红色强调：::bk{color=red}重点文字:/bk::
       - 加粗：::bk{bold}重点文字:/bk::
       - 背景高亮：::bk{background-color=yellow}重点文字:/bk::
       - 字号（1–72px）：::bk{font-size=16px}重点文字:/bk::
       属性写在 `{}` 内，用 `;` 分隔；键值可用 `=` 或 `:`。正文内仍可使用 Markdown 行内格式（**加粗**、链接、行内代码等）。

    4. 结束标记固定为 `:/bk::`，正文中不要出现该字面量。

    5. 不要输出完整 HTML 页面结构，直接给出可直接使用的通知正文即可。

    6. 若未指定具体场景细节，默认按通用应急撤离场景填写占位内容，便于后续替换。

### 与前端「提示词」prop 的区别 ​

配置位置 | 作用
--- | ---
AIDev 系统提示词 / 指令 | 约束 LLM 生成格式（如必须使用 `::bk::`）
前端 `prompts` prop 或 `/` 菜单 | 给用户一键填入的提问模板，见 提示词与资源

二者可配合：系统提示词规定输出格式，`prompts` 提供「请生成撤离通知」等快捷问法。

## 相关文档 ​

- 聊天交互 — 消息流式渲染与 Markdown 能力总览
- 提示词与资源 — 用户侧 `/` 提示词与 `@` 资源
- 更新日志 — v2.1.4-beta.6 变更说明