Skip to content

An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作

12.8 KB
Raw Blame
const assert = require("node:assert/strict");
const {EventEmitter} = require("node:events");
const {test} = require("node:test");
const {readFileSync} = require("node:fs");
const {runInNewContext} = require("node:vm");
const {captureWindowGeometry, normalizeWindowGeometry, restoreWindowGeometry} = require("./windowGeometry");
const {getTitleBarOverlayOptions, getCaptionHeight} = require("./windowControlsOverlay");

const state = (values = {}) => ({version: 1, x: 100, y: 80, width: 900, height: 700,
    maximized: false, fullscreen: false, ...values});
const display = {workArea: {x: 0, y: 0, width: 1920, height: 1040}};
const screen = {getDisplayMatching: () => display, getAllDisplays: () => [display]};
const fixture = (initial = state()) => {
    const window = new EventEmitter();
    const calls = [];
    Object.assign(window, {
        isDestroyed: () => false,
        isMaximized: () => initial.maximized,
        isFullScreen: () => initial.fullscreen,
        isMinimized: () => false,
        getNormalBounds: () => ({x: initial.x, y: initial.y, width: initial.width, height: initial.height}),
        unmaximize: () => calls.push("unmaximize"),
        maximize: () => calls.push("maximize"),
        setBounds: bounds => calls.push(bounds),
        setFullScreen: value => {
            calls.push(["fullscreen", value]);
            initial.fullscreen = value;
        },
    });
    return {window, calls};
};

test("最大化窗口保存普通窗口边界和状态", () => {
    const saved = state({maximized: true});
    assert.deepEqual(captureWindowGeometry(fixture(saved).window), saved);
});

test("负坐标显示器上的布局保持原大小和位置", () => {
    const saved = state({x: -1500, y: 80});
    assert.deepEqual(normalizeWindowGeometry(saved, {
        getDisplayMatching: () => ({workArea: {x: -1920, y: 0, width: 1920, height: 1080}}),
        getAllDisplays: () => [{workArea: {x: -1920, y: 0, width: 1920, height: 1080}}],
    }), {x: -1500, y: 80, width: 900, height: 700});
});

test("跨屏窗口保留原位置和超过单个显示器的宽度", () => {
    const right = {workArea: {x: 1920, y: 0, width: 1920, height: 1040}};
    const screens = {getAllDisplays: () => [display, right], getDisplayMatching: () => right};
    for (const bounds of [{x: 1600, y: 100, width: 1000, height: 700}, {x: 800, y: 100, width: 2800, height: 700}]) {
        assert.deepEqual(normalizeWindowGeometry(state(bounds), screens), bounds);
    }
});

test("部分移出屏幕但标题栏仍可操作时保留边界", () => {
    const bounds = {x: -100, y: 100, width: 900, height: 1100};
    assert.deepEqual(normalizeWindowGeometry(state(bounds), screen), bounds);
});

test("仅内容可见或标题栏可见区域过小时移回工作区", () => {
    for (const bounds of [{x: 100, y: -100, width: 900, height: 700}, {x: 1900, y: 100, width: 900, height: 700}]) {
        const restored = normalizeWindowGeometry(state(bounds), screen);
        assert.ok(restored.x >= 0 && restored.y >= 0);
        assert.ok(restored.x + restored.width <= display.workArea.width);
        assert.ok(restored.y + restored.height <= display.workArea.height);
    }
});

test("移除显示器或缩小工作区后窗口保持可见并遵守最小尺寸", () => {
    assert.deepEqual(normalizeWindowGeometry(state({x: 5000, y: -2000, width: 3000, height: 2000}), screen),
        {x: 0, y: 0, width: 1920, height: 1040});
    assert.deepEqual(normalizeWindowGeometry(state({width: 10, height: 20}), screen),
        {x: 100, y: 80, width: 493, height: 376});
});

test("缺失、未知版本和非法窗口信息不改变窗口", async () => {
    for (const saved of [undefined, null, {}, state({version: 2}), state({width: -1}),
        state({x: Infinity}), state({height: 1.5}), state({maximized: "true"})]) {
        const f = fixture();
        assert.equal(await restoreWindowGeometry(f.window, saved, screen), false);
        assert.deepEqual(f.calls, []);
    }
});

test("先取消最大化并恢复边界,再按保存状态最大化", async () => {
    const f = fixture(state({maximized: true}));
    assert.equal(await restoreWindowGeometry(f.window, state({maximized: true}), screen), true);
    assert.deepEqual(f.calls, ["unmaximize", {x: 100, y: 80, width: 900, height: 700}, "maximize"]);
});

test("异步退出全屏后才恢复边界和全屏状态", async () => {
    const f = fixture(state({fullscreen: true}));
    let fullscreen = true;
    f.window.isFullScreen = () => fullscreen;
    f.window.setFullScreen = value => f.calls.push(["fullscreen", value]);
    const restored = restoreWindowGeometry(f.window, state({fullscreen: true}), screen);
    assert.deepEqual(f.calls, [["fullscreen", false]]);
    fullscreen = false;
    f.window.emit("leave-full-screen");
    assert.equal(await restored, true);
    assert.deepEqual(f.calls, [["fullscreen", false], {x: 100, y: 80, width: 900, height: 700}, ["fullscreen", true]]);
    assert.equal(f.window.listenerCount("leave-full-screen"), 0);
});

const openWindow = (windowGeometry, appearance = {}, mode = "local") => {
    const source = readFileSync("electron/main.js", "utf8");
    const start = source.indexOf('ipcMain.on("siyuan-open-window",');
    const end = source.indexOf('ipcMain.on("siyuan-open-workspace",', start);
    const calls = [];
    const timers = new Set();
    const ipcMain = new EventEmitter();
    const initializedWindowIds = new Set();
    let options;
    let url;
    const windows = [];
    let pathname = "/stage/build/app/window.html";
    class Window extends EventEmitter {
        static getFocusedWindow() {
            return {getBounds: () => ({x: 0, y: 0})};
        }
        constructor(value) {
            super();
            options = value;
            windows.push(this);
            this.destroyed = false;
            this.webContents = Object.assign(new EventEmitter(), {id: 2,
                session: {setSpellCheckerLanguages: () => {}},
                send: value => calls.push(value),
            });
        }
        center() { calls.push("center"); }
        setPosition(x, y) { calls.push({x, y}); }
        setBounds(bounds) { calls.push(bounds); }
        maximize() { calls.push("maximize"); }
        setFullScreen() { calls.push("fullscreen"); }
        setAlwaysOnTop() {}
        loadURL(value) { url = value; }
        isDestroyed() { return this.destroyed; }
        destroy() { this.destroyed = true; calls.push("destroy"); }
    }
    const workArea = {x: 1920, y: 0, width: 1280, height: 1000};
    runInNewContext(source.slice(start, end), {
        ipcMain, initializedWindowIds,
        BrowserWindow: Window, URL, process: {platform: "win32"},
        getTitleBarOverlayOptions: (platform, height) => getTitleBarOverlayOptions(platform, height),
        getCaptionHeight: (compact, panel) => getCaptionHeight(compact, panel),
        getWindowKernelTarget: () => ({origin: "http://127.0.0.1:6806", mode}),
        getRemoteSession: () => ({}),
        windowWorkspaces: {get: () => windows[0], associate: () => {}},
        screen: {
            ...screen,
            getDisplayNearestPoint: point => point.x === 2000 ? {id: 2, workArea} : {id: 1, size: {width: 1920, height: 1080}},
            getCursorScreenPoint: () => ({x: 2000, y: 20}),
        },
        normalizeWindowGeometry, path: {join: () => "icon"}, appDir: "", appVer: "test",
        remote: {enable: () => {}}, bindSpellcheckContextMenu: () => {}, rememberWindowKernelTarget: () => {},
        windowNavigate: () => {},
        showWindow: () => calls.push("show"), getWindowPathname: () => pathname, writeLog: () => {},
        markExpectedRendererExit: () => calls.push("expected-exit"),
        setTimeout: callback => { timers.add(callback); return callback; },
        clearTimeout: timer => timers.delete(timer),
    });
    const open = () => ipcMain.emit("siyuan-open-window", {sender: {id: 1}}, {
        url: "http://127.0.0.1:6806/stage/build/app/window.html?windowWorkspace=20260924100000-abcdefg",
        windowGeometry,
        ...appearance,
    });
    open();
    const win = windows[0];
    return {options, calls, workArea, win, ipcMain, initializedWindowIds, url, open, timers,
        navigate: value => { pathname = value; },
        close: () => win.emit("close", {preventDefault: () => calls.push("prevent-close")}),
    };
};

test("新窗口创建时使用保存边界,不被鼠标所在显示器覆盖", () => {
    const f = openWindow(state({maximized: true}));
    assert.deepEqual([f.options.x, f.options.y, f.options.width, f.options.height], [100, 80, 900, 700]);
    // 首帧绘制(或短延迟)前不显示窗口,最大化也在那时才应用
    assert.equal(f.options.show, false);
    // 独立文档窗口首帧按面板高度预留窗口按钮区,不落到系统的默认标题栏高度
    assert.equal(f.options.titleBarOverlay.height, 42);
    assert.deepEqual(f.calls, []);
    f.win.emit("ready-to-show");
    assert.deepEqual(f.calls, ["maximize", "show"]);
    f.win.emit("ready-to-show");
    assert.deepEqual(f.calls, ["maximize", "show"]);
});

test("旧窗口布局继续使用默认窗口位置", () => {
    const f = openWindow(undefined);
    assert.deepEqual(f.calls, ["center", f.workArea]);
});

// 独立文档窗口的首帧按钮区跟随界面密度,避免加载完成后再纠正一次高度。
test("新窗口首帧按钮区跟随界面密度", () => {
    assert.equal(openWindow(state()).options.titleBarOverlay.height, 42);
    assert.equal(openWindow(state(), {compactMode: true}).options.titleBarOverlay.height, 34);
    assert.equal(openWindow(state(), {compactMode: false}).options.titleBarOverlay.height, 42);
    assert.equal(openWindow(state(), {compactMode: "true"}).options.titleBarOverlay.height, 42,
        "非布尔输入按舒适密度处理");
});

test("新窗口首帧后显示,定时器先到也显示,重复打开激活已有窗口", () => {
    const f = openWindow(state());
    assert.equal(f.options.show, false);
    assert.equal(f.options.webPreferences.backgroundThrottling, undefined);
    assert.equal(f.ipcMain.listenerCount("siyuan-window-ready"), 0);
    assert.deepEqual(f.calls, []);
    f.win.emit("ready-to-show");
    assert.deepEqual(f.calls, ["show"]);
    assert.equal(f.timers.size, 1, "ready-to-show 已显示,只保留兜底超时");
    f.open();
    assert.deepEqual(f.calls, ["show", "show"]);

    // 首帧迟迟不来时由短延迟定时器显示,且不会重复显示
    const timer = openWindow(state());
    assert.equal(timer.timers.size, 2);
    assert.ok([...timer.timers].some(fn => {
        if (fn.name !== "revealWindow") return false;
        fn();
        return true;
    }), "存在短延迟显示定时器");
    assert.deepEqual(timer.calls, ["show"]);
    timer.win.emit("ready-to-show");
    assert.deepEqual(timer.calls, ["show"]);
});

test("全屏窗口首帧后恢复状态", () => {
    const f = openWindow(state({fullscreen: true}));
    assert.deepEqual(f.calls, []);
    f.win.emit("ready-to-show");
    assert.deepEqual(f.calls, ["fullscreen", "show"]);
});

test("原生窗口和页面使用同一实际主题颜色,非法颜色使用安全默认值", () => {
    for (const appearance of [
        {themeMode: "dark", backgroundColor: "#234567", foregroundColor: "#abcdef"},
        {themeMode: "light", backgroundColor: "#f0e8d8", foregroundColor: "#345678"},
        {themeMode: "dark", backgroundColor: "transparent", foregroundColor: "red;}"},
        {},
    ]) {
        const f = openWindow(state(), appearance);
        const dark = appearance.themeMode === "dark";
        const background = appearance.backgroundColor?.startsWith("#") ? appearance.backgroundColor : dark ? "#1e1e1e" : "#ffffff";
        const foreground = appearance.foregroundColor?.startsWith("#") ? appearance.foregroundColor : dark ? "#d4d4d4" : "#222222";
        assert.equal(f.options.backgroundColor, background);
        const params = new URL(f.url).searchParams;
        assert.equal(params.get("windowBackground"), background);
        assert.equal(params.get("windowForeground"), foreground);
        assert.equal(params.get("windowThemeMode"), dark ? "dark" : "light");
    }
});

for (const mode of ["local", "remote"]) {
    test(`加载期间可直接关闭窗口,初始化后仍保存布局:${mode}`, () => {
        const loading = openWindow(state(), {}, mode);
        loading.close();
        assert.deepEqual(loading.calls, ["prevent-close", "expected-exit", "destroy"]);
        const ready = openWindow(state(), {}, mode);
        ready.initializedWindowIds.add(ready.win.webContents.id);
        ready.close();
        assert.deepEqual(ready.calls, ["siyuan-save-close", "prevent-close"]);
        if (mode === "remote") {
            const auth = openWindow(state(), {}, mode);
            auth.initializedWindowIds.add(auth.win.webContents.id);
            auth.navigate("/check-auth");
            auth.close();
            assert.deepEqual(auth.calls, ["prevent-close", "expected-exit", "destroy"]);
        }
    });
}