Add initial Avalonia desktop device workbench

This commit is contained in:
tongtong committed 2026-11-12 14:42:42 +08:00
1 parent 3fb894c1a1
commit 87e888af69
12 files changed
+221

No files matched your search

+37
View File
@@ -0,0 +1,37 @@
# ADS 桌面客户端
C# / .NET 8 + Avalonia 11 + CommunityToolkit.Mvvm,Windows、Linux、macOS 共用代码。本次在 Windows 构建与启动验证。
## 启动
在 `desktop` 目录运行:
```powershell
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 端点。
请从 scrcpy 官方发行包安装程序及配套 server、DLL 等文件,不要只复制 scrcpy.exe。首次调试必须在手机端授权。
## 边界
UI 使用 `/v1/devices` 的 Bearer 认证接口并管理现有 Rust ads-client 子进程,不承担 ADB 数据转发,也未新增本机 HTTP 管理 API。一次管理一个远程连接;断线重连由 ads-client 负责。完全退出 UI 后不保留后台守护进程。连接配置修改在下次连接生效。
令牌仅保存在内存,通过 `ADS_CLIENT_TOKEN` 子进程环境变量传递,可在启动 UI 前设置该环境变量。配置保存在系统 LocalApplicationData 下 `TTSTD/ADS/settings.json`,不包含令牌。日志最多保留 1000 条,可导出到同目录;不自动落盘。
托盘需要桌面环境支持;Linux 桌面可能需要 AppIndicator。未在 Linux/macOS 或真实手机上验收此 UI。真实投屏仍需远程 agent 在线、手机 TCP ADB 已开启且本机密钥获得手机授权。
## 发布
```powershell
dotnet publish Ads.Desktop -c Release -r win-x64 --self-contained true -o ../bin/desktop-win-x64
```
将对应平台的 ads-client 放到 PATH,或在设置指定绝对路径,同时安装 ADB 与 scrcpy。