mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-07-24 12:44:18 +08:00
docs: document CC_SWITCH_GDK_BACKEND Linux Wayland escape hatch
Document the opt-in CC_SWITCH_GDK_BACKEND environment variable (added in #4351) that overrides the AppImage's hardcoded GDK_BACKEND=x11, letting Wayland+NVIDIA users switch back to native Wayland when the webview goes click-dead and black-screens on resize. The override is generic, so tiling-Wayland users can set it to x11 for the inverse input bug. - CHANGELOG.md: new Unreleased/Fixed entry (#4351, fixes #4350) - README.md / README_ZH / README_JA / README_DE: FAQ entry across all locales - docs/user-manual/{zh,en,ja}/5-faq/5.2-questions.md: Linux troubleshooting entry
This commit is contained in:
@@ -284,6 +284,19 @@ CC Switch は「最小限の介入」という設計原則に従っています
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><strong>Linux(Wayland + NVIDIA):Web コンテンツがクリックできない・リサイズで黒画面になる</strong></summary>
|
||||
|
||||
AppImage は過去のネイティブ Wayland クラッシュを避けるため `GDK_BACKEND=x11`(XWayland)を強制します。新しい Wayland + NVIDIA 環境ではこれが原因で Web コンテンツ領域がクリックできなくなり(タイトルバーのボタンは動作します)、リサイズ時に黒画面になることがあります。内蔵のエスケープハッチでネイティブ Wayland に戻せます:
|
||||
|
||||
```bash
|
||||
CC_SWITCH_GDK_BACKEND=wayland ./CC-Switch-*.AppImage
|
||||
```
|
||||
|
||||
デスクトップアイコンから起動する場合は、`.desktop` の `Exec=` 行に追記するか(例:`env CC_SWITCH_GDK_BACKEND=wayland /path/to/AppImage`)、セッション環境で設定してください。この変数は汎用です:タイル型 Wayland コンポジタ(sway/Hyprland)でクリックが効かない場合は、逆に `CC_SWITCH_GDK_BACKEND=x11` を試してください。未設定の場合は既定の動作のままです。
|
||||
|
||||
</details>
|
||||
|
||||
## ドキュメント
|
||||
|
||||
各機能の詳しい使い方については、**[ユーザーマニュアル](docs/user-manual/ja/README.md)** をご覧ください。プロバイダ管理、MCP/Prompts/Skills、プロキシとフェイルオーバーなど、すべての機能を網羅しています。
|
||||
|
||||
Reference in New Issue
Block a user