easytouchme: EasyTouch 是一款轻量、无广告、自主可控、全平台跨端触屏远程控制开源工具，完全替代向日葵、ToDesk、TeamViewer 等重型商用远控。

1. 项目总览

1.1 项目定位

EasyTouch 是一款轻量、无广告、自主可控、全平台跨端触屏远程控制开源工具，完全替代向日葵、ToDesk、TeamViewer 等重型商用远控。

项目基于 Zenoh 低延迟消息总线构建「APP(Client)-Router-Peer」原生三层架构，主打手机触屏精准操控电脑，原生适配 Trae、Hermes、OpenClaw 等 AI 本地智能体，解决 AI 命令审批阻塞、远程操作繁琐、商用远控限速/隐私泄露/臃肿冗余等痛点。

1.2 品牌统一规范（最终定稿）

项目品牌名：EasyTouch
开源主仓库：easytouch
项目 Slogan：Simple Cross-Platform Touch Remote Control Based on Zenoh
核心理念：轻量、精准、自主、跨端、AI 友好

1.3 全平台覆盖范围

被控端（电脑端）：Windows / Linux / macOS / HarmonyOS PC（一套代码跨平台）

控制端（移动端）：Android / iOS / HarmonyOS（独立三端 APP）

2. 整体架构设计（标准化网关智能体架构）

2.1 三层架构（Zenoh 原生 Client-Router-Peer 标准模型）

完全遵循 Zenoh 官方节点角色规范与通信机制：移动端APP（Zenoh Client 客户端模式）→ Router路由网关 → 桌面端Peer（Zenoh Peer 对等节点模式）。架构天然支持两种通信链路自动适配，兼顾局域网极致低延迟与外网全域可用性。

APP（移动端 Client）：easytouch-android / easytouch-ios / easytouch-harmony，Zenoh Client 轻量化模式，支持局域网直连 Peer、外网 Router 中转双模式，仅负责交互与收发指令，无路由开销
Router（路由网关）：easytouch-router（基于 Zenoh 官方路由封装，为公网外网跨网访问提供全局消息中转、鉴权、流量管控能力）
Peer（桌面端 Peer）：easytouch-peer（全平台统一桌面常驻对等节点，完整 Zenoh Peer 模式，本地设备能力承载节点，支持被移动端直连/网关转发两种接入方式）

2.2 架构核心优势

原生双链路自适应通信（核心架构优势）：依托 Zenoh 原生网络机制，局域网内 Client 与 Peer 可无网关直连通信，零转发、极低延迟；公网跨网环境自动降级为 Router 网关中转模式，无需公网IP、无需端口映射、无需第三方穿透服务。
角色严格区分（Zenoh 官方标准）：移动端APP固定为 Client 轻量模式，不参与路由、不维护网络拓扑，资源占用极低；桌面端为标准 Peer 全功能节点，常驻在线、可被发现、可处理本地业务、支持双链路接入。
全链路私有化部署，所有数据自主可控，不经过任何第三方厂商服务器。
按需截图、事件驱动推送，区别传统持续视频推流，外网流量消耗极致轻量化。
模块化 Skill 设计，业务可无限扩展，不破坏核心架构。

3. 模块拆分与仓库结构（开源标准化）

主仓库 + 模块化子仓库，结构清晰、解耦彻底，适合长期开源迭代

easytouch                 # 主仓库：文档、公共协议、部署脚本、项目总配置
├─ easytouch-peer         # 全平台桌面被控节点（Win/Linux/macOS/HarmonyOS PC 一套代码，Zenoh Peer模式，支持直连/网关接入）
├─ easytouch-router       # Zenoh 外网网关封装、一键部署、TLS/ACL 配置
├─ easytouch-android      # Android 控制端 APP（Zenoh Client模式，支持局域网直连/外网中转）
├─ easytouch-ios          # iOS 控制端 APP（Zenoh Client模式，支持局域网直连/外网中转）
└─ easytouch-harmony      # HarmonyOS 控制端 APP（Zenoh Client模式，支持局域网直连/外网中转）

easytouchme