DeepSeek Harness手机版

DeepSeek Harness手机版是一款实现手机与电脑端Agent实时协同的远程控制软件。应用通过独立HTTPS移动访问网关与本地电脑安全配对，完整同步工作区、文件修改与事件流。

软件针对触屏深度适配，支持用户随时用手机接管电脑端AI代理会话，提供流畅无缝的移动端远程AI编程与任务排发体验。

DeepSeek Harness手机版能做什么

• 在手机上继续电脑端的工作：同一份会话、工作区、消息和工具，实时同步。

• 用对话定制手机端：在 DSH 对话里提出布局、交互或功能需求；文件修改完成后，手机页面通常会自动刷新。

• 专属触屏布局：会话抽屉、工具详情、设置、提问卡片和输入栏都按手机重新组织；App 跟随系统语言（简/英/意），插件界面跟随 DSH 语言。

• 种远程通道：Tailscale、cpolar、cloudflared 快速/命名隧道、自建 FRP、自有反向代理，按网络任选。

• 配对与多设备：扫码、链接或密钥配对一次；切换 Wi-Fi、热点或 IP 后通常自动恢复；App 在一个列表中显示局域网和远程配对的电脑，定期检测可达状态，并支持切换、重新配对或删除本地记录。

• 一键诊断与放行：检查版本、网关、网卡、防火墙和远程通道，生成脱敏报告；被拦截的第三方插件连接按确切路径一键放行。

• 任务系统通知：任务完成与待输入以 Android 系统通知提醒，可在 App 内的 DSH“通用设置”中开启，锁屏文本脱敏。

• 纵深安全：局域网固定私有 CA，公开远程入口使用受信任 HTTPS；自签 FRP 入口由 App 固定远程 CA。凭据存 Keystore，设备令牌只发往精确 Origin，第三方 WS 默认拦截。

配对设备可以操作电脑上的 DSH，应视为完全受信任的设备。局域网只在可信网络开启；远程访问应使用可靠的 HTTPS 通道。手机丢失时，请立即从电脑端撤销设备。

DeepSeek Harness移动端连接教程

局域网和远程访问是两套相互独立的连接：在电脑附近优先使用局域网，延迟最低；离开当前网络时再启用远程访问。电脑端分别管理开关与配对授权；Android App 将所有已配对电脑集中显示在设备列表中。

局域网访问

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

1.让手机和电脑连接同一个局域网，在 DeepSeek Harness 左下角打开 移动访问 → 局域网。

2.如果尚未开启，点击 开启局域网访问；随后点击 生成并复制密钥，面板会显示配对二维码。

3.在 Android App 中进入 局域网访问，扫描发现电脑并点击设备，再扫描二维码或粘贴配对密钥。

4.配对完成后会建立持久设备信任。以后打开 App 会自动发现并连接，切换 Wi-Fi、热点或 DHCP 地址通常不需要重新配对。

端口说明：dsh web --port 修改 DSH Web 上游端口（默认 3080），插件会自动跟随；dsh-mobile setup --port 修改 Mobile HTTPS 监听端口（默认 3443），配对二维码会包含实际端口。

无图形界面的 Linux 主机，或通过局域网 IP / 反向代理打开 DSH Web 时，左下角 移动访问 管理口同样可用。管理 API 仍要求 TCP 对端是本机回环（例如本机 socat / 反向代理连到 127.0.0.1），不会把插件自己暴露到公网；浏览器 Host 可以是 localhost、RFC1918 或 IPv4 链路本地地址，公网 IP 和任意域名仍会返回 403。反向代理必须只对可信的本机或内网请求开放，不能把 /api/mobile-access 管理路径公开转发到互联网。手机走的独立 HTTPS 入口（默认 3443）仍是移动端界面，不会变成桌面管理口。

不安装 App 也可以访问：点击 复制配对链接，在手机浏览器中打开。局域网使用私有证书，浏览器首次访问可能提示不受信任；只在确认这是自己的 DSH 网关后按浏览器指引继续。公开证书的远程入口不应出现证书警告，若出现请检查通道和证书，不要直接忽略。

手机浏览器中的配对和重新连接页面会按浏览器的 Accept-Language 显示简体中文、英文或意大利文；Android App 则跟随系统语言。DSH 内的插件控制面板继续跟随 DSH 当前语言。

远程访问

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

远程服务可能受带宽和连接限额影响：cpolar 免费方案 当前为 1 Mbps，Tailscale Funnel 也存在不可配置的带宽限制，cloudflared 的 quick tunnel 由 Cloudflare 免费提供、地址随机且有限流。DSH Mobile 使用静态资源 gzip、WebSocket 长连接和顶部按需加载改善体验；会话的历史窗口与分页大小由 DSH 决定，插件无法提高服务商限额。

页面能打开但一直“重连中”，应先区分 WebSocket 升级失败、慢速数据同步和心跳超时，操作见慢链路与反复重连指南。0.5.4 还提供按确切路径启用的 WebSocket 压缩，默认关闭；长会话或计量网络可按指南尝试，并对比实际传输量。

1.在 DeepSeek Harness 左下角打开 移动访问 → 远程，选择一种连接方式：

• Tailscale Funnel：点击 启用远程访问，在打开的官方页面完成一次 Tailscale 登录；按面板提示继续允许 Funnel，然后返回 DSH 等待连接就绪。

• cpolar：点击 安装官方组件，登录 cpolar 控制台取得 Authtoken，粘贴后点击 保存并连接。组件只会在确认后下载到插件私有目录；免费临时地址可能在 DSH 或 cpolar 重启后变化。

• 自建 FRP（高级）：已有 VPS 时，展开 自建连接，填写 frps 信息和公开 HTTPS 域名或真实公网 IPv4。可以复制受限的 frps + Caddy 模板手动部署，也可以在 Ubuntu/Debian + systemd 上用 SSH 密钥一键部署；不支持密码登录，也不会覆盖非 DSH Mobile 管理的 Caddy 配置。部署或清理前须到 VPS 控制台核对主机指纹。本机 frpc 按需下载校验，VPS 需单独清理。需要 Android App 0.3.3 或更新版本；证书、端口和操作步骤见 自建 FRP 使用指南。

• 自有反向代理：展开 自建连接 → 自有反向代理，填写公网 HTTPS 地址（支持自定义端口）、私有监听 IPv4、独立 HTTP 后端端口（默认 3444）和代理来源 CIDR，再点击 保存并启动后端。适合已有 Lucky/Nginx/Caddy 的用户，无需隧道组件；需要 Android App 0.4.0 或更高版本。详见 自有反向代理指南。

• cloudflared 快速隧道：点击 安装官方组件，插件在确认后从官方发布页下载固定版本到插件私有目录，随后自动申请一个临时公网地址（quick tunnel），无需注册或登录。适合不想注册账号的用户；quick tunnel 地址每次重连都会变化，官方定位为测试用途、有限流且无可用性保证，请勿用于必须长期可达的生产访问，只适合临时或验证场景。

• cloudflared 命名隧道：已有 Cloudflare 账号和域名时，把隧道类型切到 命名隧道，填入连接器令牌、公网域名与本机转发端口，即可获得重启后不变的固定地址（令牌只存私有目录、只经环境变量传给 cloudflared）。步骤见 Cloudflare 命名隧道。

2.状态变为“远程访问已就绪”后，点击 生成远程配对二维码。自有反向代理仅显示“后端已监听”：它不验证公网连通性，仍需检查代理 HTTPS、证书与 WebSocket 并用手机验收。

3.在 Android App 中进入 远程访问，扫描二维码完成独立配对。

4.此后 App 会保存当前地址和设备凭据并自动重连。若 cpolar 免费临时地址发生变化，请扫描电脑端当前远程二维码重新验证连接；无需清除 App 数据。旧设备 token 只会发送到原先保存的精确 Origin，不会发送给二维码中的新域名。

远程通知说明：浏览器的 Notification 权限按 Origin 分别授权，网页系统通知只显示在运行该网页的设备上。Android App 的任务提醒是独立的 0.4.0 功能，需要在 App 内 DSH 的 设置 → 通用设置 中主动开启，且依赖 WebView 页面仍存活；它不是通用的后台推送。需要可靠的后台推送时，请使用你已配置的服务端 webhook 或机器人通道。

Tailscale Funnel 覆盖范围广，但在国内网络下可能不稳定。其运行组件把公开监听生命周期绑定到父进程和受限控制通道；父进程退出、控制通道关闭或显式停止时会结束当前代次并清理资源。cpolar 更适合国内网络；自建 FRP 适合已有 VPS、希望避开公共服务带宽限制的用户。cloudflared 有两种模式：快速隧道不需要账号或登录，但地址随机、每次重连都会变化，官方定位为测试用途且无可用性保证，因此只适合临时或验证场景；命名隧道使用 Cloudflare 账号令牌，能保留重启后不变的固定公网域名。国内 VPS 上的未备案域名可能被云厂商拦截，此时可使用公网 IPv4 模式。插件会校验按需下载的固定版本组件；本机托管的配置与程序保存在 $DSH_HOME/mobile-access/，可在面板中清理。VPS 侧的文件须按自建连接指南单独清理。

自建 FRP 的托管部署使用指向 DSH 回环网关的 HTTP vhost：VPS 上的明文 vhost 只允许回环访问，由 Caddy 提供公网 HTTPS。0.4.6 新增“接入既有 frps”，不会安装或改动服务器；公开 CA 档仍需受限 HTTP vhost 与 Caddy，自签档则用 frps TCP 透传至电脑端 HTTPS 网关，须由 Android App 在配对时固定 CA。自签档目前面向公网 IPv4，旧版 App 不支持；两档都不开放任意 FRP 配置。frps 的 proxyBindAddr 是全局代理监听设置，不能只为新增 TCP 入口调整而忽略已有明文 vhost。接入指南。

自有反向代理的 HTTP 后端只允许留在可信私网；不要把它映射到公网，也不要绕过它直连 DSH 或现有 LAN 3443。来源 CIDR 匹配代理的直接 TCP 来源，不信任转发头；反代须保留外部 Host（含端口）、Origin、Cookie 和 WebSocket。清除代理配置不会删除已配对远程设备。

远程公开地址仍受 DSH 设备配对保护。内置 Funnel 与托管 cpolar、cloudflared 支持 Windows x64 与 Linux x64/arm64；cloudflared 还支持 macOS x64/arm64 按需安装。FRP 0.70.1 支持 Windows、Linux、macOS 的 x64 与 arm64。各通道的系统支持矩阵见兼容性。

DeepSeek Harness移动端扩展与自定义指南

在 DSH 对话里输入 /mobile <需求>，当前会话的 agent 会处理定制请求；文件修改完成后，手机端通常会在几秒内刷新。例如：

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

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

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

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

扩展清单及其脚本、样式和资源按版本标识刷新。插件监听到 /mobile 或扩展文件变化后，会通过已认证连接通知手机立即更新；页面可见时每 45 秒、隐藏时每 5 分钟的检查只作为断线兜底。Host 暂存失败会继续使用现有版本；若 Host 已更新但新手机界面激活失败，则关闭该扩展并自动重试，避免混用新旧能力。

扩展动作的 input 可以直接使用 api.schema.object(...) 等 Schemastery schema，也可以使用带 parse(value) 的适配器；手机端 api.host.invoke() 会按 JSON 请求发送，输入会在电脑端动作执行前完成校验和规范化。

你甚至可以通过扩展连接电脑上运行的酒馆，并从同一 App 打开它的简易移动前端。

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

示例的实际效果：

DeepSeek Harness移动端如何管理设备

Android App 用一个“已配对设备”列表同时显示多台电脑：局域网、cpolar、cloudflared、Tailscale Funnel 和自建 FRP 配对共处一处。首次升级会自动迁移旧版局域网与远程凭据，不要求重新配对；地址变化且 instanceId 与原记录一致时会合并条目，保留自定义名称。自签 FRP 使用独立 CA 指纹作为身份，首次与局域网配对时可能显示为另一条记录。设备 Token 和局域网 CA 由 Android Keystore 加密保存；0.4.6 App 还会加密保存自签 FRP 入口固定的远程 CA。这些信息不会显示在设备列表或二维码中。

每条记录显示自定义名称、连接方式、Origin、定期更新的可达状态和最近连接时间。绿色状态点表示“可达”，灰色状态点表示“检测中”“暂不可达”“配对已过期”或“电脑端已移除”；可达性检查直接验证 DSH Gateway，不依赖 ICMP，也不会把暂时断网误判成电脑端撤销。

• 启动时打开 → 直接进入 DSH（默认）：单设备直接连接；多设备优先连接上次使用的设备，其次按最近连接时间选择仍有效的设备。连接超过有限重试预算后自动回到列表，不会无限转圈。

• 启动时打开 → 显示设备列表：每次启动先选择电脑，适合经常在多台设备之间切换。该选项位于列表右上角的设置按钮中，修改后立即保存。

• 点按设备行可连接；右侧“…”和长按提供相同的操作面板，可编辑名称、立即检测、重新配对或删除本地记录。删除前会二次确认，并提供短暂撤销；撤销只恢复本机记录，不恢复电脑端已经撤销的授权。

• 在 WebView 页面打开 DSH 设置 → 通用设置，选择 切换电脑 可回到已配对设备列表；该动作仅在 Android App 中显示。在线收到电脑端撤销通知后，App 保留该条目并显示“电脑端已移除”，停止自动重连，同时提供 重新配对 和 删除本地记录。

电脑端撤销会永久删除持久化存储中的设备记录及令牌摘要，而不是保留 revokedAt 标记；启动时也会清理旧版留下的已撤销记录。删除后，旧令牌与未知令牌一样返回 401 authentication_failed。现有 App 若在离线期间被撤销，再次检测时可能显示“配对已过期”，需要重新配对；在线会话仍会收到撤销通知并立即断开。

设备管理列表：查看已配对电脑、连接方式和可达状态

启动行为设置：选择直接进入 DSH 或显示设备列表

故障排查

• 配对成功后仍反复提示重新配对或续期 401：同一域名上的其他服务或旧 Cookie 可能干扰认证。更新至最新插件及 App，再从当前移动访问入口重试；浏览器重新扫描当前二维码可更新本插件的认证 Cookie，无需清除所有网站数据。若仍失败，查看失败请求与脱敏日志，其他认证或代理错误也可能返回 401。

• 内测声明无法确认或设置无法保存：先在电脑端直接打开 DSH 的本机地址，查看终端日志或浏览器 Network 中失败的设置请求。连接诊断不检查设置写入；保留现有配置及 settings.yaml.imported，按具体错误排查。相同界面提示可能有不同原因，见 DSH #860。

• 设置请求返回 HTTP 403：先检查 DSH 的 Host/Origin 信任校验及代理响应。检查 iframe、代理和浏览器扩展是否改变请求来源，使用本机直接访问验证；保持信任检查启用。

• 错误包含 profile reload requires the root Include entry：该错误发生在 DSH 重载 profile 时。Issue #132 报告过加载两份 dsh-app-boot 导致此错误，但单凭提示不能确认原因。核对实际运行的 DSH 命令与当前 profile 的版本和安装路径，保留配置并按 DSH 官方文档修复依赖；仍失败时将版本、模块路径及脱敏后的完整错误提交上游。

• 设置错误包含 EACCES、EPERM 或锁文件操作失败：检查报错文件的权限及启动环境注入的文件操作工具。锁清理失败也可能发生在写入之后，先核对实际保存结果。

• 手机出现另一插件的“输入配对码”页面：dsh-remote-web-ui 与 DSH Mobile 各有独立的远程通道和配对码，不能交叉使用。若电脑端连接诊断提示“第三方远程插件”，先关闭该插件的远程访问并刷新，再扫描 DSH Mobile 当前二维码。仅安装该插件而未启用它的远程接管，不会触发这条诊断。

• 远程诊断显示“电脑经代理可访问”：诊断先直连，失败后才尝试 DSH 进程环境变量中的 HTTP 代理；NO_PROXY 可排除目标。此结果只说明电脑经代理完成 HTTPS 探测，不代表手机或实际隧道可用。请用手机流量实际连接；若直连和代理都失败，报告仍为不可达，不会把离线误报为就绪。

• 切换网络后局域网访问不可用：如果日志提示 saved LAN interface "XXX" is not connected，表示保存的网卡当前未连接。DSH 会继续运行，移动访问暂时休眠，原网卡恢复后会自动重试；若已改用新网卡，请重新完成局域网配置或重跑 setup。暂时不用移动访问时，可以在 cordis.patch.yml 中禁用 mobile-access。

更新日志

v0.5.5版本

屏幕宽度不超过 720px 时，未编辑的输入栏保留可滚动的 72px 草稿预览，为会话留出更多空间；编辑区或工具栏获得焦点后恢复展开。文字、引用和附件保留，发送、排队、引导与停止按钮的触摸区域至少为 44px。提交和输入法行为继续由既有 DSH 与 App 机制处理。

模型搜索框与配对页的输入字号已补齐，Android 返回键可逐级退出模型菜单。App 旋转和调整窗口大小时保留当前页面、引用与未发送图片，已收到的“电脑端已移除”状态不会被后续检测覆盖。请同步更新插件与 App；App 进程终止后，未发送附件仍可能丢失。