ds-harness-remote:通过 P2P 加密通道远程访问本地 DSH 工作区

前言

DeepSeek Harness(DSH)习惯在固定工作机上跑:工作区、工具链和会话都留在本机。人离开工位时,常见做法是 SSH、内网穿透或自建网关,往往要公网 IP、开端口,或把控制面放到第三方,延迟和运维成本都不低。

下面介绍社区客户端插件 ds-harness-remote(维护者 liguobao)。它在 DSH 插件机制上提供远程访问:主机侧 Harness 继续运行,Web、PC 或移动端通过低延迟、端到端加密的 P2P 通道连入同一套界面与工作区,也可经 ACP 触及 Codex、Cursor、Claude Code 等原生工作区。

这是什么

ds-harness-remote 是发布在 npm 上的 DSH 插件包,当前文档固定版本为 0.6.4,许可证 MIT。项目描述为:基于 WebRTC/P2P、端到端加密的远程访问方案,让 Web 与移动客户端访问本机上的 DeepSeek Harness、CodeX、Claude Code、Pi 等工作区。

默认协调与 Web 入口使用项目托管服务 https://dsh.r2049.cn;也可按仓库说明自建 minimal Server(含 WebRTC 协调与加密 Relay,完整 Remote Web 体验以托管站为准)。

社区目录页:https://www.skillhub.cn/plugins/liguobao/ds-harness-remote。源码与说明:https://github.com/liguobao/ds-harness-remote。

核心功能

以下能力均来自项目 README 与 package.json 说明。

  1. 多客户端连同一 Host:Harness 留在工作电脑上;可从 Web、另一台 PC 的 DSH、Android/iOS(iOS 为 TestFlight Beta)等连接。多客户端可同时在线,RPC 与流按连接隔离。
  2. 网络与隐私:Host 侧无需公网监听端口或公网 IP;优先 P2P,配合全球 TURN 与中继 Server Relay 回退,双向通道端到端加密。
  3. 与本地 DSH 一致的操作面:远程侧使用原生 Harness 界面(非单独桌面会话 UI),可创建工作区、配置模型、切换对话模型;侧栏支持工作区文件、只读预览、远程终端、经授权的本地开发服务预览。
  4. Remote Tool 上下文注入:支持 Host/工作区发现、Harness 会话创建与管理、历史读取、等待执行、中断请求、经授权的文件传输等(详见仓库 packages/plugin/README.md 中 Remote Agent Tools)。
  5. 多工具工作区:除 DSH 外,经 ACP 集成可访问 Codex、Cursor、Google Antigravity、Pi、OpenCode、Claude Code、Harness Agent 等,含远程文件浏览与终端。
  6. Android 扩展:原生 Android 客户端支持多工作区并行会话;Bot mode 由 Fei2411/DS-Bot 提供。另可配合 ccch1mneyyy/dsh-go 在手机上本地跑 DSH 或反向遥控电脑。

支持的客户端形态(摘录):

客户端 形态 状态
DSH Desktop 插件 Remote 侧栏 已支持
Web 浏览器 已支持,打开 https://dsh.r2049.cn
Android 原生应用 已支持,从 GitHub Releases 安装 APK
DSH Go 第三方 Android 客户端 已支持,内置本协议
iOS 原生应用 Beta(见仓库 issue #20)
Chrome 扩展 入口 仅做 Web 授权换取设备凭证、列 Host、打开同源 Remote Web,不提供对话 UI
Linux 云主机 一键装 Host 已支持,在官网登录后获取安装授权码

安装与启用

DeepSeek Harness Desktop

在 DSH Desktop 中打开 Extensions / Plugin management,选择从 npm 安装,填写:

ds-harness-remote@0.6.4

安装后重启 Desktop。若使用官方 dsh 启动器,也可在桌面 profile 下执行:

dsh plugin --profile desktop add -w ds-harness-remote@0.6.4

DSH 0.2.2+ 在插件管理中支持 npm 包的版本校验与更新;热更新失败时会尝试回退上一版本。若此前从 GitHub 或本地 link 安装,需先改为 npm 安装路径,详见仓库 docs/installation.md 中 online updates 一节。

Linux 一键安装 Host

访问 https://dsh.r2049.cn 登录账号,获取安装授权码后按站点指引一条命令完成 Host 侧安装。

Android 原生客户端

从 GitHub Releases(latest) 下载 APK,使用与插件相同的账号体系登录后即可看到在线 Host。

自建协调服务(可选)

需要完全自管控制面时,参考仓库 apps/server/README.md 的 minimal Server(Docker 自托管)。当前版本包含 WebRTC LAN/P2P/TURN 协调(TURN 需自行部署 coturn)与加密 Relay Server,但不等同托管站上的完整 Remote Web 产品形态。

典型用法

按 README Quick start,首次打通远程的大致顺序如下。

  1. 在本机 DSH 侧栏打开 Remote。
  2. 选择知乎、GitHub、Google 授权,或使用账号密码登录。注册账号需要邀请码,可向仓库作者邮件申请。
  3. 在另一台设备上:同样在 DSH 中安装 ds-harness-remote@0.6.4 并按步骤 1–2 登录;或直接使用 Remote Web、iOS/Android/DSH Go,无需在该设备装桌面插件。
  4. 在客户端列表中选择在线 Host,再选已有工作区或浏览远程目录打开。

默认情况下,Remote 使用项目托管 Server https://dsh.r2049.cn。在另一台电脑上选中 Host 打开工作区后,界面为原生 Harness,页头会显示当前 Host 与加密连接状态。

适用场景与注意

适合谁:需要在通勤、出差或第二台设备上延续同一 Harness 会话与工具配置的开发者;Host 留在内网、又不想在工位机上长期暴露公网端口的场景;希望在手机/Web 上查看远程终端、文件与授权预览的用户。

权限与安全:插件作为 DSH 进程的一部分运行,具备与当前 DSH 用户相当的本地能力(文件、终端、经授权的服务预览与传输)。安装前应阅读源码、MIT 许可证及 packages/plugin 中 Remote Tools 的授权边界,再决定是否在生产工作区启用。

账号与邀请:托管 Web 注册依赖邀请码;自建 Server 可减轻对默认托管的依赖,但需自行维护 TURN/Relay 与证书等组件。

客户端差异:Chrome 扩展仅协助设备凭证与跳转,不能独立承载对话;iOS 仍为 TestFlight Beta;文档标明 dsh-TUI 集成计划在后续版本,当前安装器不会为其自动创建 Web 服务。

结尾

ds-harness-remote 把「Harness 只在本机」和「人在哪都能连上」放在同一套原生 UI 里:插件装在 Host 的 DSH Desktop,客户端用 Web、移动应用或另一台 DSH 即可选 Host、进工作区。版本以 ds-harness-remote@0.6.4 为准,安装与更新请走 npm 或 dsh plugin --profile desktop add -w 官方写法。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye