rdsh-gateway 0.8.0 → 0.8.2

package/dist/service.d.ts

@@ -21,8 +21,9 @@ export interface ServiceSpec {
 }
 /** systemd 用户级 unit 模板。 */
 export declare function systemdUnit(execStart: string, spec: ServiceSpec): string;
-/** launchd plist 模板。 */
-export declare function launchdPlist(execStart: string, spec: ServiceSpec): string;
+/** launchd plist 模板。program 为启动前缀 argv（[node, 脚本]），命令参数由 spec 提供——
+ * launchd 不做空格切分，每个 <string> 是一个 argv 元素，故 node 与脚本必须分开。 */
+export declare function launchdPlist(program: string[], spec: ServiceSpec): string;
 /** 安装并启动服务（用户级）。 */
 export declare function installService(spec: ServiceSpec): Promise<string>;
 /** 服务状态。 */

package/dist/service.js

@@ -58,9 +58,10 @@ RestartSec=3
 WantedBy=default.target
 `;
 }
-/** launchd plist 模板。 */
-export function launchdPlist(execStart, spec) {
-    const args = commandArgs(spec).map((a) => `    <string>${a}</string>`).join("\n");
+/** launchd plist 模板。program 为启动前缀 argv（[node, 脚本]），命令参数由 spec 提供——
+ * launchd 不做空格切分，每个 <string> 是一个 argv 元素，故 node 与脚本必须分开。 */
+export function launchdPlist(program, spec) {
+    const argLines = [...program, ...commandArgs(spec)].map((a) => `    <string>${a}</string>`).join("\n");
     const envBlock = spec.pathEnv !== undefined
         ? `  <key>EnvironmentVariables</key>
   <dict>
@@ -77,13 +78,15 @@ export function launchdPlist(execStart, spec) {
   <string>com.${spec.name}</string>
   <key>ProgramArguments</key>
   <array>
-    <string>${execStart}</string>
-${args}
+${argLines}
   </array>
   <key>RunAtLoad</key>
   <true/>
   <key>KeepAlive</key>
-  <true/>
+  <dict>
+    <key>SuccessfulExit</key>
+    <false/>
+  </dict>
 ${envBlock}  <key>StandardOutPath</key>
   <string>${serviceLogPath(spec.name)}</string>
   <key>StandardErrorPath</key>
@@ -103,18 +106,25 @@ async function run(cmd, args) {
 }
 /** 安装并启动服务（用户级）。 */
 export async function installService(spec) {
-    const execStart = `${process.execPath} ${process.argv[1]}`;
+    const bin = process.argv[1];
+    if (bin === undefined) {
+        throw new Error("cannot install a service: the running entry script (process.argv[1]) is unknown");
+    }
     if (isLinux()) {
+        const execStart = `${process.execPath} ${bin}`;
         await mkdir(SYSTEMD_DIR, { recursive: true });
         await writeFile(systemdUnitPath(spec.name), systemdUnit(execStart, spec), { mode: 0o600 });
         await run("systemctl", ["--user", "daemon-reload"]);
         await run("systemctl", ["--user", "enable", "--now", spec.name]);
         return `installed systemd user unit: ${systemdUnitPath(spec.name)}`;
     }
+    // macOS（launchd）：ProgramArguments 不做空格切分 —— node 与脚本必须作为独立 argv 元素
+    const plistPath = launchdPlistPath(spec.name);
     await mkdir(LAUNCHD_DIR, { recursive: true });
-    await writeFile(launchdPlistPath(spec.name), launchdPlist(execStart, spec), { mode: 0o600 });
-    await run("launchctl", ["load", launchdPlistPath(spec.name)]);
-    return `installed launchd plist: ${launchdPlistPath(spec.name)}`;
+    await writeFile(plistPath, launchdPlist([process.execPath, bin], spec), { mode: 0o600 });
+    await run("launchctl", ["unload", plistPath]).catch(() => undefined); // 重装幂等：先卸旧 job（不存在时忽略）
+    await run("launchctl", ["load", plistPath]);
+    return `installed launchd plist: ${plistPath}`;
 }
 /** 服务状态。 */
 export async function serviceStatus(name = SERVICE_NAME) {
@@ -128,8 +138,9 @@ export async function serviceStatus(name = SERVICE_NAME) {
         }
     }
     try {
-        await run("launchctl", ["print", `com.${name}`]);
-        return "active";
+        const out = await run("launchctl", ["print", `com.${name}`]);
+        // loaded 但进程已退出的 job（如 exec 失败）print 仍成功 —— 按 state 细分
+        return out.includes("state = running") ? "active" : "loaded (not running)";
     }
     catch {
         return "unloaded";

package/dist/spawn-dsh.d.ts

@@ -40,9 +40,12 @@ export declare function compareDshVersions(a: string, b: string): number;
 /**
  * remote-dsh 已实测兼容的 dsh 版本窗口（registry 实存版本定界）。
  * ⚠️ 适配新的 dsh 版本并真机实测后，须同步扩展此窗口（见 doc/fix/20260907-dsh-0.1.2-rc1-auth/）。
+ * 2026-09-11：MAX 扩到 `0.1.5-rc.2` —— 真机实测通过（spawn + ready 行 token + 会话 cookie 换发 +
+ * `/api` 转发 + HTML 注入 + WS `/api/remote.mux` 桥接 + join 的 `patchLoopbackJs` 命中），
+ * 见 doc/review/20260911-dsh-0.1.5-rc.2-plugin-compat.md §5。
  */
 export declare const DSH_COMPAT_MIN = "0.1.1-rc.2";
-export declare const DSH_COMPAT_MAX = "0.1.2-rc.1";
+export declare const DSH_COMPAT_MAX = "0.1.5-rc.2";
 /**
  * 版本落在实测窗口外时的提示文案（零文档导向：直接给动作指令，用户不查表）。
  * - 比 max 新 → 升级 remote-dsh 或暂用旧 dsh；

package/dist/spawn-dsh.js

@@ -197,9 +197,12 @@ export function compareDshVersions(a, b) {
 /**
  * remote-dsh 已实测兼容的 dsh 版本窗口（registry 实存版本定界）。
  * ⚠️ 适配新的 dsh 版本并真机实测后，须同步扩展此窗口（见 doc/fix/20260907-dsh-0.1.2-rc1-auth/）。
+ * 2026-09-11：MAX 扩到 `0.1.5-rc.2` —— 真机实测通过（spawn + ready 行 token + 会话 cookie 换发 +
+ * `/api` 转发 + HTML 注入 + WS `/api/remote.mux` 桥接 + join 的 `patchLoopbackJs` 命中），
+ * 见 doc/review/20260911-dsh-0.1.5-rc.2-plugin-compat.md §5。
  */
 export const DSH_COMPAT_MIN = "0.1.1-rc.2";
-export const DSH_COMPAT_MAX = "0.1.2-rc.1";
+export const DSH_COMPAT_MAX = "0.1.5-rc.2";
 /**
  * 版本落在实测窗口外时的提示文案（零文档导向：直接给动作指令，用户不查表）。
  * - 比 max 新 → 升级 remote-dsh 或暂用旧 dsh；

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rdsh-gateway",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "rdsh host-side component: LAN auth gateway + outbound tunnel endpoint (spawns dsh web)",
   "license": "MIT",
   "type": "module",