Skip to content

远程视图

远程视图让你从仪表板直接查看受支持 IDE 会话的屏幕并与之交互。

云端是面向互联网远程访问的主要路径。在自托管上,同样的视图只能通过你的本地/局域网仪表板路径工作。

打开远程视图

  1. 从仪表板或某台机器的 Workspace 标签页打开一个 IDE 会话。
  2. 为该会话打开 Remote
  3. ADHDev 打开远程界面,并为该 IDE 会话启动截图流。

查看模式

分屏视图

在桌面端,标准远程界面以分屏对话框打开,一侧是聊天,另一侧是 IDE 屏幕。

仅远程视图

当你想让屏幕占据整个工作区时,可以把同一个对话框切换到仅远程模式。

预览界面

一些布局还会在你打开完整远程对话框之前显示一个更小的截图预览。

交互

当远程视图激活时,你可以控制 IDE 会话:

操作桌面移动
单击鼠标单击点按
右键单击鼠标右键长按
双击双击双击
输入物理键盘屏幕键盘
滚动鼠标滚轮 / 触控板双指滑动
缩放捏合缩放

视觉反馈

每次单击都会在单击位置显示涟漪效果,让你知道单击已被记录。

性能

直接连接(STUN)

当 P2P 直接连接(无中继)时,截图快速且响应灵敏:

  • 刷新率自动自适应(屏幕变化时更快,静态时更慢)
  • 质量:高(JPEG 质量 25)

中继连接(TURN)

当 P2P 通过 TURN 中继时(通常在严格 NAT 之后):

  • 刷新率略慢
  • 更低质量(JPEG 质量 12)以减少带宽
  • 对于监控和控制仍完全可用

基于套餐的限制

云账户限制:

套餐套餐下限中继预算
Free5 秒60 分钟/天
Pro2 秒4 小时/天
Team2 秒无限
Enterprise无额外套餐下限无限

INFO

中继预算适用于经 TURN 中继的截图时间。直接 P2P 路径不消耗该云中继预算。

INFO

这些配额是云套餐限制。自托管不使用云截图预算,但它也不提供你网络之外的托管远程访问路径。

故障排除

“CDP not connected” 警告

你的 IDE 需要在启用 CDP 的情况下运行。用以下命令重新启动:

bash
adhdev launch <supported-ide>

黑屏 / 无截图

  • 检查 IDE 是否确实在你的机器上打开并可见
  • 验证 P2P 连接状态
  • 尝试关闭并重新打开远程视图

缓慢或卡顿

  • 检查你是否处于 TURN 中继(在连接信息中显示)
  • 关闭其他大量占用 P2P 的应用程序
  • 尝试 NAT 穿透更好的网络(STUN 直连最快)

会话已打开,但远程控件感觉受限

  • 首先把远程视图视为一种 IDE 工作流,而非全面的远程桌面承诺
  • Cursor 是当前远程视图最强的公开起点
  • 如果 IDE 本身仅部分验证,聊天可能仍然比远程控件工作得更好

后续步骤

托管云端文档在此。开源与自托管文档位于 OSS 仓库。