Spaces:
Running
Running
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 +86 -0
- server.js +17 -1
- vendor/mermaid-10.9.1.min.js +0 -0
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 |
-
|
|
|
|
|
|
|
|
|
|
| 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
|
|
|