liguobao/ds-harness-remote
开发工具把本地 DeepSeek Harness 及 Codex、Cursor、Claude Code 工作区通过加密 P2P 远程开放给桌面、网页和手机客户端。
项目介绍
DS Harness Remote 是 DeepSeek Harness Desktop 的插件,让其他设备连接工作电脑上的 Harness 实例。主机保留原有的工作区、工具和项目配置,客户端只是打开同一环境的另一个窗口。除 DSH 外,它也能通过 ACP 暴露 Codex、Cursor、Claude Code、Hermes 等 Agent 工作区。
客户端包括 DSH 桌面插件、Web 页面、Android、DSH Go,以及仅通过 TestFlight 分发的 iOS 版本。主机只发起出站连接,不需要公网端口或路由器端口转发。连接路径按 LAN → P2P → TURN → Relay 顺序协商,业务流量使用 Noise_IK_25519_ChaChaPoly_SHA256 端到端加密,中继只转发密文,不保存会话明文或设备私钥。
快速使用
- 在 DeepSeek Harness Desktop 的 Extensions / Plugin management 中选择从 npm 安装,填入
ds-harness-remote@0.6.2并重启。官方dsh启动器也可执行dsh plugin --profile desktop add -w ds-harness-remote@0.6.2。 - 在 Harness 侧边栏打开 Remote,使用知乎、GitHub、Google 或账号密码登录。新账号注册需要邀请码,需向仓库作者申请。
- 在另一台设备上安装同一插件并登录,或直接使用 Remote Web、Android、DSH Go,无需安装插件。
- 选择在线主机,打开已有工作区或浏览远程目录后进入。
默认使用托管服务器 dsh.r2049.cn。自托管可部署仓库内的最小 Server,它提供 P2P 协调和中继,但不包含完整的托管 Remote Web 体验。
使用约束
- 兼容基线为
dsh-v0.2.1-rc.5,对0.2.0rc.2 / rc.1 有限支持;缺少能力发现的老版本主机会被拒绝,详见兼容性说明。 - 注册需要邀请码;iOS 客户端仅在 TestFlight 测试,尚未公开发布。
- Linux 一键安装需要 root 权限,因为它会配置 systemd 系统服务,之后主机、Agent 工具和远程终端以 root 身份运行。
- 交互式终端以主机用户身份运行,不受 Agent 审批流程约束;Remote Tools 注入默认开启,可在设置中关闭。
- ACP 工作区支持属于实验性功能;Claude 与 Hermes 不支持图片输入和直接访问 Files/Terminal。
- 插件采用 MIT 许可,但仓库本身未声明许可证;该项目为独立社区项目,并非 DeepSeek 官方产品。
HotRepo 点评
该项目于 2026-11-03 进入 TypeScript 日榜第 3 名,当时共 1,407 Stars、125 Forks,当日新增 135 Stars。这组数据反映的是 DeepSeek Harness 插件生态的热度,而不只是插件本身。项目在架构上的特点是:不开放公网监听端口、四级传输回退、中继只处理密文,并提供较完整的 ACP 接入面。评估是否采用时,应结合兼容基线和自托管 Server 功能不完整这两点核对自己的环境。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。