rylena/sshdesk

它解決的問題

SSHDESK 提供了一種透過單一 SSH 會話完全存取完整互動式遠端桌面的方式，無需額外的遠端桌面協定（如 VNC 或 RDP）、網頁瀏覽器，或額外開啟的網路埠。它讓使用者能直接在標準終端模擬器內檢視並控制遠端圖形介面。

工作原理

系統透過捕獲遠端主機的螢幕，並將其以視覺資料形式透過 SSH PTY 傳送。它使用 OpenSSH 的強制命令設定來啟動桌面會話。根據終端機的功能，它會透過 Kitty 圖形協定傳輸高解析度的「真實像素」圖塊，或在 ANSI 終端機上降級為較低解析度的色彩單元。

輸入（鍵盤與滑鼠）會透過相同的 SSH 會話傳回。在 Linux 上，它整合了多種顯示堆疊，包括 X11、GNOME Wayland（透過 PipeWire），以及其他 Wayland 合成器（透過 ydotool）。同時也支援 macOS 與 Windows 作為主機。

適用對象

• 遠端管理員：希望在不設定複雜防火牆規則或額外服務的情況下，取得遠端機器的圖形存取權。
• AI 代理：專案內建 sshdesk-agent 命令集，讓 AI 代理能截圖、移動滑鼠與輸入文字，進而透過 SSH 實現「電腦使用」功能。
• 終端機進階使用者：偏好在終端環境中完成所有遠端管理任務的使用者。

主要特色

• 零額外埠口：完全透過現有的 SSH 埠運作。
• 跨終端相容性：支援 Kitty、Ghostty 與 WezTerm 的高保真圖形，並為 PuTTY 與行動裝置客戶端提供通用降級方案。
• 自適應效能：具備最新畫面排程機制，可捨棄過時畫面以降低延遲，並在慢速網路中自動調整縮放。
• 支援代理：提供結構化的 JSON API（sshdesk-remote），讓 AI 代理能與桌面互動。
• 多平台主機支援：可在 Linux（X11/Wayland）、macOS 與 Windows 上運作。