dshost-plugin 0.1.9 → 0.1.11

package/README.md

@@ -6,7 +6,7 @@
 [![GitHub](https://img.shields.io/badge/GitHub-NoelJudeNoel%2Fdshost--plugin-blue)](https://github.com/NoelJudeNoel/dshost-plugin)
 
 **DSHost 官方 DSH 远程中继插件** — 在你的 dsh（DeepSeek Harness）实例上运行一个 Agent，
-通过 `wss` 主动外连 DHost 中继，让你在世界任何地方用浏览器安全访问自己的 dsh Web UI，
+通过 `wss` 主动外连 DSHost 中继，让你在世界任何地方用浏览器安全访问自己的 dsh Web UI，
 无需公网 IP、无需端口映射。
 
 *Official remote cloud relay plugin for DSHost (dshost.me): securely access your
@@ -15,7 +15,7 @@ dsh Web UI from anywhere.*
 ## 特性
 
 - **零公网 IP**：Agent 主动外连中继（`wss://dshost.me/agent`），本机不开任何入站端口
-- **零破坏性多版本兼容**：同时支持 dsh `0.0.1-rc.*` / `0.1.0-rc.*` / `0.1.1-*` / `0.1.2-*`
+- **零破坏性多版本兼容**：同时支持 dsh `0.0.1-rc.*` / `0.1.0-rc.*` / `0.1.1-*` ~ `0.1.5-*`
 - **安全**：中继层 Host/Origin 重写遵守 dsh 信任栅栏；`settings.describe` 密钥脱敏下发；
   生产环境强制 `wss://`
 - **随 dsh 启动**：以 cordis 插件身份随 `dsh web` 加载，自动重连、休眠省流
@@ -30,7 +30,10 @@ dsh Web UI from anywhere.*
 ### 2. 一键安装（推荐）
 
 ```bash
+# macOS / Linux
 curl -fsSL https://dshost.me/install.sh | bash
+# Windows (PowerShell)
+$env:RELAY_HOST='dshost.me'; irm https://dshost.me/install.ps1 | iex
 ```
 
 脚本会安装 pnpm、通过 `dsh plugin add dshost-plugin` 把插件装入当前 profile，
@@ -47,7 +50,7 @@ dsh plugin add dshost-plugin
 
 ```yaml
 - insert:
-    - id: dsh-remote-agent
+    - id: dshost-agent
       name: 'dshost-plugin'
       config:
         token: dsh_your_token_here
@@ -76,6 +79,7 @@ sudo systemctl restart dsh   # 或你的启动方式
 
 | dsh 版本 | 支持 |
 |---|---|
+| `0.1.5-*`（已实证 `0.1.5-rc.1`） / `0.1.4-*` / `0.1.3-*` | ✔ |
 | `0.1.2-*`（含 `--trusted-host`、BrowserAuth、remote.mux） | ✔ |
 | `0.1.1-*` / `0.1.0-rc.7+`（insert 块 patch 格式） | ✔ |
 | `0.1.0-rc.2 ~ rc.6` / `0.0.1-rc.*` | ✔（旧包名 `@noeljude/dsh-remote-plugin` 亦可解析） |

package/lib/core.js

@@ -267,6 +267,9 @@ export function collectSystemInfo(defaultVersion) {
     diskFree,
     dshVersion: defaultVersion || meta.dshVersion,
     plugins: meta.plugins,
+    // 服务旁挂：独立 services agent（DSH_SERVICES_ONLY=1，无本地 dsh 承载）
+    // 上报 role=services，relay 不将其注册为主实例，只挂到同 hostname 的主实例下
+    role: process.env.DSH_SERVICES_ONLY === '1' ? 'services' : 'dsh',
     // 无头检测：供 relay 注入脚本决定产物点击行为(新窗口HTTP直出 vs 本地打开)
     headless: !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY,
   };
@@ -334,6 +337,7 @@ export function normalizeServices(raw, log) {
       auth: s.auth === 'sso' ? 'sso' : 'open',
       entry: typeof s.entry === 'string' && s.entry.startsWith('/') ? s.entry : '/',
       ssoSecret: typeof s.ssoSecret === 'string' && s.ssoSecret ? s.ssoSecret : '',
+      spa: s.spa === true,
       basicUser: typeof s.basicUser === 'string' ? s.basicUser : '',
       basicPassword: typeof s.basicPassword === 'string' ? s.basicPassword : '',
       host: up.host,
@@ -470,9 +474,11 @@ export function startAgent(opts) {
         log.log?.(`[agent] Registered as ${msg.username} (session ${msg.sessionId || ''})`);
         send(ws, { type: 'system-info', info: collectSystemInfo(dshVersion) });
         // 插件工作区：上报本实例声明的服务清单（relay 存实例维度，供 /p 路由校验）
+        // DSH_SERVICES_ONLY=1：独立 services agent，relay 不注册主实例（服务旁挂到同机 dsh 实例）
         send(ws, {
           type: 'services',
-          services: svcList.map(({ id, name, desc, icon, auth, entry }) => ({ id, name, desc, icon, auth, entry })),
+          servicesOnly: process.env.DSH_SERVICES_ONLY === '1' || undefined,
+          services: svcList.map(({ id, name, desc, icon, auth, entry, spa }) => ({ id, name, desc, icon, auth, entry, spa })),
         });
         startHeartbeat(ws);
         return;
@@ -561,9 +567,17 @@ export function startAgent(opts) {
 
   function startHeartbeat(ws) {
     if (heartbeatInterval) clearInterval(heartbeatInterval);
+    // 半开死链看门狗：只发不收时 TCP 仍 ESTAB（FIN 被代理链路吞掉的场景），
+    // close 事件永远不来，agent 变僵尸。每次 ping 记账，收到任意下行帧清零；
+    // 连续 3 个周期（45s）无下行则主动 terminate() 触发重连。
+    let lastRx = Date.now();
+    ws.on('message', () => { lastRx = Date.now(); });
     heartbeatInterval = setInterval(() => {
-      if (ws.readyState === WebSocket.OPEN) {
-        send(ws, { type: 'heartbeat', ts: Date.now() });
+      if (ws.readyState !== WebSocket.OPEN) return;
+      send(ws, { type: 'heartbeat', ts: Date.now() });
+      if (Date.now() - lastRx > 45000) {
+        log.log?.('[agent] heartbeat watchdog: no inbound for 45s, forcing reconnect');
+        try { ws.terminate(); } catch (eT) {}
       }
     }, 15000);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dshost-plugin",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Official remote cloud relay plugin for DSHost (dshost.me): securely access your dsh Web UI from anywhere",
   "type": "module",
   "main": "lib/index.js",