[Bug]: Wayland 下快捷键/Keyboard Shortcut

[Yubo-Cao]

Issue Checklist

• I have viewed the pinned issues and searched existing issues but couldn't find anything similar.
• I have filled out the issue title correctly.

Platform

Linux

Version

v0.9.23

Bug Description

在 KDE 6.3 Wayland 环境下，快捷助手的快捷键不工作。

Steps To Reproduce

1. 将快捷助手快捷键设置为 Ctrl+Alt+Shift+E
2. 按下快捷键

Expected Behavior

理论上讲，快捷助手应该出现。在 Xorg 环境下，助手正常出现。

Relevant Log Output

Additional Context

希望 Cherry Studio 增加 CLI 支持，这样就可以在 KDE/Gnome DE 中直接配置快捷键，解决 Wayland 下不能全局捕捉快捷键的问题。

[GoodbyeNJN]

因为该功能仅用于 Linux 系统下，所以我提议使用 UNIX domain socket 来实现外部调用。

大致原型：

cherry-studio 内部

import fs from "node:fs";
import net from "node:net";

const SOCKET_PATH = "/tmp/CherryStudio/cherry-studio.sock";

const onData = (data: Buffer) => {
    console.log("Received data:", data.toString());

    let json;
    try {
        json = JSON.parse(data.toString());
    } catch (error) {
        console.error("Failed to parse data:", error);
        return;
    }

    const { cmd, args } = json || {};
    switch (cmd) {
        case "showApplication":
        case "hideApplication":
        case "toggleApplication":
        case "showQuickAssistant":
        case "hideQuickAssistant":
        case "toggleQuickAssistant": {
            console.log("Command:", cmd);
            console.log("Arguments:", args);
            break;
        }
        case undefined:
        default: {
            console.warn("Unknown command:", cmd);
        }
    }
};

const server = net.createServer(stream => {
    stream.on("data", onData);
});

server.listen(SOCKET_PATH);

const cleanup = () => {
    try {
        fs.existsSync(SOCKET_PATH) && fs.rmSync(SOCKET_PATH);
    } catch {}
};

process.on("SIGINT", () => {
    cleanup();
    process.exit();
});

process.on("SIGTERM", () => {
    cleanup();
    process.exit();
});

process.on("exit", cleanup);

外部调用

echo -n '{ "cmd": "showApplication" }' | socat - /tmp/CherryStudio/cherry-studio.sock

@Yubo-Cao @kangfenmao @DeJeune 几位是否同意这个方案？或者有没有什么更好的建议？

[0xfullex]

之前Electron未打开Wayland快捷键设置，PR #8080 将打开该开关

另外，快捷键设置里面有bug，导致某些情况下虽然设置了快捷键，但是快捷键对应关系有问题，PR #8084 将解决该问题

[0xfullex]

根据社区反馈，目前 Electron v35 & v36 在 Wayland 下的全局快捷键绑定依然存在问题。参见：electron/electron#45607

我的kde wayland可以使用没问题

按electron社区的讨论，chromium对该功能还在修改当中，不同系统的开启方式可能还不太一样，应该这段时间能稳定下来了，如果你用了新pr版本还不生效，只能再等等electron和chromium那边了

[GoodbyeNJN]

使用该 PR 分支编译了一份，并切到 Gnome 和 KDE 分别试了下，Gnome 直接无法绑定，KDE 无法绑定带 F1~F12 的快捷键，其他不完整的 WM 环境估计全挂。所以我还是建议考虑加入外部控制相关的功能。

[GoodbyeNJN]

我顺便阐述一下加入外部控制相关功能的目的：

1. 绕过 Electron/Chromium 尚未稳定的全局快捷键绑定功能，为 Linux Wayland 环境下提供可用的替代方案（刚需），也为其他系统下提供更多可能的使用方式
2. 在外部控制功能的基础之上，通过传参的形式直接调用某个二级页面的功能，例：通过快捷键直接打开快捷助手的翻译页并翻译剪贴板中的文字，甚至可以适配直接跳转将来的插件页面

[GoodbyeNJN]

目前已实现快捷助手下二级页面的直接跳转并调用功能，实现代码在 https://github.com/GoodbyeNJN/cherry-studio ，其中 cmd.mts 脚本可以在外部控制服务器启动后测试命令。

[0xfullex]

该实现成本开销过大，收益过小（影响全局安装包，但<0.5%用户受益），暂不考虑。

建议将你发现的不受支持的平台具体情况，向electron反馈，以尽快获得更新