多端远程访问 liguobao/ds-harness-remote

· 文档 · Web · Android · iOS

自部署 · npm ·

一次连接，随时可用。

从手机、电脑、浏览器继续使用你的 DeepSeek Harness 实例。无论使用哪台设备，都可以回到同一个 Harness 会话。

Harness 始终运行在工作电脑上，原有的工作区、工具和项目配置保持不变。DS Harness Remote 只是通往这个工作环境的另一个窗口。

已支持 DeepSeek Harness 桌面版，使用最新版本安装即可：

ds-harness-remote@0.6.2

主要特性

- 从另一台设备（Web、PC、移动端）远程到本地Harness实例：DSH 优先，CodeX、Cursor、Antigravity 一样可用。
- 已支持 DeepSeek Harness 桌面版，安装即可使用。原生界面，不另外维护一套桌面会话 UI。
- 支持新建工作区、模型配置、对话模型切换，远端如本地一样丝滑。
- Harness 主机无需开放公网监听端口，无需公网IP，可以从任意可上网的地方，通过双向端到端加密链路安全连接。
- 优先使用P2P网络，全球多TURN节点中转，极端情况下使用多Server Relay兜底，一切畅通无阻。
- 通过 Harness 原生侧栏提供工作区文件、只读预览、远程终端和已授权本机开发服务预览。
- Remote Tool 上下文注入，支持 发现主机与工作区、创建和管理 Harness 会话、读取历史、等待执行、请求中断及传输获准文件。详情
- 除了支持DeepSeek Harness，同时通过ACP协议支持 Codex、Cursor、Google Antigravity、Pi、OpenCode、Claude Code、Harness Agent等工具的原生工作区，远程文件浏览、终端均可使用。
- Android、iOS、Web、原生DSH 都有对应客户端，全平台可用。
- 多个客户端可以同时连接同一个 Harness Host，RPC 与数据流按连接隔离。

目录

- 一次连接，随时可用
- 主要特性
- 支持的客户端
- 安装
- 快速开始
- 界面截图
- 工作方式
- 实验性 ACP 工作区
- 端到端加密
- 网络与传输
- 安全边界
- 常见问题
- 文档
- 友情链接
- Star History
- 项目声明与商标
- License

支持的客户端

| 客户端 | 形态 | 状态 | 说明 |
| DSH Desktop 插件 | Remote 侧栏 | 已支持 | 装 ds-harness-remote@0.6.2；Host 也可以就是这台电脑 |
| Web | 浏览器页面 | 已支持 | 打开 https://dsh.r2049.cn，复用 Harness 原生界面 |
| Android | 原生 App | 已支持 | 从 Releases 下载 APK，见 Android 说明 |
| DSH Go | C佬精品 | 已支持 | 详情见：ccch1mneyyy/dsh-go: DeepSeek Harness 的 Android 客户端。手机上直接跑，也能遥控你电脑上的 DSH。
| iOS | TestFlight 内测 | 内测 | 未公开上架，入口见 issue #20 |
| 浏览器扩展 | Chrome | 仅入口 | 读取已登录 Web 的授权换取独立设备凭据、列出在线 Host、打开同源 Remote Web，不承载会话界面 |
| dsh-TUI | 纯终端 CLI | 已支持 | 可作 Host，见 dsh-TUI Remote 使用指南；安装脚本不会为它自动创建 Web 服务 |
| Linux | 云服务器 | 已支持 | 官网登录后可一条命令全程无操作安装，无需任何配置。

多个客户端可以同时连接同一个 Host，RPC 与数据流按连接隔离。

安装

支持 DeepSeek Harness 桌面版

在 DeepSeek Harness Desktop 的 扩展 / 插件管理 中，选择从 npm 安装，输入包名和版本：

ds-harness-remote@0.6.2

安装后重启 Desktop。也可使用它的官方 dsh 启动器安装固定版本： dsh plugin --profile desktop add -w ds-harness-remote@0.6.2。

Linux 一键安装

见官网首页https://dsh.r2049.cn，登陆后获取一键安装授权码安装即可。

dsh-TUI Host

将 dsh-TUI 作为终端 Host 的配置，请参阅 dsh-TUI Remote 使用指南。

原生Android 客户端

支持同时使用多工作区连接对话，同时创造性加入了 「Bot 模式」（ Power by Fei2411/DS-Bot）

从 GitHub Releases 下载最新 APK，登录同一账号即可看到主机。

DSH Go - DeepSeek Harness 装进口袋：手机本机运行，也能遥控你的电脑。

ccch1mneyyy/dsh-go：已内置 ds-harness-remote 协议，既可以在手机本机运行 DeepSeek Harness，也可以远程连接电脑。

在手机端DSH Go安装 ds-harness-remote 插件后，电脑端、Web端一样可以远程到手机上的DSH，丝滑使用Mobile Use.

iOS 客户端

- 内测招募

快速开始

1. 从 DeepSeek Harness 侧边栏打开 Remote 入口。
2. 按需选择登录方式：「知乎」、「Github」、[Google ] 授权登录均已支持，账号密码登录（使用邀请码注册，可邮件本仓库作者申请）
3. 在另一台设备上使用 DeepSeek Harness安装同样插件，根据1、2完成同样方式的登录。也可以按需使用Remote Web、iOS、Android、DSH Go等客户端，即开即用，无需安装任何插件。
4. 选择在线 Host，再选择已有 Workspace 或浏览远端目录后打开。

默认使用本项目提供的https://dsh.r2049.cn托管 Remote Server。

自建托管Server可使用仓库内的最小 Server，当前版本已包含P2P协调、Relay Server 等功能，暂不支持托管Remote Web的完整功能。

界面截图

桌面端

在另一台电脑上选择在线 Host，然后打开它的 Workspace。Workspace 会在 Harness 原生界面中打开，顶部显示当前 Host 和加密连接状态。

注意：如果想关闭当前电脑远控其他主机功能，可在https://dsh.r2049.cn/ 「主机列表」中，打开「仅被控」开关，开启「仅被控」后当前设备无法看到账号下其他设备，Web端、其他客户端依旧可以远程当前设备。

Android

支持文字/图片 Prompt、模型切换，以及可用工作区的文件和终端。

界面默认跟随系统，支持英文、简体中文、日语、繁体中文、西语、德语、法语；语言设置点击「More ...」可展开全部语言。详细使用见 Android 说明。

移动端设置提供默认关闭的全局「会话精简模式」，下次打开会话生效。

支持该能力的 Host 缩减历史工具详情，保留正文和工具状态，关闭此设置后重新打开会话可加载完整历史。

工作方式

DSH Desktop / Remote Web / Android
↔ 已认证的端到端加密通道 Host 上的 Remote 插件 ↔ 支持的 Harness 能力或可选 Codex 工作区支持 Harness 会话/Workspace 或 Codex 项目

Harness 主机无需开放公网监听端口。只要能够访问互联网，就可以从任意地方连接，ds-harness-remote 通过双向端到端加密链路通信。

它将客户端切换到所选 Host 的 Harness 原生 API，因此原有 Workspace、工具和权限流程都保留在该电脑上。

Host 当前注册的全部设置分区也可以通过 Harness 官方设置 API 在远端配置，大部分插件配置均已得到完整支持。

实验性 ACP 工作区

Host 启动本机支持ACP 的Agent，通过ds-harness-remote 通道传递 Prompt、流式回复和审批。所有Agent都使用自身工作区和会话，只做DSH 会话翻译转换，不写入 Harness 存储。

当前已支持：

- Codex：通过独立的 App Server 接口接入，使用同一工作区入口。
- Cursor：通过 CLI 的 ACP 接口接入。
- Antigravity（AGY）：将 CLI 的 stream-json 接口适配到 ACP gateway。
- Pi Agent（实验性）：在 Host 安装 @earendil-works/pi-coding-agent 与 pi-acp，配置 Pi 本机模型服务后，Remote 默认自动检测并初始化，ACP 初始化成功才开放工作区；可在 Remote 设置中明确关闭，使用独立 ACP 数据面。工具按 Host 用户权限执行，逐工具确认需要 Pi 扩展，默认不会自动启用。
- OpenCode — 通过 opencode acp 接入，支持工作区发现和历史恢复。Host 启动时检查 CLI 支持的参数，兼容带原生监听器与纯 stdio 的 ACP 构建。Desktop/Android 原生会话归档要求认证 loopback API；不提供该接口的版本会明确报告归档不可用。归档状态由 OpenCode 保存，历史保留；暂不提供恢复归档入口。
- Claude — 使用 Host 本机已授权的 claude-agent-acp，需在 Remote 设置中开启；Desktop/Android 支持工作区、历史、文字消息及审批，暂不开放图片输入与直接 Files/Terminal 访问。
- Hermes — 通过 Hermes Agent 自带的 ACP 服务端（hermes acp）接入，需在 Remote 设置中开启；Desktop/Android 支持工作区、历史、流式思考与工具输出、文字消息、审批及模型选择，暂不开放图片输入与直接 Files/Terminal 访问。

配置与后端适配开发见 Agent 工作区接入指南。

Desktop/Android 的 Cursor、Claude、Hermes、Pi、OpenCode、AGY 模型选择使用 Host 实际模型目录，由Agent ACP决定

思考强度选项以上游实际提供为准。Cursor 每个会话使用独立进程，切换模型不会影响其他会话。

端到端加密

Harness 业务流量在 Client 加密，只能由选定的 Host 解密，固定使用 Noise_IK_25519_ChaChaPoly_SHA256。

连接必须同时通过同账号 membership 与本地固定的设备 identity key 校验。

服务端可以协调连接并看到必要的网络元数据，但不能读取会话消息、Prompt、工具输出、Workspace 路径或 远端文件内容。

握手、密钥生命周期、可见元数据、重放保护和安全边界详见端到端加密。

网络与传输

Host 只建立出站连接，不监听公网端口，也不要求路由器端口转发。

Remote 按 LAN -> P2P -> TURN -> Relay 协商路径；

WebRTC 不可用或连接失败时，会降级到加密的 WebSocket Relay。

所有路径都承载同一份 Noise 密文，并保持相同的 Host/Client 身份边界。

网络拓扑、控制面与数据面、NAT、降级、重连语义和当前验证状态详见网络与传输。

安全边界

- LAN 、P2P网络下，除了网络协调相关指令，所有的数据不经过服务器；TURN服务使用开源coturn服务器部署，Relay 模式使用WebSocket转发。
- 所有的会话流量经过端到端加密；服务端只中继密文，不保存会话明文或设备私钥。
- Server membership 与 Host 本地固定的 peer identity 必须同时授权连接。
- Remote Tools 注入说明：可选的 remote_* 会话工具，默认开启，可在详细 Remote 设置中开启。
- 交互终端使用 Host 本地的 terminal.enabled（默认开启），以 Host 用户身份运行，独立于 Agent 审批；
- 不开放通用工具 RPC 或远程桌面。
- Workspace 选择器只列出文件夹，并且只返回受限的只读目录元数据。
- 远端文件预览不能写入、删除、上传、执行文件，也不能调用远端系统的“外部打开”。
- Codex Remote / Agent ACP是可选功能，可以关闭，并遵循与 Remote 其他能力相同的加密 Host 权限边界。
- 移除设备后，其凭证、membership 和已建立的 Remote 连接均会失效。

常见问题

需要公网 IP 或端口转发吗？

不需要。Host 只建立出站连接，不监听公网端口。

服务端能看到我的会话内容吗？

不能。服务端只中继密文；它能读到的是完成授权、在线状态、选路与限流所需的控制元数据，例如设备归属、在线状态、连接时间与 connectionId，读不到 Prompt、对话内容、工具输入输出、Workspace 路径与文件预览内容。

哪台机器可以当 Host？

装了 Remote 插件并已登录的 Harness 实例，无论是Windows还是MacOS、Linux，甚至于DSH-Go 都可以作为Harness Remote Host实例。

可以几台设备同时连同一个 Host？

暂无限制，当前可以同时使用多设备并发连接，RPC 与数据流按连接隔离。

支持哪些 Harness 版本？

当前基线为 dsh-v0.2.1-rc.5，兼容 0.2.0 rc.2 / rc.1，详见兼容性说明。

Host 插件、随包 Remote 客户端和 Android 已移除 Harness 0.1.1-rc.2 ApiProxy 兼容。请使用提供官方 Typert Remote carrier 的 Host；

仅提供 ApiProxy 或不支持能力发现的旧 Host 会被拒绝，不再降级。

CodeX/ACP 保留独立数据面，Desktop 内存投影统一使用 Typert。

Linux 安装为什么要求 root？

安装脚本要配置 systemd 系统服务；Host、Agent 工具与远程终端因此具备 root 权限，只应对可信账号开放。

iOS 可以直接装吗？

目前是 TestFlight 内测，未公开上架，入口见 issue #20。

和 frp、内网穿透或远程桌面有什么不同？

通用端口映射使用Server TCP转发流量，流量需要从Server经过一道，受限于Server端的带宽瓶颈。

本项目使用4层网络模式依次探测，在复杂网络环境下依旧能保持良好的P2P直连。

远程桌面为了满足用户使用需求，需要把整个电脑屏幕获取下来，然后再用户侧重放，整体对上下行带宽和电脑性能都有要求。

本项目只把 Harness 原生会话界面需要的消息加密后传输到远端，不开放通用工具 RPC 与桌面控制，权限与审批仍留在 Host 侧。

Tailscale 、 CF Turn 、UU远程都是非常优秀的解决方案，大家按需使用即可。

推荐搭配插件

Intelligent UI

Intelligent UI 让模型用卡片、表格、图表和表单作答。
Android 客户端可原生渲染这些内容，并在 插件 → Remote 适配 中列出该插件，可直接开关和修改实时设置。

Fei2411/DS-Bot

DS Bot 是一个基于 DeepSeek Harness（简称 dsh）的 bot 插件，插件将 dsh 改造为 bot 形式。你可以与自己创建的 bot 交流、工作。

文档

- 插件说明
- 安装指南
- dsh-TUI Remote 使用指南
- Codex Remote 技术说明
- ACP Remote / Agent adapter 技术说明
- 文档索引
- 端到端加密
- 网络与传输
- 远程协议
- 开发进度与路线图
- 更新记录
- 隐私说明
- Android 说明
- 当前开发适配基线为 dsh-v0.2.1-rc.5，验证范围见兼容性说明。

友情链接

- 友情链接：DSH Go — 把 DeepSeek Harness 装进口袋：手机本机运行，也能遥控你的电脑。「已适配 Remote。」
- 友情链接：dsh-TUI（已适配 Remote，参见 dsh-TUI Remote 使用指南）
- 友情链接：LINUX DO 社区
- 友情链接：赛博刘看山

Star History

项目声明与商标

本项目是独立的社区项目，不是 DeepSeek 官方产品。DeepSeek 及相关名称和商标归其各自权利人所有。

License

MIT