feat: migrate desktop server to Tauri v2 headless architecture

.github/workflows/build_linux.yml

@@ -1,8 +1,8 @@
 name: Build Linux Server
 
 on:
-  push:
-    branches: [ "master" ]
+  pull_request:
+    branches: [ master ]
     paths:
       - 'server/**'
       - 'web-client/**'
@@ -11,7 +11,7 @@ on:
 
 jobs:
   build:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
 
     steps:
     - uses: actions/checkout@v4
@@ -21,37 +21,39 @@ jobs:
       uses: actions/setup-node@v4
       with:
         node-version: '20'
-        cache: 'npm'
-        cache-dependency-path: web-client/package-lock.json
 
     - name: Build Web Client
       working-directory: ./web-client
       run: |
         npm ci
         npm run build
 
-    # --- 2. Install Linux Dependencies ---
+    # --- 2. Build Tauri Server ---
     - name: Install System Dependencies
       run: |
         sudo apt-get update
-        sudo apt-get install -y python3-dev libappindicator3-dev libgirepository1.0-dev pkg-config
+        sudo apt-get install -y libwebkit2gtk-4.1-dev build-essential curl wget file libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
 
-    # --- 3. Build Python Server ---
-    - name: Install uv
-      uses: astral-sh/setup-uv@v5
+    - name: Setup Rust
+      uses: dtolnay/rust-toolchain@stable
       with:
-        python-version: '3.13'
-        enable-cache: true
-        cache-dependency-glob: "server/uv.lock"
+        targets: x86_64-unknown-linux-gnu
 
-    - name: Build with PyInstaller
+    - name: Install Tauri CLI
+      run: cargo install tauri-cli --version "^2.0.0"
+
+    - name: Build Tauri App
       working-directory: ./server
-      # --add-data format for Linux: "source_path:dest_folder_name" (same as macOS)
-      run: |
-        uv run --frozen pyinstaller --clean --onefile --noconsole --name "RemoteMouse" --exclude-module tkinter --exclude-module unittest --add-data "../web-client/dist:web_dist" --add-data "src/server/assets:assets" src/server/main.py
+      env:
+        TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
+        TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
+      run: cargo tauri build
 
     - name: Upload Artifact
       uses: actions/upload-artifact@v4
       with:
         name: RemoteMouse-linux
-        path: server/dist/RemoteMouse
+        path: |
+          server/target/release/bundle/deb/*.deb
+          server/target/release/bundle/appimage/*.AppImage
+          server/target/release/bundle/appimage/*.tar.gz*

.github/workflows/build_macos.yml

@@ -1,8 +1,8 @@
 name: Build macOS Server
 
 on:
-  push:
-    branches: [ "master" ]
+  pull_request:
+    branches: [ master ]
     paths:
       - 'server/**'
       - 'web-client/**'
@@ -21,31 +21,33 @@ jobs:
       uses: actions/setup-node@v4
       with:
         node-version: '20'
-        cache: 'npm'
-        cache-dependency-path: web-client/package-lock.json
 
     - name: Build Web Client
       working-directory: ./web-client
       run: |
         npm ci
         npm run build
 
-    # --- 2. Build Python Server ---
-    - name: Install uv
-      uses: astral-sh/setup-uv@v5
+    # --- 2. Build Tauri Server ---
+    - name: Setup Rust
+      uses: dtolnay/rust-toolchain@stable
       with:
-        python-version: '3.13'
-        enable-cache: true
-        cache-dependency-glob: "server/uv.lock"
+        targets: x86_64-apple-darwin, aarch64-apple-darwin
 
-    - name: Build with PyInstaller
+    - name: Install Tauri CLI
+      run: cargo install tauri-cli --version "^2.0.0"
+
+    - name: Build Tauri App
       working-directory: ./server
-      # --add-data format for macOS/Linux: "source_path:dest_folder_name" (separator is :)
-      run: |
-        uv run --frozen pyinstaller --clean --onefile --noconsole --name "RemoteMouse" --exclude-module tkinter --exclude-module unittest --add-data "../web-client/dist:web_dist" --add-data "src/server/assets:assets" src/server/main.py
+      env:
+        TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
+        TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
+      run: cargo tauri build
 
     - name: Upload Artifact
       uses: actions/upload-artifact@v4
       with:
         name: RemoteMouse-macos
-        path: server/dist/RemoteMouse
+        path: |
+          server/target/release/bundle/dmg/*.dmg
+          server/target/release/bundle/macos/*.tar.gz*

.github/workflows/build_windows.yml

@@ -1,8 +1,8 @@
 name: Build Windows Server
 
 on:
-  push:
-    branches: [ "master" ]
+  pull_request:
+    branches: [ master ]
     paths:
       - 'server/**'
       - 'web-client/**'
@@ -21,32 +21,34 @@ jobs:
       uses: actions/setup-node@v4
       with:
         node-version: '20'
-        cache: 'npm'
-        cache-dependency-path: web-client/package-lock.json
 
     - name: Build Web Client
       working-directory: ./web-client
       run: |
         npm ci
         npm run build
 
-    # --- 2. Build Python Server ---
-    - name: Install uv
-      uses: astral-sh/setup-uv@v5
+    # --- 2. Build Tauri Server ---
+    - name: Setup Rust
+      uses: dtolnay/rust-toolchain@stable
       with:
-        python-version: '3.13'
-        enable-cache: true
-        cache-dependency-glob: "server/uv.lock"
+        targets: x86_64-pc-windows-msvc
 
-    - name: Build with PyInstaller
+    - name: Install Tauri CLI
+      run: cargo install tauri-cli --version "^2.0.0"
+
+    - name: Build Tauri App
       working-directory: ./server
-      # --add-data format for Windows: "source_path;dest_folder_name"
-      # Embedding web-client/dist into web_dist folder inside the executable
-      run: |
-        uv run --frozen pyinstaller --clean --onefile --noconsole --name "RemoteMouse" --exclude-module tkinter --exclude-module unittest --add-data "../web-client/dist;web_dist" --add-data "src/server/assets;assets" src/server/main.py
+      env:
+        TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
+        TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
+      run: cargo tauri build
 
     - name: Upload Artifact
       uses: actions/upload-artifact@v4
       with:
         name: RemoteMouse-exe
-        path: server/dist/RemoteMouse.exe
+        path: |
+          server/target/release/bundle/nsis/*.exe
+          server/target/release/bundle/msi/*.msi
+          server/target/release/bundle/msi/*.zip*

.github/workflows/release.yml

@@ -53,13 +53,6 @@ jobs:
           path: assets/linux
           workflow_conclusion: success
 
-      - name: Rename Artifacts
-        run: |
-          mv assets/macos/RemoteMouse assets/RemoteMouse-macos
-          mv assets/linux/RemoteMouse assets/RemoteMouse-linux
-          mv assets/windows/RemoteMouse.exe assets/RemoteMouse-windows.exe
-          rm -rf assets/macos assets/linux assets/windows
-
       - name: Display downloaded files
         run: ls -R assets
 

.gitignore

@@ -0,0 +1,34 @@
+# --- IDEs & OS ---
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+Thumbs.db
+
+# --- Rust (Server) ---
+/server/target/
+# Tauri v2 gen directory
+/server/gen/
+# Binary projects usually commit Cargo.lock to ensure reproducible builds
+# server/Cargo.lock
+
+# --- Node.js (Web Client) ---
+/web-client/node_modules/
+/web-client/dist/
+/web-client/.cache/
+# web-client/package-lock.json
+
+# --- Python (Legacy Server) ---
+/server-py/.venv/
+/server-py/__pycache__/
+/server-py/dist/
+/server-py/build/
+/server-py/*.spec
+/server-py/.pytest_cache/
+/server-py/.ruff_cache/
+
+# --- Logs & Temp ---
+*.log
+.gemini/tmp/
+.temp/

AGENTS.md

@@ -0,0 +1,103 @@
+# Remote Mouse
+
+## 1. 项目概述
+Remote Mouse 是一个轻量级、低延迟的远程控制工具，允许通过移动设备（浏览器/PWA）作为触控板和键盘控制桌面计算机（Windows/macOS/Linux）。
+
+## 2. 技术架构
+项目采用 **Client-Server (C/S)** 架构：
+- **Web Client (控制端)**: 运行在移动端浏览器中，作为 PWA 应用通过 WebSocket 发送控制指令。
+- **Rust Server (被控端)**: 基于 **Tauri v2** 构建的纯托盘后台服务。它集成了一个高性能的 Web 服务器，执行指令并提供静态资源，并支持开机自启管理与自动更新检查。
+
+## 3. 技术栈组成
+### 服务端 (Rust / Tauri v2)
+- **核心框架**: Tauri v2 (纯托盘模式，无窗口，低内存占用)
+- **辅助功能**: tauri-plugin-autostart (开机自启), tauri-plugin-updater (自动更新), tauri-plugin-dialog (原生对话框)
+- **Web 服务**: Axum (高性能异步 Web 框架，处理 HTTP/WebSocket)
+- **输入模拟**: Enigo (跨平台原生输入控制)
+- **服务发现**: mdns-sd (异步 mDNS 注册与发现)
+- **异步运行时**: Tokio
+
+### 客户端 (TypeScript / Vite)
+- **构建工具**: Vite
+- **核心语言**: TypeScript
+- **界面开发**: 原生 CSS + PWA (Progressive Web App)
+
+## 4. 线程模型
+项目采用多线程协作模式：
+
+1.  **主线程 (Tauri Event Loop)**:
+    - 负责 Tauri 应用程序的生命周期管理。
+    - 运行系统托盘（Tray）的事件监听，响应菜单点击（如退出程序）。
+2.  **Tokio 服务线程**:
+    - 在 `setup` 阶段开启的独立后台线程，运行 Tokio 运行时。
+    - **mDNS 服务**: 负责服务注册与发现，处理 UDP 广播。
+    - **Web 服务 (Axum)**: 处理 HTTP 静态资源分发及 WebSocket 长连接。
+    - **指令中转**: 将收到的网络指令通过 `mpsc` 异步通道发送给 input 工作线程。
+3.  ** input 工作线程**:
+    - 专门处理同步/阻塞的系统级调用（通过 `Enigo` 库）。
+    - 持续从 `mpsc` 通道接收 `ProtocolCommand` 并执行真实的鼠标移动、点击、滚动及键盘输入。
+
+## 5. 核心原理
+1. **多线程解耦**: 使用 Tokio 异步处理网络 IO，独立线程处理同步系统调用，确保托盘和网络响应流畅。
+2. **纯净后台体验**: 通过 `LSUIElement` (macOS) 和 `windows_subsystem` 配置，应用作为真正的系统级工具运行。
+3. **嵌入式资源**: 通过 `rust-embed` 将静态网页嵌入二进制，实现单文件分发。
+4. **零配置接入**: 客户端通过 mDNS 自动发现服务端。
+
+## 6. 模块组成
+### 服务端 (server/src/)
+- `main.rs`: **程序入口**。配置 Tauri 事件循环、托盘菜单、以及跨平台策略。
+- `core/protocol.rs`: **协议解析**。处理二进制指令流，并将其分发给输入 Worker。
+- `services/input.rs`: **输入执行器**。封装 Enigo 操作。
+- `services/web.rs`: **Web 服务引擎**。使用 Axum 提供静态文件托管（基于 `rust-embed`）和 WebSocket 指令接收。
+- `services/mdns.rs`: **自动发现服务**。注册 `_remote-mouse._tcp.local.` 服务。
+
+## 7. 命令
+
+### 开发与环境配置
+**1. Web 客户端**
+客户端资源会被嵌入到 Rust 二进制文件中。首先构建客户端：
+```bash
+cd web-client
+npm install
+npm run build
+```
+
+**2. 服务端**
+使用开发模式运行（需安装 [Tauri CLI](https://tauri.app/v2/guides/development/getting-started/))：
+```bash
+cd server
+cargo tauri dev
+```
+
+打包生产版本安装程序：
+```bash
+cd server
+cargo tauri build
+```
+
+## 8. 接口与协议
+### WebSocket 二进制协议 (`/ws`)
+指令格式：`[OpCode (1B)] [Data (NB)]`
+- `0x01 (MOVE)`: `[dx (short)] [dy (short)]` (相对位移)
+- `0x02 (CLICK)`: `[button (1B)] [modifier_mask (1B)]` (左/右键及修饰键)
+- `0x03 (SCROLL)`: `[sx (short)] [sy (short)]` (横向/纵向滚动)
+- `0x04 (DRAG)`: `[state (1B: 0/1)]` (鼠标左键按下/释放)
+- `0x05 (TEXT)`: `[utf8_payload]` (文本字符串内容)
+- `0x06 (KEY)`: `[modifier_mask (1B)] [key_name (utf8)]` (功能键按压)
+
+## 9. 目录地图
+```text
+remote-mouse/
+├── requirement/          # 需求文档与迭代计划 (v1-v4)
+├── server/               # Rust 服务端代码 (Tauri v2)
+│   ├── src/
+│   │   ├── core/         # 协议解析逻辑
+│   │   ├── services/     # Web/mDNS/Input 核心服务
+│   │   └── main.rs       # Tauri 应用入口与托盘配置
+│   ├── assets/           # 跨平台图标资源 (.ico, .icns, .png)
+│   ├── Cargo.toml        # Rust 依赖配置
+│   └── tauri.conf.json   # Tauri 构建与分发配置
+├── web-client/           # Web 客户端代码 (控制端)
+├── server-py/            # (Legacy) 旧版 Python 服务端备份
+└── README.md             # 项目说明文档
+```