首款 AI 原生远程桌面
内置 MCP Server · AI Agent 操控任意远程电脑 · 开源免费
English | 中文
--- QuickDesk 是**首款 AI 原生远程桌面** —— 一款开源免费的远程桌面软件，**内置 MCP (Model Context Protocol) Server**，让任何 AI Agent 都能看到和操控远程电脑。 其他远程桌面工具只服务于人类用户，而 QuickDesk 将 **AI Computer Use** 从"只能操作本机"扩展到**"操作世界上任何一台远程设备"**。将 Claude、GPT、Cursor 或任何 MCP 兼容的 AI 接入 QuickDesk，即可截图、点击、输入、拖拽，在远程桌面上自动化执行任务 —— 像人一样操作，但更快、更持久，7×24 不间断。 底层基于 Google Chromium Remoting 技术架构（Chrome Remote Desktop 背后的引擎），经过十多年大规模商用验证，性能、稳定性和安全性都达到工业级水准。 主界面  远程桌面  AI配置  ## 为什么选择 QuickDesk？ ### AI 优先：唯一内置 MCP 的远程桌面 [ → MCP 接入指南](docs/MCP接入指南.md) - **内置 MCP Server**：AI Agent 通过标准 MCP 协议连接 —— 无需插件、无需 Hack、零配置 - **双传输模式**：stdio 模式（AI 客户端启动进程）或 HTTP/SSE 模式（QuickDesk 托管 MCP 服务器，支持多客户端同时连接） - **完整的 Computer Use 工具集**：20+ MCP 工具 —— 截图、点击、输入、拖拽、滚动、快捷键、剪贴板等 - **实时可见**：AI 的所有操作实时显示在 QuickDesk 界面中 —— 用户看到每一次鼠标移动和键盘输入，随时可以干预 - **多设备 AI 编排**：AI 可同时连接控制多台远程设备 —— 批量自动化、跨设备工作流、设备集群管理 - **内置操作指南**：9 个 MCP Prompt 模板，覆盖远程操作、服务器健康检查、批量自动化、故障诊断、屏幕分析、多设备编排、SOP 文档生成 ### 高性能基座 - **开源免费**：MIT 许可证，商用无忧，无功能限制，无连接数限制 - **私有化部署**：自建信令服务器和 TURN 中继服务器，数据完全掌控在自己手中 - **商用级底座**：基于 Chromium Remoting —— 驱动 Chrome Remote Desktop 的同一套技术，经过 Google 十年+打磨、全球亿级用户验证 - **纯 C++ 极致性能**：从远程协议核心到 GUI 应用全栈 C++，无 GC 停顿、无运行时开销，内存和 CPU 占用极低 - **现代编解码**：支持 H.264、VP8、VP9、AV1 等多种编码，可根据网络和硬件灵活切换 - **WebRTC P2P 直连**：优先建立端到端直连，延迟最低；穿透失败自动回退 TURN 中继 - **跨平台**：支持 Windows 和 macOS（Linux 计划中） - **现代化 UI**：Qt 6 + QML 打造的 Fluent Design 风格界面，支持明暗主题 ## 竞品对比 | 特性 | QuickDesk | RustDesk | BildDesk | ToDesk | TeamViewer | |------|:---------:|:--------:|:--------:|:------:|:----------:| | **AI Agent 支持 (MCP)** | ✅ 内置 | ❌ | ❌ | ❌ | ❌ | | **开源** | ✅ MIT | ✅ AGPL-3.0 | ❌ | ❌ | ❌ | | **免费商用** | ✅ | ❌ 需商业授权 | ❌ | ❌ | ❌ | | **核心语言** | C++ | Rust + Dart | — | — | — | | **远程协议** | Chromium Remoting (WebRTC) | 自研 | 自研 | 自研 | 自研 | | **协议成熟度** | ⭐⭐⭐⭐⭐ Google 10年+商用 | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | | **P2P 直连** | ✅ WebRTC ICE | ✅ TCP 打洞 | ✅ | ✅ | ✅ | | **视频编码** | H.264/VP8/VP9/AV1 | VP8/VP9/AV1/H.264/H.265 | — | — | — | | **私有化部署** | ✅ 完整方案 | ✅ | ❌ | ❌ | ❌ | | **GUI 框架** | Qt 6 (C++) | Flutter (Dart) | — | — | — | | **内存占用** | ⭐⭐⭐⭐⭐ 极低 | ⭐⭐⭐ 中等 | — | ⭐⭐⭐ | ⭐⭐⭐ | | **CPU 占用** | ⭐⭐⭐⭐⭐ 极低 | ⭐⭐⭐ 中等 | — | ⭐⭐⭐ | ⭐⭐⭐ | | **Windows** | ✅ | ✅ | ✅ | ✅ | ✅ | | **macOS** | ✅ | ✅ | ✅ | ✅ | ✅ | | **Linux** | 🔜 | ✅ | ❌ | ✅ | ✅ | | **iOS/Android** | 🔜 | ✅ | ✅ | ✅ | ✅ | ### 为什么性能最好？ 1. **纯 C++ 全栈**：从底层协议到上层 GUI 全部使用 C++ 实现，无 GC（垃圾回收）带来的停顿抖动，无 VM/Runtime 开销。相比 RustDesk 的 Dart/Flutter GUI 层、ToDesk 等使用 Electron 的方案，CPU 和内存占用显著更低。 2. **Chromium 级别优化**：视频编解码、网络传输、屏幕捕获等核心路径直接复用 Chromium 中经过极致性能调优的 C++ 代码，包括 SIMD 指令优化、零拷贝渲染管线等。 3. **共享内存视频传输**：QuickDesk 采用共享内存在进程间传递视频帧（YUV I420），避免了传统 IPC 的序列化/反序列化和数据拷贝开销。 4. **GPU 加速渲染**：通过 Qt 6 的 `QVideoSink` 直接将 YUV 数据送入 GPU 渲染管线，实现零 CPU 拷贝的视频渲染。 ## 功能 ### AI 集成（MCP Server） - 内置 MCP Server —— AI Agent 通过标准协议连接，支持 Cursor、Claude Desktop、VS Code 等所有 MCP 客户端 - 双传输模式：stdio（AI 客户端启动进程）或 HTTP/SSE（QuickDesk 管理 MCP 服务器，多个 AI 客户端同时连接） - 20+ 远程控制工具：截图、鼠标点击/拖拽/滚动、键盘输入/快捷键、按键按下/释放、剪贴板读写、屏幕分辨率查询 - MCP Resources：实时设备状态、连接信息、主机详情 - 9 个 MCP Prompts：操作指南、服务器健康检查、批量自动化、故障诊断、屏幕分析、多设备编排、SOP 文档生成 - 实时事件推送：连接状态变化、剪贴板更新、性能统计 - 事件驱动工具：wait_for_event、wait_for_connection_state、wait_for_clipboard_change，支持响应式自动化 - 后台自动化模式：`show_window=false` 无界面批量操作 - 截图缩放：可调分辨率，加速 AI 处理 ### 远程控制 - 高清低延迟远程桌面显示 - 键盘和鼠标完整映射控制 - 远程光标实时同步 - 剪贴板双向同步 - 自适应帧率与码率 - 帧率增强模式（办公 / 游戏） ### 连接管理 - 9 位设备 ID + 临时访问码机制 - 访问码自动刷新（可配置 30 分钟~24 小时或永不刷新） - 多标签页同时连接多台远程设备 - 连接历史记录与快速重连 - 实时连接状态监控 ### 性能监控 - 详细的延迟分解面板（捕获 → 编码 → 网络 → 解码 → 渲染） - 实时帧率、码率、带宽统计 - 输入往返时延（Input RTT）监测 - 编码分辨率、编码质量信息 ### 个性化 - Fluent Design 风格界面 - 明暗主题切换 - 中英文国际化支持 - 视频编码偏好设置（H.264 / VP8 / VP9 / AV1） ### 私有化部署 - 自定义信令服务器地址 - 自定义 STUN/TURN 服务器 - 完整的服务端部署方案（Go 信令服务器 + PostgreSQL + Redis + coturn） ## 架构 QuickDesk 采用模块化多进程架构： ```mermaid graph TD subgraph AI["AI Agent (Claude / GPT / Cursor)"] A1["MCP 协议"] end subgraph MCP["quickdesk-mcp (Rust 桥接)"] M1["MCP stdio ↔ WebSocket"] M2["MCP HTTP/SSE ↔ WebSocket"] end subgraph GUI["QuickDesk GUI (Qt 6)"] direction LR WS["WebSocket API 服务端"] QML["QML/C++"] MainWin["主窗口"] RemoteWin["远程桌面窗口"] end subgraph Host["quickdesk-host (Chromium Remoting)"] H1["屏幕捕获"] H2["视频编码"] H3["输入事件处理"] H4["WebRTC 连接"] end subgraph Client["quickdesk-client (Chromium Remoting)"] C1["视频解码"] C2["输入事件注入"] C3["共享内存视频帧传输"] C4["WebRTC 连接"] end subgraph Signaling["Signaling Server (Go + Gin)"] S1["WebSocket 信令"] S2["ICE 配置分发"] S3["设备注册与认证"] S4["PostgreSQL + Redis"] end subgraph TURN["TURN Server (coturn)"] T1["P2P 穿透失败时提供中继服务"] end AI -- "stdio (JSON-RPC)" --> MCP AI -. "HTTP/SSE" .-> M2 MCP -- "WebSocket" --> WS GUI -- "Native Messaging\n(stdin/stdout JSON)" --> Host GUI -- "Native Messaging\n(stdin/stdout JSON)" --> Client Host -- "WebSocket" --> Signaling Client -- "WebSocket" --> Signaling Signaling -- "ICE 配置" --> TURN Host -. "WebRTC P2P / TURN 中继" .-> Client ``` ### 技术栈 | 层级 | 技术 | |------|------| | AI 集成 | MCP Server (Rust) + WebSocket API | | GUI 客户端 | Qt 6 (QML + C++17) | | UI 风格 | Fluent Design 组件库（自研） | | 远程协议核心 | Chromium Remoting (C++) | | 音视频编解码 | H.264 / VP8 / VP9 / AV1 | | 网络传输 | WebRTC (ICE/STUN/TURN) | | 进程间通信 | Native Messaging (JSON) + 共享内存 | | 信令服务器 | Go + Gin + GORM | | 数据存储 | PostgreSQL + Redis | | TURN 中继 | coturn | | 日志 | spdlog | | 构建系统 | CMake 3.19+ | | CI/CD | GitHub Actions | ## 快速开始 ### 下载安装 前往 [Releases](https://github.com/barry-ran/QuickDesk/releases) 下载最新版本： | 平台 | 下载 | |------|------| | Windows x64 | [QuickDesk-win-x64-setup.exe](https://github.com/barry-ran/QuickDesk/releases/latest) | | macOS ARM64 | [QuickDesk-mac-arm64.dmg](https://github.com/barry-ran/QuickDesk/releases/latest) | ### 使用方法 1. 在**被控端**和**主控端**分别安装并运行 QuickDesk 2. 被控端会自动生成 **设备 ID** 和 **访问码** 3. 在主控端输入被控端的设备 ID 和访问码，点击**连接** 4. 连接成功后即可远程控制 ## 从源码编译 ### 环境要求 - CMake 3.19+ - Qt 6.5+（需要 Multimedia、WebSockets 模块） - C++17 编译器 ### Windows ```bash # 需要 Visual Studio 2022 + MSVC # 设置 Qt 路径环境变量 set ENV_QT_PATH=C:\Qt\6.8.3 # 编译 scripts\build_qd_win.bat Release # 打包（需要 Inno Setup） scripts\publish_qd_win.bat Release scripts\package_qd_win.bat Release ``` ### macOS ```bash # 需要 Xcode Command Line Tools # 设置 Qt 路径环境变量 export ENV_QT_PATH=/path/to/Qt/6.8.3 # 编译 bash scripts/build_qd_mac.sh Release # 打包 bash scripts/publish_qd_mac.sh Release bash scripts/package_qd_mac.sh Release ``` ### API Key（可选） 如果你部署了自己的信令服务器并启用了 API Key，可以在编译时注入 API Key 使客户端能够通过认证： ```bash # Windows set ENV_QUICKDESK_API_KEY=your-secret-key scripts\build_qd_win.bat Release # macOS ENV_QUICKDESK_API_KEY=your-secret-key bash scripts/build_qd_mac.sh Release ``` 不设置 `ENV_QUICKDESK_API_KEY` 时，编译出的客户端只能连接未开启 API Key 保护的信令服务器。 > **WebClient 说明：** WebClient 是运行在浏览器中的静态网页，嵌入到 JS 中的 API Key 可通过 DevTools 看到，因此 WebClient 采用 **Origin 域名白名单** 验证而非 API Key。在信令服务器配置 `ALLOWED_ORIGINS` 来限制允许访问的域名。浏览器会自动发送 `Origin` 请求头且 JavaScript 无法伪造，只有从官方域名加载的 WebClient 才能通过验证。 详情参见[信令服务器部署文档](docs/信令服务器部署.md)。 ## 私有化部署 QuickDesk 支持完整的私有化部署，你可以将所有服务部署在自己的服务器上，确保数据安全。 ### 部署组件 1. **信令服务器**（必需）：负责设备注册、信令转发 → [信令服务器部署文档](docs/信令服务器部署.md) 2. **TURN 中继服务器**（推荐）：在 P2P 直连失败时提供中继 → [TURN 服务器部署文档](docs/TURN服务器部署.md) ### 客户端配置 在 QuickDesk **设置 → 网络** 中配置： - 信令服务器地址：`ws://your-server.com:8000` 或 `wss://your-server.com:8000` - 自定义 STUN 服务器：`stun:your-server.com:3478` - 自定义 TURN 服务器：`turn:your-server.com:3478`（需提供用户名和密码） ## 项目结构 ``` QuickDesk/ ├── QuickDesk/ # Qt GUI 客户端 │ ├── main.cpp # 应用入口 │ ├── src/ │ │ ├── api/ # WebSocket API 服务端 + 请求处理 │ │ ├── controller/ # 主控制器 │ │ ├── manager/ # 业务管理（Host/Client/Process/TURN/...） │ │ ├── component/ # 视频渲染、按键映射、光标同步 │ │ ├── core/ # 配置中心、用户数据 │ │ ├── viewmodel/ # MVVM ViewModel │ │ └── language/ # 国际化 │ ├── qml/ │ │ ├── views/ # 主窗口、远程桌面窗口 │ │ ├── pages/ # 远程控制页、设置页、关于页 │ │ ├── component/ # Fluent Design 通用组件库 │ │ └── quickdeskcomponent/ # QuickDesk 专用组件 │ ├── base/ # 基础工具库 │ └── infra/ # 基础设施（数据库、日志、HTTP） ├── quickdesk-mcp/ # Rust MCP 桥接（stdio ↔ WebSocket） │ └── src/ │ ├── main.rs # 入口、命令行参数、MCP Server 启动 │ ├── server.rs # MCP 工具、提示词模板、资源 │ └── ws_client.rs # 连接 Qt API 的 WebSocket 客户端 ├── SignalingServer/ # Go 信令服务器 │ ├── cmd/signaling/ # 程序入口 │ └── internal/ # 业务逻辑 ├── scripts/ # 编译、打包、发布脚本 ├── docs/ # 文档 │ ├── mcp-integration.md # MCP 接入指南（英文） │ └── MCP接入指南.md # MCP 接入指南（中文） ├── .github/workflows/ # CI/CD 配置 └── version # 版本号 ``` ## 路线图 - [x] Windows 支持 - [x] macOS 支持 - [x] P2P 直连 + TURN 中继 - [x] 多标签页多连接 - [x] 访问码自动刷新 - [x] 视频性能统计面板 - [x] Fluent Design UI - [x] 明暗主题 - [x] 国际化（中/英） - [x] **MCP Server —— AI Agent 操控远程桌面** - [x] **20+ MCP 工具（截图、点击、输入、拖拽、快捷键、剪贴板等）** - [x] **MCP Resources & Prompts** - [ ] Linux 支持 - [ ] 文件传输 - [ ] 音频传输 - [ ] iOS / Android 客户端 - [ ] 无人值守访问 - [ ] 地址簿与设备分组 ## 贡献 欢迎参与 QuickDesk 的开发！请遵循以下规范： 1. Fork 本仓库并创建特性分支 2. 代码风格保持与项目一致 3. 提交 PR 前请确保编译通过 4. 一个 PR 只包含一个功能点或修复 ## 许可证 QuickDesk 自身代码基于 [MIT License](LICENSE) 开源，商用无忧。 项目中捆绑的 `quickdesk-remoting` 组件基于 Chromium，遵循 [BSD 3-Clause License](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/LICENSE)。 完整的第三方许可证信息请参见 [THIRD_PARTY_LICENSES](THIRD_PARTY_LICENSES)。 ## 致谢 - [Chromium Remoting](https://chromium.googlesource.com/chromium/src/+/refs/tags/140.0.7339.249/remoting/) — 远程桌面协议核心 - [Qt](https://www.qt.io/) — 跨平台 GUI 框架 - [spdlog](https://github.com/gabime/spdlog) — 高性能日志库 - [coturn](https://github.com/coturn/coturn) — TURN 中继服务器 ## Star 历史 [](https://star-history.com/#barry-ran/QuickDesk&Date)