aws-runtime-bridge 1.9.74 → 1.9.75

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

@@ -17,6 +17,14 @@ export interface CliCommandOptions {
     platform?: NodeJS.Platform;
     serviceUnitPath?: string;
     executablePath?: string;
+    /** Windows 服务日志文件路径（默认 ProgramData 下的 awsb-service.log），供 install 重定向与 log 读取。 */
+    windowsServiceLogPath?: string;
+    /** 检测正在运行的 bridge 进程 PID 列表（默认按平台用 pgrep / powershell）。 */
+    findRunningBridgeProcesses?: (platform: NodeJS.Platform) => number[];
+    /** 关闭指定 PID 的进程（默认按平台用 kill -9 / taskkill）。 */
+    killBridgeProcess?: (pid: number, platform: NodeJS.Platform) => void;
+    /** 交互式询问，返回用户输入（默认从 stdin 读取一行）。 */
+    prompt?: (question: string) => Promise<string>;
 }
 export declare function readPackageVersion(packageRoot?: string): string;
 /**

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":"AAWA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAM5E,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,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAYD,wBAAgB,kBAAkB,CAAC,WAAW,SAA0B,GAAG,MAAM,CAMhF;AAgCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAsBvE;AAwOD,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAgD3B"}
+{"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;AAsB5E,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,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;AA+rBD,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA8B3B"}

package/dist/services/cli-commands.js

@@ -1,10 +1,17 @@
 import { spawnSync } from "node:child_process";
+import { createInterface } from "node:readline/promises";
 import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { configureStartupConfig } from "./startup-config-wizard.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 时用 cmd 包装脚本把 node 输出重定向到此文件，
+// `awsb log` 再读取它。路径放在 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_WRAPPER_PATH = path.join(WINDOWS_SERVICE_LOG_DIR, "awsb-service.cmd");
 function getDefaultPackageRoot() {
     const currentFile = fileURLToPath(import.meta.url);
     return path.resolve(path.dirname(currentFile), "..", "..");
@@ -83,7 +90,7 @@ function ensureLinuxSystemd(platform, stderr) {
     return false;
 }
 function printServiceUsage(stdout) {
-    stdout("Usage: awsb service <install|uninstall>");
+    stdout("Usage: awsb service <install|uninstall|start|stop|restart>");
 }
 /**
  * 安装 systemd 服务，主干流程是写入 unit、重载 systemd、启用开机自启，并在未运行时启动服务。
@@ -198,6 +205,173 @@ function uninstallSystemdService(options) {
     options.stdout("[runtime-bridge] awsb systemd 服务已卸载。");
     return { handled: true, exitCode: 0 };
 }
+/**
+ * 重启 systemd 服务，即执行 systemctl restart awsb.service。
+ * 若 unit 尚未安装，提示先执行 install。
+ */
+function restartSystemdService(options) {
+    if (!ensureLinuxSystemd(options.platform, options.stderr)) {
+        return { handled: true, exitCode: 1 };
+    }
+    if (!existsSync(options.serviceUnitPath)) {
+        options.stderr("[runtime-bridge] awsb systemd 服务尚未安装，请先执行 `awsb service install`。");
+        return { handled: true, exitCode: 1 };
+    }
+    const restartResult = runSystemctl(options.runCommand, [
+        "restart",
+        SYSTEMD_SERVICE_NAME,
+    ]);
+    if (!commandSucceeded(restartResult)) {
+        options.stderr(systemctlFailureMessage("重启 awsb 服务", restartResult));
+        return { handled: true, exitCode: restartResult.status ?? 1 };
+    }
+    options.stdout("[runtime-bridge] awsb systemd 服务已重启。");
+    return { handled: true, exitCode: 0 };
+}
+/**
+ * 启动 systemd 服务，即执行 systemctl start awsb.service。
+ * 若 unit 尚未安装，提示先执行 install。
+ */
+function startSystemdService(options) {
+    if (!ensureLinuxSystemd(options.platform, options.stderr)) {
+        return { handled: true, exitCode: 1 };
+    }
+    if (!existsSync(options.serviceUnitPath)) {
+        options.stderr("[runtime-bridge] awsb systemd 服务尚未安装，请先执行 `awsb service install`。");
+        return { handled: true, exitCode: 1 };
+    }
+    const startResult = runSystemctl(options.runCommand, [
+        "start",
+        SYSTEMD_SERVICE_NAME,
+    ]);
+    if (!commandSucceeded(startResult)) {
+        options.stderr(systemctlFailureMessage("启动 awsb 服务", startResult));
+        return { handled: true, exitCode: startResult.status ?? 1 };
+    }
+    options.stdout("[runtime-bridge] awsb systemd 服务已启动。");
+    return { handled: true, exitCode: 0 };
+}
+/**
+ * 停止 systemd 服务，即执行 systemctl stop awsb.service。
+ * 若 unit 尚未安装，提示先执行 install。
+ */
+function stopSystemdService(options) {
+    if (!ensureLinuxSystemd(options.platform, options.stderr)) {
+        return { handled: true, exitCode: 1 };
+    }
+    if (!existsSync(options.serviceUnitPath)) {
+        options.stderr("[runtime-bridge] awsb systemd 服务尚未安装，请先执行 `awsb service install`。");
+        return { handled: true, exitCode: 1 };
+    }
+    const stopResult = runSystemctl(options.runCommand, [
+        "stop",
+        SYSTEMD_SERVICE_NAME,
+    ]);
+    if (!commandSucceeded(stopResult)) {
+        options.stderr(systemctlFailureMessage("停止 awsb 服务", stopResult));
+        return { handled: true, exitCode: stopResult.status ?? 1 };
+    }
+    options.stdout("[runtime-bridge] awsb systemd 服务已停止。");
+    return { handled: true, exitCode: 0 };
+}
+/**
+ * 安装并启动 Windows 服务（通过 PowerShell 的 New-Service / Start-Service）。
+ * 服务以 `cmd /c wrapper.cmd` 运行，wrapper 把 node 的 stdout/stderr 重定向到日志文件，
+ * 等价于 systemd 的 ExecStart + 日志采集，供 `awsb log` 读取。
+ * 日志重定向为尽力而为：若日志目录/包装脚本创建失败，则回退为直接运行 node，
+ * 此时 `awsb log` 会提示无日志文件，但服务仍可正常安装。
+ */
+function installWindowsService(options) {
+    const logPath = options.windowsServiceLogPath || WINDOWS_SERVICE_LOG_PATH;
+    let binPath = `"${process.execPath}" "${options.executablePath}"`;
+    try {
+        mkdirSync(WINDOWS_SERVICE_LOG_DIR, { recursive: true });
+        const wrapperContent = `@echo off\r\n` +
+            `"${process.execPath}" "${options.executablePath}" >> "${logPath}" 2>&1\r\n`;
+        writeFileSync(WINDOWS_SERVICE_WRAPPER_PATH, wrapperContent, {
+            encoding: "utf-8",
+        });
+        const cmdExe = path.join(process.env.SystemRoot || "C:\\Windows", "System32", "cmd.exe");
+        binPath = `"${cmdExe}" /c "${WINDOWS_SERVICE_WRAPPER_PATH}"`;
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        options.stderr(`[runtime-bridge] 无法配置日志重定向（将直接运行，awsb log 可能无文件可读）: ${err.message}`);
+    }
+    const script = `if (Get-Service -Name ${WINDOWS_SERVICE_NAME} -ErrorAction SilentlyContinue) { ` +
+        `Set-Service -Name ${WINDOWS_SERVICE_NAME} -StartupType Automatic -BinaryPathName '${binPath}' } ` +
+        `else { New-Service -Name ${WINDOWS_SERVICE_NAME} -BinaryPathName '${binPath}' -StartupType Automatic }; ` +
+        `Start-Service -Name ${WINDOWS_SERVICE_NAME}`;
+    const result = options.runCommand("powershell", ["-NoProfile", "-Command", script]);
+    if (!commandSucceeded(result)) {
+        options.stderr(`[runtime-bridge] 安装/启动 Windows 服务失败: ${result.error?.message ?? `退出码 ${result.status ?? "unknown"}`}`);
+        return { handled: true, exitCode: result.status ?? 1 };
+    }
+    options.stdout(`[runtime-bridge] awsb Windows 服务已安装并已启动（日志: ${logPath}）。`);
+    return { handled: true, exitCode: 0 };
+}
+/**
+ * 卸载 Windows 服务（Stop-Service + Remove-Service）。
+ */
+function uninstallWindowsService(options) {
+    const script = `Stop-Service -Name ${WINDOWS_SERVICE_NAME} -Force -ErrorAction SilentlyContinue; ` +
+        `Remove-Service -Name ${WINDOWS_SERVICE_NAME} -ErrorAction SilentlyContinue`;
+    const result = options.runCommand("powershell", ["-NoProfile", "-Command", script]);
+    if (!commandSucceeded(result)) {
+        options.stderr(`[runtime-bridge] 卸载 Windows 服务失败: ${result.error?.message ?? `退出码 ${result.status ?? "unknown"}`}`);
+        return { handled: true, exitCode: result.status ?? 1 };
+    }
+    options.stdout("[runtime-bridge] awsb Windows 服务已卸载。");
+    return { handled: true, exitCode: 0 };
+}
+/**
+ * 重启 Windows 服务（Restart-Service，未运行时会被启动）。
+ */
+function restartWindowsService(options) {
+    const result = options.runCommand("powershell", [
+        "-NoProfile",
+        "-Command",
+        `Restart-Service -Name ${WINDOWS_SERVICE_NAME}`,
+    ]);
+    if (!commandSucceeded(result)) {
+        options.stderr(`[runtime-bridge] 重启 Windows 服务失败: ${result.error?.message ?? `退出码 ${result.status ?? "unknown"}`}`);
+        return { handled: true, exitCode: result.status ?? 1 };
+    }
+    options.stdout("[runtime-bridge] awsb Windows 服务已重启。");
+    return { handled: true, exitCode: 0 };
+}
+/**
+ * 启动 Windows 服务（Start-Service）。
+ */
+function startWindowsService(options) {
+    const result = options.runCommand("powershell", [
+        "-NoProfile",
+        "-Command",
+        `Start-Service -Name ${WINDOWS_SERVICE_NAME}`,
+    ]);
+    if (!commandSucceeded(result)) {
+        options.stderr(`[runtime-bridge] 启动 Windows 服务失败: ${result.error?.message ?? `退出码 ${result.status ?? "unknown"}`}`);
+        return { handled: true, exitCode: result.status ?? 1 };
+    }
+    options.stdout("[runtime-bridge] awsb Windows 服务已启动。");
+    return { handled: true, exitCode: 0 };
+}
+/**
+ * 停止 Windows 服务（Stop-Service -Force）。
+ */
+function stopWindowsService(options) {
+    const result = options.runCommand("powershell", [
+        "-NoProfile",
+        "-Command",
+        `Stop-Service -Name ${WINDOWS_SERVICE_NAME} -Force`,
+    ]);
+    if (!commandSucceeded(result)) {
+        options.stderr(`[runtime-bridge] 停止 Windows 服务失败: ${result.error?.message ?? `退出码 ${result.status ?? "unknown"}`}`);
+        return { handled: true, exitCode: result.status ?? 1 };
+    }
+    options.stdout("[runtime-bridge] awsb Windows 服务已停止。");
+    return { handled: true, exitCode: 0 };
+}
 function handleServiceCommand(argv, options, stdout, stderr) {
     const subcommand = argv[1];
     if (!subcommand ||
@@ -215,16 +389,205 @@ function handleServiceCommand(argv, options, stdout, stderr) {
         serviceUnitPath: options.serviceUnitPath || DEFAULT_SYSTEMD_UNIT_PATH,
         executablePath: options.executablePath || getDefaultExecutablePath(),
     };
+    // 仅 Linux systemd 与 Windows 服务支持 install/uninstall/restart
+    if (serviceOptions.platform !== "linux" &&
+        serviceOptions.platform !== "win32") {
+        stderr("[runtime-bridge] service 命令仅支持 Linux systemd 与 Windows 服务环境。");
+        return { handled: true, exitCode: 1 };
+    }
     if (subcommand === "install") {
-        return installSystemdService(serviceOptions);
+        return serviceOptions.platform === "win32"
+            ? installWindowsService(serviceOptions)
+            : installSystemdService(serviceOptions);
     }
     if (subcommand === "uninstall") {
-        return uninstallSystemdService(serviceOptions);
+        return serviceOptions.platform === "win32"
+            ? uninstallWindowsService(serviceOptions)
+            : uninstallSystemdService(serviceOptions);
+    }
+    if (subcommand === "restart") {
+        return serviceOptions.platform === "win32"
+            ? restartWindowsService(serviceOptions)
+            : restartSystemdService(serviceOptions);
+    }
+    if (subcommand === "start") {
+        return serviceOptions.platform === "win32"
+            ? startWindowsService(serviceOptions)
+            : startSystemdService(serviceOptions);
+    }
+    if (subcommand === "stop") {
+        return serviceOptions.platform === "win32"
+            ? stopWindowsService(serviceOptions)
+            : stopSystemdService(serviceOptions);
     }
     stderr(`[runtime-bridge] 未知 service 子命令: ${subcommand}`);
     printServiceUsage(stdout);
     return { handled: true, exitCode: 1 };
 }
+function parsePids(raw) {
+    if (!raw) {
+        return [];
+    }
+    return raw
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => /^\d+$/.test(line))
+        .map(Number);
+}
+/**
+ * 默认进程检测：列出正在运行且与当前进程不同的 bridge 实例 PID。
+ * - Windows: 通过 PowerShell 查询命令行包含 aws-runtime-bridge 的 node.exe。
+ * - Linux/macOS: 通过 pgrep -f aws-runtime-bridge。
+ * 任何异常都返回空数组，避免更新流程被检测逻辑阻断。
+ */
+function defaultFindRunningBridgeProcesses(platform) {
+    try {
+        if (platform === "win32") {
+            const result = spawnSync("powershell", [
+                "-NoProfile",
+                "-Command",
+                `Get-CimInstance Win32_Process -Filter "Name='node.exe'" | ` +
+                    `Where-Object { $_.CommandLine -like '*aws-runtime-bridge*' -and $_.ProcessId -ne ${process.pid} } | ` +
+                    `ForEach-Object { $_.ProcessId }`,
+            ], { encoding: "utf-8" });
+            return parsePids(result.stdout);
+        }
+        const result = spawnSync("pgrep", ["-f", "aws-runtime-bridge"], {
+            encoding: "utf-8",
+        });
+        return parsePids(result.stdout).filter((pid) => pid !== process.pid);
+    }
+    catch {
+        return [];
+    }
+}
+function defaultKillBridgeProcess(pid, platform) {
+    if (platform === "win32") {
+        // /T 结束进程树，/F 强制
+        spawnSync("taskkill", ["/PID", String(pid), "/F", "/T"], {
+            stdio: "ignore",
+        });
+        return;
+    }
+    // Linux/macOS：直接 SIGKILL。注意若进程由 systemd 托管，kill 后可能被自动拉起。
+    spawnSync("kill", ["-9", String(pid)], { stdio: "ignore" });
+}
+function defaultPrompt(question) {
+    if (!process.stdin.isTTY) {
+        // 非交互环境（管道 / CI）不要挂起，默认不关闭进程。
+        return Promise.resolve("n");
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return rl.question(question).finally(() => rl.close());
+}
+/**
+ * 更新 aws-runtime-bridge：
+ * 1. 检测是否有正在运行的实例；
+ * 2. 若有，询问用户是否关闭（y 关闭 / 其他 不关闭）；
+ * 3. 关闭后再安装；若不关闭，则以 --force 强制安装（文件被占用可能仍有警告）。
+ */
+async function handleUpdateCommand(options, stdout, stderr) {
+    const runCommand = options.runCommand || defaultRunCommand;
+    const platform = options.platform || process.platform;
+    const findProcesses = options.findRunningBridgeProcesses || defaultFindRunningBridgeProcesses;
+    const prompt = options.prompt || defaultPrompt;
+    const killProcess = options.killBridgeProcess || defaultKillBridgeProcess;
+    stdout("[runtime-bridge] 正在更新 aws-runtime-bridge 到最新版本...");
+    const running = findProcesses(platform).filter((pid) => pid !== process.pid);
+    let forceInstall = false;
+    if (running.length > 0) {
+        stdout(`[runtime-bridge] 检测到 aws-runtime-bridge 正在运行 (PID: ${running.join(", ")})，` +
+            "更新时这些进程可能占用文件导致覆盖失败。");
+        const answer = (await prompt("是否关闭上述进程以继续更新? (y/N) ")).trim().toLowerCase();
+        if (answer === "y" || answer === "yes") {
+            for (const pid of running) {
+                try {
+                    killProcess(pid, platform);
+                    stdout(`[runtime-bridge] 已关闭进程 PID: ${pid}`);
+                }
+                catch (error) {
+                    const err = error instanceof Error ? error : new Error(String(error));
+                    stderr(`[runtime-bridge] 关闭进程 PID ${pid} 失败: ${err.message}`);
+                }
+            }
+        }
+        else {
+            forceInstall = true;
+            stdout("[runtime-bridge] 已选择不关闭进程，将以 --force 方式强制安装（若文件仍被占用可能会有警告）。");
+        }
+    }
+    const args = ["install", "-g", "aws-runtime-bridge@latest", "--omit=optional"];
+    if (forceInstall) {
+        args.push("--force");
+    }
+    const result = runCommand("npm", args);
+    if (result.error) {
+        stderr(`[runtime-bridge] 更新失败: ${result.error.message}`);
+        return { handled: true, exitCode: 1 };
+    }
+    if (result.status !== 0) {
+        stderr(`[runtime-bridge] 更新失败，npm 退出码: ${result.status ?? "unknown"}`);
+        return { handled: true, exitCode: result.status ?? 1 };
+    }
+    stdout("[runtime-bridge] 更新完成。请重新运行 awsb -v 查看当前版本。");
+    return { handled: true, exitCode: 0 };
+}
+/**
+ * 查看 awsb 服务日志。
+ * - Linux systemd：journalctl -u awsb.service（支持 --follow 实时跟踪）。
+ * - Windows：读取 install 时重定向到磁盘的日志文件（支持 --follow 实时跟踪）。
+ * 非服务环境（未安装 / 不支持的平台）给出明确提示。
+ */
+function handleLogCommand(options, stdout, stderr) {
+    const argv = options.argv || process.argv.slice(2);
+    const follow = argv
+        .slice(1)
+        .some((arg) => arg === "--follow" || arg === "-f");
+    const platform = options.platform || process.platform;
+    const runCommand = options.runCommand || defaultRunCommand;
+    const unitPath = options.serviceUnitPath || DEFAULT_SYSTEMD_UNIT_PATH;
+    if (platform === "linux") {
+        if (!existsSync(unitPath)) {
+            stderr("[runtime-bridge] awsb 服务尚未安装（awsb service install），无日志可查看。");
+            return { handled: true, exitCode: 1 };
+        }
+        const args = ["-u", SYSTEMD_SERVICE_NAME];
+        if (follow) {
+            args.push("-f");
+        }
+        else {
+            args.push("-n", "200", "--no-pager");
+        }
+        const result = runCommand("journalctl", args);
+        if (result.error) {
+            stderr(`[runtime-bridge] 读取日志失败: ${result.error.message}`);
+            return { handled: true, exitCode: 1 };
+        }
+        return { handled: true, exitCode: result.status ?? 0 };
+    }
+    if (platform === "win32") {
+        const logPath = options.windowsServiceLogPath || WINDOWS_SERVICE_LOG_PATH;
+        if (!existsSync(logPath)) {
+            stderr(`[runtime-bridge] 尚未生成日志文件: ${logPath}。请先执行 ` +
+                "`awsb service install` 并运行服务。");
+            return { handled: true, exitCode: 1 };
+        }
+        const psCommand = `Get-Content -Encoding UTF8 -Tail 200 "${logPath}"` +
+            (follow ? " -Wait" : "");
+        const result = runCommand("powershell", [
+            "-NoProfile",
+            "-Command",
+            psCommand,
+        ]);
+        if (result.error) {
+            stderr(`[runtime-bridge] 读取日志失败: ${result.error.message}`);
+            return { handled: true, exitCode: 1 };
+        }
+        return { handled: true, exitCode: result.status ?? 0 };
+    }
+    stderr("[runtime-bridge] awsb log 仅支持 Linux systemd 与 Windows 服务环境。");
+    return { handled: true, exitCode: 1 };
+}
 export async function handleCliCommand(options = {}) {
     const argv = options.argv || process.argv.slice(2);
     const command = argv[0];
@@ -235,24 +598,7 @@ export async function handleCliCommand(options = {}) {
         return { handled: true, exitCode: 0 };
     }
     if (command === "update") {
-        stdout("[runtime-bridge] 正在更新 aws-runtime-bridge 到最新版本...");
-        const runCommand = options.runCommand || defaultRunCommand;
-        const result = runCommand("npm", [
-            "install",
-            "-g",
-            "aws-runtime-bridge@latest",
-            "--omit=optional",
-        ]);
-        if (result.error) {
-            stderr(`[runtime-bridge] 更新失败: ${result.error.message}`);
-            return { handled: true, exitCode: 1 };
-        }
-        if (result.status !== 0) {
-            stderr(`[runtime-bridge] 更新失败，npm 退出码: ${result.status ?? "unknown"}`);
-            return { handled: true, exitCode: result.status ?? 1 };
-        }
-        stdout("[runtime-bridge] 更新完成。请重新运行 awsb -v 查看当前版本。");
-        return { handled: true, exitCode: 0 };
+        return await handleUpdateCommand(options, stdout, stderr);
     }
     if (command === "config") {
         const configure = options.configure || configureStartupConfig;
@@ -262,5 +608,8 @@ export async function handleCliCommand(options = {}) {
     if (command === "service") {
         return handleServiceCommand(argv, options, stdout, stderr);
     }
+    if (command === "log") {
+        return handleLogCommand(options, stdout, stderr);
+    }
     return { handled: false, exitCode: 0 };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aws-runtime-bridge",
-  "version": "1.9.74",
+  "version": "1.9.75",
   "description": "AgentsWorkStudio runtime bridge service for machine-level agent runtime integration",
   "type": "module",
   "main": "dist/index.js",