深度台 · DeepDesk

📱 用手机随身掌控电脑 AI 智能体与大模型

Windows 本地 AI 工作台 & 手机移动端远程遥控中枢

📖 简体中文 (当前) | 🌐 English Documentation

---

⬇️ 快速下载安装 (Official Downloads)

平台 / 客户端	下载地址	当前版本与状态	说明
🖥️ Windows 桌面端	📥 下载 DeepDesk.exe	v1.0.0 (正式发布)	双击直接静默启动，免安装绿色版
📱 Android 手机端	📥 下载 DeepDeskRemote.apk	v1.0.0 (正式发布)	适用于 Android 8.0 及以上安卓手机
🍎 iOS 苹果手机端	(加紧开发中 🚧)	In Development	iOS 原生客户端正在内测开发中，敬请期待

---

💡 深度台（DeepDesk）是什么？

一句话看懂：深度台 (DeepDesk) 让你在电脑上运行最强大的 AI 智能体（DeepSeek Harness、Claude Code、WorkBuddy、Codex 等）和全网大模型，并且无论你走到哪里，只要掏出手机（安卓），就能实时查看电脑智能体跑代码、下发新任务、确认操作权限，随时随地掌控电脑 AI。

---

✨ 核心特色功能

1. 📱 手机随时随地远程遥控电脑 AI（0 门槛一键搞定）

• 出门在外掌控电脑：手机 App 实时同步电脑端 DeepSeek Harness 的执行日志、对话流、智能体执行进度。
• 远程下发指令与权限审批：在手机上随时向电脑智能体发送新提示词，或在智能体需要修改文件/执行终端命令时一键远程批准。
• 全自动零摩擦连接：电脑端无需繁琐配置网络，只需粘贴 cpolar Authtoken，系统在后台全自动下载、安装、启动安全加密隧道并生成二维码，手机扫码秒连。

2. 🤖 多智能体协同战队（Multi-Agent Teammates）

• 官方 Harness 深度集成：原生搭载官方 @deepseek-ai/dsh 核心引擎，支持历史续聊、模型检索与流式交互。
• ACP 官方协议直连：通过标准智能体通信协议 (ACP) 与本机 WorkBuddy / CodeBuddy 互通。
• 系统智能体自动探测：自动识别本机已安装的 Codex、Claude Code、Kimi Code 等主流代码智能体。

3. 🌐 全网主流大模型一站式聚合

• 内置开箱即用支持：DeepSeek、OpenAI (GPT-4o/o3)、Anthropic Claude 3.7、Google Gemini 2.0、月之暗面 Kimi、阿里云百炼 (通义千问 Qwen)、智谱 GLM (Z.AI)、硅基流动 (SiliconFlow)、MiniMax 与 OpenRouter。
• 支持多模型动态热切换、流式多轮对话与统一提示词管理。

4. 🔒 银行级安全加密与回环物理隔离

• 硬件级密钥加密：所有 API Key 均采用 Windows 原生 DPAPI 硬件加密（Electron safeStorage），明文绝不落盘、不进导出配置。
• 回环物理隔离：本地服务严格只监听回环地址 127.0.0.1:3090，不向局域网暴露任何端口；公网连接由用户专属端到端加密 HTTPS 隧道承载，安全无忧。

5. 🚀 原生极速启动体验

• 附带由 C# 原生编译的轻量启动器 DeepDesk.exe，双击瞬间静默启动，免除黑色 CMD 命令行窗口困扰。

---

🏗️ 整体架构图

┌──────────────────────────────────────────────────────────────────┐
│                      DeepDesk 桌面端 (Windows)                   │
│  ┌─────────────────────────┬──────────────────────────────────┐  │
│  │   现代化桌面 UI 界面     │   核心服务与安全中枢              │  │
│  │   - Harness 智能体对话   │   - Windows DPAPI 硬件密钥加密    │  │
│  │   - 全网大模型聚合中心   │   - 多厂商 LLM 请求调度与流式分发 │  │
│  │   - 本机智能体协同面板   │   - ACP / WorkBuddy 协议桥接      │  │
│  │   - 远程手机控制配置     │   - 127.0.0.1:3090 回环安全隔离   │  │
│  └─────────────────────────┴──────────────────────────────────┘  │
└─────────────────────────────────┬────────────────────────────────┘
                                  │
          ┌───────────────────────┴───────────────────────┐
          ▼                                               ▼
┌──────────────────────────────┐              ┌────────────────────────┐
│    cpolar 极速全自动穿透     │              │    手机端移动应用      │
│  - 静默后台下载与解压部署    │  ◄════════►  │  - Android 原生客户端  │
│  - 用户专属 HTTPS 加密隧道   │  (安全连接)  │  - 扫码秒配对 · 随身遥控│
│  - Token 热重载与实时地址感知│              │  - iOS (开发中 🚧)     │
└──────────────────────────────┘              └────────────────────────┘

---

📂 项目结构

.
├── src/                   # 桌面端主程序、预加载脚本与服务
│   ├── main.cjs           # Electron 主进程与系统级 IPC 中枢
│   ├── preload.cjs        # 安全上下文隔离桥接层
│   ├── cpolar-tunnel.cjs  # cpolar 全自动静默部署、穿透与状态管理
│   ├── workbuddy/         # 手机远程控制服务端与 Web 控制台
│   └── renderer/          # 桌面端现代化 UI 交互与新手向导
├── android/               # Android 原生客户端源码 (Kotlin / Compose)
├── ios/                   # iOS 移动端源码 (开发中 🚧)
├── test/                  # 自动化测试套件 (58/58 项测试用例全部通过)
├── DeepDesk.exe           # 已编译的原生 Windows 双击启动器
├── launcher.cs            # C# 静默启动器源码
├── package.json           # 项目配置与依赖说明
├── README.md              # 简体中文介绍文档
└── README_EN.md           # 英文专业说明文档 (English Documentation)

---

🚀 快速开始

1. 运行 Windows 桌面端

直接双击运行下载的 DeepDesk.exe 即可启动！

如果需要以开发者模式运行：

# 1. 安装项目依赖
pnpm install

# 2. 执行全量自动化测试（58项全部通过）
pnpm test

# 3. 启动开发版
pnpm start

2. 构建 Android 客户端

cd android/DSHRemote
./gradlew assembleDebug

构建产物输出至：android/DSHRemote/app/build/outputs/apk/debug/app-debug.apk。

---

📱 手机远程连接 3 步指南

1. 打开桌面端顶部的 「远程控制」 页面。
2. 点击直达 cpolar 官网 注册登录，在网页左侧点击 【验证】(Auth) 复制您的 Authtoken。
3. 粘贴到输入框点击 【✨ 一键生成配对二维码】，用手机 DeepDesk Remote App 扫码即可连接！

---

🧪 自动化测试验证

本项目拥有完善的单元测试保障，运行 npm test 即可验证全部核心模块：

• ✅ 环境变量与密钥安全掩码
• ✅ cpolar 自动化下载、解压、部署与隧道重载
• ✅ Harness 官方 RPC 通信与对话解析
• ✅ 多厂商大模型适配与离线回退保护
• ✅ ACP 智能体桥接与网络安全路由

---

📄 开源许可证

本项目采用 MIT 许可证。欢迎提交 Issue 与 Pull Request 共同完善！

Made with ❤️ by DeepDesk Team