saya-ch/dsh-mobile
DeepSeek Harness 的 Android App 与安全远程访问插件,支持局域网/远程连接和高度自定义的移动界面与扩展能力。
什么是 DSH Mobile?
DSH Mobile 是 DeepSeek Harness (DSH) 的插件——这是 DeepSeek 的开源聊天助手平台。该插件添加了一个 移动访问层,因此您可以在主 DSH 服务器在计算机上继续运行的同时,从 Android 手机(或手机浏览器)继续相同的 DSH 会话、工作区和聊天。
- 该插件在计算机端运行,并创建一个提供移动优化 UI 的小型 HTTPS 网关(默认 3443)。
- Android 应用(一个轻量级的 Kotlin WebView 包装器)或手机浏览器通过 LAN 或 远程隧道(Tailscale Funnel、cpolar、Cloudflare Tunnel、自托管 FRP 或自定义反向代理)连接到该网关。
- 配对只需通过二维码或 43 字符密钥进行一次;手机将凭据存储在 Android Keystore 中,并且可以自动重新连接。
主要功能
| 功能 | 作用 |
|---|---|
| 无缝会话同步 | 移动 UI 显示与桌面 DSH 实例完全相同的聊天历史、工作区和工具。 |
| 触控友好布局 | UI 组件(侧边栏、工具详细信息、输入栏等)针对小屏幕重新排列;应用遵循系统语言。 |
| 多隧道选项 | 选择 LAN、Tailscale Funnel、cpolar、Cloudflare(快速或命名隧道)、自托管 FRP 或您自己的 HTTPS 反向代理。 |
| 设备配对与管理 | 扫描二维码或粘贴密钥;应用列出所有配对的计算机,显示可达性,并允许您重新配对或删除条目。 |
| 一键诊断 | 检查版本、网络接口、防火墙、隧道状态并生成脱敏报告;可以自动允许被阻止的第三方 WebSocket 路径。 |
| 系统通知 | 任务完成和需要输入的通知作为 Android 通知显示(可选,可在锁屏上遮盖)。 |
| 安全优先设计 | LAN 网关使用私有 CA;远程网关使用可信的公共证书。凭据保存在 Android Keystore 中,仅发送到确切的来源。 |
| 扩展系统 | 通过 /mobile <request> 命令,您可以要求 DSH 代理修改 mobile.css、mobile.js 或添加在计算机端运行的 JavaScript 扩展(host.mjs)。更改会立即推送到手机。 |
| 工作线程模式(可选) | 扩展可以在非阻塞工作线程中运行,以避免 UI 冻结。 |
快速入门
- 在计算机上安装插件
- 在官方 DSH 桌面应用中 → 插件 → 添加
dsh-mobile并启用,或 - 在 DSH Web 安装上运行:
dsh plugin --profile web add dsh-mobile@latest dsh plugin --profile web exec dsh-mobile setup - 在官方 DSH 桌面应用中 → 插件 → 添加
- 配置连接
- 在 DSH 中打开 移动访问 并打开 LAN 访问(或启用您选择的远程隧道)。插件将生成私有证书和二维码。
- 安装 Android 应用
- 从发布页面下载 APK(例如
dsh-mobile-android-v0.6.3.apk)。
- 从发布页面下载 APK(例如
- 配对手机
- 在应用中选择 LAN 或 远程,扫描二维码(或粘贴 43 字符密钥)。设备现在受信任,并将自动重新连接。
- 开始在手机上使用 DSH
- 应用显示相同的聊天工作区。您也可以在任意移动浏览器中打开相同的 URL。
扩展/自定义移动 UI
- 在任意 DSH 对话中发送消息:
/mobile 把手机端做成老式终端的样子,让消息像终端输出一样逐行滚动 - DSH 代理将请求的更改写入
$DSH_HOME/mobile-access/(CSS/JS 文件或新的extensions/文件夹)。插件监视这些文件,并在几秒钟内将更新推送到手机。 - 对于更复杂的逻辑,您可以添加一个带有
host.mjs文件的 JavaScript 扩展,该文件以与用户相同的权限在计算机上运行。 - 可选的 工作线程 模式(按扩展启用)在单独的线程中运行代码,以保持 UI 响应。
安全注意事项
- LAN 模式应仅在可信的家庭/办公室网络中使用;网关不会暴露到互联网。
- 远程隧道使用公共 CA(cloudflare、Tailscale)或应用固定的私有 CA 的 HTTPS。隧道二进制文件(cloudflared、cpolar、frpc)从官方发布下载,并通过 SHA-256 验证。
- 配对的手机对 DSH 实例拥有完全控制权——请将其视为受信任的设备。如果手机丢失,请立即在计算机端撤销。
- 所有写操作(设置、扩展)都会根据配对的会话令牌和受 CSRF 保护的来源进行检查。
谁可以受益?
- 本地运行 DeepSeek Harness 并希望在离开办公桌时拥有响应式 UI 的开发人员或高级用户。
- 需要在不运行单独 DSH 服务器的情况下在手机上快速查看同一聊天工作区的团队。
- 需要移动访问且希望获得基于云 AI 聊天应用的安全自托管替代方案的任何人。
以上所有信息均直接取自存储库的 README;没有推断其他功能。
相关
- 项目
- 项目
- 项目
- 项目
- 项目