Skip to content

fix: 修复 DSH Remote 配对与连接恢复 - #206

Merged
IGNGserver merged 1 commit into
mainfrom
agent/dsh-remote-reliability
Nov 16, 2026
Merged

IGNGserver merged 1 commit into
mainfrom
agent/dsh-remote-reliability

Conversation

@IGNGserver

@IGNGserver IGNGserver commented Nov 15, 2026 •

Copy link
Copy Markdown
Owner

问题与修复

DSH Remote 的扫码配对、身份续期、远端撤权和实时会话在断线、重复操作或多设备并存时可能出现状态不一致;设备管理页也可能跳到其他中枢、将旧在线状态当成实时状态,或隐藏部分失败。

  • 保存可恢复的加密配对事务,区分普通账号、受限扫码身份及每台设备的恢复方式;整理多中枢选择、空列表、部分失败、在线状态与退出/移除提示。
  • 逐身份合并主机目录并保留不完整结果;授权撤销先持久化再清理本地身份,后台重试并保护共享身份与其他设备;保留用户的暂停设置。
  • 将中继连接按认证、主机连接、数据通道和安全握手分阶段限时,修正失败分类、生命周期和并发资源清理。
  • 保证会话流缺口、审批提交结果未知和异步压缩操作可恢复,避免丢数据或静默重复提交;修正首页刷新完成时序。
  • 先更新设备模型文档,再调整设备管理流程与连接状态;补充协议、故障和并发回归测试。

影响范围

Android 应用及其共享 Kotlin Remote/DSH 代码;不修改服务器、官网或发布流程。旧身份记录保留兼容读取;未完成的配对和压缩记录使用现有设备加密存储。

验证

  • 本地 scratch(/Users/lvziw/.build/Lagoon/dsh-remote-reliability/source)离线运行 :app:testDebugUnitTest,筛选下列 22 个测试类,182 项通过:RemotePairingRecoveryTest、RemoteDevicePairingTest、RemoteAccountManagerTest、RemoteAccountScopeRegressionTest、RemoteServerApiTest、RemoteTextAndUrlTest、RemoteCatalogTest、RemoteHubLifecycleRegressionTest、RemoteDeletionAndRevocationTest、RemoteSignOutLifecycleTest、RemoteCompactionTrackerTest、RemoteDeviceStoreTest、RemoteRelayTest、RemoteSessionFailureLifecycleTest、RemoteConnectionRegistryTest、RemoteGatewayTest、RemotePhase4ProtocolTest、DshRemoteRecoveryRegressionTest、DshRemoteCompactionRoutingTest、OverviewReconciliationTest、InformationArchitectureRegressionTest、ConnectionParentControllerTest。
  • git diff --cached --check:通过;gitleaks protect --staged --redact=100 --no-banner --no-color:未发现凭据。
  • 将测试用固定密钥改为运行时生成后,再次执行 BUILD_SCRATCH_ROOT=/Users/lvziw/.build GRADLE_USER_HOME=/Users/lvziw/.build/gradle-home ANDROID_HOME=/Users/lvziw/Android/Sdk ./gradlew --offline --no-daemon :app:testDebugUnitTest --tests '*RemotePairingRecoveryTest':通过。
  • 后续账号状态并发保护:BUILD_SCRATCH_ROOT=/Users/lvziw/.build GRADLE_USER_HOME=/Users/lvziw/.build/gradle-home ANDROID_HOME=/Users/lvziw/Android/Sdk ./gradlew --offline --no-daemon :app:testDebugUnitTest --tests '*AndroidRemoteCatalogIntegrityTest' --tests '*RemoteAccountManagerTest' --tests '*RemoteAccountScopeRegressionTest' --tests '*RemoteHubLifecycleRegressionTest' --tests '*RemoteSignOutLifecycleTest':通过;追加并发用例后单独重跑 --tests '*RemoteAccountScopeRegressionTest':通过。
  • 首次完整 CI 在 1821 项中发现 4 项失败;已修复取消传播、上游测试数据格式及工作区缓存失效后读取时机,并在 scratch 运行 BUILD_SCRATCH_ROOT=/Users/lvziw/.build GRADLE_USER_HOME=/Users/lvziw/.build/gradle-home ANDROID_HOME=/Users/lvziw/Android/Sdk ./gradlew --offline --no-daemon :app:testDebugUnitTest --tests '*CancellationSafetyTest' --tests '*DshJobsRegressionTest' --tests '*DshWorkspaceManagementTest' --tests '*DshRemoteRecoveryRegressionTest' --tests '*OverviewReconciliationTest':通过。追加工作区并发用例后单独重跑 --tests '*DshWorkspaceManagementTest' --tests '*OverviewReconciliationTest':通过。发现失败时取消了仍使用旧代码的第二次 CI,最新提交将重新运行完整 CI。
  • 整合主分支前的提交通过 CI「构建与测试」:固定上游 Host 连接器检查,以及 ANDROID_HOME="$ANDROID_SDK_ROOT" ./gradlew :app:testDebugUnitTest :app:assembleDebug 均通过;Gradle 用时 7 分 17 秒,job 用时 7 分 35 秒。

定向测试的实际命令:

BUILD_SCRATCH_ROOT=/Users/lvziw/.build GRADLE_USER_HOME=/Users/lvziw/.build/gradle-home ANDROID_HOME=/Users/lvziw/Android/Sdk ./gradlew --offline --no-daemon :app:testDebugUnitTest --tests '*RemotePairingRecoveryTest' --tests '*RemoteDevicePairingTest' --tests '*RemoteAccountManagerTest' --tests '*RemoteAccountScopeRegressionTest' --tests '*RemoteServerApiTest' --tests '*RemoteTextAndUrlTest' --tests '*RemoteCatalogTest' --tests '*RemoteHubLifecycleRegressionTest' --tests '*RemoteDeletionAndRevocationTest' --tests '*RemoteSignOutLifecycleTest' --tests '*RemoteCompactionTrackerTest' --tests '*RemoteDeviceStoreTest' --tests '*RemoteRelayTest' --tests '*RemoteSessionFailureLifecycleTest' --tests '*RemoteConnectionRegistryTest' --tests '*RemoteGatewayTest' --tests '*RemotePhase4ProtocolTest' --tests '*DshRemoteRecoveryRegressionTest' --tests '*DshRemoteCompactionRoutingTest' --tests '*OverviewReconciliationTest' --tests '*InformationArchitectureRegressionTest' --tests '*ConnectionParentControllerTest'

整合 SSH 修改后的验证

主分支合入 SSH 设备修复后,重新整合了设备发现、页面路由、DSH HTTP 与审批恢复,保留两边的并发和错误处理;补充了审批回复期间再次投递的回归用例。

  • 本机 scratch 执行以下 Android 定向测试,16 个测试类、192 项全部通过:
BUILD_SCRATCH_ROOT=/Users/lvziw/.build GRADLE_USER_HOME=/Users/lvziw/.build/gradle-home ANDROID_HOME=/Users/lvziw/Android/Sdk ./gradlew --offline --no-daemon :app:testDebugUnitTest --tests '*DshRemoteRecoveryRegressionTest' --tests '*DshApiTest' --tests '*DshWorkspaceManagementTest' --tests '*CancellationSafetyTest' --tests '*RemoteHubLifecycleRegressionTest' --tests '*RemoteAccountScopeRegressionTest' --tests '*RemoteAccountManagerTest' --tests '*SshDeviceDiscoveryTest' --tests '*SshHarnessDiscoveryTest' --tests '*SshHarnessRoutingTest' --tests '*SshSourceLifecycleTest' --tests '*DeviceProjectionTest' --tests '*InformationArchitectureRegressionTest' --tests '*SessionNavigationTest' --tests '*ConnectionParentControllerTest'
  • git diff --check origin/main..HEAD 与 gitleaks git --log-opts 'origin/main..HEAD' --redact=100 --no-banner --no-color:通过,未发现凭据。
  • 按旧工作区说明尝试 ./gradlew --offline --no-daemon :hub:test,Gradle 报 project 'hub' not found:当前仓库已退役并删除该模块,见 docs/HUB_EOL.md 与当前 AGENTS.md;现行仓库校验为 Android 单测和 Debug 构建。
  • 整合后的提交 3c6fa9f 通过 CI「构建与测试」:上游 Host 连接器、./gradlew :app:testDebugUnitTest :app:assembleDebug 均通过;Android 步骤用时 7 分 05 秒,job 用时 7 分 28 秒。

已知限制

本机没有已连接 Android 设备或可用模拟器,未实机验证摄像头扫码、生命周期恢复及远端设备操作。远端授权撤销可能因设备离线而延后;界面会展示待处理状态并在可用时重试。

@IGNGserver
IGNGserver force-pushed the agent/dsh-remote-reliability branch from bcc8d36 to 3c6fa9f Compare November 16, 2026 09:50
@IGNGserver
IGNGserver merged commit ed6d075 into main Nov 16, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant