DSH Tauri 手机远程连接教程：从主机配对到只读任务核对

**当前版本提示（10 月 29 日）：**社区常规版为 v0.25.1，另有 v0.25.2-beta.1 与 nightly-20261028 预发布。下面按日期保留的说明属于历史记录，手机实际包与主机版本分别核对。

v0.24.0 公告介绍社区 DSH Mobile 连接主机的方式。以下是根据公告整理的试用流程，没有完成手机安装或实机配对。

1. 先让主机上的任务可用

记录桌面版本、内核、模型地址和工作目录。在主机创建一个只含公开样例的测试文件夹，先完成一次读取和摘要任务，再增加手机连接这一层。

这能区分主机任务本身的问题与远程连接问题。手机上能看到界面，并不代表模型连接或工具执行一定正常。

2. 从局域网入口配对

在主机右上角打开“远程访问”，按当前界面选择局域网路径，使用配对码或二维码连接。配对信息仅交给预期设备；手机与主机显示的身份和会话应能对应。

先使用当前发布页列出的客户端。iOS 的 TestFlight 是测试分发，未签名 IPA 不能直接安装。具体下载入口、资格和实际资产以发布页为准。

3. 核对执行位置

先请求“读取指定测试文件并总结，不修改文件”，核对手机看到的会话、主机工作目录和工具记录。随后才在测试目录尝试创建一个可丢弃文件，回主机确认实际结果。

远程界面、主机文件处理和云模型调用是三个环节。根据实际配置判断数据去向，不能仅凭手机或电脑端界面推断全程离线。

4. 需要公网时再检查隧道

使用公开网络前核对连接入口、身份校验和当前共享范围。本文不提供绕过配对的端口暴露方法。公告中手机 SSH 路径仍属计划，应等待明确实现与文档。

5. 断开和休眠也要核对

结束试用后关闭远程共享，观察旧入口是否仍可连接。主机休眠或应用退出后，回到主机核对任务状态；不要仅因手机断线就断言任务停止或完成。

10 月 20 日：连接与旧 WebView 问题分别看

社区新 Nightly 提到较旧 WebView 的布局和会话可用性修复，但它仍属于开发构建，不能据此宣布所有手机已兼容。常规发行记录仍为 v0.24.5。

先区分页面打不开、布局异常、会话无法使用和工具授权失败。保存系统与浏览器或 WebView 版本、主机版本及脱敏复现信息，再决定是否验证指定构建。具体步骤见旧 WebView 排查教程。

10 月 22 日：手填地址入口属于新 Nightly

nightly-20261020 新增扫码页手填地址入口，Android 平板旋转、iPadOS 窗口与宽屏侧栏也有调整。这些是开发构建中的记录，不应直接套用到常规 v0.24.5。

手填地址不代替配对与授权。仍按主机可达、连接身份、会话显示、模型和工具调用逐层确认；远程访问也不能被默认当成本机回环。具体改动见新 Nightly 报道。

10 月 23 日：使用 v0.25.0 核对配对与布局

v0.25.0 已列出扫码页手填地址，以及没有 ?auth= 的链接可正常使用配对表单的修复。仍应确认主机、连接身份和会话范围，不能据链接形式判断无需授权。

Android 平板旋转、宽屏侧栏折叠、iOS 键盘与 iPad 窗口问题也在常规版修复列表。先测会话显示，再测只读任务及主机输出。后续 nightly-20261022 的韩语语言与区域检测是单独构建条目，不归入本版本。

10 月 25 日：窄屏却显示桌面布局时记录输入条件

nightly-20261024（191206f，北京时间 25 日 04:11）移除移动检测中的 hover 条件。维护者在 PR #1232 记录了窄屏触控设备的判断冲突，但没有据此证明所有设备或 WebView 均兼容。

连接身份核对通过后，再记录屏幕尺寸、浏览器 / WebView 及外接鼠标等输入条件，比较布局和会话。当前常规版仍为 v0.25.0；新修复属于开发构建，不能通过修改配对或授权来解决渲染判断问题。

10 月 26 日：Android 键盘遮挡另查客户端构建

nightly-20261025 列出 Android 输入区键盘高度修复。原生应用与手机浏览器的输入路径要分别记录；桌面标签包含代码不能代替移动包版本核对。先观察键盘开关时的输入区，再核对主机是否收到请求，详见键盘排查步骤。

10 月 27 日：v0.25.1 纳入布局与键盘修复

社区常规版 v0.25.1 已列出移动布局识别与 Android 键盘高度修复。上文 Nightly 记录描述当时状态；现在可先核对对应常规版及实际移动包，再复现连接、输入和发送。

移动分发可能晚于桌面发行，先查实际 APK 或 TestFlight 构建，不用桌面壳版本推断手机端已经更新。

10 月 29 日：连接后另查同步目标与结果

Beta 新增多项同步状态修复。配对后继续核对当前目标、同步项和目标侧结果，切换设备或断线后不要沿用旧反馈。操作记录见远程同步教程。手机实际包与主机版本仍分别记录。