# autojsServer **Repository Path**: 963149408.com/autojs-server ## Basic Information - **Project Name**: autojsServer - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-13 - **Last Updated**: 2026-11-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # autojsServer — AutoJs6 中心服务器 基于 Python asyncio(仅标准库,无第三方依赖)的中心服务器:**AutoJs6 手机零改动接入**,控制端 App(myscreen)通过改进协议接入并下发命令。 ## 架构 ``` AutoJs6 手机 ──客户端模式拨入(host:8080)──┐ ├── 中心服务器 ── 控制端 App(myscreen 等,改进协议) AutoJs6 手机 ──客户端模式拨入(host:8080)──┘ ``` - **设备侧**(AutoJs6):协议保持原样(8 字节大端帧 + hello 版本校验 + command/bytes_command 下行 + log/script_data 上行)。手机端只在「连接到计算机 → 客户端模式」里填 `服务器IP:8080` 即可,**不改任何代码**。 - **控制端侧**(myscreen):hello 声明 `role=controller`,命令经 `forward` 包装帧路由到指定设备,设备上下行数据以 `device_event` / `device_frame` 回推。协议规范见 [doc/protocol.md](doc/protocol.md)。 ## 快速开始 ```bash # 1. 启动服务器(Python 3.10+) python server.py --port 8080 # 2. AutoJs6 手机端:侧边栏「连接到计算机 → 客户端模式」 # 输入 服务器IP:8080 (支持域名 / IPv6,端口可自定) # 3. 控制端 myscreen:「连接」页 →「中心服务器地址」填入同地址 ``` ## 自检 ```bash python test_smoke.py ``` 在进程内起服务器,模拟一台设备 + 一个控制端走完整链路(hello 握手、forward 路由、bytes_command 双帧透传、name 兜底、上下线广播),当前 11 项全部通过。该文件同时是控制端/设备侧的字节流级协议交互示例。 ## 运行参数 | 参数 | 默认 | 说明 | |---|---|---| | `--host` | `0.0.0.0` | 监听地址 | | `--port` | `8080` | 监听端口(设备与控制端共用,按 hello 的 role 分流) | | `--ext-version` | `1.0.13` | hello 应答版本,须 ≥ 客户端 `VSCODE_EXT_REQUIRED_VERSION`(客户端升级后需同步调高) | | `--keepalive` | `40` | 空闲保活间隔秒数(0 关闭);设备收 `keepalive`(手机端静默忽略)、控制端收 `ping` | | `-v` | 关 | 调试日志 | ## 关键行为 - **设备路由**:`device_id`(ANDROID_ID,缺失时退化为来源地址)→ 最近一次 hello 的连接为命令通道;同设备重连自动接管,僵尸连接不再收命令。 - **name 兜底**:转发 `run` / `save` 时若缺 `name` 键,服务端自动补 `null`(手机端缺键会触发被静默吞掉的 NPE)。 - **bytes_command 透传**:控制端 `forward`(JSON,顶层 md5)后紧随一帧 BYTES,服务端按到达顺序原样转发,md5 与字节均不改动。 - **上下线广播**:设备 hello/断开实时广播 `device_event`,控制端接入即收 `device_list` 快照;离线设备在本进程生命周期内保留(`online=false`)。 - **已知限制**:协议无鉴权无 TLS,务必部署在可信网络(VPN / 内网);命令无回执,执行结果依赖脚本层 `pcSocket.send` 上报(见 AutoJs6 `doc/jsonsocket-protocol.md` §3.5)。