移动端远程控制台SimonMedy/DSH-Mobile

DSH Mobile

一个专注的、非官方社区移动客户端，用于官方 DeepSeek Harness Web UI。

DSH Mobile 不会在你的手机上运行 Harness。它会连接到用户自行运营的远程 DeepSeek Harness 实例，并在一个经过加固、隔离的移动端 WebView 外壳中显示官方 Web UI。

快速开始：连接到 DeepSeek Harness

1. 启动你的 DeepSeek Harness 服务器

在你的机器或远程工作站上：

Start the official DSH Web UI (listens on 127.0.0.1:3080)
Pass --trusted-host with your Tailscale hostname/IP to allow remote API calls
npx @deepseek-ai/dsh web --trusted-host my-pc.tailnet.ts.net --trusted-host 100.x.y.z

2. 将其安全地暴露给你的移动设备

按照设计，DeepSeek Harness 绑定到 127.0.0.1，以防止未经身份验证的远程代码执行。要从手机安全访问它，请使用 Tailscale（推荐）或经过身份验证的反向代理：

Option A — Automatic HTTPS (recommended):
tailscale serve --https=443 127.0.0.1:3080

Option B — Direct HTTP over private Tailnet IP:
tailscale serve --tcp=3080 tcp://127.0.0.1:3080

3. 从 DSH Mobile 连接

1. 在你的设备上打开 DSH Mobile（下载最新 APK）。
2. 点击 + Add server。
3. 填写你的服务器详细信息：
- 使用选项 A（HTTPS）： 协议 HTTPS，主机 my-pc.tailnet.ts.net，端口 443
- 使用选项 B（HTTP）： 协议 HTTP，主机 100.x.y.z（你的 Tailscale IPv4），端口 3080
4. 点击 Test Connection 以验证可达性，然后点击 Save。

[!NOTE]
API 密钥与工作区：出于网络安全考虑，上游 DeepSeek Harness 有意将主机设置、API 密钥配置以及原生文件夹选择器对话框（PRIVILEGED_METHODS）限制为仅 localhost（127.0.0.1）可访问。请在你的主机上一次性设置好模型 API 密钥并选择你的工作区。

架构

Remote Machine / VPS
DeepSeek Harness (dsh web)
│
│ Secure connection (LAN, Tailscale, or HTTPS reverse-proxy)
▼
DSH Mobile Client
React Native Server Manager & Shell
│
▼
react-native-webview
│
▼
官方 DeepSeek Harness Web UI

- 无 Harness 分支： 基于原版上游 DeepSeek Harness 运行。
- 零本地开销： 所有 AI 模型、代理、shell 和工作区工具均在你的主机上运行。
- 隔离导航： 同源策略将内部链接保留在应用内，并将外部链接路由至系统浏览器。

功能特性

- 多服务器管理： 保存并整理多个命名服务器实例（家庭、工作、云 VPS）。
- DeepSeek 设计对齐： 量身定制的深色/浅色主题、DeepSeek 胶囊按钮系统，以及宇宙氛围光晕。
- Android 自适应图标： 原生圆角方形/圆形启动器图标，支持 Material You 单色模式。
- 实时健康检查： 实时连接状态胶囊、延迟反馈，以及最近连接历史记录。
- 启动偏好设置： 直接打开默认服务器或服务器列表。
- 安全与隐私： 仅本地、无凭据的持久化存储，未保存编辑保护，以及对未加密公共 HTTP 端点的明确确认。
- 离线恢复： 内置重连与错误处理，不会暴露原始浏览器崩溃界面。

已知限制

- 上游主机设置与 API 密钥： DeepSeek Harness 有意将设置变更（settings.、credentials.）锁定为仅限 localhost（127.0.0.1），因为它目前尚不具备用户身份验证功能。请在你的主机上一次性配置模型提供商的 API 密钥。
- 原生文件夹选择器： “选择工作区”按钮会在物理 PC 上触发原生主机操作系统文件资源管理器（host.pickDirectory）。请先在主机上选择或打开你的项目工作区（或在你的工作区目录中启动 dsh web）；随后它便会出现在你的移动端工作区选择器中。
- 上游 Web 布局： DSH Mobile 展示的是官方上游 Web UI。Harness Web 前端中针对桌面端的布局元素仍由上游管理。

开发

快速开始（Docker / Make — 推荐）

无需在你的主机上手动安装 Android SDK 或 Java：

运行完整的测试与质量检查套件
make check      # 或：docker compose run --rm check

构建独立的 Android Release APK（保存至 ./dist/dsh-mobile.apk）
make build      # 或：docker compose run --rm build-apk

启动 Metro 开发服务器
make dev        # 或：docker compose up dev

本地工具链

前置条件：Node.js 24.19.0 及 npm 11.17.0，外加标准的 Android Studio / Xcode SDK。

npm install
npm run deps:verify
npm run native:bootstrap:android
npm run android

在 macOS 上构建 iOS：

bundle install
cd ios && bundle exec pod install && cd ..
npm run ios

质量检查：

npm run check

上游与免责声明

- 官方 DeepSeek Harness： https://deepseek.com/harness/en/
- 上游仓库： https://github.com/deepseek-ai/deepseek-harness
_DeepSeek Harness 是由 DeepSeek AI 创建的独立项目。DSH Mobile 是非官方社区客户端，与 DeepSeek 无关联，也未获得其认可。_

安全

在将 Harness 实例远程暴露之前，请阅读 SECURITY.md。DSH 会在你的主机上提供完整的开发者级智能体与工具执行能力；切勿将未经身份验证的原始 DSH 端口暴露到公共互联网。

许可证

MIT。DeepSeek Harness 仍受其自身上游许可证的约束。