蓝鲸行内富文本
版本要求
自 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,只要模型按语法输出,消息区即可正确渲染。
推荐写入系统提示词的要点
- 标题或关键句使用蓝鲸行内富文本,禁止使用 HTML 标签。
- 正文仍用 Markdown 组织段落与列表;重点信息可用
::bk::叠加强调。 - 结束标记必须是
:/bk::;正文内容中不得包含该字面量。 - 直接输出可展示的正文,不要包裹
<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 提供「请生成撤离通知」等快捷问法。