saya-ch/dsh-mobile 预览 preview

saya-ch/dsh-mobile

DeepSeek Harness移动端适配与安全局域网访问插件,支持Android App和手机浏览器。

项目介绍Project Overview

DSH Mobile 是 DeepSeek Harness 插件,让手机浏览器或 Android App 在受保护的局域网内连接电脑,同步会话、工作区、消息与工具,并通过 /mobile 命令用对话定制手机端布局与功能。原生 App 仅支持 Android;iOS 仍为本地实验。配对设备拥有电脑端完全控制权,建议仅在可信家庭、办公局域网或可信 VPN 中使用,避免公网转发。

DSH Mobile is a DeepSeek Harness plugin that lets a phone browser or Android app connect to a host PC over a protected LAN, syncing sessions, workspaces, messages, and tools, and lets users reshape the mobile UI via the /mobile chat command. The native app currently supports Android only; iOS remains an experimental local build. Paired devices gain full host control, so it should be used only on trusted home, office, or VPN networks, never exposed publicly.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add dshmarket

saya-ch/dsh-mobile 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

用手机使用电脑中的 DeepSeek Harness

DSH Mobile

在手机上安全、实时地使用电脑中的 DeepSeek Harness。

npm 版本 CI Android 10+ Apache-2.0 Awesome DSH Plugin

能做什么 · 快速开始 · 连接教程 · 扩展与自定义 · 更新记录 · English

DSH Mobile 0.2.1 是 DeepSeek Harness 社区插件,适配 DeepSeek Harness 0.1.1 系列(已验证 0.1.1-rc.2);原生 App 仅支持 Android。

0.2.1 更新:桌面“移动访问”面板新增 Android App 下载入口。

从 0.1.3 或更早 App 升级时需卸载旧版并重新配对一次;旧版 App 仍可使用 0.2.1 的局域网功能。

下载 Android App 0.2.1 · 版本说明与校验文件

DSH Mobile 是一个 DeepSeek Harness 插件,让手机浏览器或 Android App 通过局域网,或可选的 Tailscale Funnel、cpolar 远程通道连接电脑,继续使用同一份会话、工作区、消息和工具。局域网与远程访问分别启停、分别管理设备,且都不修改 DeepSeek Harness 源码。

移动访问使用独立的 HTTPS 与证书固定,只有配对过的设备能通过校验接入。

它还能在 DSH 对话里用 /mobile <需求> 定制手机端。

能做什么

  • 在手机上继续电脑端的工作:同一份会话、工作区、消息和工具,实时同步。
  • 用对话定制手机端:直接在 DSH 对话里改手机页面的布局、交互和功能,几秒内刷新。
  • 专属触屏布局:会话抽屉、工具详情、设置、提问卡片和输入栏都按手机重新组织。
  • 自动发现、无需重新配对:切换 Wi-Fi、热点或 IP 后通常自动恢复。
  • 三种配对方式:扫码、配对链接、密钥。

配对设备被视为完全信任,可以操作电脑上的 DSH;建议只在可信的家庭、办公局域网或可信 VPN 中使用。

快速开始

已经安装 dsh 命令:

dsh plugin --profile web add dsh-mobile@latest
dsh plugin --profile web exec dsh-mobile setup
dsh --profile web

直接使用 DeepSeek Harness 源码:

corepack enable; pnpm install
pnpm dsh plugin --profile web add dsh-mobile@latest
pnpm dsh plugin --profile web exec dsh-mobile setup
pnpm dsh --profile web

也可以通过插件市场安装(可选):

dsh plugin --profile web add dshmarket

重启 DSH 后,在 设置 → 插件市场 里搜索 dsh-mobile,一键安装即可。

setup 会自动选择并记住当前局域网,切换 Wi-Fi、热点或 IP 后通常自动恢复;仅在自动选择失败时使用 --address 192.168.x.x。设置、证书、设备和自定义文件保存在 $DSH_HOME/mobile-access/

安装并启动 DSH 后,按照下一节选择局域网或远程连接。

连接教程

局域网和远程访问是两套相互独立的连接:在电脑附近优先使用局域网,延迟最低;离开当前网络时再启用远程访问。两边分别管理开关、设备和登录状态,互不影响。

局域网访问

适合同一 Wi-Fi、以太网或手机热点,是默认且最简单的连接方式。

DSH Mobile 局域网访问、配对二维码与设备管理

  1. 让手机和电脑连接同一个局域网,在 DeepSeek Harness 左下角打开 移动访问 → 局域网
  2. 如果尚未开启,点击 开启局域网访问;随后点击 生成并复制密钥,面板会显示配对二维码。
  3. 在 Android App 中进入 局域网访问,扫描发现电脑并点击设备,再扫描二维码或粘贴配对密钥。
  4. 配对完成后会建立持久设备信任。以后打开 App 会自动发现并连接,切换 Wi-Fi、热点或 DHCP 地址通常不需要重新配对。

不安装 App 也可以访问:点击 复制配对链接,在手机浏览器中打开;首次访问需要按浏览器提示手动信任插件证书。

远程访问

适合手机离开电脑所在网络后使用。远程访问默认关闭,手机不需要另外安装 Tailscale 或 cpolar。

远程服务可能受带宽和连接限额影响:cpolar 免费方案 当前为 1 Mbps,Tailscale Funnel 也存在不可配置的带宽限制。DSH Mobile 通过 10 条分页、顶部按需加载、gzip 和 WebSocket 长连接减少流量与等待,但无法突破服务商限额。

DSH Mobile 远程访问与通道选择

  1. 在 DeepSeek Harness 左下角打开 移动访问 → 远程,选择一种连接方式:
    • Tailscale Funnel:点击 启用远程访问,在打开的官方页面完成一次 Tailscale 登录;按面板提示继续允许 Funnel,然后返回 DSH 等待连接就绪。
    • cpolar:点击 安装官方组件,登录 cpolar 控制台取得 Authtoken,粘贴后点击 保存并连接。组件只会在确认后下载到插件私有目录。
  2. 状态变为“远程访问已就绪”后,点击 生成远程配对二维码
  3. 在 Android App 中进入 远程访问,扫描二维码完成独立配对。
  4. 此后 App 会保存设备信任并自动重连;不使用时可以关闭远程访问,局域网连接不会受影响。

Tailscale Funnel 覆盖范围广,但在中国大陆网络下可能不稳定。cpolar 更适合国内网络;插件会校验下载组件的固定版本,配置与程序均保存在 $DSH_HOME/mobile-access/,可随时在面板中彻底清除。

远程公开地址仍受 DSH 设备配对保护。当前托管的远程组件支持 Windows x64。

扩展与自定义

在 DSH 对话里输入 /mobile <需求>,DSH 会直接修改手机端的文件,几秒内生效。例如:

/mobile 把手机端做成老式终端的样子,让消息像终端输出一样逐行滚动

也可以让手机端调用电脑端的能力,比如实时读取电脑状态:

/mobile 为手机端添加赛博朋克风格的电脑监控面板,实时显示电脑的 CPU、内存和磁盘占用

/mobile 把需求交给 DSH 对话中的 agent,由它直接修改本机 $DSH_HOME/mobile-access/ 下的文件,保存后手机端自动生效。改动分两类:界面和交互在 mobile.css/mobile.js;需要电脑能力时用 extensions/ 下的扩展,其 host.mjs 以本机用户权限在电脑上运行。不修改 DeepSeek Harness 源码。

你甚至可以通过扩展连接电脑上运行的酒馆(

host.mjs 与本机程序拥有相同权限;仅创建和运行你理解并信任的电脑端扩展。

示例的实际效果:

/mobile 定制为老式终端界面 /mobile 定制为老式终端界面 /mobile 定制为赛博朋克监控面板 /mobile 定制为赛博朋克监控面板

App 与手机浏览器

方式 适合场景 说明
Android App 日常使用 首屏分开显示局域网与远程入口;局域网自动发现,远程使用系统信任的 HTTPS 通道
手机浏览器 临时或跨平台访问 打开“移动访问”卡片显示的 HTTPS 地址;首次连接需在浏览器手动信任该证书

Android App 只是 Kotlin WebView 薄壳,不内置另一份网页;手机浏览器访问的是同一页面。需要排查兼容性时,可在浏览器地址后追加 ?frontend=stock,临时回到旧的桌面页面适配模式。

工作原理

flowchart LR
  Phone["Android App / 手机浏览器"] -->|"局域网 HTTPS"| Lan["局域网网关"]
  Phone -->|"远程 HTTPS"| Remote["独立远程网关"]
  Lan --> Gateway["DSH Mobile Gateway Core"]
  Remote --> Gateway
  Gateway -->|"回环代理"| DSH["原生 DSH Web 与 Host"]
  DSH -->|"同一工作区、会话和事件流"| Phone

插件包含三层:Host face 负责发现、配对、HTTPS、回环代理和扩展注册表;Client face 提供独立的移动布局与扩展 SDK;Android App 提供受限的原生 Bridge。DeepSeek Harness 的源码和 3080 桌面页面都不会被修改,安装和卸载完全通过插件机制完成。

安全

  • 局域网监听只用于可信家庭、办公网络或可信热点;不要自行做端口转发。
  • 远程地址可从公网到达,但未配对请求无法进入 DSH;不使用时应关闭远程开关。
  • cpolar 仅在用户确认后下载固定官方版本并校验大小和 SHA-256;不会安装系统服务、写入 PATH 或设置开机启动,插件清理会删除其托管文件。
  • 配对设备拥有控制电脑端 DeepSeek Harness 的能力,应视为完全可信设备;丢失手机后应在电脑端撤销设备。
  • 移动网关开启时才监听局域网;关闭后 DeepSeek Harness 仍正常在电脑本机运行。

完整说明见 SECURITY.md

兼容性

DSH Mobile 已验证的 DeepSeek Harness
0.2.1 0.1.0-rc.50.1.0-rc.60.1.0-rc.70.1.1-rc.2
0.2.0 0.1.0-rc.50.1.0-rc.60.1.0-rc.70.1.1-rc.2
0.1.4 0.1.0-rc.50.1.0-rc.60.1.0-rc.70.1.1-rc.2

插件启动时会检查 DSH Host 版本和移动布局所需的前端依赖,遇到未经验证的版本会直接报错而不是带病启动;CI 也会持续跟踪 DSH 主分支的布局契约。升级 DSH 后如遇兼容提示,请先升级 DSH Mobile。

卸载

dsh plugin --profile web remove dsh-mobile

同时清除插件数据:

dsh plugin --profile web exec dsh-mobile purge --yes
dsh plugin --profile web remove dsh-mobile

源码模式把上述 dsh 换成 pnpm dsh

开发

npm ci
npm run verify

Android 构建见 App 文档

Apache-2.0,详见 LICENSE

上一个 Prev dsh-openpencil 下一个 Next dsh-super-injector