设备互联 wwj-wwj1/dsh-device-link

dsh-device-link · 设备互联

把本机运行的 DeepSeek Harness 桌面版 一键开给别的设备访问 —— 用手机、平板、另一台电脑打开浏览器，就能用同一个 DSH。

左下角 WiFi 图标 → 点开「设备互联」卡片 → 三个开关。

设备互联卡片

当前版本 1.0.0，仅支持 Windows 10 / 11。

它解决什么问题

DSH 桌面版把服务写在 127.0.0.1 上（还带浏览器会话校验），所以同一台机器以外的设备天然打不开。这个插件做两件事：

1. 在本机起一个带鉴权注入的转发网关，把外部请求转给 DSH，手机就能访问；
2. 顺手管 EasyTier 组网服务的启停，让不在同一 WiFi 的设备也能连进来。

它不修改 DSH 本身，也不修改 EasyTier 的任何配置，只做「开 / 关」。

三个开关

| 开关 | 作用 | 打开后 |
| 互联 | 总闸 | = 局域网互联 + 组网互联一起打开 |
| 局域网互联 | 给同一 WiFi / 同一网段的设备开入口 | http://<本机局域网IP>:8900/ |
| 组网互联 | 给经 EasyTier 组网的设备开入口，并启停 EasyTier 服务 | http://<EasyTier 虚拟IP>:8899/ |

- 关掉开关 = 停网关进程（局域网互联）、或停网关 + 停 EasyTier 服务（组网互联）。
- 组网互联打开时，如果 EasyTier 服务在跑但虚拟网卡没拿到 IP（半死状态），会自动 重启 服务。
- 「关掉再打开」就等价于「重启组网」。

端口被别的程序占着时，局域网入口会自动往上顺延（默认最多顺延 5 个），实际端口显示在卡片里。

还没装 EasyTier？（组网互联的准备工作）

组网互联依赖 EasyTier。卡片「组网互联」下面会自动检测，并按情况给出按钮 —— 不装 EasyTier 也能正常用局域网互联，只是组网那行会置灰。

| 卡片状态 | 你能点 |
| 没检测到 EasyTier | 用 winget 安装（有 winget 时）/ 打开下载页（GitHub Releases）/ 重新检测 |
| 装了但还没配置 | 生成配置（生成一份属于你自己的 easytier.toml）/ 打开下载页 |
| 已经配置好 | 显示网络名称、虚拟 IP、配置路径；显示/隐藏密码、复制邀请、注册服务 / 重装服务 |

几个要点：

- 生成的是你自己的凭据。 网络名（dsh-xxxxxx）、网络密码（16 位随机）、虚拟网段都是当场随机生成的，每台设备各不相同；想两台设备组网，就把「复制邀请」里的内容发给对方，让对方填进自己生成的配置里（或统一改成同一份网络名 + 密码）。
- 包里只有公共汇合点。 随包附带的是几个公开的社区中转节点（meetPeers），它们只负责让两台设备互相发现，握手成功后数据走 P2P 直连。包里不包含任何人的网络名、网络密码或虚拟 IP。
- 汇合点随时可能失效；失效时把 meetPeers 换成你自己的节点即可（tcp:// / udp:// / ws:// 都支持）。
- 生成的配置落在 %LOCALAPPDATA%\dsh-device-link\easytier.toml，路径显示在卡片里，可以自己改。
- 「注册服务」会弹一次 UAC。 它做的事：把这个配置注册成 Windows 服务（默认 EasyTierService），顺带加两条防火墙规则、设置失败自愈策略。注意：如果本机已经有同名服务（比如别的组网客户端在用），重装会把它的启动配置换成这份新配置 —— 换完重启服务才生效。

安装

在 DSH 里用官方插件管理器安装（target 传包目录的绝对路径） plugin_manager install_bundle target="C:\path\to\dsh-device-link"

或者先打包再装
npm pack
plugin_manager install_bundle target="C:\path\to\dsh-device-link-1.0.0.tgz"

装好后侧边栏底部会多出 WiFi 图标；如果没有，重启一次 DSH。

要求

- Windows 10 / 11（用到 sc.exe / netstat / tasklist，其他系统不可用）。
- Node.js ≥ 20（网关是一个零依赖的 Node 脚本）。
- EasyTier：可选。没装也能用局域网互联；组网互联会自动探测不可用并置灰。

⚠️ 安全警告（务必读）

这个网关为了让手机免登录，会自己给请求签一个有效的 DSH 浏览器会话 Cookie（密钥从 ~/.dsh/.credentials.yaml 读取，仅在本机内存与请求头中使用，不会外发）。

也就是说：只要有人能连上这个端口，就等于拿到了你 DSH 的完整权限（能看会话、能执行工具）。

- 只在你信任的网络里打开；
- 不要在公司网、公共 WiFi、共享宿舍网里长期开着；
- 不用的时候把开关关掉 —— 关掉后端口立刻消失；
- 想更稳妥：在 Windows 防火墙里把入口端口限定到特定网段，或只对指定设备放行。

另外：生成的组网配置（easytier.toml）和状态文件（~/.dsh/device-link.state.json）里，网络密码是明文保存的（EasyTier 需要明文才能启动）。卡片上的密码默认打码只是防肩窥；这两个文件所在的位置应视为敏感文件，不要提交到公开仓库。

配置

配置在 cordis.patch.yml 的 config: 下，装好后也可以直接改 profile 里的同一段。所有值都可以留空 / 用默认。

| 键 | 默认 | 说明 |
| lanHost | 0.0.0.0 | 局域网入口绑定地址 |
| lanPort | 8900 | 局域网入口端口 |
| portRetry | 5 | 端口被占时最多顺延几个；0 = 不顺延，直接报错 |
| meshPort | 8899 | 组网入口端口 |
| meshIp | 空 = 自动 | EasyTier 给本机的虚拟 IP（自动从 et_ 网卡读） |
| serviceName | 空 = 自动 | EasyTier 的 Windows 服务名（自动探测） |
| gateScript | 空 = 随包 lib/gate.cjs | 网关脚本路径 |
| nodePath | 空 = 自动 | 跑网关的 node.exe；自动挑「防火墙已放行入站」的那个 |
| tunnelPort | 11010 | EasyTier 数据端口，只用来数组网对端数量 |
| restoreState | true | DSH 重启后自动恢复上次开着的通道 |
| statePath | 空 = ~/.dsh/device-link.state.json | 状态落盘位置 |
| wingetId | EasyTier.EasyTier | 「用 winget 安装」使用的包 ID |
| installUrl | EasyTier Releases | 没有 winget 时「打开下载页」跳转的地址 |
| corePath | 空 = 自动 | easytier-core.exe 路径（自动搜常见安装目录与 winget 包目录） |
| configPath | 空 = %LOCALAPPDATA%\dsh-device-link\easytier.toml | 「生成配置」写出的位置 |
| meetPeers | 7 个公共汇合点 | 生成配置时写入的 [[peer]] 列表，可换成你自己的节点 |

手机连不上？按这个顺序排查

1. 确认在同一个 WiFi / 网段：手机 IP 与电脑局域网 IP 前三段相同（如 192.168.68.x）。
2. 确认开关是开的，卡片里显示的地址能直接在电脑浏览器打开。
3. Windows 防火墙是头号元凶。入站放行是「程序完整路径 × 网络配置文件」的组合：同一个 node.exe 在「专用网络」放行了，在「公用网络」没放行就照样被挡。而很多机器的 WiFi / 以太网会被 Windows 判成「公用网络」。
- 本插件的做法：优先挑一个在公用网络也被放行的 node.exe 来跑网关（nodeCandidates()）；在 DSH 桌面版里如果没有可用的 node.exe，会退回用 DSH 自己的可执行文件（DeepSeek Harness.exe + ELECTRON_RUN_AS_NODE=1）当 node 用 —— 那种情况下防火墙要看的是 DeepSeek Harness.exe 的入站规则；
- 自己排查：Get-NetConnectionProfile 看当前网络类别，再 Get-NetFirewallRule -Direction Inbound -Action Allow 找 node.exe 规则是 Profile=Private 还是 Any；
- 一次性解决（管理员）： New-NetFirewallRule -DisplayName "DSH 互联入口 8900" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 8900 -Profile Any

4. 组网互联连不上：先看 EasyTier 服务是否 RUNNING、et_ 网卡上有没有虚拟 IP、对方设备是否在同一 EasyTier 网络（netstat 看 11010 有没有对端连接）。

组网关不掉？（EasyTier 侧的系统行为）

Windows 服务可以被配置「失败自动重启」。如果 EasyTier 服务带这种自愈策略（sc qfailure EasyTierService 里能看到 RESTART -- Delay = 5000 milliseconds.），你 sc stop 之后它 5 秒就自己回来了，普通权限改不动。

插件卡片会如实提示这一点（stopProtected）。真要能关：

管理员 PowerShell，一次性，之后服务就停得住了（可逆） sc failure EasyTierService reset= 0 actions= "" 想恢复原来的自愈策略 sc failure EasyTierService reset= 86400 actions= restart/5000/restart/5000/restart/5000

清空自愈策略后，EasyTier 进程真的崩了就不会再自动拉起。本仓库 scripts/ 里有两个 .cmd 帮你一键做这两件事（双击会自动提权）。

工作原理

手机/别的设备 ──HTTP/WS──> 网关(lib/gate.cjs, 监听 0.0.0.0:8900 或 <虚拟IP>:8899) │ 1. 读 ~/.dsh/.credentials.yaml 的本机会话密钥，签一个有效 Cookie │ 2. 改写 Host / Origin、剥掉代理类请求头（让 DSH 认为是本机直连） │ 3. 静态资源加 no-store，避免手机缓存住旧前端 └──> 127.0.0.1:<DSH 实际端口> (HTTP + WebSocket upgrade 双向透传)

- DSH 桌面版的端口每次重启都可能变，插件从 webServer.getOrigin() 取当前真实端口传给网关，不靠猜进程名。
- 网关是零依赖 Node 脚本，随包分发，日志默认写 %TEMP%\device-link-gate.log（可用 --log 覆盖）。

已知限制

- 只在 Windows 上验证；sc.exe / netstat / tasklist 是硬依赖。
- 没有独立的登录页：安全性依赖「知道端口 + 在可信网络」这两个前提（见上方安全警告）。
- 组网互联依赖本机已装 EasyTier 并把它注册成了 Windows 服务；EasyTier GUI 版不会被识别。
- 状态恢复是「尽力而为」：DSH 起来 2 秒后尝试恢复上次开着的通道，端口变了会自动换一个。

开发

lib/
index.js 宿主侧：探测 EasyTier、起停网关、状态落盘、/api/device-link/* 路由text gate.cjs 零依赖转发网关（也能单独用：node gate.cjs --host 0.0.0.0 --port 8900 --target 8069） client.js Web UI：侧边栏 WiFi 图标 + 卡片（用 DSH 主题变量，跟随深浅色） scripts/ easytier-guard.ps1 清空 / 恢复 EasyTier 服务自愈策略（需管理员，双击 .cmd 自动提权） easytier-allow-stop.cmd → -Action Clear easytier-restore.cmd → -Action Restore cordis.patch.yml bundle 补丁（插入插件行 + 默认配置）

接口：

- GET /api/device-link/status.json（同时兼容 /device-link/status.json）
- POST /api/device-link/toggle.json，body {"switch":"master|lan|mesh","on":true}

两个路由都会校验 Host 头，只接受本机 / 已知入口地址的请求，避免被随便跨站调用。

许可

MIT。见 LICENSE。

本项目与 DeepSeek 官方无关，是社区插件。