cursor-fx-userscript.user.js

// ==UserScript==
// @name         Cursor FX
// @name:zh-CN   自定义鼠标光标特效
// @namespace    https://github.com/Xinyang-Gao/cursor-fx-userscript
// @version      3.0.0
// @description  Smooth custom cursor: delayed ring follow, hover fitting, text caret mode, click spring scale, scroll trail. GPU-composited, frame-rate independent, auto-pauses when idle. Settings panel via the Tampermonkey menu.
// @description:zh-CN  隐藏系统指针，使用圆点 + 圆环自定义光标：延迟跟随、悬停贴合、文本竖条、点击弹性缩放、滚动拖尾。transform 合成层定位，帧率无关平滑，空闲自动暂停。点击篡改猴菜单中的「⚙ 光标设置」打开设置面板，实时调节、自动保存。
// @author       Xinyang-Gao
// @license      MIT
// @icon         https://raw.githubusercontent.com/Xinyang-Gao/cursor-fx-userscript/main/assets/logo.png
// @match        *://*/*
// @run-at       document-start
// @grant        GM_registerMenuCommand
// @grant        GM_unregisterMenuCommand
// @grant        GM_getValue
// @grant        GM_setValue
// @grant        GM_deleteValue
// @noframes
// @homepageURL  https://github.com/Xinyang-Gao/cursor-fx-userscript
// @supportURL   https://github.com/Xinyang-Gao/cursor-fx-userscript/issues
// @downloadURL  https://raw.githubusercontent.com/Xinyang-Gao/cursor-fx-userscript/main/cursor-fx-userscript.user.js
// @updateURL    https://raw.githubusercontent.com/Xinyang-Gao/cursor-fx-userscript/main/cursor-fx-userscript.meta.js
// ==/UserScript==

(function () {
    'use strict';

    const SCRIPT_VERSION = '3.0.0';
    const WEB_API_VERSION = '1.3';

    // ==================== I18N ====================
    const LANGUAGES = {
        'zh-CN': {
            dict: {
                menu: { settings: '⚙ 光标设置' },
                title: 'Cursor FX 设置',
                version: 'v{v}',
                reducedMotionMsg: '系统启用了「减少动态效果」，动画已自动弱化',
                a11y: { close: '关闭', dialog: 'Cursor FX 设置面板' },
                groups: {
                    appearance: '外观', fit: '贴合', follow: '跟随',
                    click: '点击', scroll: '滚动', text: '文本', other: '其他'
                },
                labels: {
                    ENABLE_DOT: '启用圆点', ENABLE_RING: '启用圆环', HIDE_CURSOR: '隐藏系统鼠标',
                    DOT_SIZE: '圆点大小', RING_SIZE: '圆环大小', RING_BORDER: '圆环粗细',
                    RING_ALPHA: '圆环透明度', FIT_PADDING: '贴合留白', MAX_FIT_SIZE: '最大贴合尺寸',
                    FOLLOW_SPEED: '跟随速度', FIT_SPEED: '吸附速度', SHAPE_SPEED: '形变速度',
                    CLICK_SCALE: '按下缩放', SPRING_K: '回弹刚度', SPRING_DAMP: '回弹阻尼',
                    SCROLL_ENABLED: '启用滚轮反馈', SCROLL_MAX: '拖尾幅度', SCROLL_DECAY: '拖尾回收',
                    TEXT_BAR_W: '竖条宽度', TEXT_BAR_H: '竖条高度', TEXT_RING_SIZE: '文本环大小',
                    TEXT_RING_ALPHA: '文本环透明度', IDLE_PAUSE_MS: '空闲暂停'
                },
                buttons: {
                    reset: '恢复默认', close: '完成',
                    saved: '✓ 已保存', restored: '✓ 已恢复默认'
                },
                settings: {
                    language: '界面语言',
                    langOptionZh: '简体中文',
                    langOptionEn: 'English'
                }
            }
        },
        'en': {
            dict: {
                menu: { settings: '⚙ Cursor FX Settings' },
                title: 'Cursor FX Settings',
                version: 'v{v}',
                reducedMotionMsg: 'System "Reduce Motion" is enabled. Animations are minimized.',
                a11y: { close: 'Close', dialog: 'Cursor FX settings panel' },
                groups: {
                    appearance: 'Appearance', fit: 'Fitting', follow: 'Following',
                    click: 'Click', scroll: 'Scroll', text: 'Text', other: 'Other'
                },
                labels: {
                    ENABLE_DOT: 'Enable Dot', ENABLE_RING: 'Enable Ring', HIDE_CURSOR: 'Hide System Cursor',
                    DOT_SIZE: 'Dot Size', RING_SIZE: 'Ring Size', RING_BORDER: 'Ring Border',
                    RING_ALPHA: 'Ring Opacity', FIT_PADDING: 'Fit Padding', MAX_FIT_SIZE: 'Max Fit Size',
                    FOLLOW_SPEED: 'Follow Speed', FIT_SPEED: 'Fit Speed', SHAPE_SPEED: 'Shape Speed',
                    CLICK_SCALE: 'Click Scale', SPRING_K: 'Spring Stiffness', SPRING_DAMP: 'Spring Damping',
                    SCROLL_ENABLED: 'Enable Scroll Feedback', SCROLL_MAX: 'Scroll Trail Max', SCROLL_DECAY: 'Scroll Decay',
                    TEXT_BAR_W: 'Bar Width', TEXT_BAR_H: 'Bar Height', TEXT_RING_SIZE: 'Text Ring Size',
                    TEXT_RING_ALPHA: 'Text Ring Alpha', IDLE_PAUSE_MS: 'Idle Pause'
                },
                buttons: {
                    reset: 'Reset Defaults', close: 'Done',
                    saved: '✓ Saved', restored: '✓ Defaults Restored'
                },
                settings: {
                    language: 'Interface Language',
                    langOptionZh: '简体中文',
                    langOptionEn: 'English'
                }
            }
        }
    };

    const STORE_PREFIX = 'CursorFX.';
    const hasGM = typeof GM_getValue === 'function';

    function readRaw(key) {
        try {
            return hasGM ? GM_getValue(STORE_PREFIX + key, null) : localStorage.getItem(STORE_PREFIX + key);
        } catch { return null; }
    }
    function writeRaw(key, s) {
        try {
            if (hasGM) GM_setValue(STORE_PREFIX + key, s);
            else localStorage.setItem(STORE_PREFIX + key, s);
        } catch { /* ignore */ }
    }
    function eraseRaw(key) {
        try {
            if (typeof GM_deleteValue === 'function') GM_deleteValue(STORE_PREFIX + key);
            else localStorage.removeItem(STORE_PREFIX + key);
        } catch { /* ignore */ }
    }

    function getInitialLang() {
        const stored = readRaw('lang');
        if (stored && LANGUAGES[stored]) return stored;

        const candidates = navigator.languages || [navigator.language || 'en'];
        for (const lang of candidates) {
            if (LANGUAGES[lang]) return lang;
            const base = lang.split('-')[0];
            if (base === 'zh') return 'zh-CN';
            if (LANGUAGES[base]) return base;
        }
        return 'en';
    }

    let CURRENT_LANG = getInitialLang();

    function t(key, params) {
        const dict = LANGUAGES[CURRENT_LANG].dict;
        const val = key.split('.').reduce((o, k) => (o ? o[k] : null), dict);
        if (val == null) return key;
        if (!params) return val;
        return val.replace(/\{(\w+)\}/g, (m, p) => params[p] !== undefined ? params[p] : m);
    }

    function saveLang(lang) { writeRaw('lang', lang); }

    // ==================== 可调参数 ====================
    const DEFAULTS = {
        ENABLE_DOT: true,
        ENABLE_RING: true,
        HIDE_CURSOR: true,

        DOT_SIZE: 8,
        RING_SIZE: 40,
        RING_BORDER: 1.5,
        RING_ALPHA: 0.9,
        TEXT_RING_ALPHA: 0.4,
        TEXT_RING_SIZE: 24,
        MAX_FIT_SIZE: 200,
        FIT_PADDING: 6,
        TEXT_BAR_W: 2,
        TEXT_BAR_H: 22,
        FOLLOW_SPEED: 16,
        FIT_SPEED: 26,
        SHAPE_SPEED: 18,
        SCROLL_ENABLED: true,
        SCROLL_MAX: 30,
        SCROLL_DECAY: 7,
        CLICK_SCALE: 0.78,
        SPRING_K: 520,
        SPRING_DAMP: 21,
        IDLE_PAUSE_MS: 2500,
    };
    const CFG = { ...DEFAULTS };

    const clamp = (v, a, b) => v < a ? a : (v > b ? b : v);

    if (matchMedia('(pointer: coarse)').matches) return;

    // ---------- 字段定义 ----------
    const FIELDS = [
        { g: 'appearance', key: 'ENABLE_DOT', label: 'ENABLE_DOT', type: 'bool' },
        { g: 'appearance', key: 'ENABLE_RING', label: 'ENABLE_RING', type: 'bool' },
        { g: 'other', key: 'HIDE_CURSOR', label: 'HIDE_CURSOR', type: 'bool' },

        { g: 'appearance', key: 'DOT_SIZE', label: 'DOT_SIZE', min: 2, max: 24, step: 1, unit: 'px', deps: ['ENABLE_DOT'] },
        { g: 'appearance', key: 'RING_SIZE', label: 'RING_SIZE', min: 16, max: 96, step: 2, unit: 'px', deps: ['ENABLE_RING'] },
        { g: 'appearance', key: 'RING_BORDER', label: 'RING_BORDER', min: 0.5, max: 6, step: 0.5, unit: 'px', deps: ['ENABLE_RING'] },
        { g: 'appearance', key: 'RING_ALPHA', label: 'RING_ALPHA', min: 0.1, max: 1, step: 0.05, unit: '', deps: ['ENABLE_RING'] },
        { g: 'fit', key: 'FIT_PADDING', label: 'FIT_PADDING', min: 0, max: 24, step: 1, unit: 'px', deps: ['ENABLE_RING'] },
        { g: 'fit', key: 'MAX_FIT_SIZE', label: 'MAX_FIT_SIZE', min: 80, max: 480, step: 10, unit: 'px', deps: ['ENABLE_RING'] },
        { g: 'follow', key: 'FOLLOW_SPEED', label: 'FOLLOW_SPEED', min: 2, max: 40, step: 1, unit: '' },
        { g: 'follow', key: 'FIT_SPEED', label: 'FIT_SPEED', min: 4, max: 80, step: 1, unit: '', deps: ['ENABLE_RING'] },
        { g: 'follow', key: 'SHAPE_SPEED', label: 'SHAPE_SPEED', min: 4, max: 80, step: 1, unit: '', deps: ['ENABLE_RING'] },
        { g: 'click', key: 'CLICK_SCALE', label: 'CLICK_SCALE', min: 0.4, max: 1, step: 0.02, unit: '', deps: ['ENABLE_DOT', 'ENABLE_RING'] },
        { g: 'click', key: 'SPRING_K', label: 'SPRING_K', min: 100, max: 1200, step: 20, unit: '', deps: ['ENABLE_DOT', 'ENABLE_RING'] },
        { g: 'click', key: 'SPRING_DAMP', label: 'SPRING_DAMP', min: 5, max: 40, step: 1, unit: '', deps: ['ENABLE_DOT', 'ENABLE_RING'] },
        { g: 'scroll', key: 'SCROLL_ENABLED', label: 'SCROLL_ENABLED', type: 'bool' },
        { g: 'scroll', key: 'SCROLL_MAX', label: 'SCROLL_MAX', min: 0, max: 80, step: 2, unit: 'px', deps: ['SCROLL_ENABLED'] },
        { g: 'scroll', key: 'SCROLL_DECAY', label: 'SCROLL_DECAY', min: 1, max: 20, step: 0.5, unit: '', deps: ['SCROLL_ENABLED'] },
        { g: 'text', key: 'TEXT_BAR_W', label: 'TEXT_BAR_W', min: 1, max: 6, step: 0.5, unit: 'px', deps: ['ENABLE_DOT'] },
        { g: 'text', key: 'TEXT_BAR_H', label: 'TEXT_BAR_H', min: 12, max: 40, step: 1, unit: 'px', deps: ['ENABLE_DOT'] },
        { g: 'text', key: 'TEXT_RING_SIZE', label: 'TEXT_RING_SIZE', min: 12, max: 64, step: 2, unit: 'px', deps: ['ENABLE_RING'] },
        { g: 'text', key: 'TEXT_RING_ALPHA', label: 'TEXT_RING_ALPHA', min: 0.1, max: 1, step: 0.05, unit: '', deps: ['ENABLE_RING'] },
        { g: 'other', key: 'IDLE_PAUSE_MS', label: 'IDLE_PAUSE_MS', min: 500, max: 10000, step: 250, unit: 'ms' },
    ];
    const FMAP = Object.create(null);
    for (const f of FIELDS) FMAP[f.key] = f;

    // ---------- 覆盖值加载 ----------
    const overrides = Object.create(null);
    {
        let raw = {};
        try { raw = JSON.parse(readRaw('overrides') || '{}'); } catch { raw = {}; }
        for (const f of FIELDS) {
            const v = raw[f.key];
            if (f.type === 'bool') {
                if (typeof v === 'boolean') overrides[f.key] = v;
            } else if (typeof v === 'number' && isFinite(v)) {
                overrides[f.key] = clamp(v, f.min, f.max);
            }
        }
    }

    const RM = matchMedia('(prefers-reduced-motion: reduce)').matches;
    const RM_KEYS = RM
        ? new Set(['FOLLOW_SPEED', 'FIT_SPEED', 'SHAPE_SPEED', 'SCROLL_MAX', 'SCROLL_DECAY', 'SPRING_K', 'SPRING_DAMP'])
        : null;
    const RM_PATCH = RM ? {
        FOLLOW_SPEED: 1e4, FIT_SPEED: 1e4, SHAPE_SPEED: 1e4,
        SCROLL_MAX: 0, SCROLL_DECAY: 1e4, SPRING_K: 1e4, SPRING_DAMP: 1e4,
    } : null;

    // ---------- 选择器 & 几何工具 ----------
    const SEL_INTERACTIVE = 'a, button, [role="button"], [tabindex]:not([tabindex="-1"]), [onclick]';
    const SEL_TEXT = [
        'input:not([type="button"]):not([type="checkbox"]):not([type="radio"]):not([type="submit"]):not([type="reset"]):not([type="image"]):not([type="range"]):not([type="color"]):not([type="file"])',
        'textarea', '[contenteditable="true"]', '[contenteditable=""]',
        '[contenteditable="plaintext-only"]', '[role="textbox"]',
    ].join(',');

    function parseBorderRadius(el, rect) {
        const br = getComputedStyle(el).borderRadius || '0px';
        const parts = br.split(/\s+/);
        const minSide = Math.min(rect.width, rect.height);
        let max = 0;
        for (const p of parts) {
            const v = parseFloat(p);
            if (!isFinite(v)) continue;
            max = Math.max(max, p.endsWith('%') ? (v / 100 * minSide) : v);
        }
        return max;
    }

    function measure(el) {
        const r = el.getBoundingClientRect();
        if (r.width === 0 && r.height === 0) return null;
        if (r.width > CFG.MAX_FIT_SIZE || r.height > CFG.MAX_FIT_SIZE) return null;
        return parseBorderRadius(el, r);
    }

    function writeTransform(el, x, y, s, cache) {
        const qx = Math.round(x * 100) / 100;
        const qy = Math.round(y * 100) / 100;
        const qs = Math.round(s * 1000) / 1000;
        if (cache.x === qx && cache.y === qy && cache.s === qs) return;
        cache.x = qx; cache.y = qy; cache.s = qs;
        el.style.transform = 'translate3d(' + qx + 'px,' + qy + 'px,0) translate(-50%,-50%) scale(' + qs + ')';
    }

    // ---------- 样式 ----------
    const styleEl = document.createElement('style');

    function renderCSS() {
        const cursorRule = CFG.HIDE_CURSOR
            ? '*, *::before, *::after { cursor: none !important; }'
            : '';
        const dotDisplay = CFG.ENABLE_DOT ? '' : '.cc-dot { display: none !important; }';
        const ringDisplay = CFG.ENABLE_RING ? '' : '.cc-ring { display: none !important; }';

        styleEl.textContent = `
            ${cursorRule}
            .cc-dot, .cc-ring {
                position: fixed; left: 0; top: 0;
                pointer-events: none;
                z-index: 2147483647;
                mix-blend-mode: difference;
                will-change: transform;
                opacity: 0;
            }
            .cc-dot {
                width: ${CFG.DOT_SIZE}px; height: ${CFG.DOT_SIZE}px;
                background: #fff; border-radius: 50%;
                transition: opacity .3s ease, width .22s ease, height .22s ease, border-radius .22s ease;
            }
            .cc-ring {
                width: ${CFG.RING_SIZE}px; height: ${CFG.RING_SIZE}px;
                border: ${CFG.RING_BORDER}px solid rgb(255 255 255 / var(--ccA, ${CFG.RING_ALPHA}));
                border-radius: 50%;
                transition: opacity .3s ease, border-color .25s ease;
            }
            .cc-live { opacity: 1; }
            ${dotDisplay}
            ${ringDisplay}
        `;
    }

    // ---------- 光标控制器 ----------
    class CursorController {
        constructor() {
            this.dotEl = null;
            this.ringEl = null;
            this.abortCtrl = null;
            this.rafId = 0;
            this.active = false;
            this._tickBound = this._tick.bind(this);
            this.dotCache = { x: NaN, y: NaN, s: NaN };
            this.ringCache = { x: NaN, y: NaN, s: NaN };
        }

        isMounted() {
            return !!(this.dotEl && this.dotEl.isConnected && this.ringEl && this.ringEl.isConnected);
        }

        mount() {
            if (this.isMounted()) return;
            this.unmount();

            this.dotEl = document.createElement('div');
            this.ringEl = document.createElement('div');
            this.dotEl.className = 'cc-dot';
            this.ringEl.className = 'cc-ring';
            document.documentElement.append(this.ringEl, this.dotEl);

            // 重置运动状态
            const cx = innerWidth / 2, cy = innerHeight / 2;
            this.mx = cx; this.my = cy;
            this.rx = cx; this.ry = cy;
            this.rw = CFG.RING_SIZE; this.rh = CFG.RING_SIZE; this.rr = CFG.RING_SIZE / 2;
            this.lastW = -1; this.lastH = -1; this.lastR = -1;
            this.tw = 0; this.th = 0; this.tr = 0;
            this.sX = 0; this.sY = 0;
            this.dotS = 1; this.ringS = 1; this.dotV = 0; this.ringV = 0;
            this.pressed = false;
            this.hoverEl = null; this.hoverRad = 0;
            this.focusEl = null; this.focusRad = 0;
            this.textEl = null; this.dotIsBar = false; this.ringDim = false;
            this.shown = false; this.inside = true;
            this.lastInput = 0; this.lastT = 0;
            this.dotCache.x = this.dotCache.y = this.dotCache.s = NaN;
            this.ringCache.x = this.ringCache.y = this.ringCache.s = NaN;

            writeTransform(this.dotEl, this.mx, this.my, 1, this.dotCache);
            writeTransform(this.ringEl, this.rx, this.ry, 1, this.ringCache);

            this.abortCtrl = new AbortController();
            const sig = this.abortCtrl.signal;
            this._bindEvents(sig);
            this._installApi(sig);

            this.active = true;
            this.lastT = performance.now();
            this.lastInput = this.lastT;
            this.rafId = requestAnimationFrame(this._tickBound);
        }

        unmount() {
            this.active = false;
            if (this.abortCtrl) { this.abortCtrl.abort(); this.abortCtrl = null; }
            if (this.rafId) { cancelAnimationFrame(this.rafId); this.rafId = 0; }
            if (this.dotEl) this.dotEl.remove();
            if (this.ringEl) this.ringEl.remove();
            this.dotEl = null;
            this.ringEl = null;
        }

        refresh() {
            const { dotEl: dot, ringEl: ring } = this;
            if (!dot || !ring) return;

            const dotTrans = dot.style.transition;
            const ringTrans = ring.style.transition;
            dot.style.transition = 'none';
            ring.style.transition = 'none';

            // 强制重绘一次形状
            const b = this.dotIsBar; this.dotIsBar = !b; this._setDotShape(b);
            const d = this.ringDim; this.ringDim = !d; this._setRingAlpha(d);

            this.lastW = this.lastH = this.lastR = -1;
            this.dotCache.x = this.dotCache.y = this.dotCache.s = NaN;
            this.ringCache.x = this.ringCache.y = this.ringCache.s = NaN;

            requestAnimationFrame(() => {
                if (this.dotEl) this.dotEl.style.transition = dotTrans || '';
                if (this.ringEl) this.ringEl.style.transition = ringTrans || '';
            });

            this.wake();
        }

        show() {
            if (this.shown) return;
            this.shown = true;
            this.dotEl && this.dotEl.classList.add('cc-live');
            this.ringEl && this.ringEl.classList.add('cc-live');
        }

        hide() {
            if (!this.shown) return;
            this.shown = false;
            this.dotEl && this.dotEl.classList.remove('cc-live');
            this.ringEl && this.ringEl.classList.remove('cc-live');
        }

        wake() {
            this.lastInput = performance.now();
            this.show();
            if (!this.rafId) {
                this.lastT = this.lastInput;
                this.rafId = requestAnimationFrame(this._tickBound);
            }
        }

        _setDotShape(bar) {
            if (this.dotIsBar === bar) return;
            this.dotIsBar = bar;
            const d = this.dotEl;
            if (!d) return;
            d.style.width = (bar ? CFG.TEXT_BAR_W : CFG.DOT_SIZE) + 'px';
            d.style.height = (bar ? CFG.TEXT_BAR_H : CFG.DOT_SIZE) + 'px';
            d.style.borderRadius = bar ? '2px' : '50%';
        }

        _setRingAlpha(dim) {
            if (this.ringDim === dim) return;
            this.ringDim = dim;
            if (this.ringEl) {
                this.ringEl.style.setProperty('--ccA', dim ? CFG.TEXT_RING_ALPHA : CFG.RING_ALPHA);
            }
        }

        _bindEvents(sig) {
            document.addEventListener('visibilitychange', () => {
                if (!document.hidden && this.rafId) this.lastT = performance.now();
            }, { signal: sig });

            addEventListener('pointermove', (e) => {
                if (e.pointerType === 'touch') return;
                this.mx = e.clientX;
                this.my = e.clientY;
                if (this.focusEl) { this.focusEl = null; this.focusRad = 0; }
                this.wake();
            }, { passive: true, signal: sig });

            addEventListener('pointerdown', (e) => {
                if (e.pointerType === 'touch') return;
                this.pressed = true;
                this.wake();
            }, { signal: sig });

            addEventListener('pointerup', () => { this.pressed = false; this.wake(); }, { signal: sig });
            addEventListener('pointercancel', () => { this.pressed = false; this.wake(); }, { signal: sig });

            addEventListener('wheel', (e) => {
                if (!CFG.SCROLL_ENABLED) return;
                if (this.hoverEl || this.focusEl || this.textEl) return;
                let dx = e.deltaX, dy = e.deltaY;
                if (e.deltaMode === 1) { dx *= 16; dy *= 16; }
                else if (e.deltaMode === 2) { dx *= 120; dy *= 120; }
                this.sX = clamp(this.sX - clamp(dx, -80, 80), -CFG.SCROLL_MAX, CFG.SCROLL_MAX);
                this.sY = clamp(this.sY - clamp(dy, -80, 80), -CFG.SCROLL_MAX, CFG.SCROLL_MAX);
                this.wake();
            }, { passive: true, signal: sig });

            document.addEventListener('mouseover', (e) => this._onMouseOver(e), { signal: sig });

            document.addEventListener('focusin', (e) => this._onFocusIn(e), { signal: sig });

            document.addEventListener('focusout', (e) => {
                if (this.focusEl === e.target) { this.focusEl = null; this.wake(); }
            }, { signal: sig });

            const docEl = document.documentElement;
            docEl.addEventListener('mouseenter', () => { this.inside = true; this.wake(); }, { signal: sig });
            docEl.addEventListener('mouseleave', () => { this.inside = false; this.hide(); }, { signal: sig });
            addEventListener('blur', () => this.hide(), { signal: sig });
            addEventListener('focus', () => { if (this.inside) this.wake(); }, { signal: sig });
        }

        _onMouseOver(e) {
            const tgt = e.target;
            if (!tgt || tgt.nodeType !== 1) return;

            const txt = tgt.closest(SEL_TEXT) || null;
            if (txt !== this.textEl) {
                this.textEl = txt;
                this._setDotShape(!!txt);
                this._setRingAlpha(!!txt);
            }

            if (this.hoverEl && !this.hoverEl.isConnected) {
                this.hoverEl = null;
                this.hoverRad = 0;
            }

            const inter = tgt.closest(SEL_INTERACTIVE);
            if (inter !== this.hoverEl) {
                let next = null, rad = 0;
                if (inter && !inter.matches(SEL_TEXT)) {
                    const m = measure(inter);
                    if (m !== null) { next = inter; rad = m; }
                }
                this.hoverEl = next;
                this.hoverRad = rad;
            }
        }

        _onFocusIn(e) {
            const tgt = e.target;
            if (!tgt || tgt.nodeType !== 1) return;
            if (tgt.matches(SEL_TEXT) || !tgt.matches(SEL_INTERACTIVE)) return;
            const m = measure(tgt);
            if (m !== null) {
                this.focusEl = tgt;
                this.focusRad = m;
                this.wake();
            }
        }

        _installApi(sig) {
            window.addEventListener('CURSORFX_REQUEST', (e) => {
                const { action, requestId, payload } = e.detail || {};
                if (!action) return;
                let result;
                try { result = this._handleApiAction(action, payload); }
                catch (err) { result = { error: err.message }; }

                if (requestId) {
                    window.dispatchEvent(new CustomEvent('CURSORFX_RESPONSE', {
                        detail: { requestId, result }
                    }));
                }
            }, { signal: sig });

            // 异步广播 ready，避免和脚本主逻辑抢同一个 tick
            setTimeout(() => {
                if (!this.active) return;
                window.dispatchEvent(new CustomEvent('CURSORFX_READY', {
                    detail: { version: WEB_API_VERSION, scriptVersion: SCRIPT_VERSION }
                }));
            }, 0);
        }

        _handleApiAction(action, payload) {
            switch (action) {
                case 'ping':
                    return { status: 'alive', version: WEB_API_VERSION };
                case 'getStatus':
                    return {
                        visible: this.shown,
                        pressed: this.pressed,
                        hoverEl: !!this.hoverEl,
                        focusEl: !!this.focusEl,
                        textMode: this.dotIsBar,
                        ringDim: this.ringDim,
                        scrollOffset: { x: this.sX, y: this.sY },
                        dotScale: this.dotS,
                        ringScale: this.ringS,
                    };
                case 'getSettings': {
                    const settings = {};
                    for (const f of FIELDS) settings[f.key] = CFG[f.key];
                    return { settings };
                }
                case 'setSetting': {
                    const { key, value } = payload || {};
                    if (!key || !(key in FMAP)) return { success: false, error: 'Invalid key' };
                    const f = FMAP[key];
                    if (f.type === 'bool') {
                        if (typeof value !== 'boolean') return { success: false, error: 'Expected boolean' };
                        overrides[key] = value;
                    } else {
                        if (typeof value !== 'number' || !isFinite(value)) return { success: false, error: 'Invalid value type' };
                        overrides[key] = clamp(value, f.min, f.max);
                    }
                    commit();
                    store.write('overrides', overrides);
                    return { success: true, key, value: overrides[key] };
                }
                case 'resetSettings':
                    for (const k in overrides) delete overrides[k];
                    store.erase('overrides');
                    commit();
                    return { success: true };
                case 'toggleVisible':
                    if (this.shown) this.hide(); else this.wake();
                    return { visible: this.shown };
                case 'getVersion':
                    return { version: WEB_API_VERSION, scriptVersion: SCRIPT_VERSION };
                default:
                    return { error: 'Unknown action: ' + action };
            }
        }

        _tick(t) {
            if (!this.active) return;
            this.rafId = 0;

            const dt = clamp((t - this.lastT) / 1000, 0, 0.05) || 0.016;
            this.lastT = t;

            let el = this.hoverEl || this.focusEl;
            const elRad = this.hoverEl ? this.hoverRad : this.focusRad;
            if (el && !el.isConnected) {
                if (this.hoverEl === el) this.hoverEl = null;
                if (this.focusEl === el) this.focusEl = null;
                el = null;
            }

            // 滚动拖尾衰减
            if (this.sX !== 0 || this.sY !== 0) {
                const d = Math.exp(-CFG.SCROLL_DECAY * dt);
                this.sX *= d; this.sY *= d;
                if (Math.abs(this.sX) < 0.05) this.sX = 0;
                if (Math.abs(this.sY) < 0.05) this.sY = 0;
            }

            let tx = this.mx + this.sX, ty = this.my + this.sY;
            let speed = CFG.FOLLOW_SPEED;

            const baseSize = this.textEl ? CFG.TEXT_RING_SIZE : CFG.RING_SIZE;
            let tw = baseSize, th = baseSize, tr = baseSize / 2;

            if (el) {
                const r = el.getBoundingClientRect();
                if ((r.width === 0 && r.height === 0) || r.width > CFG.MAX_FIT_SIZE || r.height > CFG.MAX_FIT_SIZE) {
                    if (this.hoverEl === el) { this.hoverEl = null; this.hoverRad = 0; }
                    if (this.focusEl === el) { this.focusEl = null; this.focusRad = 0; }
                } else {
                    tx = r.left + r.width / 2;
                    ty = r.top + r.height / 2;
                    tw = r.width + CFG.FIT_PADDING * 2;
                    th = r.height + CFG.FIT_PADDING * 2;
                    tr = Math.min(elRad + CFG.FIT_PADDING, Math.min(tw, th) / 2);
                    speed = CFG.FIT_SPEED;
                }
            }

            const pressedTarget = this.pressed ? CFG.CLICK_SCALE : 1;

            if (CFG.ENABLE_RING) {
                const k = 1 - Math.exp(-speed * dt);
                this.rx += (tx - this.rx) * k;
                this.ry += (ty - this.ry) * k;
                if (Math.abs(tx - this.rx) < 0.05) this.rx = tx;
                if (Math.abs(ty - this.ry) < 0.05) this.ry = ty;

                const ks = 1 - Math.exp(-CFG.SHAPE_SPEED * dt);
                this.rw += (tw - this.rw) * ks;
                this.rh += (th - this.rh) * ks;
                this.rr += (tr - this.rr) * ks;
                if (Math.abs(tw - this.rw) < 0.1) this.rw = tw;
                if (Math.abs(th - this.rh) < 0.1) this.rh = th;
                if (Math.abs(tr - this.rr) < 0.1) this.rr = tr;

                this.ringV = (this.ringV + (pressedTarget - this.ringS) * CFG.SPRING_K * dt) * Math.exp(-CFG.SPRING_DAMP * dt);
                this.ringS = Math.max(0.2, this.ringS + this.ringV * dt);

                const ring = this.ringEl;
                writeTransform(ring, this.rx, this.ry, this.ringS, this.ringCache);

                const qrw = Math.round(this.rw * 10) / 10;
                const qrh = Math.round(this.rh * 10) / 10;
                const qrr = Math.round(this.rr * 10) / 10;
                if (qrw !== this.lastW) { ring.style.width = qrw + 'px'; this.lastW = qrw; }
                if (qrh !== this.lastH) { ring.style.height = qrh + 'px'; this.lastH = qrh; }
                if (qrr !== this.lastR) { ring.style.borderRadius = qrr + 'px'; this.lastR = qrr; }

                // 空闲判定使用 ring 的量化收敛值
                this._ringSettled = (
                    qrw === Math.round(tw * 10) / 10 &&
                    qrh === Math.round(th * 10) / 10 &&
                    qrr === Math.round(tr * 10) / 10 &&
                    Math.abs(this.ringS - pressedTarget) < 0.002 &&
                    Math.abs(this.ringV) < 0.01
                );
            } else {
                this._ringSettled = true;
            }

            if (CFG.ENABLE_DOT) {
                this.dotV = (this.dotV + (pressedTarget - this.dotS) * CFG.SPRING_K * dt) * Math.exp(-CFG.SPRING_DAMP * dt);
                this.dotS = Math.max(0.2, this.dotS + this.dotV * dt);
                writeTransform(this.dotEl, this.mx, this.my, this.dotS, this.dotCache);

                this._dotSettled =
                    Math.abs(this.dotS - pressedTarget) < 0.002 &&
                    Math.abs(this.dotV) < 0.01;
            } else {
                this._dotSettled = true;
            }

            const idle = this._ringSettled && this._dotSettled &&
                !el && this.sX === 0 && this.sY === 0;
            if (idle && t - this.lastInput > CFG.IDLE_PAUSE_MS) return;

            this.rafId = requestAnimationFrame(this._tickBound);
        }
    }

    // ---------- 设置存储（延迟定义，避免和 commit 互引） ----------
    const store = {
        write(k, v) { writeRaw(k, JSON.stringify(v)); },
        erase(k) { eraseRaw(k); },
    };

    // ---------- 初始化 ----------
    Object.assign(CFG, DEFAULTS, overrides);
    if (RM_PATCH) Object.assign(CFG, RM_PATCH);

    renderCSS();
    (document.head || document.documentElement).appendChild(styleEl);

    const cursor = new CursorController();

    let commitQueued = false;
    function commit() {
        Object.assign(CFG, DEFAULTS, overrides);
        if (RM_PATCH) Object.assign(CFG, RM_PATCH);
        if (commitQueued) return;
        commitQueued = true;
        requestAnimationFrame(() => {
            commitQueued = false;
            renderCSS();
            cursor.refresh();
        });
    }

    function startGuardian() {
        const observer = new MutationObserver(() => {
            // 只在元素掉线时重建，O(1) 检查
            if (!cursor.isMounted()) cursor.mount();
        });

        const boot = () => {
            if (!cursor.isMounted()) cursor.mount();
            observer.observe(document.documentElement, { childList: true, subtree: true });
        };

        if (document.documentElement) boot();
        else document.addEventListener('DOMContentLoaded', boot, { once: true });
    }

    startGuardian();

    // ==================== 设置面板 ====================
    let panelHost = null;
    let panelOpen = false;
    let saveTimeoutId = 0;

    const decimals = f => String(f.step).includes('.') ? String(f.step).split('.')[1].length : 0;
    const fmt = (v, f) => f.type === 'bool'
        ? (v ? 'ON' : 'OFF')
        : (+v).toFixed(decimals(f)) + (f.unit ? ' ' + f.unit : '');
    const curVal = f => (f.key in overrides ? overrides[f.key] : DEFAULTS[f.key]);

    function isFieldDisabled(f) {
        if (RM_KEYS && RM_KEYS.has(f.key)) return true;
        if (f.deps) {
            for (const depKey of f.deps) {
                const val = depKey in overrides ? overrides[depKey] : DEFAULTS[depKey];
                if (!val) return true;
            }
        }
        return false;
    }

    function rowsHTML() {
        let html = '', lastG = '';
        for (const f of FIELDS) {
            if (f.g !== lastG) {
                if (lastG) html += '</section>';
                html += '<section><h3>' + t('groups.' + f.g) + '</h3>';
                lastG = f.g;
            }

            const v = curVal(f);
            const disabled = isFieldDisabled(f);
            const disAttr = disabled ? ' disabled' : '';
            const disStyle = disabled ? ' style="opacity:.4;pointer-events:none"' : '';

            if (f.type === 'bool') {
                html +=
                    '<label class="row toggle-row"' + disStyle + '>' +
                    '<span class="lab">' + t('labels.' + f.label) + '</span>' +
                    '<input type="checkbox" data-k="' + f.key + '"' + (v ? ' checked' : '') + disAttr + '>' +
                    '</label>';
            } else {
                const p = ((v - f.min) / (f.max - f.min) * 100).toFixed(1);
                html +=
                    '<label class="row"' + disStyle + '>' +
                    '<span class="lab">' + t('labels.' + f.label) + '</span>' +
                    '<input type="range" data-k="' + f.key + '" min="' + f.min + '" max="' + f.max +
                    '" step="' + f.step + '" value="' + v + '" style="--p:' + p + '%"' + disAttr + '>' +
                    '<span class="val">' + fmt(v, f) + '</span>' +
                    '</label>';
            }
        }
        return html + '</section>';
    }

    function updatePanelDisabledState(sh) {
        for (const f of FIELDS) {
            const inp = sh.querySelector('input[data-k="' + f.key + '"]');
            if (!inp) continue;
            const disabled = isFieldDisabled(f);
            inp.disabled = disabled;
            const row = inp.closest('.row');
            if (row) {
                row.style.opacity = disabled ? '.4' : '';
                row.style.pointerEvents = disabled ? 'none' : '';
            }
        }
    }

    function buildPanel() {
        if (panelHost) { panelHost.remove(); panelHost = null; }

        panelHost = document.createElement('div');
        const hs = panelHost.style;
        hs.setProperty('position', 'fixed', 'important');
        hs.setProperty('right', '20px', 'important');
        hs.setProperty('top', '50%', 'important');
        hs.setProperty('transform', 'translateY(-50%)', 'important');
        hs.setProperty('z-index', '2147483646', 'important');
        hs.setProperty('color-scheme', 'dark', 'important');

        const sh = panelHost.attachShadow({ mode: 'open' });

        sh.innerHTML =
            '<style>' +
            '*{box-sizing:border-box;margin:0;padding:0}' +
            '.panel{width:340px;max-height:min(620px,88vh);display:flex;flex-direction:column;' +
            'background:rgba(18,19,23,.97);border:1px solid rgba(255,255,255,.1);border-radius:12px;' +
            'box-shadow:0 24px 60px rgba(0,0,0,.55),0 2px 12px rgba(0,0,0,.4);' +
            'font:13px/1.45 -apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Hiragino Sans GB","Microsoft YaHei",sans-serif;' +
            'color:#e8e9ec;overflow:hidden;user-select:none}' +
            '.panel.pop{animation:pop .18s cubic-bezier(.2,.9,.3,1.2)}' +
            '@keyframes pop{from{opacity:0;transform:scale(.95) translateX(8px)}}' +
            'header{display:flex;align-items:center;justify-content:space-between;padding:12px 12px 10px 16px;' +
            'border-bottom:1px solid rgba(255,255,255,.07)}' +
            '.ttl{font:700 13px/1 ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;letter-spacing:.06em}' +
            '.ver{font:600 10px/1 ui-monospace,Menlo,Consolas,monospace;color:#8b8e98;' +
            'background:rgba(255,255,255,.07);padding:3px 6px;border-radius:4px;margin-left:8px;vertical-align:1px}' +
            '.x{width:26px;height:26px;border:none;border-radius:7px;background:transparent;color:#9a9da6;' +
            'font-size:13px;line-height:1;cursor:none;transition:background .15s,color .15s}' +
            '.x:hover{background:rgba(255,255,255,.09);color:#fff}' +
            '.rm{margin:10px 14px 0;padding:7px 10px;font-size:11px;color:#e8c98a;' +
            'background:rgba(232,201,138,.08);border:1px solid rgba(232,201,138,.18);border-radius:7px}' +
            '.body{overflow-y:auto;padding:2px 16px 10px;scrollbar-width:thin;scrollbar-color:rgba(255,255,255,.18) transparent}' +
            '.body::-webkit-scrollbar{width:8px}' +
            '.body::-webkit-scrollbar-thumb{background:rgba(255,255,255,.14);border-radius:4px}' +
            'section h3{font-size:10px;font-weight:600;letter-spacing:.24em;color:#787b85;margin:14px 2px 4px}' +
            '.row{display:grid;grid-template-columns:96px 1fr 62px;gap:10px;align-items:center;padding:3px 0;' +
            'transition:opacity .2s ease}' +
            '.row.toggle-row{display:flex;justify-content:space-between;align-items:center;padding:6px 0}' +
            '.lab{font-size:12px;color:#b7bac3;white-space:nowrap}' +
            '.val{font:500 11px/1 ui-monospace,"SF Mono",Menlo,Consolas,monospace;color:#dfe1e6;' +
            'text-align:right;font-variant-numeric:tabular-nums;white-space:nowrap}' +
            'input[type=range]{-webkit-appearance:none;appearance:none;width:100%;height:26px;' +
            'background:transparent;cursor:none;margin:0}' +
            'input[type=range]::-webkit-slider-runnable-track{height:3px;border-radius:2px;' +
            'background:linear-gradient(90deg,#fff var(--p,50%),rgba(255,255,255,.16) var(--p,50%))}' +
            'input[type=range]::-webkit-slider-thumb{-webkit-appearance:none;width:13px;height:13px;margin-top:-5px;' +
            'border-radius:50%;background:#fff;box-shadow:0 1px 5px rgba(0,0,0,.55);transition:transform .15s ease}' +
            'input[type=range]:hover::-webkit-slider-thumb{transform:scale(1.25)}' +
            'input[type=range]:active::-webkit-slider-thumb{transform:scale(.9)}' +
            'input[type=range]::-moz-range-track{height:3px;border-radius:2px;background:rgba(255,255,255,.16)}' +
            'input[type=range]::-moz-range-progress{height:3px;border-radius:2px;background:#fff}' +
            'input[type=range]::-moz-range-thumb{width:13px;height:13px;border:none;border-radius:50%;' +
            'background:#fff;box-shadow:0 1px 5px rgba(0,0,0,.55)}' +
            'input[type=range]:focus-visible{outline:2px solid rgba(255,255,255,.45);outline-offset:2px;border-radius:6px}' +
            'input[type=range]:disabled{opacity:.5;cursor:not-allowed}' +
            'input[type=checkbox]{-webkit-appearance:none;appearance:none;width:36px;height:20px;' +
            'background:transparent;border:1.5px solid rgba(255,255,255,.3);border-radius:10px;' +
            'position:relative;cursor:none;transition:all .2s ease;outline:none;vertical-align:middle;flex-shrink:0}' +
            'input[type=checkbox]::after{content:"";position:absolute;left:2px;top:50%;transform:translateY(-50%);' +
            'width:12px;height:12px;background:rgba(255,255,255,.5);border-radius:50%;' +
            'transition:all .2s cubic-bezier(.4,.0,.2,1)}' +
            'input[type=checkbox]:checked{background:#fff;border-color:#fff}' +
            'input[type=checkbox]:checked::after{left:18px;background:#131417;transform:translateY(-50%)}' +
            'input[type=checkbox]:hover{border-color:rgba(255,255,255,.6)}' +
            'input[type=checkbox]:hover::after{transform:translateY(-50%) scale(1.15)}' +
            'input[type=checkbox]:checked:hover::after{transform:translateY(-50%) scale(1.15)}' +
            'input[type=checkbox]:active::after{width:14px}' +
            'input[type=checkbox]:checked:active::after{left:16px;width:14px}' +
            'input[type=checkbox]:focus-visible{box-shadow:0 0 0 2px rgba(255,255,255,.45)}' +
            'input[type=checkbox]:disabled{opacity:.5;cursor:not-allowed}' +
            '.lang-row{display:flex;align-items:center;justify-content:space-between;padding:10px 16px;' +
            'border-top:1px solid rgba(255,255,255,.07);background:rgba(255,255,255,.02)}' +
            '.lang-label{font-size:12px;color:#b7bac3}' +
            'select.lang-select{background:rgba(0,0,0,.3);color:#e8e9ec;border:1px solid rgba(255,255,255,.15);' +
            'border-radius:6px;padding:4px 8px;font-size:12px;outline:none;cursor:none}' +
            'select.lang-select:hover{border-color:rgba(255,255,255,.3)}' +
            'footer{display:flex;align-items:center;gap:8px;padding:10px 14px 13px;' +
            'border-top:1px solid rgba(255,255,255,.07)}' +
            'button{font:inherit}' +
            '.ghost{background:transparent;border:1px solid rgba(255,255,255,.16);color:#c3c6cd;font-size:12px;' +
            'padding:6px 12px;border-radius:7px;cursor:none;transition:border-color .15s,color .15s}' +
            '.ghost:hover{border-color:rgba(255,255,255,.42);color:#fff}' +
            '.prime{background:#fff;color:#131417;border:none;font-size:12px;font-weight:650;padding:7px 16px;' +
            'border-radius:7px;cursor:none;transition:transform .15s,box-shadow .15s}' +
            '.prime:hover{transform:translateY(-1px);box-shadow:0 4px 14px rgba(255,255,255,.16)}' +
            '.prime:active{transform:translateY(0)}' +
            '.saved{flex:1;text-align:center;font-size:11px;color:#8fd6a8;opacity:0;transition:opacity .35s}' +
            '.saved.on{opacity:1}' +
            '</style>' +
            '<div class="panel" role="dialog" aria-label="' + t('a11y.dialog') + '">' +
            '<header>' +
            '<span class="ttl">' + t('title') +
            '<span class="ver">' + t('version', { v: SCRIPT_VERSION }) + '</span></span>' +
            '<button class="x" data-act="close" aria-label="' + t('a11y.close') + '">✕</button>' +
            '</header>' +
            (RM ? '<p class="rm">' + t('reducedMotionMsg') + '</p>' : '') +
            '<div class="body">' + rowsHTML() + '</div>' +
            '<div class="lang-row">' +
            '<span class="lang-label">' + t('settings.language') + '</span>' +
            '<select class="lang-select" id="lang-selector">' +
            '<option value="zh-CN"' + (CURRENT_LANG === 'zh-CN' ? ' selected' : '') + '>' +
            t('settings.langOptionZh') + '</option>' +
            '<option value="en"' + (CURRENT_LANG === 'en' ? ' selected' : '') + '>' +
            t('settings.langOptionEn') + '</option>' +
            '</select>' +
            '</div>' +
            '<footer>' +
            '<button class="ghost" data-act="reset">' + t('buttons.reset') + '</button>' +
            '<span class="saved">' + t('buttons.saved') + '</span>' +
            '<button class="prime" data-act="close">' + t('buttons.close') + '</button>' +
            '</footer>' +
            '</div>';

        const body = sh.querySelector('.body');
        const saved = sh.querySelector('.saved');
        const langSelect = sh.querySelector('#lang-selector');
        let flashT = 0;

        function flash(msgKey) {
            saved.textContent = t(msgKey);
            saved.classList.add('on');
            clearTimeout(flashT);
            flashT = setTimeout(() => saved.classList.remove('on'), 1100);
        }
        function scheduleSave() {
            clearTimeout(saveTimeoutId);
            saveTimeoutId = setTimeout(() => {
                store.write('overrides', overrides);
                flash('buttons.saved');
            }, 350);
        }

        body.addEventListener('input', (e) => {
            const k = e.target.dataset && e.target.dataset.k;
            if (!k) return;
            const f = FMAP[k];

            if (f.type === 'bool') {
                overrides[k] = e.target.checked;
                commit();
                updatePanelDisabledState(sh);
            } else {
                const v = clamp(parseFloat(e.target.value), f.min, f.max);
                overrides[k] = v;
                e.target.closest('.row').querySelector('.val').textContent = fmt(v, f);
                e.target.style.setProperty('--p',
                    ((v - f.min) / (f.max - f.min) * 100).toFixed(1) + '%');
                commit();
            }
            scheduleSave();
        });

        langSelect.addEventListener('change', (e) => {
            const newLang = e.target.value;
            if (LANGUAGES[newLang] && newLang !== CURRENT_LANG) {
                CURRENT_LANG = newLang;
                saveLang(newLang);
                updateMenuLabel();
                closePanel();
                openPanel();
            }
        });

        sh.querySelector('.panel').addEventListener('click', (e) => {
            const b = e.target.closest('[data-act]');
            if (!b) return;

            if (b.dataset.act === 'close') {
                closePanel();
            } else if (b.dataset.act === 'reset') {
                for (const k in overrides) delete overrides[k];
                store.erase('overrides');

                body.querySelectorAll('input[data-k]').forEach(inp => {
                    const f = FMAP[inp.dataset.k];
                    const v = DEFAULTS[f.key];
                    if (f.type === 'bool') {
                        inp.checked = v;
                    } else {
                        inp.value = v;
                        inp.style.setProperty('--p',
                            ((v - f.min) / (f.max - f.min) * 100).toFixed(1) + '%');
                        inp.closest('.row').querySelector('.val').textContent = fmt(v, f);
                    }
                });

                commit();
                updatePanelDisabledState(sh);
                flash('buttons.restored');
            }
        });

        document.body.appendChild(panelHost);
    }

    function openPanel() {
        if (!panelHost) buildPanel();
        panelOpen = true;
        panelHost.style.display = 'block';
        const p = panelHost.shadowRoot.querySelector('.panel');
        p.classList.remove('pop');
        void p.offsetWidth;
        p.classList.add('pop');
    }

    function closePanel() {
        panelOpen = false;
        clearTimeout(saveTimeoutId);
        if (panelHost) {
            panelHost.remove();
            panelHost = null;
        }
    }

    function togglePanel() {
        if (!document.body) {
            addEventListener('DOMContentLoaded', () => togglePanel(), { once: true });
            return;
        }
        panelOpen ? closePanel() : openPanel();
    }

    addEventListener('keydown', (e) => { if (e.key === 'Escape') closePanel(); });

    document.addEventListener('pointerdown', (e) => {
        if (!panelOpen || !panelHost) return;
        const path = e.composedPath ? e.composedPath() : [];
        if (!path.includes(panelHost)) closePanel();
    }, true);

    // ---------- 菜单命令 ----------
    let menuCmdId = null;

    function updateMenuLabel() {
        if (typeof GM_unregisterMenuCommand === 'function' && menuCmdId != null) {
            GM_unregisterMenuCommand(menuCmdId);
        }
        if (typeof GM_registerMenuCommand === 'function') {
            menuCmdId = GM_registerMenuCommand(t('menu.settings'), togglePanel);
        }
    }

    updateMenuLabel();
})();