aws-runtime-bridge 1.9.77 → 1.9.78

package/dist/services/cli-commands.d.ts

@@ -1,4 +1,5 @@
 import type { StartupConfigWizardResult } from "./startup-config-wizard.js";
+import { type WindowsServiceManager } from "./windows-service-manager.js";
 export interface CliCommandResult {
     handled: boolean;
     exitCode: number;
@@ -19,8 +20,10 @@ export interface CliCommandOptions {
     platform?: NodeJS.Platform;
     serviceUnitPath?: string;
     executablePath?: string;
-    /** Windows 服务日志文件路径（默认 ProgramData 下的 awsb-service.log），供 install 重定向与 log 读取。 */
+    /** Windows 服务日志文件路径（默认 ProgramData 下的 awsb.out.log），供 install 重定向与 log 读取。 */
     windowsServiceLogPath?: string;
+    /** Windows 服务管理器（基于 node-windows），用于 install 操作；测试时可注入 mock。 */
+    windowsServiceManager?: WindowsServiceManager;
     /** 检测正在运行的 bridge 进程 PID 列表（默认按平台用 pgrep / powershell）。 */
     findRunningBridgeProcesses?: (platform: NodeJS.Platform) => number[];
     /** 关闭指定 PID 的进程（默认按平台用 kill -9 / taskkill）。 */

package/dist/services/cli-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-commands.d.ts","sourceRoot":"","sources":["../../src/services/cli-commands.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAqB5E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,gBAAgB,CAAC;IACnE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACrD,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,0BAA0B,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;IACrE,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC;IACrE,oCAAoC;IACpC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD;AAYD,wBAAgB,kBAAkB,CAAC,WAAW,SAA0B,GAAG,MAAM,CAMhF;AAgCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAsBvE;AAkuBD,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA8C3B"}
+{"version":3,"file":"cli-commands.d.ts","sourceRoot":"","sources":["../../src/services/cli-commands.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAK5E,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAkBtC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,gBAAgB,CAAC;IACnE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACrD,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gEAAgE;IAChE,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,2DAA2D;IAC3D,0BAA0B,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;IACrE,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC;IACrE,oCAAoC;IACpC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD;AAYD,wBAAgB,kBAAkB,CAAC,WAAW,SAA0B,GAAG,MAAM,CAMhF;AAgCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAsBvE;AA8sBD,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA8C3B"}

package/dist/services/cli-commands.js

@@ -4,13 +4,15 @@ import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, } from
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { configureStartupConfig, printConfigExampleCommand, } from "./startup-config-wizard.js";
+import { createWindowsServiceManager, isNodeWindowsAvailable, } from "./windows-service-manager.js";
 const SYSTEMD_SERVICE_NAME = "awsb.service";
 const DEFAULT_SYSTEMD_UNIT_PATH = `/etc/systemd/system/${SYSTEMD_SERVICE_NAME}`;
 const WINDOWS_SERVICE_NAME = "awsb";
-// Windows 服务日志：install 时用 nssm 的 AppStdout/AppStderr 把 node 输出重定向到此文件，
-// `awsb log` 再读取它。路径放在 ProgramData 下，保证安装用户与服务运行账户（LocalSystem）都能访问。
+// Windows 服务日志：node-windows (WinSW) 的 logpath 配置项将日志输出到此目录，
+// 生成 awsb.out.log（stdout）和 awsb.err.log（stderr）。
+// 路径放在 ProgramData 下，保证安装用户与服务运行账户（LocalSystem）都能访问。
 const WINDOWS_SERVICE_LOG_DIR = path.join(process.env.ProgramData || "C:\\ProgramData", "aws-runtime-bridge", "logs");
-const WINDOWS_SERVICE_LOG_PATH = path.join(WINDOWS_SERVICE_LOG_DIR, "awsb-service.log");
+const WINDOWS_SERVICE_LOG_PATH = path.join(WINDOWS_SERVICE_LOG_DIR, "awsb.out.log");
 function getDefaultPackageRoot() {
     const currentFile = fileURLToPath(import.meta.url);
     return path.resolve(path.dirname(currentFile), "..", "..");
@@ -273,100 +275,98 @@ function stopSystemdService(options) {
     options.stdout("[runtime-bridge] awsb systemd 服务已停止。");
     return { handled: true, exitCode: 0 };
 }
-function findNssmCommand(options) {
-    const probe = options.runCommand("nssm", ["version"]);
-    return commandSucceeded(probe) ? "nssm" : null;
-}
-function nssmMissingError(options) {
-    options.stderr("[runtime-bridge] 未检测到 nssm（Windows 服务包装器）。在 Windows 上把 node 程序" +
-        "注册为真正的服务必须借助 nssm 实现 SCM 协议，否则会像之前一样“启动失败”。请先安装 nssm：\n" +
-        "    winget install nssm\n" +
-        "  或  choco install nssm\n" +
-        "  或访问 https://nssm.cc 下载 nssm.exe 并放入 PATH，然后重试。");
+/**
+ * Windows 服务通过 node-windows（内置 WinSW 包装器）实现 SCM 协议适配。
+ * 用户 `npm install -g aws-runtime-bridge` 时自动获得 node-windows，无需额外安装 nssm。
+ *
+ * - install: 用 node-windows 注册服务（WinSW 包装器处理 SCM 协议）；
+ * - uninstall/start/stop/restart: 用 sc.exe（Windows 原生命令）直接操作 SCM。
+ */
+function nodeWindowsMissingError(stderr) {
+    stderr("[runtime-bridge] 未检测到 node-windows 模块。请重新安装 aws-runtime-bridge：\n" +
+        "    npm install -g aws-runtime-bridge");
     return { handled: true, exitCode: 1 };
 }
 /**
- * 用 nssm 安装并启动 Windows 服务。
- * - nssm install 把 `node <executablePath>` 注册为真正的 Windows 服务（SCM 协议由 nssm 实现）；
- * - 安装前先 remove 一次，清理可能由旧 `New-Service` 方式残留的坏服务；
- * - AppStdout/AppStderr 把输出写入 ProgramData 下的日志文件，供 `awsb log` 读取。
- * 日志目录创建失败不阻断安装（nssm 启动时按需创建）。
+ * 用 node-windows 安装并启动 Windows 服务。
+ * - node-windows 在 script 所在目录下创建 daemon/ 子目录（含 WinSW 包装器和 XML 配置）；
+ * - logpath 配置项将日志输出到 ProgramData 下的指定目录，供 `awsb log` 读取；
+ * - 安装后用 sc.exe start 启动服务。
  */
-function installWindowsService(options) {
-    const nssm = findNssmCommand(options);
-    if (!nssm) {
-        return nssmMissingError(options);
+async function installWindowsService(options) {
+    // 测试时可注入 mock manager；生产环境用 node-windows 默认实现
+    const manager = options.windowsServiceManager;
+    if (!manager && !isNodeWindowsAvailable()) {
+        return nodeWindowsMissingError(options.stderr);
     }
     const logPath = options.windowsServiceLogPath || WINDOWS_SERVICE_LOG_PATH;
     const execDir = path.dirname(options.executablePath);
     try {
-        mkdirSync(WINDOWS_SERVICE_LOG_DIR, { recursive: true });
+        const actualManager = manager || createWindowsServiceManager();
+        await actualManager.install({
+            name: WINDOWS_SERVICE_NAME,
+            description: "awsb runtime bridge",
+            script: options.executablePath,
+            workingDirectory: execDir,
+            env: [{ name: "AWS_BRIDGE_SKIP_SETUP", value: "true" }],
+            logpath: WINDOWS_SERVICE_LOG_DIR,
+        });
     }
-    catch {
-        // 日志目录创建失败不阻断安装
-    }
-    const run = (args) => options.runCommand(nssm, args);
-    // 清理可能残留的旧服务（含非 nssm 创建的），忽略失败
-    run(["remove", WINDOWS_SERVICE_NAME, "confirm"]);
-    run(["install", WINDOWS_SERVICE_NAME, process.execPath, options.executablePath]);
-    run(["set", WINDOWS_SERVICE_NAME, "AppDirectory", execDir]);
-    run(["set", WINDOWS_SERVICE_NAME, "DisplayName", "awsb runtime bridge"]);
-    run(["set", WINDOWS_SERVICE_NAME, "Start", "SERVICE_AUTO_START"]);
-    run(["set", WINDOWS_SERVICE_NAME, "AppStdout", logPath]);
-    run(["set", WINDOWS_SERVICE_NAME, "AppStderr", logPath]);
-    run(["set", WINDOWS_SERVICE_NAME, "AppRotateFiles", "1"]);
-    run(["set", WINDOWS_SERVICE_NAME, "AppRotateBytes", "1048576"]);
-    const startResult = run(["start", WINDOWS_SERVICE_NAME]);
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        options.stderr(`[runtime-bridge] 安装 Windows 服务失败: ${err.message}`);
+        return { handled: true, exitCode: 1 };
+    }
+    // 安装成功后启动服务
+    const startResult = options.runCommand("sc.exe", [
+        "start",
+        WINDOWS_SERVICE_NAME,
+    ]);
     if (!commandSucceeded(startResult)) {
-        options.stderr(`[runtime-bridge] 安装/启动 Windows 服务失败: ${startResult.error?.message ?? `退出码 ${startResult.status ?? "unknown"}`}`);
+        options.stderr(`[runtime-bridge] 启动 Windows 服务失败: ${startResult.error?.message ?? `退出码 ${startResult.status ?? "unknown"}`}`);
         return { handled: true, exitCode: startResult.status ?? 1 };
     }
     options.stdout(`[runtime-bridge] awsb Windows 服务已安装并已启动（日志: ${logPath}）。`);
     return { handled: true, exitCode: 0 };
 }
 /**
- * 卸载 Windows 服务（nssm stop + nssm remove）。
+ * 卸载 Windows 服务（sc.exe stop + sc.exe delete）。
  */
 function uninstallWindowsService(options) {
-    const nssm = findNssmCommand(options);
-    if (!nssm) {
-        return nssmMissingError(options);
-    }
-    const run = (args) => options.runCommand(nssm, args);
-    run(["stop", WINDOWS_SERVICE_NAME]); // 未运行则忽略
-    const removeResult = run(["remove", WINDOWS_SERVICE_NAME, "confirm"]);
-    if (!commandSucceeded(removeResult)) {
-        options.stderr(`[runtime-bridge] 卸载 Windows 服务失败: ${removeResult.error?.message ?? `退出码 ${removeResult.status ?? "unknown"}`}`);
-        return { handled: true, exitCode: removeResult.status ?? 1 };
+    const run = (args) => options.runCommand("sc.exe", args);
+    // 先尝试停止（服务可能未运行，忽略失败）
+    run(["stop", WINDOWS_SERVICE_NAME]);
+    const deleteResult = run(["delete", WINDOWS_SERVICE_NAME]);
+    if (!commandSucceeded(deleteResult)) {
+        options.stderr(`[runtime-bridge] 卸载 Windows 服务失败: ${deleteResult.error?.message ?? `退出码 ${deleteResult.status ?? "unknown"}`}`);
+        return { handled: true, exitCode: deleteResult.status ?? 1 };
     }
     options.stdout("[runtime-bridge] awsb Windows 服务已卸载。");
     return { handled: true, exitCode: 0 };
 }
 /**
- * 重启 Windows 服务（nssm restart，未运行会被启动）。
+ * 重启 Windows 服务（sc.exe stop + sc.exe start，未运行会被启动）。
  */
 function restartWindowsService(options) {
-    const nssm = findNssmCommand(options);
-    if (!nssm) {
-        return nssmMissingError(options);
-    }
-    const result = options.runCommand(nssm, ["restart", WINDOWS_SERVICE_NAME]);
-    if (!commandSucceeded(result)) {
-        options.stderr(`[runtime-bridge] 重启 Windows 服务失败: ${result.error?.message ?? `退出码 ${result.status ?? "unknown"}`}`);
-        return { handled: true, exitCode: result.status ?? 1 };
+    const run = (args) => options.runCommand("sc.exe", args);
+    // 先停止（可能未运行，忽略失败）
+    run(["stop", WINDOWS_SERVICE_NAME]);
+    const startResult = run(["start", WINDOWS_SERVICE_NAME]);
+    if (!commandSucceeded(startResult)) {
+        options.stderr(`[runtime-bridge] 重启 Windows 服务失败: ${startResult.error?.message ?? `退出码 ${startResult.status ?? "unknown"}`}`);
+        return { handled: true, exitCode: startResult.status ?? 1 };
     }
     options.stdout("[runtime-bridge] awsb Windows 服务已重启。");
     return { handled: true, exitCode: 0 };
 }
 /**
- * 启动 Windows 服务（nssm start）。
+ * 启动 Windows 服务（sc.exe start）。
  */
 function startWindowsService(options) {
-    const nssm = findNssmCommand(options);
-    if (!nssm) {
-        return nssmMissingError(options);
-    }
-    const result = options.runCommand(nssm, ["start", WINDOWS_SERVICE_NAME]);
+    const result = options.runCommand("sc.exe", [
+        "start",
+        WINDOWS_SERVICE_NAME,
+    ]);
     if (!commandSucceeded(result)) {
         options.stderr(`[runtime-bridge] 启动 Windows 服务失败: ${result.error?.message ?? `退出码 ${result.status ?? "unknown"}`}`);
         return { handled: true, exitCode: result.status ?? 1 };
@@ -375,14 +375,13 @@ function startWindowsService(options) {
     return { handled: true, exitCode: 0 };
 }
 /**
- * 停止 Windows 服务（nssm stop）。
+ * 停止 Windows 服务（sc.exe stop）。
  */
 function stopWindowsService(options) {
-    const nssm = findNssmCommand(options);
-    if (!nssm) {
-        return nssmMissingError(options);
-    }
-    const result = options.runCommand(nssm, ["stop", WINDOWS_SERVICE_NAME]);
+    const result = options.runCommand("sc.exe", [
+        "stop",
+        WINDOWS_SERVICE_NAME,
+    ]);
     if (!commandSucceeded(result)) {
         options.stderr(`[runtime-bridge] 停止 Windows 服务失败: ${result.error?.message ?? `退出码 ${result.status ?? "unknown"}`}`);
         return { handled: true, exitCode: result.status ?? 1 };
@@ -390,7 +389,7 @@ function stopWindowsService(options) {
     options.stdout("[runtime-bridge] awsb Windows 服务已停止。");
     return { handled: true, exitCode: 0 };
 }
-function handleServiceCommand(argv, options, stdout, stderr) {
+async function handleServiceCommand(argv, options, stdout, stderr) {
     const subcommand = argv[1];
     if (!subcommand ||
         subcommand === "-h" ||
@@ -406,6 +405,7 @@ function handleServiceCommand(argv, options, stdout, stderr) {
         platform: options.platform || process.platform,
         serviceUnitPath: options.serviceUnitPath || DEFAULT_SYSTEMD_UNIT_PATH,
         executablePath: options.executablePath || getDefaultExecutablePath(),
+        windowsServiceManager: options.windowsServiceManager,
     };
     // 仅 Linux systemd 与 Windows 服务支持 install/uninstall/restart
     if (serviceOptions.platform !== "linux" &&
@@ -415,7 +415,7 @@ function handleServiceCommand(argv, options, stdout, stderr) {
     }
     if (subcommand === "install") {
         return serviceOptions.platform === "win32"
-            ? installWindowsService(serviceOptions)
+            ? await installWindowsService(serviceOptions)
             : installSystemdService(serviceOptions);
     }
     if (subcommand === "uninstall") {
@@ -636,7 +636,7 @@ export async function handleCliCommand(options = {}) {
         };
     }
     if (command === "service") {
-        return handleServiceCommand(argv, options, stdout, stderr);
+        return await handleServiceCommand(argv, options, stdout, stderr);
     }
     if (command === "log") {
         return handleLogCommand(options, stdout, stderr);

package/dist/services/windows-service-manager.d.ts

@@ -0,0 +1,28 @@
+/**
+ * node-windows 封装模块。
+ *
+ * node-windows 内部使用 WinSW（.NET 服务包装器）实现 SCM 协议适配，
+ * 用户 `npm install -g aws-runtime-bridge` 时自动获得，无需额外安装 nssm。
+ *
+ * 关键行为：
+ * - install 时在 `path.dirname(script)/daemon/` 下创建 winsw.exe + XML 配置；
+ * - `logpath` 配置项控制日志输出目录（WinSW 生成 `<id>.out.log` / `<id>.err.log`）；
+ * - `id` = `name.replace(/[^\w]/gi,'').toLowerCase()`，对 "awsb" → "awsb"。
+ */
+export interface WindowsServiceConfig {
+    name: string;
+    description: string;
+    script: string;
+    workingDirectory?: string;
+    env?: {
+        name: string;
+        value: string;
+    }[];
+    logpath?: string;
+}
+export interface WindowsServiceManager {
+    install(config: WindowsServiceConfig): Promise<void>;
+}
+export declare function isNodeWindowsAvailable(): boolean;
+export declare function createWindowsServiceManager(): WindowsServiceManager;
+//# sourceMappingURL=windows-service-manager.d.ts.map

package/dist/services/windows-service-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-service-manager.d.ts","sourceRoot":"","sources":["../../src/services/windows-service-manager.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAiBD,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,2BAA2B,IAAI,qBAAqB,CAkCnE"}

package/dist/services/windows-service-manager.js

@@ -0,0 +1,54 @@
+import { createRequire } from "node:module";
+import { mkdirSync } from "node:fs";
+// node-windows 是 CommonJS 包，在 ESM 中通过 createRequire 懒加载。
+// 非Windows 平台或包未安装时返回 null。
+let cachedServiceCtor;
+function getNodeWindowsServiceCtor() {
+    if (cachedServiceCtor !== undefined)
+        return cachedServiceCtor;
+    try {
+        const require = createRequire(import.meta.url);
+        cachedServiceCtor = require("node-windows").Service;
+    }
+    catch {
+        cachedServiceCtor = null;
+    }
+    return cachedServiceCtor;
+}
+export function isNodeWindowsAvailable() {
+    return getNodeWindowsServiceCtor() !== null;
+}
+export function createWindowsServiceManager() {
+    return {
+        async install(config) {
+            const ServiceCtor = getNodeWindowsServiceCtor();
+            if (!ServiceCtor) {
+                throw new Error("node-windows 未安装。请重新安装 aws-runtime-bridge：npm install -g aws-runtime-bridge");
+            }
+            // 确保日志目录存在
+            if (config.logpath) {
+                try {
+                    mkdirSync(config.logpath, { recursive: true });
+                }
+                catch {
+                    // 日志目录创建失败不阻断安装
+                }
+            }
+            const svc = new ServiceCtor({
+                name: config.name,
+                description: config.description,
+                script: config.script,
+                workingDirectory: config.workingDirectory,
+                env: config.env,
+                logpath: config.logpath,
+                logmode: "rotate",
+            });
+            await new Promise((resolve, reject) => {
+                svc.on("install", () => resolve());
+                svc.on("alreadyinstalled", () => resolve());
+                svc.on("error", (err) => reject(err));
+                svc.install();
+            });
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aws-runtime-bridge",
-  "version": "1.9.77",
+  "version": "1.9.78",
   "description": "AgentsWorkStudio runtime bridge service for machine-level agent runtime integration",
   "type": "module",
   "main": "dist/index.js",
@@ -25,6 +25,9 @@
   "bundleDependencies": [
     "@cc-switch/sdk"
   ],
+  "optionalDependencies": {
+    "node-windows": "^1.0.0-beta.8"
+  },
   "engines": {
     "node": ">=20.0.0 <25"
   },