Skip to content

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

perf(webui): reduce tier star animation overhead

myhloli9791a1963edb
diff --git a/mineru/resources/gradio_tier.css b/mineru/resources/gradio_tier.css
index b1affbf6..febe7da4 100644
--- a/mineru/resources/gradio_tier.css
+++ b/mineru/resources/gradio_tier.css
@@ -35,12 +35,15 @@
.mineru-tier-track { position: absolute; inset: 15px 0; overflow: hidden; border-radius: 99px; background: var(--tier-track); pointer-events: none; }
.mineru-tier-fill { position: absolute; inset: 0 auto 0 0; width: calc(var(--tier-position) * (100% - var(--tier-knob)) + var(--tier-knob) / 2); background: var(--tier-accent); transition: width 180ms cubic-bezier(.2,.85,.25,1); }
.mineru-tier-capsule[data-tier="advanced"] .mineru-tier-fill { background: linear-gradient(105deg, #3d56d8, #9574ed 55%, #9b66e5); }
-/* 两种动效复用八个星点,GPU 优先采用单向快速流动;星光始终由填充区域裁切。 */
+/* 两种动效复用最多十二个星点,按档位显隐;GPU 优先采用单向快速流动。 */
.mineru-tier-stars { position: absolute; inset: 0; display: none; overflow: hidden; pointer-events: none; }
.mineru-tier-capsule[data-stars="slow"] .mineru-tier-stars,
.mineru-tier-capsule[data-stars="fast"] .mineru-tier-stars { display: block; }
-.mineru-tier-star { position: absolute; top: var(--star-y); left: 0; width: 100%; height: var(--star-size, 2px); opacity: .55; animation: mineru-tier-twinkle var(--star-period) var(--star-delay) ease-in-out infinite alternate; }
-.mineru-tier-star::before { content: ""; position: absolute; top: 0; left: var(--star-x); width: var(--star-size, 2px); height: 100%; border-radius: 50%; background: #fff; box-shadow: 0 0 3px #ffffff45; }
+.mineru-tier-star { position: absolute; top: var(--star-y); left: var(--star-x); width: var(--star-size, 2px); height: var(--star-size, 2px); opacity: .55; animation: mineru-tier-twinkle var(--star-period) var(--star-delay) ease-in-out infinite alternate; }
+.mineru-tier-star[hidden] { display: none !important; }
+.mineru-tier-star::before { content: ""; position: absolute; inset: 0; border-radius: 50%; background: #fff; box-shadow: 0 0 3px #ffffff45; }
+/* 仅为可见且正在播放的微小星点保留合成层;离屏暂停时允许浏览器回收。 */
+.mineru-tier-capsule[data-stars-paused="false"] .mineru-tier-star { will-change: transform, opacity; }
.mineru-tier-star:nth-child(1) { --star-x: 8%; --star-y: 25%; --star-size: 2px; --star-period: 4.2s; --star-delay: -2.2s; }
.mineru-tier-star:nth-child(2) { --star-x: 20%; --star-y: 65%; --star-size: 3px; --star-period: 5.1s; --star-delay: -1.6s; }
.mineru-tier-star:nth-child(3) { --star-x: 32%; --star-y: 42%; --star-size: 2px; --star-period: 3.7s; --star-delay: -3s; }
@@ -49,19 +52,24 @@
.mineru-tier-star:nth-child(6) { --star-x: 68%; --star-y: 60%; --star-size: 2px; --star-period: 4.6s; --star-delay: -2.8s; }
.mineru-tier-star:nth-child(7) { --star-x: 80%; --star-y: 28%; --star-size: 2px; --star-period: 5s; --star-delay: -1s; }
.mineru-tier-star:nth-child(8) { --star-x: 92%; --star-y: 68%; --star-size: 2px; --star-period: 3.9s; --star-delay: -2.5s; }
-.mineru-tier-capsule[data-stars="fast"] .mineru-tier-star { animation: mineru-tier-flow-left calc(var(--star-period) * .35) var(--star-delay) linear infinite; }
-.mineru-tier-capsule[data-stars="fast"] .mineru-tier-star::before { left: 0; }
+.mineru-tier-star:nth-child(9) { --star-y: 18%; --star-size: 2px; --star-period: 4.4s; --star-delay: -.3s; }
+.mineru-tier-star:nth-child(10) { --star-y: 80%; --star-size: 3px; --star-period: 5.3s; --star-delay: -4.2s; }
+.mineru-tier-star:nth-child(11) { --star-y: 50%; --star-size: 2px; --star-period: 4s; --star-delay: -1.2s; }
+.mineru-tier-star:nth-child(12) { --star-y: 38%; --star-size: 2px; --star-period: 4.9s; --star-delay: -3.7s; }
+/* 像素端点仅随填充尺寸更新,循环播放只改变 transform 和透明度,不逐帧布局。 */
+.mineru-tier-capsule[data-stars="fast"] .mineru-tier-star { left: 0; animation: mineru-tier-flow-left calc(var(--star-period) * .35) var(--star-delay) linear infinite; }
+.mineru-tier-capsule[data-stars-paused="true"] .mineru-tier-star { animation-play-state: paused; }
@keyframes mineru-tier-twinkle {
0% { opacity: .12; transform: translate(-7px, 2px); }
48% { opacity: .8; }
100% { opacity: .25; transform: translate(8px, -3px); }
}
@keyframes mineru-tier-flow-left {
- 0% { opacity: 0; transform: translateX(105%); }
+ 0% { opacity: 0; transform: translate3d(var(--star-start, 0px), 0, 0); }
12% { opacity: .7; }
52% { opacity: .9; }
88% { opacity: .5; }
- 100% { opacity: 0; transform: translateX(-5%); }
+ 100% { opacity: 0; transform: translate3d(var(--star-end, 0px), 0, 0); }
}
.mineru-tier-dots { position: absolute; inset: 0 calc(var(--tier-knob) / 2); display: flex; justify-content: space-between; align-items: center; pointer-events: none; }
.mineru-tier-dot { width: 6px; height: 6px; margin-inline: -3px; border-radius: 50%; background: var(--tier-dot); }
@@ -99,6 +107,6 @@
}
@media (prefers-reduced-motion: reduce) {
.mineru-tier-fill, .mineru-tier-thumb { transition: none; }
- .mineru-tier-star { animation: none !important; }
- .mineru-tier-capsule[data-stars="fast"] .mineru-tier-star::before { left: var(--star-x); }
+ .mineru-tier-capsule[data-stars-paused] .mineru-tier-star { animation: none !important; will-change: auto; }
+ .mineru-tier-capsule[data-stars="fast"] .mineru-tier-star { left: var(--star-x); }
}
diff --git a/mineru/resources/gradio_tier.html b/mineru/resources/gradio_tier.html
index edda4c2e..90d8f912 100644
--- a/mineru/resources/gradio_tier.html
+++ b/mineru/resources/gradio_tier.html
@@ -26,6 +26,8 @@
<span class="mineru-tier-star"></span><span class="mineru-tier-star"></span>
<span class="mineru-tier-star"></span><span class="mineru-tier-star"></span>
<span class="mineru-tier-star"></span><span class="mineru-tier-star"></span>
+ <span class="mineru-tier-star"></span><span class="mineru-tier-star"></span>
+ <span class="mineru-tier-star"></span><span class="mineru-tier-star"></span>
</span></div></div>
<div class="mineru-tier-dots" aria-hidden="true"></div>
<div class="mineru-tier-thumb" aria-hidden="true"></div>
diff --git a/mineru/resources/gradio_tier.js b/mineru/resources/gradio_tier.js
index bb5cb33e..a302f676 100644
--- a/mineru/resources/gradio_tier.js
+++ b/mineru/resources/gradio_tier.js
@@ -11,6 +11,12 @@
const current = element.querySelector(".mineru-tier-current");
const deviceButton = element.querySelector(".mineru-tier-device");
const deviceTooltip = element.querySelector(".mineru-tier-device-tooltip");
+ const fill = element.querySelector(".mineru-tier-fill");
+ const starLayer = element.querySelector(".mineru-tier-stars");
+ // 各档位的星点数量集中配置;Flash 的填充位于圆点下方,不显示星点。
+ const starCounts = { flash: 0, basic: 4, standard: 8, advanced: 12 };
+ const stars = [...element.querySelectorAll(".mineru-tier-star")];
+ let starCount = -1;
let runtimeDevice = null;
let drag = null;
let committed = Number(props.value);
@@ -39,14 +45,54 @@
+ current.getBoundingClientRect().width + 54);
capsule.classList.toggle("is-wide", capsule.getBoundingClientRect().width >= minimumWidth);
};
- const resizeObserver = new ResizeObserver(resize);
+ // 只在填充宽度变化时更新像素端点;固定尺寸星点不依赖 Safari 缓存的百分比变换距离。
+ const resizeObserver = new ResizeObserver(entries => {
+ for (const entry of entries) {
+ if (entry.target === capsule) resize();
+ if (entry.target === fill) {
+ const width = entry.contentRect.width;
+ starLayer.style.setProperty("--star-start", `${width * 1.05}px`);
+ starLayer.style.setProperty("--star-end", `${width * -.05}px`);
+ }
+ }
+ });
resizeObserver.observe(capsule);
+ resizeObserver.observe(fill);
resize();
+ let inViewport = false;
+ // 页面后台和控件离屏时停止合成动画,恢复可见后从原有进度继续。
+ const syncStarPlayback = () => {
+ capsule.dataset.starsPaused = String(ownerDocument.hidden || !inViewport);
+ };
+ // 卸载时释放新增观察器及文档监听,避免后台持有旧控件。
+ const intersectionObserver = new IntersectionObserver(entries => {
+ if (!capsule.isConnected) {
+ resizeObserver.disconnect();
+ intersectionObserver.disconnect();
+ ownerDocument.removeEventListener("visibilitychange", syncStarPlayback);
+ return;
+ }
+ inViewport = entries[entries.length - 1].isIntersecting;
+ syncStarPlayback();
+ });
+ intersectionObserver.observe(capsule);
+ ownerDocument.addEventListener("visibilitychange", syncStarPlayback);
+ syncStarPlayback();
+
// 设备信息独立于档位偏好;提示、颜色和动效只消费当前页面的只读快照。
const renderDevice = () => {
capsule.dataset.runtime = runtimeDevice || "unknown";
capsule.dataset.stars = runtimeDevice === "gpu" ? "fast" : capsule.dataset.tier === "advanced" ? "slow" : "none";
+ const count = starCounts[capsule.dataset.tier];
+ if (count !== starCount) {
+ starCount = count;
+ // 仅在跨档位时调整现有节点,保留已显示星点的动画进度;静态星点按当前数量均匀分布。
+ for (const [index, star] of stars.entries()) {
+ star.hidden = index >= count;
+ if (index < count) star.style.setProperty("--star-x", `${(index + 0.5) * 100 / count}%`);
+ }
+ }
const message = text(`runtime_device_${runtimeDevice || "unknown"}`) || "设备状态未知";
setText(".mineru-tier-device-tooltip", message);
setAttribute(deviceButton, "aria-label", message);
diff --git a/tests/unittest/test_kit_gradio_tier.cjs b/tests/unittest/test_kit_gradio_tier.cjs
index 0c9117a2..b2da4beb 100644
--- a/tests/unittest/test_kit_gradio_tier.cjs
+++ b/tests/unittest/test_kit_gradio_tier.cjs
@@ -4,6 +4,7 @@ const fs = require("node:fs");
const path = require("node:path");
const vm = require("node:vm");
const script = fs.readFileSync(path.join(__dirname, "../../mineru/resources/gradio_tier.js"), "utf8");
+const template = fs.readFileSync(path.join(__dirname, "../../mineru/resources/gradio_tier.html"), "utf8");
// 最小 DOM 保留输入值、属性和事件;不替代生产状态转换算法。
function node() {
@@ -58,9 +59,11 @@ function node() {
// 每个控件独立持有 props 和提交记录,模拟 Gradio watch 的输出回执。
function setup(tiers, position = 0, defaultIndex = position) {
const nodes = Object.fromEntries(["capsule", "rail", "thumb", "range", "reset", "dots", "title", "current", "options", "announcement",
- "label", "device", "device-tooltip"]
+ "label", "device", "device-tooltip", "fill", "stars"]
.map(name => [name, node()]));
nodes["device-tooltip"].hidden = true;
+ nodes.capsule.isConnected = true;
+ const stars = Array.from({ length: (template.match(/class="mineru-tier-star"/g) || []).length }, node);
const props = { value: position, selected_tier: tiers[position], locked: false };
const submissions = [];
// 保留目标档位参数,验证动态按钮说明没有使用当前档位替代默认值。
@@ -82,19 +85,36 @@ function setup(tiers, position = 0, defaultIndex = position) {
return new Promise((resolve, reject) => { receiveRuntime = resolve; rejectRuntime = reject; });
},
};
- const ownerDocument = { ...node(), body: node(), createElement: node };
- // 不模拟浏览器布局,只提供生产脚本所需的尺寸观察接口。
+ const ownerDocument = { ...node(), body: node(), createElement: node, hidden: false };
+ const observers = [];
+ // 重放尺寸通知和离屏通知,不替浏览器计算几何与可见性。
class ResizeObserver {
- // 控件在本测试中不会改变布局,无需触发异步尺寸回调。
- observe() {}
+ // 保存生产回调以验证填充尺寸变化后更新运动端点。
+ constructor(callback) { this.callback = callback; this.targets = []; observers.push(this); }
+ // 记录被观察元素,允许按真实目标派发通知。
+ observe(target) { this.targets.push(target); }
+ // 卸载后观察器必须释放控件。
+ disconnect() { this.targets = []; }
}
- vm.runInNewContext(`(${script})`, { window, document: ownerDocument, ResizeObserver })({
- element: { ownerDocument, querySelector: selector => nodes[selector.replace(".mineru-tier-", "")] },
+ // 两种观察器共享最小注册接口,但通知内容由调用方明确给出。
+ class IntersectionObserver extends ResizeObserver {}
+ vm.runInNewContext(`(${script})`, { window, document: ownerDocument, ResizeObserver, IntersectionObserver })({
+ element: {
+ ownerDocument, querySelector: selector => nodes[selector.replace(".mineru-tier-", "")],
+ // 使用真实模板中的节点数,确保增加档位星点时同步扩展了固定节点池。
+ querySelectorAll: selector => selector === ".mineru-tier-star" ? stars : [],
+ },
props, tiers, defaultIndex, server,
trigger: event => { submissions.push([event, props.value]); },
watch: (_keys, callback) => { watcher = callback; },
});
- return { nodes, props, submissions, window, document: ownerDocument,
+ return { nodes, stars, observers, props, submissions, window, document: ownerDocument,
+ // 复现 CSS 吸附或窗口变化产生的尺寸通知,不调用额外的 render。
+ fillWidth(width) { observers[0].callback([{ target: nodes.fill, contentRect: { width } }]); },
+ // 可见性只控制动画播放,不能改写档位或触发设备查询。
+ intersect(isIntersecting) { observers[1].callback([{ target: nodes.capsule, isIntersecting }]); },
+ // 页面后台独立于控件是否在可视区域。
+ pageHidden(hidden) { ownerDocument.hidden = hidden; ownerDocument.events.visibilitychange(); },
// 排空设备响应微任务后检查真实前端处理结果。
async runtime(value) { receiveRuntime(value); await Promise.resolve(); },
// 失败时等待 catch 完成,确保未知状态不影响其余控件。
@@ -240,7 +260,7 @@ for (const reason of ["escape", "pointercancel"]) {
assert.equal(fast.submissions.length, count);
assert.equal(fast.nodes.rail.capture, null);
assert.equal(fast.document.body.children.length, 0);
- assert.deepEqual(Object.keys(fast.document.events).sort(), ["keydown", "pointerdown"]);
+ assert.deepEqual(Object.keys(fast.document.events).sort(), ["keydown", "pointerdown", "visibilitychange"]);
}
// 按住时失去捕获仍由页面事件跟踪,在胶囊外松手也只提交一次最终位置。
@@ -256,7 +276,7 @@ outside.pointer("pointerup", outside.x(1.1));
assert.equal(outside.props.value, 1);
assert.deepEqual(outside.submissions, [["input", 1]]);
assert.equal(outside.document.body.children.length, 0);
-assert.deepEqual(Object.keys(outside.document.events).sort(), ["keydown", "pointerdown"]);
+assert.deepEqual(Object.keys(outside.document.events).sort(), ["keydown", "pointerdown", "visibilitychange"]);
// 已松手的捕获丢失、输入或窗口失焦均保留最后位置,不能退回起点。
for (const reason of ["released-capture", "input-blur", "window-blur", "missed-up"]) {
@@ -276,7 +296,7 @@ for (const reason of ["released-capture", "input-blur", "window-blur", "missed-u
assert.equal(interrupted.props.value, 1);
assert.deepEqual(interrupted.submissions, [["input", 1]]);
assert.equal(interrupted.document.body.children.length, 0);
- assert.deepEqual(Object.keys(interrupted.document.events).sort(), ["keydown", "pointerdown"]);
+ assert.deepEqual(Object.keys(interrupted.document.events).sort(), ["keydown", "pointerdown", "visibilitychange"]);
}
// 辅助技术的 input/change 仍生效,重复通知不能产生两次业务提交。
@@ -328,12 +348,22 @@ async function testRuntimeDevice() {
for (const device of ["gpu", "cpu", null, "mps"]) {
for (const [position, tier] of ["flash", "basic", "standard", "advanced"].entries()) {
const runtimeUi = setup(["flash", "basic", "standard", "advanced"], position);
+ const originalStars = [...runtimeUi.stars];
+ const expectedCount = [0, 4, 8, 12][position];
assert.equal(runtimeUi.runtimeReads(), 1);
await runtimeUi.runtime(device);
const expectedDevice = ["cpu", "gpu"].includes(device) ? device : "unknown";
const expectedEffect = device === "gpu" ? "fast" : tier === "advanced" ? "slow" : "none";
assert.equal(runtimeUi.nodes.capsule.dataset.runtime, expectedDevice);
assert.equal(runtimeUi.nodes.capsule.dataset.stars, expectedEffect);
+ const visibleStars = runtimeUi.stars.filter(star => !star.hidden);
+ assert.equal(visibleStars.length, expectedCount);
+ // 减少动态效果或慢速星光时,当前可见星点仍应分布到整段填充区域。
+ for (const [index, star] of visibleStars.entries()) {
+ const x = parseFloat(star.style["--star-x"]);
+ assert(Math.abs(x - (index + 0.5) * 100 / expectedCount) < 1e-9);
+ assert(x > 0 && x < 100);
+ }
assert.equal(runtimeUi.nodes.device.attributes["aria-label"], `runtime_device_${expectedDevice}`);
assert.equal(runtimeUi.nodes["device-tooltip"].hidden, true);
runtimeUi.nodes.device.events.pointerenter();
@@ -353,9 +383,13 @@ async function testRuntimeDevice() {
assert.equal(runtimeUi.props.value, position);
assert.deepEqual(runtimeUi.submissions, []);
runtimeUi.update({ locked: true, selected_tier: "flash" });
+ assert.equal(runtimeUi.stars.filter(star => !star.hidden).length, 0);
assert.equal(runtimeUi.nodes.capsule.dataset.runtime, expectedDevice);
assert.equal(runtimeUi.nodes.capsule.dataset.stars, device === "gpu" ? "fast" : "none");
runtimeUi.update({ locked: false, selected_tier: tier });
+ assert.equal(runtimeUi.stars.filter(star => !star.hidden).length, expectedCount);
+ // 切档、文件锁定及设备响应都复用同一批节点,不重建已运行的动画。
+ assert(runtimeUi.stars.every((star, index) => star === originalStars[index]));
assert.equal(runtimeUi.nodes.capsule.dataset.stars, expectedEffect);
// 语言变化只重绘提示,设备快照不能被清空或重新读取。
runtimeUi.window.__mineruI18n.text = key => `en:${key}`;
@@ -368,6 +402,7 @@ async function testRuntimeDevice() {
late.pointer("pointerdown", late.x(1));
late.pointer("pointermove", late.x(1.8));
await late.runtime("gpu");
+ assert.equal(late.stars.filter(star => !star.hidden).length, 8);
assert(Math.abs(late.visual() - 1.8) < 1e-9);
assert(late.nodes.capsule.classList.contains("is-dragging"));
assert.equal(late.props.value, 1);
@@ -380,6 +415,37 @@ async function testRuntimeDevice() {
assert.equal(failed.nodes.capsule.dataset.runtime, "unknown");
assert.equal(failed.nodes.capsule.dataset.stars, "slow");
assert.equal(failed.nodes.options.hidden, true);
+
+ // GPU 动画距离必须跟随真实填充宽度,切档或缩放后不能保留上一档端点。
+ const playback = setup(["flash", "basic", "standard", "advanced"], 2);
+ await playback.runtime("gpu");
+ playback.fillWidth(195);
+ assert.equal(playback.nodes.stars.style["--star-start"], "204.75px");
+ playback.key("End");
+ playback.fillWidth(285);
+ assert.equal(playback.nodes.stars.style["--star-start"], "299.25px");
+ assert.equal(playback.nodes.stars.style["--star-end"], "-14.25px");
+ playback.fillWidth(100);
+ assert.equal(playback.nodes.stars.style["--star-start"], "105px");
+
+ // 离屏与后台暂停条件取并集,重新进入视口时也不能唤醒后台动画。
+ assert.equal(playback.nodes.capsule.dataset.starsPaused, "true");
+ playback.intersect(true);
+ assert.equal(playback.nodes.capsule.dataset.starsPaused, "false");
+ playback.pageHidden(true);
+ assert.equal(playback.nodes.capsule.dataset.starsPaused, "true");
+ playback.intersect(false);
+ playback.pageHidden(false);
+ assert.equal(playback.nodes.capsule.dataset.starsPaused, "true");
+ playback.intersect(true);
+ assert.equal(playback.nodes.capsule.dataset.starsPaused, "false");
+ assert.equal(playback.nodes.capsule.dataset.stars, "fast");
+ assert.equal(playback.props.value, 3);
+ assert.equal(playback.runtimeReads(), 1);
+ playback.nodes.capsule.isConnected = false;
+ playback.intersect(false);
+ assert(playback.observers.every(observer => observer.targets.length === 0));
+ assert.equal(playback.document.events.visibilitychange, undefined);
}
// 异步断言失败必须使 Node 及调用它的 pytest 返回失败。
testRuntimeDevice().catch(error => { console.error(error); process.exitCode = 1; });