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 冻结。

快速入门

  1. 在计算机上安装插件
    • 在官方 DSH 桌面应用中 → 插件 → 添加 dsh-mobile 并启用,或
    • 在 DSH Web 安装上运行:
    dsh plugin --profile web add dsh-mobile@latest
    dsh plugin --profile web exec dsh-mobile setup
    
  2. 配置连接
    • 在 DSH 中打开 移动访问 并打开 LAN 访问(或启用您选择的远程隧道)。插件将生成私有证书和二维码。
  3. 安装 Android 应用
    • 从发布页面下载 APK(例如 dsh-mobile-android-v0.6.3.apk)。
  4. 配对手机
    • 在应用中选择 LAN 或 远程,扫描二维码(或粘贴 43 字符密钥)。设备现在受信任,并将自动重新连接。
  5. 开始在手机上使用 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;没有推断其他功能。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目