@mrrisega/dsh-remote 0.6.6 → 0.6.7-beta.2

package/README.md

@@ -23,11 +23,33 @@ dsh-remote 是一个轻量的**隧道模式**远程控制方案：电脑端运
        │
   nginx (HTTPS)
     ├─ /app/            → 静态 PWA (native.html)
-    ├─ /_devices /_quota /_login /remote/ /_bridge / → relay-router
+    ├─ /_devices /_login /remote/ /_bridge / → relay-router
     └─ /_bridge         → relay-router (WebSocket)
                            └→ bridge (电脑端) → 127.0.0.1:3080 (dsh web)
 ```
 
+## 0.6.7 速览（Windows 可用版）
+
+0.6.6 及更早的插件半整套「服务状态 / 启停 / 重启」是按 macOS/Linux 写死的
+（launchctl / systemd / pgrep / ps / /bin/sh），**在 Windows 上安装一切正常、运行期必死**：
+面板红字「读取状态失败: process.getuid is not a function」、状态永远停在「查询中…」、
+运行环境补不上、点「重启 DeepSeek harness」还会把 dsh web 打挂。本轮全部修掉：
+
+- **Windows 不再 500**：`process.getuid` 在 Windows 上根本不存在（不是返回 undefined），
+  旧的 `launchTarget()` 无条件调它 → 所有读状态接口抛错。现在非 macOS 直接短路 launchd 查询。
+- **Windows 能补上运行环境**：`spawn("npx.cmd")` 在 Node ≥20.12 起不带 shell 会抛 EINVAL。
+  现在用**当前 node 直接跑 npm 自带的 `npx-cli.js`**（不经 cmd.exe），退回 `.cmd` 时必带 `shell: true`。
+- **「重启 DeepSeek harness」不再打挂进程**：Windows 改用 node 跑的 `.mjs` 助手（不再 `/bin/sh`），
+  且**先校验 node/入口/工作目录存在再动旧进程**，spawn 真正成功才回报成功。
+- **Windows 进程发现**：安装器落 `.dsh-watcher.pid` / `.dsh-bridge.pid`，插件按 pid 判活
+  （不再依赖 Windows 上不存在的 `pgrep`/`ps`），必要时用 PowerShell 扫 node 进程兜底。
+- **Windows 自启动**：安装器在**任务计划程序**注册登录任务 `dsh-remote-bridge`，卸载时一并删除；
+  插件自愈也会隐藏地把 bridge 拉起来（日常使用看不到控制台窗口）。
+- **面板不再无限转圈**：`bridge-status` 轮询连续失败 3 次会把原因摆到连接卡上（原先静默 catch）。
+
+> 平台支持：**macOS / Linux / Windows** 均可运行。自启动方式按平台分别是
+> launchd、systemd --user、任务计划程序（Windows）。macOS/Linux 的行为与 0.6.6 完全一致。
+
 ## 0.6.4 速览（首次安装不再卡）
 
 - **登录后 bridge 自动连上，全程零刷新**：面板自动补运行环境 → 拉起 bridge → 显示「正在连接中继…」，连上后自动变成「已连接 ✅」并刷新二维码与设备列表；失败有可读原因、自动重试倒计时和「复制诊断信息」。
@@ -48,7 +70,7 @@ dsh-remote 是一个轻量的**隧道模式**远程控制方案：电脑端运
 **0.6.1 起已有**
 
 - **首次安装体验修复**：装完插件立即登录，二维码与已授权设备列表不再报「尚未登录」红字；中继未就绪时面板自动退避重试，不用再手动刷新页面。
-- **企微交流群**：README 底部扫码入群；服务端可在管理后台「推广」页上传交流群二维码，官网、付费页底部、设置面板「加入交流群」按钮与用户反馈页会同步展示。
+- **企微交流群**：README 底部扫码入群；服务端可在管理后台「推广」页配置交流群二维码，设置面板「加入交流群」按钮与用户反馈页会同步展示。
 
 **0.6.0 起已有**
 
@@ -74,7 +96,6 @@ dsh-remote 是一个轻量的**隧道模式**远程控制方案：电脑端运
 | 服务器 | 你自己部署（任意有公网 IP 的机器） | 由服务商托管 |
 | 账号体系 | 无需账号：访问密钥认证（`/_login` 换本地 JWT） | 手机号 + 短信验证码 |
 | 后台管理 | 无（密钥即实例管理员） | 超管后台（用户/套餐/审计） |
-| 流量配额 | 可选（环境变量覆盖默认值） | 按套餐分层限速限流 |
 | 许可证 | 本仓库（见下文 License） | 商业授权，闭源 |
 
 两者可随时切换：电脑端插件面板「连接模式」一键切换，互不影响。
@@ -85,8 +106,9 @@ dsh-remote 是一个轻量的**隧道模式**远程控制方案：电脑端运
 
 ## 安装
 
-需要 Node.js ≥ 20。电脑端**一条命令**完成安装：自动安装 bridge 与 dsh web 插件、
-写入配置、创建开机自启服务：
+需要 Node.js ≥ 20（macOS / Linux / Windows 均可）。电脑端**一条命令**完成安装：
+自动安装 bridge 与 dsh web 插件、写入配置、创建开机自启（macOS launchd / Linux systemd --user /
+Windows 任务计划程序）：
 
 ```bash
 npx @mrrisega/dsh-remote
@@ -138,8 +160,8 @@ npx @mrrisega/dsh-remote setup --server wss://<你的域名>:端口 --key <访
 **边界与建议（如实告知）**
 
 - E2EE 保护的是**内容**：HTTPS 下的静态页面壳与路由元数据（页面骨架、路径、大小、时间、
-  是否加密）仍对中继可见；既有登录、配额与审计不受影响。
-- E2EE 为**灰度功能**：以服务端开关逐步放量（默认关闭 = 走 HTTPS 明文回退），面板会显示
+  是否加密）仍对中继可见；既有登录与审计不受影响。
+- E2EE 为**分阶段开启的功能**：以服务端开关逐步放量（默认关闭 = 走 HTTPS 明文回退），面板会显示
   当前加密状态与原因（已启用 / 等待服务端开启 / 普通安全连接等），不会静默降级。
 - 建议上线前用**真机回归**一次完整链路：手机登录解锁 → 🔒 加密访问（对话/工具/审批/凭据）→
   明文回退提示 → 修改密码后旧会话全部失效、重新登录恢复。
@@ -217,7 +239,7 @@ export DSH_REMOTE_TELEMETRY=0     # 完全关闭匿名装机统计：不生成
 
 | 组件 | 位置 | 说明 |
 |---|---|---|
-| relay-router | `packages/relay-router/` | 中继服务器：bridge 注册表、实时设备列表、HTTP/WS 透明代理、配额 |
+| relay-router | `packages/relay-router/` | 中继服务器：bridge 注册表、实时设备列表、HTTP/WS 透明代理 |
 | bridge | `clients/dsh-remote/` | 电脑端守护进程：连 router 注册，把转发帧代理到本地 `dsh web`；心跳自愈 |
 | PWA | `clients/dsh-web/native.html` | 手机端：登录 / 注册 / 设备选择（单文件，零构建） |
 | dsh web 插件 | `packages/dsh-remote-web/` | 设置页「远程访问」面板：连接模式 / 账号 / bridge 启停 / 反馈 |

package/clients/dsh-remote/dsh-bridge.mjs

@@ -992,7 +992,7 @@ async function registerDeviceInAccount(token) {
         device_name: os.hostname() || "dsh-bridge",
         pub_key: pubKey,
         machine_fp: MACHINE_FP, // v6 同机识别:服务端据此自动顶替旧设备(重装不再被设备数卡死)
-        // 安装口径(服务端存到设备行,供运营统计「市场安装/自愈补装」vs「安装器 npx」):
+        // 安装口径(服务端存到设备行,用于区分「市场安装/自愈补装」与「安装器 npx」):
         //   install_source: npx(安装器注入) | plugin_market(插件拉起/自愈,默认) | unknown(白名单外)
         install_source: INSTALL_SOURCE,
         install_version: INSTALL_VERSION,

package/clients/dsh-remote/e2ee-shim.mjs

@@ -21,8 +21,8 @@
  *
  * 注入开关:
  *   - DSH_E2EE_SHIM=0 关闭注入(默认开启);
- *   - 灰度:bridge 端 e2ee.enabled 为 false 时 dsh-bridge 不调用本模块 → 零注入、零行为
- *     (灰度默认关 = 本 shim 默认不出现,镜像页保持既有明文路径)。
+ *   - 开关:bridge 端 e2ee.enabled 为 false 时 dsh-bridge 不调用本模块 → 零注入、零行为
+ *     (默认关 = 本 shim 默认不出现,镜像页保持既有明文路径)。
  *   - 「桌面宽屏/明文零行为」:未交接时数据面不拦截;桌面直连 dsh web 不经 bridge → 无注入。
  *
  * 测试:本模块的纯函数契约 + e2ee-shim-script.js 抽取的
@@ -108,7 +108,7 @@ export function shimScriptText() {
   return cachedScript;
 }
 
-/** 环境开关:DSH_E2EE_SHIM=0 关闭注入(默认开启;叠加桥端 e2ee.enabled 灰度门)。 */
+/** 环境开关:DSH_E2EE_SHIM=0 关闭注入(默认开启;叠加桥端 e2ee.enabled 开关)。 */
 export function e2eeShimEnabled() {
   return process.env.DSH_E2EE_SHIM !== "0";
 }
@@ -134,7 +134,7 @@ export function injectE2eeShim(html) {
 /**
  * 判断上游响应是否应注入 shim(与 mobile-adapter.shouldInjectHtml 同 gate:
  * 仅官方 dsh web 的 text/html,含 </head>、无替换字符)。e2ee.enabled 由调用方(dsh-bridge)
- * 决定,本函数只做类型/特征门 —— 「灰度关 = 不调用 = 零注入」。
+ * 决定,本函数只做类型/特征门 —— 「开关关 = 不调用 = 零注入」。
  */
 export function shouldInjectE2eeShim({ contentType, html }) {
   const ct = String(contentType || "");

package/clients/dsh-remote/mobile-adapter.mjs

@@ -351,7 +351,7 @@ const SCRIPT = `(() => {
           }
         }
       }
-    } catch (e3) { /* 私有模式/配额等:忽略 */ }
+    } catch (e3) { /* 私有模式等:忽略 */ }
 
     /* ================= 鲸鱼挂件手机辅助(仅 ≤820 生效;挂件类名 .dshwv-* 稳定) ========= */
     let whaleGuardsOn = false;

package/clients/dsh-remote/test/e2ee-shim.test.mjs

@@ -328,11 +328,11 @@ test("fetch 包装:明文响应(无信封标记)→ 原样透传;篡改响应
   const peer = bridgePeer(seS.sessId, seS.shk, seS.saltH);
   const ORIGIN = "http://relay.local";
 
-  // 1) 明文响应(如 router 402/502 错误页)
-  const plainTransport = async () => new Response('{"error":"quota"}', { status: 402, headers: { "content-type": "application/json" } });
+  // 1) 明文响应(如 router 的错误页/JSON 错误体)
+  const plainTransport = async () => new Response('{"error":"upstream_error"}', { status: 502, headers: { "content-type": "application/json" } });
   const r1 = await shim.seFetchWrapper(plainTransport, { sess: seS, origin: ORIGIN }, ORIGIN + "/api/x", { method: "GET" });
-  assert.equal(r1.status, 402);
-  assert.equal(await r1.text(), '{"error":"quota"}');
+  assert.equal(r1.status, 502);
+  assert.equal(await r1.text(), '{"error":"upstream_error"}');
 
   // 2) 篡改密文 → 502 + x-dsh-e2ee-error + ⚠(绝不静默/绝不误转发)
   const tamperTransport = async (_input, init) => {

package/docs/self-hosting.md

@@ -12,13 +12,12 @@ The self-hosted stack:
        │
   你的 nginx (HTTPS)
      ├─ /app/        → 静态 PWA (clients/dsh-web/native.html)
-     ├─ /_devices /_quota /_login /remote/ /_bridge / → relay-router
+     ├─ /_devices /_login /remote/ /_bridge / → relay-router
 ```
 
 - **relay-router** is the only server component. It registers bridges over
-  WebSocket (`/_bridge`), serves the real-time device list (`/_devices`), proxies
-  HTTP/WS traffic to the right device (`/remote/<deviceId>/…`), and enforces
-  per-plan bandwidth/traffic quotas.
+  WebSocket (`/_bridge`), serves the real-time device list (`/_devices`), and
+  proxies HTTP/WS traffic to the right device (`/remote/<deviceId>/…`).
 - Authentication: `DSH_LOCAL_ACCESS_KEYS` (comma-separated) → `POST /_login`
   → 2h local JWT. The router also accepts SaaS JWTs if
   `DSH_ENTERPRISE_JWT_SECRET` is set, so a router can serve both modes at once.
@@ -79,9 +78,10 @@ lists online devices from `/_devices` and routes into `dsh web` through the tunn
 npx @mrrisega/dsh-remote setup --server wss://你的域名:端口 --key 你的访问密钥
 ```
 
-This writes the local config, verifies the key against `/_login`, and installs a
-launchd/systemd service that keeps the bridge alive. The bridge auto-starts when
-`dsh web` (127.0.0.1:3080) is up.
+This writes the local config, verifies the key against `/_login`, and installs an
+autostart entry that keeps the bridge alive — launchd on macOS, `systemd --user`
+on Linux, and a logon task in **Task Scheduler** (`dsh-remote-bridge`) on Windows.
+The bridge auto-starts when `dsh web` (127.0.0.1:3080) is up.
 
 ## Configuration reference (open.env)
 
@@ -91,8 +91,26 @@ launchd/systemd service that keeps the bridge alive. The bridge auto-starts when
 | `DSH_LOCAL_JWT_SECRET` | JWT secret for local (self-hosted) auth |
 | `DSH_LOCAL_ACCESS_KEYS` | Comma-separated access keys for `/_login` |
 | `DSH_ROUTER_PORT` | Listen port (default 13444) |
-| `DSH_ROUTER_QUOTA_FREE_MAX_BPS` etc. | Optional quota overrides (see `packages/relay-router/README.md`) |
-| `DSH_ROUTER_PRO_MAX_ONLINE` | Max simultaneously online devices (default 3) |
+| `DSH_LOG_DIR` | **Where logs are written to disk.** Unset = stdout only. Set it in production — see below. |
+| `DSH_LOG_MAX_MB` | Max size of a single log file before rotating (default `10`) |
+| `DSH_LOG_KEEP` | Number of rotated files to keep (default `5`) |
+| `DSH_LOG_LEVEL` | `debug` \| `info` \| `warn` \| `error` (default `info`) |
+
+## Logs (must be persisted)
+
+Logs are **not** allowed to live only in a container's stdout or in memory: a
+recreated container or a restarted process would lose them, and audit trails are
+exactly what you need *after* something went wrong. So the router writes to disk
+itself and rotates by size — no host `logrotate` required.
+
+- Set `DSH_LOG_DIR` (e.g. `./logs/router`); the directory is created on demand.
+- Rotated files are `router.log`, `router.log.1`, `router.log.2`, … bounded by
+  `DSH_LOG_MAX_MB` × `DSH_LOG_KEEP` (default ≈ 60 MB per service).
+- Docker deployment already mounts this directory as a volume
+  (`./logs/router:/var/log/dsh-remote`) **and** caps the container's own
+  json-file log driver — see `docker-compose.yml`.
+- If the directory is unwritable (full disk, bad permissions) the logger degrades
+  to stdout-only and reports it **once**; it never takes the service down.
 
 ## Security notes