import type { ReactNode } from "react"; /** * 富文本渲染:把后端说明文本里的 **粗体** 与 `行内代码` 渲染成真实样式。 * * 为什么需要:`describe_strategy`(以及引擎的 `unimplemented` 说明)用 Markdown 的 * `**…**` / `` `…` `` 做**强调协议**——纯文本接口下这是合理的表达方式。但 React 不会 * 解析 Markdown,直接 `{text}` 会把星号和反引号**原样显示**出来(实测归档页/策略页 * 有 10 处这样的漏字),让「说明」看起来像没写完的草稿。 * * 为什么不引 markdown 渲染器:说明文本来自后端(可信),但仍不需要为两种标记引入 * `dangerouslySetInnerHTML` 与整个解析器;这里只做**结构化切分后生成 React 元素**, * 不产生 HTML 注入面,也不支持链接/图片等其它语法(不支持就按字面显示,不猜)。 */ export function RichText({ text }: { text?: string | null }): ReactNode { if (!text) return null; // 一次切分同时处理 **粗体** 与 `代码`(分隔符保留在结果里以便识别) const parts = text.split(/(\*\*[^*]+\*\*|`[^`]+`)/g).filter((p) => p !== ""); return ( <> {parts.map((p, i) => { if (p.length > 4 && p.startsWith("**") && p.endsWith("**")) { return {p.slice(2, -2)}; } if (p.length > 2 && p.startsWith("`") && p.endsWith("`")) { return ( {p.slice(1, -1)} ); } return {p}; })} ); }