dsh-tailscale-sync

Readme

<img src="assets/banner.png" alt="dsh-tailscale-sync" width="100%">

# dsh-tailscale-sync

在手机上继续电脑端 DeepSeek Harness 的工作 —— **装好 Tailscale、装好本插件，即可用**，无需改任何配置。

本插件会自动：

1. 把 harness 的 web 服务锁死在 `127.0.0.1:3080`（不暴露局域网）；
2. 自动探测本机的 `*.ts.net` 域名（`tailscale status`），并让 `/api` 信任围栏只放行这个域名。

## 安装

### 1. 装 Tailscale（一次性）

电脑和手机都安装 [Tailscale](https://tailscale.com/download) 并登录同一个账号（确认 tailnet 已开 MagicDNS，新版默认开启）。

### 2. 装本插件

```sh
dsh plugin --profile web add github:MoonGlassKitty/dsh-tailscale-sync
```

### 3. 开 HTTPS 隧道（一次性，一条命令）

在电脑上运行：

```sh
tailscale serve --bg 3080
```

> 若提示 "Serve is not enabled on your tailnet"，按提示点链接授权一次即可。

### 4. 手机访问

手机保持 Tailscale 连接，浏览器打开：

```
https://<你的机器名>.ts.net
```

（在电脑上运行 `tailscale status` 能看到你的 `*.ts.net` 完整域名。）

## 工作方式

```
手机浏览器 ──Tailscale HTTPS──▶ tailscale serve ──▶ 127.0.0.1:3080 (harness)
```

- 手机和电脑看到的是**同一个服务、同一份会话**，不是"两处数据互相同步"；
- 端口只监听回环，普通局域网访问不到；
- 流量走 Tailscale 的加密隧道 + 设备鉴权。

## 注意事项

- **设置 / API key 管理仍只能在本机** `http://127.0.0.1:3080` 操作（harness 源码安全限制，Tailscale 也绕不过）。
- 停用隧道：`tailscale serve --https=443 off`。
- 若你的 tailnet 没开 MagicDNS（没有 `*.ts.net` 域名），本插件会自动退化为"仅本机可访问"，此时需手动在 `cordis.patch.yml` 里填 `trustedHosts`。

## 跨平台

Windows / macOS / Linux 均可用。`tailscale serve`、`dsh`、本插件在三个平台上的命令一致。