[stevenjj33]

#224 的评审跟进。评审 APPROVED 附 5 条意见，其中两条进代码（主题重画、注释与代码对不上），两条是确认项（见下），一条（<style> 保留）以实证 + 兜底过滤回应；另带一条超出评审点的新发现（渲染期外链 fetch）。

1. 切主题时已画好的图不重画（评审点 1，进代码）

App 没有响应式的主题源——主题是 SettingsModal 的局部 state，每次变化最终都是 appearance effect 翻转 <html> 上的 dark class（设置点击、跟随系统的 OS 切换都走这一条）。所以：

• WebuiBrowserDom 端口新增 subscribeDocumentTheme：平台层用 MutationObserver 观察 documentElement 的 class 属性，谁翻 class 都能听见；无 DOM / 无 MutationObserver 时降级为 no-op。
• WebuiMermaid 订阅它，把主题作为渲染 effect 的依赖。重画期间旧 SVG 留在屏上，直到新调色板就绪——读者切主题不会看到围栏闪回源码文本。
• 浏览器新用例走真实 UI（用户菜单 → 设置 → 深色模式）切换、无任何 reload，并放了一个 window 见证标记证明没有刷新；原 reload 型用例保留（覆盖 boot 应用路径）。

2. theme 选项注释与代码对不上（评审点 2，进代码）

注释改为如实描述：默认 light，因为纯函数拿不到文档；组件侧显式传当前主题，线上路径不依赖默认值。

3. 回落块无行号槽（评审点 3，确认不改）

维持原取舍：一条 Mermaid 围栏在任何状态下都不出行号，渲染成功与渲染失败两种形态一致；失败时突然多出行号槽反而会造成「失败了」的视觉跳变。

4. splitting: true 是全仓产物布局改动（评审点 4，确认为有意）

重新确认过：动态 import 若不切分，mermaid（和 slash palette）会内联进 entry chunk，每次页面加载都要拉；resolveClientAsset 本就伺服 /assets/ 前缀。三平台 + 打包门禁（#228–#230 落地后）均绿。

5. <style> 保留的安全性（评审点 5，实证 + 兜底）

对锁定版本（mermaid 12.1.0）在 securityLevel: "strict" + htmlLabels: false 下用 chromium 实测：

注入路径	结果
%%{init}%% themeVariables CSS 逃逸（#f00; } * { …）、@import 拼接	死于颜色校验："Unsupported color format"
classDef / style / linkStyle 带 url(https://…)、{} 逃逸	语法错误，不产出规则
%%{init}%% 翻 securityLevel / htmlLabels	被库的 secure 清单挡住，均未生效（无 foreignObject）
click … call / callback	render() 路径不绑定任何东西，输出无痕迹
click A href "https://…"	落成 <a xlink:href="https://…">，点击才触发——与 transcript 里本来就渲染的 markdown 外链等价，不剥
恶意探针运行期外部请求	0 次

结论写进了净化函数的文档注释。另加两条兜底正则（@import 与外部 url() → none，保留 url(#fragment) 与 data:image）：今天的库到不了这里，成本为零，防的是未来某个图型长出裸 CSS 面。

6. 新发现：@{img: 'https://…'} 是渲染期网络信标（超出评审点，可要求拆掉）

实测：flowchart 节点写 A@{img: 'https://evil.example/logo.png'} 时，渲染期间页面真的发出对该 URL 的请求（fetch 发生在 mermaid.render 返回之前；DNS 解析成功时图片会被拉取）。图身是模型输出——一次渲染不该把它变成对任意主机的请求。守卫在动态 import 之前拒绝这类围栏（走既有的普通围栏回落），data: URI 自带字节、离线可画，放行（有单测钉住）。

这条不在评审意见里；若认为超出本 PR 范围，可以直接 revert 掉守卫与对应两条单测，其余不受影响。

测试与证伪

• 单测：markdown-mermaid.test.tsx 22 → 25 条（远程图片守卫 ×1、data: URI 放行 ×1、CSS 兜底 ×1）。证伪：src 退回 63b9739 后新增用例 2 failed（守卫、兜底）/ 23 passed；恢复后 25 passed。
• 浏览器：transcript.spec.mjs mermaid+theme 5 条含新增无刷新重画用例。证伪：旧构建下新用例 红（调色板 20s 不变超时）；新构建 5/5 绿。
• 门禁：webui 单测全量 3112/3112；pnpm verify --profile full 21 gates PASS（darwin 按配置跳过 browser 套件，已单独本地跑过）；无新增文件，vitest-suites / public-source / path-metadata oracle 均无需变更。