Skip to content

终端、文件与剪贴板 ​

除了屏幕控制,LCXL Remote Desk 还组合了 WebRTC 数据通道功能与独立鉴权的远程终端。

通过访问码连接时

通过访问码(设备码或协助码)连接时,终端、文件和剪贴板功能不会自动开放,而是同时受访问码权限上限、被控端全局设置和现场审批约束。

远程终端 ​

内置的 xterm.js 终端通过独立的鉴权 WebSocket 提供完整命令行交互,与 WebRTC 数据通道分离;无需离开浏览器会话即可操作远端终端。

Shell 选择列表中,同一条命令只显示一次,即使 PATH 多次包含相同目录。可执行文件路径或参数不同的命令仍分别保留,因此不同的 Python 安装和虚拟环境仍可单独选择。

连接时终端会显示 LCXL Remote Desk 欢迎字。被控端确认终端会话已经启动后,关闭或刷新页面会触发浏览器的离开确认,因为断开连接会结束该远端 shell 及其中运行的进程。Shell 选择页以及已经关闭的终端不会触发此提示。

终端 AI 助手 侧栏可拖动左边缘调整宽度。用户停留在底部时,对话会自动跟随新的流式文字;向上滚动查看历史后不会再被强制拉回底部,而是显示向下箭头按钮,点击即可返回最新内容。

Assistant 的流式回答与已完成回答都按 GitHub 风格 Markdown 渲染,支持标题、列表、代码和表格;原始 HTML 会被忽略,也不会加载模型提供的图片 URL。

文件管理 ​

直接从浏览器管理远端设备上的文件。

首次打开默认进入远端所选桌面会话用户的主目录(home)。房屋图标“用户主目录”会重新打开该目录;如果无法获取或读取,则回退到 Windows 磁盘列表或其他平台的根目录。旁边的磁盘图标“我的电脑”直接返回根入口;刷新和翻页会保留当前目录。Android、iOS 和 Manager 控制台采用相同行为。

  • 上传文件到远端机器。
  • 下载文件回控制端。
  • 删除文件,并带回收站机制以便可恢复删除。

拖入远程桌面上传 ​

连接 Windows、Linux 或 macOS 被控端后,把普通文件拖到远程画面上松手,即可上传到该桌面会话用户的下载目录。可一次拖入多个文件,按顺序逐个上传;暂不支持文件夹。Android 被控端目前不支持文件传输。

右上角上传面板显示每个文件的状态,以及被控端确认的保存位置。下载目录中的已有文件会保留,新文件自动改名,例如 report (1).txt。收起面板后仍会继续上传,可以同时操作远程桌面。窄窗口或短视口默认收起,展开后列表可滚动。

文件传输使用独立权限。需要审批时,“等待远端允许”会持续到设备所有者作出决定,或被控端配置的审批期限结束。定期等待更新使它区别于连接无响应;连续 30 秒没有响应或进展时,传输会结束。

“等待远端确认”表示文件已发送,仍可能在传输或保存;进入此阶段前可取消。包括空文件在内,上传都在被控端确认保存后才显示成功。如果断开连接或丢失最终确认,请先检查远端目录再决定是否重试:“结果未确认”也可能已经保存了文件。

下载目录所在的文件系统需要支持发布新文件且不替换已有名称。部分网络盘或 FUSE 挂载不支持该操作,上传会明确报错;可以调整下载目录位置,或通过文件管理器向明确路径上传。

上传到选定目录 ​

文件管理器上传到当前选中的远端目录;完整接收并保存后,会替换同名已有文件。两个上传同时写入同一路径时,第二个会被拒绝,避免互相替换结果。Android 和 iOS 控制端也在收到被控端保存确认后才显示成功。

上传期间,目标旁边会出现 .<文件名>.<编号>.part 临时文件;Windows 上的点前缀不代表隐藏。提交前取消或已确定发生在发布前的失败会清理临时文件,并保留已有文件。发布结果未确认时,可能保留临时文件或最终文件供检查。

文件传输不可用时 ​

浏览目录与删除文件走信令连接,而文件字节本身需要 WebRTC 数据通道。两者独立建立,因此浏览器无法通过 WebRTC 连到设备时(最常见的原因是 TURN 中继不可达),文件列表依然能正常浏览:只有上传和下载会被撤下,并由横幅说明原因。

横幅同时给出得出该判断的连接诊断:服务器下发了哪些 ICE 服务器、浏览器收集到了各类型候选各多少个、协商停在了哪一步。列表中存在中继服务器却一个 relay 候选都没有,说明浏览器访问不到该中继,值得转告中继的运维方——面板上的复制按钮生成的正是这份摘要。TURN 凭据永远不包含在其中。

Windows 服务模式被控端上的映射网络驱动器 ​

以 Windows 系统服务运行的被控端,是用提权账户在与桌面用户不同的登录会话中浏览文件的,而 Windows 把映射网络驱动器限定在登录会话内。因此用户在资源管理器里映射的盘符不会出现在驱动器列表中。改用 UNC 路径(\\server\share)访问这些位置,或把 EnableLinkedConnections 设为 1 并重启机器,让两个会话共享映射。

被控端报告自己运行在服务模式时,文件管理器会在驱动器列表页显示上述说明。该状态直接来自被控端,因此通过信令服务器或 Manager 远程浏览时也会正确显示。

剪贴板同步 ​

文本剪贴板的双向同步,让控制端与远端设备之间的复制/粘贴无缝衔接。

系统音频 ​

控制端提出请求且被控端独立的系统音频权限允许后,远端播放才会以 Opus 实时传输到控制端。它与控制端麦克风上行相互独立,本功能不会录制或持久化音频。见远程控制与串流。

终端补全输出额度在“设置 → 终端补全”编辑,默认 512,实际取此值与模型运行时输出额度的较小值。思考预算必须小于实际有效额度;额度不兼容会明确报错。配置写入 config.toml。