fix: Linux Wayland 改用应用级自定义标题栏，绕过 GTK CSD 点击无响应问题

[aeoform]

User description

Summary

• KDE/Wayland 下 GTK CSD 标题栏按钮无法响应点击（tao#1218, tauri#9394），WebKit 环境变量 + nudge resize 均不能可靠修复
• 参考 cc-switch 方案，设置 decorations: false + transparent: true，用 React 组件绘制应用级标题栏
• 36px 拖拽栏 + 最小化/最大化/关闭三键，通过 @tauri-apps/api/window 的 getCurrentWindow() 控制窗口
• 同时保留 WEBKIT_DISABLE_COMPOSITING_MODE / DMABUF_RENDERER 环境变量和 async nudge 作为辅助修复

Changes

File	Change
tauri.linux.conf.json	主窗口 decorations: false + transparent: true
WindowChrome.tsx	新增 LinuxTitlebar 组件（动态 import Tauri API + 内联 SVG 图标）
main.rs	WebKit 合成模式环境变量（GTK 初始化前设置）
lib.rs	async nudge（set_focus + ±1px resize）辅助修复 webview surface 输入区域

Test plan

• KDE Wayland 下窗口控制按钮可点击（最小化/最大化/关闭）
• 拖拽标题栏可移动窗口
• 双击标题栏切换最大化/还原
• macOS/Windows 不受影响（OS 条件渲染隔离）

🤖 Generated with Claude Code

---

PR Type

Bug fix, Enhancement

---

Description

• Add Linux custom titlebar controls

• Disable GTK decorations on Wayland

• Set WebKit Linux compatibility env vars

• Nudge WebView after initial show

---

Diagram Walkthrough

flowchart LR
  cfg["tauri.linux.conf.json window config"] -- "decorations:false, transparent:true" --> chrome["WindowChrome.tsx LinuxTitlebar UI"]
  chrome -- "window controls and state sync" --> tauri["Tauri window API"]
  main["main.rs WebKit env vars"] -- "compositing compatibility" --> webkit["WebKitGTK"]
  lib["`lib.rs` post-show nudge" -- "focus + ±1px resize" --> webview["Webview input region"]

Loading

File Walkthrough

	Relevant files
Bug fix	lib.rs Add Linux post-show window nudge                                                  openless-all/app/src-tauri/src/lib.rs Adds a Linux-only workaround after main.show() Forces focus and a small resize cycle Reconciles the window size after the nudge Avoids overwriting real user or compositor resizes +41/-2
Configuration changes	main.rs Set Linux WebKit compatibility variables                                  openless-all/app/src-tauri/src/main.rs Sets WEBKIT_DISABLE_DMABUF_RENDERER=1 on Linux Sets WEBKIT_DISABLE_COMPOSITING_MODE=1 on Linux Preserves existing values when already configured Applies the workaround before app startup +15/-0    tauri.linux.conf.json Switch Linux window to frameless mode                                        openless-all/app/src-tauri/tauri.linux.conf.json Disables native window decorations on Linux Enables transparency for the custom shell Keeps the main window hidden at startup +2/-2
Enhancement	WindowChrome.tsx Add Linux custom window titlebar                                                  openless-all/app/src/components/WindowChrome.tsx Adds a Linux-only draggable titlebar Implements minimize, maximize, restore, and close actions Syncs maximize state from tauri://resize Uses inline SVG icons and hover styling +155/-9

---

[github-actions]

PR Reviewer Guide 🔍

(Review updated until commit a4705fa)

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 3 🔵🔵🔵⚪⚪

🧪 No relevant tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Click handling The Linux titlebar is marked as a drag region, but the control buttons are not opted out of dragging. In Tauri, that can cause clicks on minimize/maximize/close to start a window drag instead of firing the button handler, especially on Wayland where drag regions are handled natively. <div data-tauri-drag-region style={{ height: LINUX_TITLEBAR_HEIGHT, flexShrink: 0, display: 'flex', alignItems: 'center', justifyContent: 'space-between', padding: '0 6px 0 14px', background: 'rgba(245,245,247,0.85)', backdropFilter: 'blur(12px) saturate(180%)', WebkitBackdropFilter: 'blur(12px) saturate(180%)', borderBottom: '0.5px solid rgba(0,0,0,0.08)', color: 'var(--ol-ink-3)', fontSize: 13, fontWeight: 500, cursor: 'default', userSelect: 'none', zIndex: 50, }} > <span style={{ color: 'var(--ol-ink-2)' }}>OpenLess</span> <div style={{ display: 'flex', gap: 4, pointerEvents: 'auto' }} onMouseDown={(e) => e.stopPropagation()} > <button onClick={onMinimize} aria-label="Minimize" style={ctrlBtn}> <MinimizeSvg /> </button> <button onClick={onToggleMaximize} aria-label={maximized ? 'Restore' : 'Maximize'} style={ctrlBtn}> {maximized ? <RestoreSvg /> : <MaximizeSvg />} </button> <button onClick={onClose} aria-label="Close" className="ol-linux-close-btn" style={ctrlBtn} > <CloseSvg /> </button> </div> Missing Double-Click The custom Linux titlebar does not handle double-clicks on the empty titlebar area, so the usual maximize/restore shortcut is lost after replacing the native decorations. Users who rely on double-clicking the titlebar will now get no response. <div data-tauri-drag-region style={{ height: LINUX_TITLEBAR_HEIGHT, flexShrink: 0, display: 'flex', alignItems: 'center', justifyContent: 'space-between', padding: '0 6px 0 14px', background: 'rgba(245,245,247,0.85)', backdropFilter: 'blur(12px) saturate(180%)', WebkitBackdropFilter: 'blur(12px) saturate(180%)', borderBottom: '0.5px solid rgba(0,0,0,0.08)', color: 'var(--ol-ink-3)', fontSize: 13, fontWeight: 500, cursor: 'default', userSelect: 'none', zIndex: 50, }} >

[github-actions]

Persistent review updated to latest commit a4705fa

[aeoform]

经过我的测试，这两个问题不存在