跳转至

Server Status Log Markup Safety Design

Problem

mineru server status 直接将最近的日志字符串传递给 Rich Panel。Rich 会将字符串可渲染对象视为标记(markup)。因此,类似 MinerU home [/Users/jinzhenj/.mineru] 的日志内容会被解析为闭合标记标签,并触发 MarkupError。

日志是不可信的纯文本,可能包含任意括号、路径、回溯文本或类似 Rich 标签的内容。

Decision

在构造 panel 之前,将每个近期日志 panel 的正文包裹在 rich.text.Text 中。Text 会按字面保留日志内容,防止 Rich 解析标记,同时保留现有的 panel 标题和边框样式。

全局 Rich 输出辅助函数保持不变,因为其他 CLI 渲染器可能有意使用 Rich 标记或结构化可渲染对象。

Tests

扩展现有的服务器状态日志 panel 测试,加入路径和类似标记的文本。断言每个 panel 接收到一个 Text 对象,其纯文本内容与源日志完全一致,并通过 Rich 渲染 panel 以确认不会抛出 MarkupError。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 mi/MinerU