TextCascade Linux 客户端

跨设备剪贴板同步命令行客户端，连接 TextCascade Server 的 /api/v1/login 与 textcascade.v1 WebSocket。支持 Wayland（wl-clipboard）和 X11（xclip 或 xsel）。GNOME/Wayland 建议同时安装 wl-clipboard 与 xclip：客户端通过 xclip 读取，避免轮询式 wl-paste 创建透明窗口造成焦点闪动；写入优先使用 Wayland 原生 wl-copy，没有时才回退到 XWayland 的 xclip，并明确使用 UTF-8 格式。

构建

需要 Go 1.23 或更高版本，并在构建时联网下载 gorilla/websocket：

go build -trimpath -o textcascade-client .

安装剪贴板工具

# Debian / Ubuntu, X11 或 Wayland
sudo apt install wl-clipboard xclip
# Fedora
sudo dnf install wl-clipboard xclip
# Arch Linux / EndeavourOS
sudo pacman -S wl-clipboard xclip

在纯终端/SSH 会话中需要有效桌面会话及 WAYLAND_DISPLAY 或 DISPLAY 环境变量。CopyQ 等 Wayland 剪贴板管理器建议使用原生 wl-copy 写入路径。

运行

./textcascade-client --server https://your-server.example:8443 --username alice

程序会提示输入密码。也可以用 --password（会出现在进程参数列表中，不建议日常使用）。自签证书请传入可信 CA：

./textcascade-client --server https://your-server.example:8443 --username alice --ca /path/to/ca.pem

--insecure 会关闭服务器证书校验，只建议用于临时测试。X11 和 XWayland 环境通过 xclip 或 xsel 读取剪贴板；其他 Wayland 环境通过 wl-clipboard 读取。客户端每 500ms 检查剪贴板，连接断开后自动登录重连。状态和设备 ID 默认保存在 ~/.config/textcascade/，可用 --state 覆盖状态文件。使用 Ctrl+C 退出。

默认启用与 TextCascade 桌面端兼容的端到端加密（PBKDF2-HMAC-SHA256，默认 664937 轮；AES-256-GCM）。加密密钥由账号、登录密码和加密盐派生；其他设备必须使用相同的加密盐和迭代次数。可用 --encryption-salt 和 --hash-rounds 设置非默认参数。--encrypt=false 可用于未启用端到端加密的服务端/设备。程序不会同步图片、文件或富文本。

图形托盘版（GNOME / Wayland）

客户端包含 PyQt6 托盘控制界面。登录图形桌面后，用户级 systemd 服务会静默启动到托盘；关闭主窗口会隐藏窗口。托盘菜单可打开窗口、暂停/继续同步、重新连接，或退出并停止同步。GNOME 需要启用 AppIndicator 扩展。托盘服务使用 XWayland 平台插件，避免隐藏的托盘窗口参与 Wayland 输入法焦点处理。

安装到用户目录

1. 安装 Go 1.23+、Python 3 的 PyQt6、剪贴板工具和 GNOME AppIndicator 扩展；Wayland 推荐 wl-clipboard。

2. 构建并安装命令行客户端：

   go build -trimpath -o textcascade-client .
   install -Dm755 textcascade-client ~/.local/bin/textcascade-client
   install -d -m700 ~/.config/textcascade

3. 创建仅自己可读的密码文件 ~/.config/textcascade/password，然后执行 chmod 600 ~/.config/textcascade/password。

4. 复制 textcascade-client.service.example 到 ~/.config/systemd/user/textcascade-client.service，修改服务地址和账号。

5. 安装托盘程序和服务单元：

   install -Dm755 textcascade_tray.py ~/.local/share/textcascade/textcascade_tray.py
   install -Dm644 deploy/textcascade-tray.service ~/.config/systemd/user/textcascade-tray.service
   systemctl --user daemon-reload
   systemctl --user enable --now textcascade-client.service textcascade-tray.service

窗口里的自启复选框会同时启用或关闭两个用户服务。托盘 GUI 通过单实例 IPC 工作；从应用菜单再次启动会打开已运行的主窗口。

剪贴板文本通过 UTF-8 MIME 读取；本地剪贴板内容需稳定 1.2 秒后才上传，以过滤输入法产生的瞬时中间内容。重复的服务端内容不会重复写回系统剪贴板。

许可与上游

本客户端按 GPL-3.0 发布，完整文本见 LICENSE。协议兼容目标为 long45343/TextCascade-Server，来源与许可说明见 NOTICE。