Sync desktop with public relay and add verified device connection management
This commit is contained in:
1 parent
87e888af69
commit
51c4f86918
17 files changed
+1289
-118
No files matched your search
+27
-9
@@ -12,11 +12,12 @@ dotnet run --project Ads.Desktop -c Release
|
||||
|
||||
或运行 `desktop/Ads.Desktop/bin/Release/net8.0/Ads.Desktop.exe`。
|
||||
|
||||
1. 在“连接配置”填写中继 WSS 根地址和 **客户端令牌**(不是 agent 令牌)。默认 `wss://ads.ttstd.com`;服务器域名与 TLS 必须已部署完成。
|
||||
2. 设置 ads-client、ADB、scrcpy 的可执行文件路径。开发目录自动查找根目录 `bin/ads-client.exe`;ADB 和 scrcpy 默认使用 PATH。仓库 `adb/`、`scrcpy/` 是源码目录,不能作为可执行文件使用。
|
||||
3. 刷新设备,选择空闲设备并连接。状态每 3 秒从本机 ADB 检查;未取得租约时显示等待状态,详细错误见日志。
|
||||
4. 手机允许调试后,点击“打开手机控制”。scrcpy 使用独立窗口,支持鼠标、键盘操作;可设置分辨率、帧率、音频与只读模式。强制 `--force-adb-forward`,避免反向连接无法穿过中继。
|
||||
5. 关闭窗口默认进入托盘,右键托盘可重新打开或退出。取消托盘选项后关闭窗口会退出。退出会停止本应用启动的 scrcpy、ads-client,并只断开所用 ADB 端点。
|
||||
1. 默认公网中继已同步为 `wss://ttstd.com/ads`,直连服务器为 `175.178.213.60:443`。设备 API 和 Rust 子进程都使用同一套地址、路径前缀和直连设置;TLS 仍按 `ttstd.com` 验证。直连留空时使用正常域名解析,不使用系统 HTTP 代理。
|
||||
2. 自动读取 `ADS_CLIENT_TOKEN` 环境变量,或项目 `config/private/client.env`,也支持应用旁的 `client.env`。也可在“连接配置”导入文件;拒绝仅有 agent 角色令牌的文件。发布包不包含令牌。
|
||||
3. 自动查找 ads-client、ADB 和 scrcpy。Windows 分发包附带 ads-client 和完整 scrcpy 官方运行目录(包含 ADB);也可选择自己的工具路径,并使用“检查工具”。仓库 `adb/`、`scrcpy/` 是源码,不能作为可执行文件使用。
|
||||
4. 自动每 10 秒刷新在线设备,状态每 3 秒从本机 ADB 检查。支持连接、断开、重新连接、读取型号/Android/API 等级、复制本地 ADB 地址。当前占用标记区分“本机正在使用”和其他客户端占用。
|
||||
5. 手机允许调试后,点击“打开手机控制”。scrcpy 使用独立窗口,支持鼠标、键盘操作;可设置分辨率、帧率、音频与只读模式。强制 `--force-adb-forward`,避免反向连接无法穿过中继。
|
||||
6. 关闭窗口默认进入托盘,右键托盘可重新打开、断开连接或退出。取消托盘选项后关闭窗口会退出。退出会停止本应用启动的 scrcpy、ads-client,并只断开所用 ADB 端点;远程守护程序继续运行。
|
||||
|
||||
请从 scrcpy 官方发行包安装程序及配套 server、DLL 等文件,不要只复制 scrcpy.exe。首次调试必须在手机端授权。
|
||||
|
||||
@@ -24,14 +25,31 @@ dotnet run --project Ads.Desktop -c Release
|
||||
|
||||
UI 使用 `/v1/devices` 的 Bearer 认证接口并管理现有 Rust ads-client 子进程,不承担 ADB 数据转发,也未新增本机 HTTP 管理 API。一次管理一个远程连接;断线重连由 ads-client 负责。完全退出 UI 后不保留后台守护进程。连接配置修改在下次连接生效。
|
||||
|
||||
令牌仅保存在内存,通过 `ADS_CLIENT_TOKEN` 子进程环境变量传递,可在启动 UI 前设置该环境变量。配置保存在系统 LocalApplicationData 下 `TTSTD/ADS/settings.json`,不包含令牌。日志最多保留 1000 条,可导出到同目录;不自动落盘。
|
||||
令牌仅保存在内存,通过 `ADS_CLIENT_TOKEN` 子进程环境变量传递,不出现在命令参数、配置或日志中。配置保存在系统 LocalApplicationData 下 `TTSTD/ADS/settings.json`,只记住非敏感连接配置和凭据文件路径。旧的默认子域名配置会自动迁移到当前公网地址,自定义中继地址保持不变。日志最多保留 1000 条,可导出到同目录;不自动落盘。子进程不继承远程 ADB Server 或 agent 角色凭据环境变量。
|
||||
|
||||
托盘需要桌面环境支持;Linux 桌面可能需要 AppIndicator。未在 Linux/macOS 或真实手机上验收此 UI。真实投屏仍需远程 agent 在线、手机 TCP ADB 已开启且本机密钥获得手机授权。
|
||||
托盘需要桌面环境支持;Linux 桌面可能需要 AppIndicator。当前在 Windows 完成构建、Avalonia 离屏布局和真实公网手机连接测试;Linux/macOS 尚未运行验收。设备列表表示网关在线,实际手机就绪状态以本地 ADB 检测为准。一次管理一个远程连接,不提供远程守护重启、SSH 或服务器管理。USB 模拟仍仅为 AGENTS.md 中的后续方案,没有在本次加入。
|
||||
|
||||
## 发布
|
||||
|
||||
```powershell
|
||||
dotnet publish Ads.Desktop -c Release -r win-x64 --self-contained true -o ../bin/desktop-win-x64
|
||||
# 在项目根目录运行
|
||||
.\scripts\build-desktop.ps1
|
||||
.\scripts\start-desktop.ps1
|
||||
```
|
||||
|
||||
将对应平台的 ads-client 放到 PATH,或在设置指定绝对路径,同时安装 ADB 与 scrcpy。
|
||||
产物:`bin/desktop-win-x64/Ads.Desktop.exe`,Windows 自包含包无需另装 .NET。构建脚本会复制已准备好的 `bin/ads-client.exe` 和 `bin/tools/scrcpy/`,不会复制凭据。将整个目录分发,不要只复制 exe。离开项目目录使用时,导入用户自己的 client.env。
|
||||
|
||||
当前随项目准备的 scrcpy 为官方 5.0.1 Windows x64 包,下载 ZIP 的 SHA-256 已对照官方说明验证:`b12a2c4ee8be317422451fc7dcf8ee20a71b5ea7ef9ad73ddd825a25316227a5`。来源:[scrcpy 官方 Windows 说明](https://github.com/Genymobile/scrcpy/blob/master/doc/windows.md)。
|
||||
|
||||
## 验证
|
||||
|
||||
在 `desktop/` 运行:
|
||||
|
||||
```powershell
|
||||
dotnet test Ads.Desktop.Tests -c Debug
|
||||
dotnet run --project Ads.Desktop.Smoke -c Debug
|
||||
# 会连接真实 home-phone,仅在设备空闲且本地具有 client.env 时运行:
|
||||
dotnet run --project Ads.Desktop.Smoke -c Debug -- --live --screen
|
||||
```
|
||||
|
||||
单元测试覆盖路径前缀、源站配置、旧默认地址迁移、角色凭据隔离、不可信证书拒绝、环境变量与保存配置。离屏测试加载真实 XAML,覆盖按钮可用状态、实际设备发现/连接/型号显示/重连/释放、scrcpy 视频纹理启动与停止。示例布局图片写入 `work/`。原生 Windows 自动化运行时本次初始化失败,因此未自动点击真实原生窗口或验证托盘菜单;不是把无头测试当作原生点击验收。
|
||||
Reference in new issue
Block a user