Add `alwaysOnTop` parameter to `openWindow` plugin

[wish5115]

Is there an existing issue for this?

• I have searched the existing issues

Can the issue be reproduced with the default theme (daylight/midnight)?

• I was able to reproduce the issue with the default theme

Could the issue be due to extensions?

• I've ruled out the possibility that the extension is causing the problem.

Describe the problem

我把下面这个函数提取出来用于打开新窗口，发现里面有一个pin参数，起初，以为是置顶参数，经过 @TCOTC 讲解发现不是，所以，我在像，能否加个参数用于新窗口置顶的参数？这样新窗口打开并置顶就方便多了。

siyuan/app/src/window/openNewWindow.ts

Line 36 in 26568e3

export const openNewWindowById = async (id: string | string[], options: windowOptions = {}) => {

---

完整测试函数如下：

// 测试
openNewWindowById('20251013071922-hz4xf3e', {pin: true})

// see https://github.com/siyuan-note/siyuan/blob/26568e33cf3a5e1f847b799118bfcdbb9c31db6a/app/src/window/openNewWindow.ts#L36
// options = {position:{x:0, y:0}, width:0, height:0}
async function openNewWindowById(id, options = {}) {
    await new Promise(resolve => setTimeout(resolve, 50));
    let ids = id;
    if (typeof ids === "string") {
        ids = [ids];
    }
    const json = [];
    for (let i = 0; i < ids.length; i++) {
        const response = await requestApi("/api/block/getBlockInfo", {id: ids[i]});
        if (response.code === 3) {
            showMessage(response.msg);
            return;
        }
        json.push({
            title: response.data.rootTitle,
            docIcon: response.data.rootIcon,
            pin: options.pin || false,
            active: true,
            instance: "Tab",
            action: "Tab",
            children: {
                notebookId: response.data.box,
                blockId: ids[i],
                rootId: response.data.rootID,
                mode: "wysiwyg",
                instance: "Editor",
                action: response.data.rootID === ids[i] ? 'cb-get-scroll' : 'cb-get-all'
            }
        });
    }
    if(!isBrowser()) {
      const ipcRenderer = require('electron').ipcRenderer;
      ipcRenderer.send('siyuan-open-window', {
          position: options.position,
          width: options.width,
          height: options.height,
          url: `${window.location.protocol}//${window.location.host}/stage/build/app/window.html?v=${window.siyuan.config.system.kernelVersion}&json=${encodeURIComponent(JSON.stringify(json))}`
      });
    }
}
function showMessage(message, isError = false, delay = 7000) {
  return fetch('/api/notification/' + (isError ? 'pushErrMsg' : 'pushMsg'), {
      "method": "POST",
      "body": JSON.stringify({"msg": message, "timeout": delay})
  });
}
function isBrowser() {
  return !navigator.userAgent.startsWith("SiYuan") ||
      navigator.userAgent.indexOf("iPad") > -1 ||
      (/Android/.test(navigator.userAgent) && !/(?:Mobile)/.test(navigator.userAgent));
}

Expected result

期望置顶参数可用

Screenshot or screen recording presentation

No response

Version environment

- Version: 3.3.4
- Operating System: mac14
- Browser (if used): no

Log file

no

More information

No response

[TCOTC]

AI 这样说，我试了了一下作用确实是钉住页签，跟窗口置顶没有关系

[TCOTC]

你可以用：

const pinElement = document.getElementById("pinWindow");
if (判断当前是置顶或者未置顶) {
    pinElement.click();
}

[wish5115]

你可以用：

const pinElement = document.getElementById("pinWindow");
if (判断当前是置顶或者未置顶) {
pinElement.click();
}

现在就是这么用的，但我觉得可有加个置顶参数。

其实这样用还挺麻烦的，也不好测试，首先得判断是新窗口，然后为了不影响其他操作得新窗口，比如思源自带得新窗口打开，就得给自己得操作加标记，然后新窗口再读取标记，根据标记进行下一步操作，不能因为自己得功能影响了其他操作，产生副作用。

总之，如果能支持就方便多了。

[TCOTC]

你能看到我前面的回复吗？我已经说明了不存在置顶窗口的参数

[wish5115]

你能看到我前面的回复吗？我已经说明了不存在置顶窗口的参数

我理解你意思，置顶和钉住标签不是同一个东西嘛

那就加个新置顶参数呗

另外，这个新窗口置顶也叫pin，着实容易让人误解和混淆

[TCOTC]

那就加个新置顶参数呗

修改一下 issue 标题

[wish5115]

那就加个新置顶参数呗

修改一下 issue 标题

欧克