zexadev/dsh-tether 预览 preview

zexadev/dsh-tether

插件Plugin ⭐ 13 MIT codingsocial

Reach the DeepSeek Harness on your dev machine from your phone — across networks, through no server at all (iroh P2P)

编辑导读Editor's Brief

## 核心特性
- DSH Tether 通过点对点直连,将开发机上的 DeepSeek Harness Web 界面带到手机上。
- 手机端展示来自原始 DSH 界面的会话、工具调用、审批和设置,而不是单独重新实现的一套界面。
- 配对使用六位数字码,已配对设备可在不同网络间自动重连,无需用户自行部署中继。
- 手机应用可保存多台已配对机器,允许切换、重命名、移除或添加计算机,无需重新输入凭据。
- 等待审批状态可在手机上触发系统通知,而审批决策仍在 DSH 界面内完成。

## 使用场景
- 在离开开发机所在本地网络时,通过手机监控并审批 DeepSeek Harness 会话。
- 让 agent 继续运行在存放代码的机器上,同时通过蜂窝网络或其他网络使用手机进行控制。
- 当每台机器都运行 DSH Web profile 和 tether 插件时,用一部手机管理多台开发机。

## 技术细节
- 机器端以 DSH Web 插件形式安装,并包含一个负责 iroh 连接的 Rust sidecar。
- 网络穿透使用基于 QUIC/TLS 的 iroh 打洞,在直接穿透失败时回退到中继,且中继仅传输密文。
- 配对访问与手机的 iroh 公钥绑定,未配对节点在完成控制流握手前无法访问该界面。
- 插件的 HTTP 路由强制执行 loopback Host 规则,拒绝显式的跨站标记,并要求附带的 Origin 值与 Host 匹配。

## 注意事项
- iOS 构建为 beta 版本、未签名、仅在 CI 中构建,并且尚未在真实设备上运行;Android 已在真实硬件上验证。
- 应用会在打开时连接,不会维持后台连接。
- 开发机上的本地进程可以生成配对码并自行配对,因此不应在运行不可信代码的机器上使用该插件。

## Core Features
- DSH Tether carries the DeepSeek Harness web interface from a development machine to a phone through a direct peer-to-peer connection.
- The phone presents conversations, tool calls, approvals, and settings from the original DSH interface rather than a separate reimplementation.
- Pairing uses a six-digit code, and paired devices can reconnect automatically across different networks without a user-deployed relay.
- The phone app can store several paired machines, allowing switching, renaming, removing, or adding computers without re-entering credentials.
- Approval waiting states can raise system notifications on the phone, while approval decisions remain inside the DSH interface.

## Use Cases
- Monitoring and approving a DeepSeek Harness session from a phone while away from the development machine's local network.
- Keeping the agent running on the machine where code lives while using a phone over cellular or another network for control.
- Managing multiple development machines from one phone when each machine runs the DSH web profile and the tether plugin.

## Technical Details
- The machine side installs as a DSH web plugin and includes a Rust sidecar that owns the iroh connection.
- Network traversal uses iroh hole-punching over QUIC/TLS, with a fallback relay carrying only ciphertext when direct traversal fails.
- Pairing access is tied to the phone's iroh public key, and unpaired peers cannot reach the interface before completing the control-stream handshake.
- The plugin's HTTP routes enforce loopback Host rules, reject explicit cross-site markers, and require attached Origin values to match the Host.

## Notes
- The iOS build is beta, unsigned, built only in CI, and has not been run on a real device, while Android is verified on real hardware.
- The app connects when opened and does not maintain a background connection.
- A local process on the development machine can mint a pairing code and pair itself, so the plugin should not be used on machines running untrusted code.

安装Install

dsh plugin --profile web add github:zexadev/dsh-tether

zexadev/dsh-tether 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

上一个 Prev dsh-md-notes 下一个 Next DSH-EasyRewrite