catcatchcatast/dsh-t-remote-android

DSH T-remote — 安卓客户端

DeepSeek Harness 手机端 · 原生会话 · SSH · Tailscale

English · 主机配置 · 构建说明 · 发布下载 · 远程插件

通过原生 Android 界面操作电脑上的 DSH 任务。DSH T-remote 将多主机会话、审批、提问、加密本地历史、真实 SSH 终端和内嵌用户态 Tailscale 连接放在同一个应用中。

这是社区客户端，并非 DeepSeek 官方产品。模型调用和任务执行留在所选电脑，手机使用该主机的 DSH 和已配置供应商。

版本状态：下载前先看

| 对象 | 版本／目标 | 状态 |
| --- | --- | --- |
| 当前源码 | DSH 0.1.5-rc.2 | 预览源码；APK 见 v0.1.5-rc.2-preview |
| v0.1.5-rc.2-preview APK | 1.10.7-135-publication-oss，版本码 11007135 | OSS 调试签名包，仅供预览和测试 |
| 已有 v0.1.2-preview APK | 1.10.7-121-publication-oss，DSH 0.1.2-rc.1 | 旧版 OSS 调试签名预发布包 |
| Android 基线 | Android 8／API 26 及以上 | 各设备实际行为仍需验证 |
| 保留的运行时兼容路径 | 0.1.2-rc.1 | 需搭配对应适配包验证 |
| 其他 DSH 版本 | 包括正式版 0.1.5 | 未声明兼容 |

旧 Release（发布下载区）APK 不是当前 rc.2 源码的构建包。 使用 rc.2 请下载匹配的 v0.1.5-rc.2-preview，或自行构建当前源码。公开调试包名为 com.dsh.t.remote.debug，用于测试；正式签名材料由外部配置提供。

任务留在主机，手机负责交互

- 在手机创建或继续任务，项目文件和模型执行仍在所选电脑。
- 阅读正文、思考和工具摘要，批准待处理动作或回答结构化问题。
- 排队消息、插话或中断运行，无需切换到远程网页。
- 主机离线时查看已有缓存，并用相同主机路由打开真实 SSH 终端。

DSH T-remote 连接与缓存示意

图中展示连接原理，并非实机截图或性能测量。所有标签均为通用名称，不含个人主机、账号、设备或会话。

项目优点

| 设计 | 使用价值 |
| --- | --- |
| 原生 Jetpack Compose 界面 | 会话导航、控件和渲染在手机完成，不依赖远程 WebView（内嵌网页）。 |
| 独立主机身份 | 连接状态、项目、会话、草稿、缓存和终端保持所属主机。 |
| SSH 与内嵌用户态网络 | 经指纹验证的 SSH 直连或 Tailscale 连接；内嵌节点不通过 Android VpnService 接管其他应用流量。 |
| 缓存正文优先 | 先显示本地加密预览，再补齐近期历史并合并网络增量。 |
| 工具详情按需 | 正文和思考正常加载，完整工具参数、输出、差异等点击后读取。 |
| 序号持久化同步 | 重连后补齐已确认缺口；关闭手机客户端本身不停止主机任务。 |

速度取决于设备、缓存准备、历史量、主机与网络条件。上述机制不代表已达到 300ms 首次可读保证。

功能列表

下列能力已在预览源码中实现；主机能力、权限、Android 后台限制和对应远程适配包决定实际可用性。

| 领域 | 功能 |
| --- | --- |
| 主机与连接 | 添加／编辑主机、连接／断开、切换所属主机、确认 SSH 指纹和使用公钥认证；私钥受保护。 |
| 内嵌 Tailscale | 登录用户态 Tailnet（Tailscale 私有网络）节点并为应用连接提供路由，也支持常规 SSH 直连。 |
| 项目与会话 | 按项目／时间浏览、搜索、创建、重命名、分叉、归档；保留主机归属，较新的项目活动和会话靠前。 |
| 会话时间线 | 用户／助手正文、流式输出、思考、Markdown、工具摘要、Goal／Todo（目标／待办）及子代理归属。 |
| 输入与任务控制 | 发送、排队、插话、编辑／删除排队消息、中断及本地草稿恢复。 |
| 审批与提问 | 必要决定上下文自动提供；批准／拒绝、多端交互同步、逐题回答、跳过和自由文本替代。 |
| 模型 | 读取所选主机目录，通过协商后的运行时接口保留会话模型选择。 |
| 工具详情 | 默认折叠，点击读取所选参数／结果／输出／差异页，加密缓存并显式翻页。 |
| 本地缓存与离线 | 加密历史、首屏预览、正文块、草稿和有界详情页；未缓存内容提示不可用，不以空结果冒充成功。 |
| 后台同步 | 每主机一次非归档会话全局事件流、已确认缺口恢复、去重和序号持久化；受后台设置与系统限制。 |
| 通知 | 区分历史追平与实时完成／交互，锁屏脱敏，并跳转到所属会话。 |
| SSH 终端 | 真实 PTY（伪终端）通道、多终端会话及稳定主机／终端身份。 |
| 附件与文件 | 区分草稿与历史附件；传输、续传和校验行为取决于主机声明的支持能力。 |

哪些内容自动加载

聊天正文和思考正文正常加载。工具卡片默认接收工具名、简短操作说明、状态、耗时和错误摘要；完整参数、命令、原始输出和代码差异等点击后加载。审批必要内容例外：为作出决定所需的信息仍自动显示。

已下载的详情页保留在有容量上限的加密缓存中，默认总额 128 MiB；命中的页离线可读。重新进入会话仍默认折叠，不自动下载剩余所有页。

rc.2 这轮更新

- 运行时协商、历史世代和手机流式正文适配。
- 加密分块读写与历史世代读取门闩。
- 草稿持久化移出主线程阻塞路径。
- 合并主机摘要落盘，并延后已追平但末序号未知、曾阻塞同步的冷会话。

当前快照导入的 36 个代码／测试文件已与开发来源核对，保留合成主机夹具脱敏。本轮未从公开快照重新构建或安装；开发验证不替代完整公开发布验收。来源见 SOURCE_SNAPSHOT.md。

安装与连接

先选择匹配组合

使用旧 APK 时，请按 v0.1.2-preview 配套 rc.1 主机适配包，安装前校验 SHA-256（文件内容哈希）。

使用当前 rc.2 源码时，按下文构建，并安装对应的 Remote Hosts 源码包。不要把旧 APK／清单与新源码混合后直接假定兼容。

主机前提与连接流程

1. 准备 Android 8+ 手机、安装 OpenSSH Server 的 Windows 或 Linux 电脑，以及已登录的 DSH。
2. DSH 保持监听主机回环地址。独立核对 SSH 指纹并准备公钥登录。
3. 使用内嵌 Tailnet 时，目标电脑安装 Tailscale，手机内嵌节点登录适当的网络。
4. 在应用生成 Ed25519 密钥，只把公钥安装到主机。
5. 添加主机 SSH 路由和 DSH 端口，先测试终端并确认主机身份。
6. 连接 DSH、选择主机并打开项目／会话；按需启用后台同步，并核对系统后台权限。

详见 主机配置。连接与安全模型：架构、安全说明。

构建与验证

仓库包含完整 Android 源码、Gradle Wrapper（固定版本构建入口）、Go 桥接源码及锁定依赖。需要 JDK 17、构建说明 指定的 SDK／NDK 和 tailscale-bridge/go.mod 声明的 Go 版本。

先通过 tools/prepare-plugin-assets.ps1 准备锁定的旧主机引导归档；它是独立兼容回退，不是 rc.2 主机包集合。然后执行：

Push-Location tailscale-bridge
go test ./...
.\build-aar.ps1
Pop-Location
.\gradlew.bat :app:assembleOssDebug

Gradle 的 preBuild 也会调用桥接构建。上述分层命令便于区分 Go 与应用构建失败。发布版本可通过 Gradle 属性覆盖，不依赖私人开发标签。正式签名通过外部配置提供，签名文件和 local.properties 不进入 Git。

下一次发布与当前限制

- rc.2 OSS 调试预览 APK 与匹配远程包见 v0.1.5-rc.2-preview。
- 核对 APK、全部原生 ABI（处理器架构）、内嵌归档、签名、隐私、NOTICE 和第三方许可。
- 组合兼容检查完成后发布 SHA-256 与来源清单。

全部旧缓存缺页补齐、持续低延迟首屏及所有网络／后台／稳定负载场景尚未声明验收通过。首屏预览不是完整历史，也不推进同步游标。不承诺新增产品功能或发布日期。

仓库导航

| 路径 | 职责 |
| --- | --- |
| app/src/main | Compose 界面、持久化、DSH 协议、同步和终端。 |
| app/src/test、app/src/sharedTest | 合成协议、缓存和界面回归测试。 |
| tailscale-bridge | Go／tsnet 桥接、状态存储和锁定的 Go 依赖。 |
| tools/prepare-plugin-assets.ps1 | 校验并准备独立的旧主机回退包。 |
| docs | 主机配置、架构、安全、构建与第三方许可。 |

支持、隐私和许可证

普通支持：GitHub Issues。私人诊断与安全报告：catcatchcatast@gmail.com。

不要在公开问题或截图中包含令牌、授权 URL、私钥、真实 IP／主机名、序列号、签名资料或会话正文。本地 DSH 缓存和内嵌网络状态加密保存；主机密钥变化须独立核对。

贡献规范 · 安全政策 · 支持渠道 · 发布要求

项目自有代码使用 Apache-2.0。ConnectBot 和其他第三方组件保留原版权和许可：LICENSE、NOTICE、第三方许可证。

配套项目：DSH Remote Hosts 远程插件。检索关键词：DSH 安卓客户端、DSH 手机端、多主机客户端、DeepSeek Harness Android client、mobile client、SSH、Tailscale。