DSH Mobile

August 15, 2026 · View on GitHub

DeepSeek Harness（DSH）的移动端客户端，基于 React Native（Android）。通过 Tailscale 安全访问运行在桌面端的 DSH，在手机上完成对话、工作区管理、工具审批、任意文件上传/下载等操作，并在对话中途切换 Agent 模式。

配套的桌面端增强（会话中途切换模式按钮）见 desktop-plugin/；Windows 上的 Git Bash 版极简模式预设见 presets/minimal-bash/。

功能亮点

  • 🔄 对话中更换模式：默认以「极简模式」开始，对话进行到任意时刻（首次回复结束后）都能切换成标准/代码/创造等其它预设——手机端侧边栏「切换模式」、桌面端会话头部「切换模式」按钮，两条路共用同一后端能力。
  • 🐧 Git Bash 版极简模式：Windows 上不用装 WSL，也能让极简模式跑在 Git Bash(MSYS2) 上；手机端默认优先选它。
  • 📜 会话历史与桌面端完全同步：上滑可一路翻到第一条（分页 + 主机端 compact 瘦身，一页从 MB 级降到 KB 级）。
  • 💭 思维链输出：助手回复可展开查看完整推理过程（历史与流式都支持）。
  • 🛠 工具调用卡片 + 审批弹窗（允许/拒绝）
  • 📎 任意文件上传到宿主机 / 下载到手机（文件桥），🖼 图片附件下载
  • ⏹ 停止当前对话、📊 Token 实时显示（输入/输出/缓存命中）
  • ⚙️ 设置：服务器地址、Agent 预设、模型选择（本地持久化）

架构

手机（RN App）
   │  HTTP POST /api/*  +  两条纯下行 WebSocket（events.mux / events.host）
   ▼
转发器 poc/forwarder.mjs（监听 Tailscale IP，如 100.x.x.x:8787）
   │  转发到 127.0.0.1:3080，Host 重写为 loopback 以通过 DSH trust-fence
   │  └─ 附带文件桥：POST /files 上传、GET /files?path= 下载
   ▼
DSH web（127.0.0.1:3080，桌面端 dsh web）

DSH 的 /api 是类型化 RPC（HTTP 上行 + 两条纯下行 WebSocket），协议细节见 poc/protocol.md，公网安全接入方案见 poc/P2-public-access.md。

目录结构

App.tsx、src/dsh/             RN 应用（DSH 协议客户端 client.ts + 类型 types.ts）
android/、ios/                原生工程
build-android.cmd             Windows 一键构建脚本（自动定位 JDK17 + Android SDK）
poc/                          转发器 forwarder.mjs、协议参考、协议探针
desktop-plugin/dsh-mode-switcher/  桌面端「会话中途切换模式」插件（可选安装）
presets/minimal-bash/         Git Bash 版极简模式预设（复制到 DSH 预设目录即可用）
.github/workflows/            GitHub Actions 自动构建 release

安装部署

0. 前置条件

  • 桌面端：Node.js ≥ 22、DSH 已安装并配置好模型（dsh web 可跑起来）
  • Windows 桌面端：已安装 Git for Windows（提供 Git Bash）
  • 桌面与手机都安装 Tailscale 并登录同一账号
  • 构建 APK：JDK 17 + Android SDK（推荐 Android Studio）

1. 桌面端运行 DSH

dsh web            # 绑定 127.0.0.1:3080

2. 创建 Git Bash 版极简模式（可选，但手机端默认会优先选它）

DSH 官方预设（standard/code/minimal/cordis）只读，需复制一份到用户预设目录再改：

  1. 把本仓库 presets/minimal-bash/ 整个目录复制到
    • Windows：C:\Users\<你>\.dsh\.agent-presets\minimal-bash\
    • Linux/macOS：~/.dsh/.agent-presets/minimal-bash/
  2. 若你的 Git Bash 不在 C:\Program Files\Git\bin\bash.exe，改 agent.cordis.yml 里 terminal-bash 的 shellPath。
  3. 重启 DSH，预设列表里会出现「极简模式 (Git Bash)」。

这个预设 = 官方 minimal（固定人设 + bash + str_replace_editor 双工具），只是把 shell 换成 Git Bash。手机端 App.tsx 里的默认预设选择顺序：minimal-bash → minimal → 系统默认。

3. 开启「对话中更换模式」（必需的主机 patch）

DSH 默认只允许在空会话（尚未对话）时切换预设，对话开始后会被 agent-preset-locked 拒绝。要让「对话中切换」生效，需要改一处源码（位于 DSH 安装目录，npm update 后会丢失，需重打）：

文件：<DSH 安装目录>/node_modules/@deepseek-ai/dsh-host-apiproxy/lib/index.js （Windows 常见位置：%APPDATA%\npm\node_modules\@deepseek-ai\dsh\node_modules\@deepseek-ai\dsh-host-apiproxy\lib\index.js）

改动：在 agentPreset.select 的处理器里（搜索 agent-preset-locked 或 sessionBlank），删掉/注释掉 swap 里的这行判断——

if (!sessionBlank(agent.session)) return err(request, { code: "agent-preset-locked", ... });

使 swap 直接执行 presets.recompose(agent.ctx, agentPreset) 并追加 agent-preset/selected 事件。改完重启 DSH。

同文件还有一处可选优化（本仓库手机端已依赖）：给 session.history 加 compact 标志，跳过逐 token 的 assistant/chunk，让历史分页从约 8MB/页降到约 50KB/页。不改也能用，只是分页慢；改了需重启 DSH。

4. （可选）桌面端也加「切换模式」按钮

让电脑浏览器里的 DSH 会话头部也有切换按钮（与手机端共用同一后端能力）：

  1. 把 desktop-plugin/dsh-mode-switcher/ 复制到 $DSH_HOME/profiles/web/node_modules/dsh-mode-switcher/ （Windows：C:\Users\<你>\.dsh\profiles\web\node_modules\dsh-mode-switcher\）

  2. 在 $DSH_HOME/profiles/web/cordis.patch.yml 里插入一行：

    - insert:
    - id: mode-switcher
      name: dsh-mode-switcher

  3. 重启 DSH，刷新浏览器页面即可。

5. 启动转发器

cd poc
node forwarder.mjs
# 默认监听 YOUR_TAILSCALE_IP:8787；用环境变量覆盖：
#   LISTEN_HOST=<你的 Tailscale IP>  LISTEN_PORT=8787  FILE_ROOT=<工作区根目录>

FILE_ROOT 是文件桥可读写的根目录，上传的文件落在 FILE_ROOT/shared-files/。只绑 Tailscale IP，不暴露给局域网/公网。

6. 构建并安装 APK

npm install
build-android.cmd assembleRelease -PreactNativeArchitectures=arm64-v8a
# 产物：android/app/build/outputs/apk/release/app-release.apk

国内 Gradle 下载慢已处理：android/gradle/wrapper/gradle-wrapper.properties 默认用腾讯镜像。

把 APK 传到手机安装；或直接下载 GitHub Release 里的预构建 APK（见下）。

7. 配置

位置说明
App.tsx 的 DEFAULT_BASE_URL转发器地址（Tailscale IP + 端口），也可在 App 内「设置」里改
poc/forwarder.mjs 的 FILE_ROOT文件桥根目录，上传落 shared-files/
明文 HTTP已放行（Tailscale 内自带 WireGuard 端到端加密）

对话中更换模式（说明）

  • 默认极简，随时可换：新会话默认用极简模式（优先 minimal-bash）；首次对话结束、回复完成后，即可在手机端侧边栏或桌面端会话头部点击「切换模式」换成任意预设。
  • 原理：切换走 DSH 既有的 agentPreset.select RPC，调 agentPresets.recompose() 把该会话重新挂到目标预设的常驻组合上，并写入 agent-preset/selected 事件（历史与模型可见性一致）。
  • 前置：必须完成上面「步骤 3」的主机 patch，否则对话开始后切换会被拒绝。

Git Bash 版极简模式（说明）

  • 解决 Windows 上没有 WSL 时极简模式的持久化 shell 不可用的问题：用 Git Bash(MSYS2) 作为 bash 后端。
  • 与官方 minimal 完全等价的能力（固定人设、bash、str_replace_editor），仅 shellPath/shellArgs 不同。
  • 手机端 App.tsx 默认预设选择顺序优先 minimal-bash，因此装上即自动用上。

文件桥（任意文件上传/下载）

DSH 原生附件域只支持图片，任意文件走旁路「文件桥」：

  • 上传：输入框 📎（黑色回形针）选任意文件 → 传到宿主机 shared-files/ → 路径自动填入输入框 → 发送后 agent 即可读取
  • 下载：聊天里点击 D:\... 路径，或侧边栏「下载宿主机文件」手动输入路径
  • 实现：poc/forwarder.mjs 的 POST /files / GET /files?path=（限制在工作区内，文件名穿越清洗，单文件上限 100MB）

GitHub Actions 自动构建 release

.github/workflows/build-release.yml 在推送 v* 标签时自动构建 arm64-v8a release APK 并创建 GitHub Release 附带 APK；也可在 Actions 页面手动触发（workflow_dispatch）。

发布一个新版本：

git tag v1.4.0
git push origin v1.4.0

版本历史

见 CHANGELOG.md。

已知限制

  • DSH 原生附件域仅支持图片（png/jpeg/webp/gif）；任意文件走文件桥（旁路，不参与 DSH 附件/导出体系）
  • 明文 HTTP（Tailscale 内已有 WireGuard 端到端加密，但应用层无 TLS；正式化应加 wss:// + 认证）
  • 当前按 arm64-v8a 单架构打包，老机型需改 -PreactNativeArchitectures
  • 桌面能力（host.openPath、host.pickDirectory native）在手机不可用
  • 「对话中切换模式」与「compact 历史」两处主机 patch 位于 DSH 的 node_modules 内，npm update dsh 后需重新打

协议

poc/protocol.md 是从 DSH 源码提取的 /api wire 协议完整参考；poc/spike-client.mjs 是非浏览器客户端最小探针（describe/list/stream/prompt），可用于验证宿主连通性与协议。

License

MIT