XWX-AI commited on
Commit
ac5fcb4
·
1 Parent(s): afe1c54

fix(widget): 142号方案 mermaid定义信封渲染分支+本地vendor内联去CDN(方案D)+replace函数形式修复——背景:XWXExporter v3.2.5起扩展包内不得含远程脚本URL(CWS MV3远程托管代码政策,违规参考ID Blue Argon,2026-11-01 3.2.4被拒——content.bundle.js载荷里cdn.jsdelivr.net/npm/mermaid@10脚本URL被静态扫描判违规,即使扩展自身从不执行、URL仅为渲染端载荷),扩展改为只传定义信封{"_xwxMermaidDef":def},执行环境由本端自建——①新建lib/mermaid-widget-html.js:parseMermaidDefEnvelope互斥判别(完整HTML以<!DOCTYPE或<开头,信封以{开头且可解析出_xwxMermaidDef字符串字段;畸形/缺失/非字符串一律null落回旧路径)+buildMermaidWidgetCode(模板提供#widget-container容器,本代码以%%WIDGET_CODE%%注入其内,getElementById命中容器本身);②renderMermaid信封分支:识别→本地vendor内联构建执行代码,未识别→widgetHtml逐字透传(≤3.2.4旧扩展完整HTML载荷零改动向下兼容,v11→v10降级逻辑不受影响);③方案D去CDN:vendor/mermaid-10.9.1.min.js(3.3MB,与桌面BatchExporter pdf-render/vendor同版本)内联<script>,</script与<!--标准转义(esbuild/webpack内联同款;源文件实测0处</script、1处<!--且均在字符串字面量内)——单widget渲染实测~0.9s(旧CDN路径每次渲染联网拉3.3MB,预算15s),受限网络下不再依赖jsdelivr;④附带修复_renderWidgetPuppeteerImpl的template.replace('%%WIDGET_CODE%%',widgetCode)字符串形式会解释$&/$'/$$替换模式的静默损坏(压缩库与用户'$100'节点标签均可触发),改函数形式replace——本修复对所有widget类型的载荷注入生效,对旧载荷只会修复损坏不可能引入回归;⑤初始化参数与扩展旧执行模板逐字一致(theme default/flowchart htmlLabels/securityLevel loose,v10规避v11 ER themeVariables缺陷),导出位图与3.2.4前同语义。验证:Puppeteer真渲染探针26/26($&毒药样本/反引号/中文节点/sequenceDiagram/pie/信封判别8边界);docker pdf-test/pdf-prod双容器重建后经真实HTTP端到端实测:信封请求3.6s出SVG(viewBox=-8 -8 160 310,含中文节点'下单'),与插件发出的同款请求逐字段一致

Browse files
lib/mermaid-widget-html.js ADDED
@@ -0,0 +1,86 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ /**
2
+ * Mermaid widget 执行环境构建器(备忘录 142)
3
+ *
4
+ * 背景:CWS MV3 远程托管代码政策(违规参考 ID Blue Argon)对扩展包做静态
5
+ * 扫描,任何指向包外的 <script src> 字符串——即使仅作为渲染端载荷、扩展自身
6
+ * 从不执行——都判违规。因此扩展只传 mermaid 定义信封
7
+ * {"_xwxMermaidDef": "<定义原文>"},执行环境由本模块在渲染端构建。
8
+ *
9
+ * 契约(三端必须保持一致,导出位图与 3.2.4 前逐像素同语义):
10
+ * - 库版本:mermaid 10.9.1 本地 vendor(v11 ER 图 themeVariables
11
+ * rowEven/rowOdd/nodeBorder 缺陷,server.js 旧格式 v11→v10 降级同款规避;
12
+ * 桌面端 BatchExporter widget_renderer.rs 同版本 vendor)
13
+ * - initialize 参数:{ startOnLoad: false, theme: 'default',
14
+ * flowchart: { htmlLabels: true }, securityLevel: 'loose' }
15
+ * - 渲染:mermaid.render('xwx-mmd', def) → #widget-container innerHTML;
16
+ * 失败置 document.title = 'MERMAID_RENDER_ERROR'(桌面端轮询 SVG in DOM,
17
+ * 标题信号保留与旧扩展模板一致)
18
+ * - 桌面端 BatchExporter widget_renderer.rs 的 mermaid 定义分支为本文件
19
+ * 的 Rust 同构实现,改参数须两端同步
20
+ *
21
+ * 信封识别(parseMermaidDefEnvelope):html 传输字段历史上有两种载荷——
22
+ * 完整执行 HTML(≤3.2.4 旧扩展)与本信封(≥3.2.5)。完整 HTML 以 <!DOCTYPE
23
+ * 或 < 开头,信封以 { 开头且可解析出 _xwxMermaidDef 字符串字段,判据互斥。
24
+ */
25
+
26
+ const fs = require('fs');
27
+ const path = require('path');
28
+
29
+ /** vendor 库文本缓存(进程内只读一次;3.3MB 字符串常驻内存) */
30
+ let _mermaidLibJs = null;
31
+
32
+ /**
33
+ * 读取本地 vendor 的 mermaid 10.9.1 并做内联转义。
34
+ * 内联进 <script> 的标准转义:'</script' 会提前闭合脚本标签;'<!--' 会把
35
+ * HTML 解析器置入 script-data-escaped 状态。二者在 JS 字符串/正则/注释内
36
+ * 转义后(\/ 与 \!)语义不变,属于 esbuild/webpack 内联脚本的同款处理。
37
+ * @returns {string}
38
+ */
39
+ function getMermaidVendorJs() {
40
+ if (_mermaidLibJs === null) {
41
+ const vendorPath = path.join(__dirname, '..', 'vendor', 'mermaid-10.9.1.min.js');
42
+ const raw = fs.readFileSync(vendorPath, 'utf8');
43
+ _mermaidLibJs = raw
44
+ .replace(/<\/script/gi, '<\\/script')
45
+ .replace(/<!--/g, '<\\!--');
46
+ }
47
+ return _mermaidLibJs;
48
+ }
49
+
50
+ /**
51
+ * 识别 mermaid 定义信封载荷。
52
+ * @param {string} widgetHtml - 传输字段原文(可能是完整 HTML 或信封 JSON)
53
+ * @returns {string|null} 定义原文;非信封载荷返回 null(走旧格式完整 HTML 路径)
54
+ */
55
+ function parseMermaidDefEnvelope(widgetHtml) {
56
+ if (typeof widgetHtml !== 'string') return null;
57
+ const s = widgetHtml.trim();
58
+ if (!s.startsWith('{') || !s.includes('_xwxMermaidDef')) return null;
59
+ try {
60
+ const obj = JSON.parse(s);
61
+ const def = obj && typeof obj === 'object' ? obj._xwxMermaidDef : undefined;
62
+ return (typeof def === 'string' && def.trim().length > 0) ? def : null;
63
+ } catch {
64
+ return null;
65
+ }
66
+ }
67
+
68
+ /**
69
+ * mermaid 定义 → 可执行 widget 代码(不含外层文档——渲染模板
70
+ * templates/widget-render.html 已提供 #widget-container 容器,本代码作为
71
+ * %%WIDGET_CODE%% 注入该容器内,getElementById 命中的即容器本身)。
72
+ * @param {string} definition - mermaid 图定义(flowchart/sequenceDiagram/…)
73
+ * @returns {string}
74
+ */
75
+ function buildMermaidWidgetCode(definition) {
76
+ const defJson = JSON.stringify(String(definition));
77
+ return `<script>${getMermaidVendorJs()}</script>` +
78
+ `<script>` +
79
+ `mermaid.initialize({ startOnLoad: false, theme: 'default', flowchart: { htmlLabels: true }, securityLevel: 'loose' });` +
80
+ `mermaid.render('xwx-mmd', ${defJson}).then(function (r) {` +
81
+ `document.getElementById('widget-container').innerHTML = r.svg;` +
82
+ `}).catch(function (e) { document.title = 'MERMAID_RENDER_ERROR'; document.getElementById('widget-container').textContent = String(e); });` +
83
+ `<\/script>`;
84
+ }
85
+
86
+ module.exports = { parseMermaidDefEnvelope, buildMermaidWidgetCode };
server.js CHANGED
@@ -37,6 +37,9 @@ const { buildChatGPTChartHtml } = require('./lib/chatgpt-chart-html');
37
  const { resolveDilIcons, dilIconStats } = require('./lib/dil-icons');
38
  // Claude widgets chart(chart_display_v0)→ Chart.js 4 渲染 HTML(CD 视觉皮肤,备忘录 125)
39
  const { buildClaudeChartHtml } = require('./lib/claude-chart-html');
 
 
 
40
 
41
  let ChartJSNodeCanvas = null;
42
  try {
@@ -961,6 +964,16 @@ class WidgetRenderer {
961
  // 在 Chromium 中执行原始 HTML+JS,保留所有 mermaid.initialize() 参数、
962
  // themeVariables、自定义后处理(path→圆角rect)等。
963
  // 这样 PDF/DOCX 中的图表与 Claude 网页渲染结果完全一致。
 
 
 
 
 
 
 
 
 
 
964
  console.log(`[WIDGET] renderMermaid: delegating to Puppeteer (full widget_code execution), title=${title}, codeLen=${widgetHtml.length}`);
965
  return this.renderWidgetPuppeteer(widgetHtml, 'mermaid', title, 10000);
966
  }
@@ -1190,7 +1203,10 @@ class WidgetRenderer {
1190
  }
1191
 
1192
  let fullHtml = template
1193
- .replace('%%WIDGET_CODE%%', widgetCode);
 
 
 
1194
 
1195
  // 性能优化:与 PDF 一致,setContent 用 'load'(避免 networkidle0 的 ~2s 额外等待)
1196
  await page.setContent(fullHtml, { waitUntil: 'load', timeout: 15000 });
 
37
  const { resolveDilIcons, dilIconStats } = require('./lib/dil-icons');
38
  // Claude widgets chart(chart_display_v0)→ Chart.js 4 渲染 HTML(CD 视觉皮肤,备忘录 125)
39
  const { buildClaudeChartHtml } = require('./lib/claude-chart-html');
40
+ // Mermaid 定义信封 → 可执行 widget 代码(备忘录 142:扩展包内不得含远程脚本
41
+ // URL——CWS MV3 远程托管代码政策,库走本地 vendor 内联,见 lib 顶部契约说明)
42
+ const { parseMermaidDefEnvelope, buildMermaidWidgetCode } = require('./lib/mermaid-widget-html');
43
 
44
  let ChartJSNodeCanvas = null;
45
  try {
 
964
  // 在 Chromium 中执行原始 HTML+JS,保留所有 mermaid.initialize() 参数、
965
  // themeVariables、自定义后处理(path→圆角rect)等。
966
  // 这样 PDF/DOCX 中的图表与 Claude 网页渲染结果完全一致。
967
+ //
968
+ // 备忘录 142: ≥3.2.5 扩展只传定义信封 {"_xwxMermaidDef": def}(CWS MV3
969
+ // 远程托管代码政策,扩展包内不得含远程脚本 URL),执行环境由渲染端自建
970
+ // (本地 vendor 内联,零网络);≤3.2.4 旧扩展的完整 HTML 载荷原样透传
971
+ // (仍含 CDN 引用,向下兼容)。判据 = parseMermaidDefEnvelope,互斥。
972
+ const mermaidDef = parseMermaidDefEnvelope(widgetHtml);
973
+ if (mermaidDef !== null) {
974
+ console.log(`[WIDGET] renderMermaid: definition envelope detected (len=${mermaidDef.length}), building exec code from local vendor`);
975
+ widgetHtml = buildMermaidWidgetCode(mermaidDef);
976
+ }
977
  console.log(`[WIDGET] renderMermaid: delegating to Puppeteer (full widget_code execution), title=${title}, codeLen=${widgetHtml.length}`);
978
  return this.renderWidgetPuppeteer(widgetHtml, 'mermaid', title, 10000);
979
  }
 
1203
  }
1204
 
1205
  let fullHtml = template
1206
+ // 替换必须用函数形式:字符串形式的 replace 会解释替换文本中的
1207
+ // $&/$'/$1 等 $ 模式——mermaid 库与用户图定义(如 "$100" 节点标签)
1208
+ // 都可能含这些序列,字符串形式会产生静默内容损坏
1209
+ .replace('%%WIDGET_CODE%%', () => widgetCode);
1210
 
1211
  // 性能优化:与 PDF 一致,setContent 用 'load'(避免 networkidle0 的 ~2s 额外等待)
1212
  await page.setContent(fullHtml, { waitUntil: 'load', timeout: 15000 });
vendor/mermaid-10.9.1.min.js ADDED
The diff for this file is too large to render. See raw diff