aws-runtime-bridge 1.1.0 → 1.1.2

package/README.md

@@ -6,11 +6,13 @@ AgentsWorkStudio 机器实例运行时桥接服务，用于在实例上管理 Ag
 
 从 npm 包安装时：
 
-```bash
-npm install -g aws-runtime-bridge
-```
-
-从当前仓库安装时：
+```bash
+npm install -g aws-runtime-bridge
+```
+
+安装脚本会在 macOS、Linux 与常见 Unix 平台自动为 CLI 入口补齐可执行权限；Windows 平台无需 chmod，会自动跳过该步骤。
+
+从当前仓库安装时：
 
 ```bash
 cd aws-runtime-bridge
@@ -19,10 +21,30 @@ npm run build
 npm install -g .
 ```
 
-## 启动
-
-```bash
-AWS_RUNTIME_BRIDGE_PORT=18081 \
+## 启动
+
+首次运行 `awsb` / `aws-bridge` 时，如果不存在 `~/.aws-bridge/config.json`，CLI 会进入交互式配置引导；也可以在提示中选择跳过。跳过时仍会创建配置文件并自动生成随机 `connectionKey`，终端会输出该密钥，请保存后在 server/面板连接此 Bridge 时使用。非交互环境（如 systemd、CI、Docker 后台启动）不会阻塞等待输入，也会自动生成 `connectionKey` 并跳过引导。
+
+引导会生成类似下面的配置：
+
+```json
+{
+  "connectionKey": "gkmzjaznX55..",
+  "autoRegisterTargets": [
+    {
+      "serverUrl": "http://127.0.0.1:8080",
+      "instanceName": "至强主机",
+      "userKey": "aws_live_crh_g0GGrg5IntODg1sFwnas7qf4yGrcwoisDWPBtd8",
+      "registerIp": "127.0.0.1"
+    }
+  ]
+}
+```
+
+如需在交互式终端中也强制跳过引导，可设置 `AWS_BRIDGE_SKIP_SETUP=true`；此时仍会生成随机 `connectionKey`。
+
+```bash
+AWS_RUNTIME_BRIDGE_PORT=18081 \
 AWS_RUNTIME_SCHEDULER_BASE_URL=http://your-server-host:7380 \
 AWS_RUNTIME_CALLBACK_TOKEN=replace-with-a-long-random-runtime-callback-token \
 AWS_RUNTIME_HOME_DIR=/opt/agentswork/runtime-home \

package/dist/index.js

@@ -31,7 +31,9 @@ import { adapterRegistry } from "./adapter/index.js";
 import { logger } from "./utils/logger.js";
 import { autoRegister, unregister, bridgeRestartCleanup, } from "./services/auto-register.js";
 import { ensureAwsClientAgentMcpReleased } from "./services/aws-client-agent-mcp.js";
+import { ensureStartupConfig } from "./services/startup-config-wizard.js";
 // 验证生产环境配置
+await ensureStartupConfig();
 validateProductionToken();
 ensureAwsClientAgentMcpReleased();
 logRuntimeBindingStartupState();

package/dist/routes/instance.d.ts

@@ -1,3 +1,13 @@
 export declare function setGracefulShutdownFn(fn: (signal: string, preserveSessions: boolean) => Promise<void>): void;
 export declare const instanceRouter: import("express-serve-static-core").Router;
+export declare function buildConnectionCheckResponse(connectionKeyMd5: string): {
+    status: number;
+    body: {
+        ok: boolean;
+        runtimeBridge?: "healthy";
+        connectionKeyMatched: boolean;
+        connectionKeyRequired: boolean;
+        error?: string;
+    };
+};
 //# sourceMappingURL=instance.d.ts.map

package/dist/routes/instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/routes/instance.ts"],"names":[],"mappings":"AA0BA,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/D,IAAI,CAEN;AAED,eAAO,MAAM,cAAc,4CAAW,CAAC"}
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/routes/instance.ts"],"names":[],"mappings":"AA0BA,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/D,IAAI,CAEN;AAED,eAAO,MAAM,cAAc,4CAAW,CAAC;AAyBvC,wBAAgB,4BAA4B,CAAC,gBAAgB,EAAE,MAAM,GAAG;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QACJ,EAAE,EAAE,OAAO,CAAC;QACZ,aAAa,CAAC,EAAE,SAAS,CAAC;QAC1B,oBAAoB,EAAE,OAAO,CAAC;QAC9B,qBAAqB,EAAE,OAAO,CAAC;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAqCA"}

package/dist/routes/instance.js

@@ -34,6 +34,41 @@ function hasMatchingConnectionKeyDigest(connectionKeyMd5) {
             timingSafeEqual(configuredBuffer, providedBuffer));
     });
 }
+export function buildConnectionCheckResponse(connectionKeyMd5) {
+    const configuredConnectionKeys = getConfiguredConnectionKeys();
+    const connectionKeyRequired = configuredConnectionKeys.length > 0;
+    if (!connectionKeyRequired) {
+        return {
+            status: 200,
+            body: {
+                ok: true,
+                runtimeBridge: "healthy",
+                connectionKeyMatched: true,
+                connectionKeyRequired: false,
+            },
+        };
+    }
+    if (hasMatchingConnectionKeyDigest(connectionKeyMd5)) {
+        return {
+            status: 200,
+            body: {
+                ok: true,
+                runtimeBridge: "healthy",
+                connectionKeyMatched: true,
+                connectionKeyRequired: true,
+            },
+        };
+    }
+    return {
+        status: 401,
+        body: {
+            ok: false,
+            error: "connection_key_mismatch",
+            connectionKeyMatched: false,
+            connectionKeyRequired: true,
+        },
+    };
+}
 instanceRouter.get("/healthz", (_req, res) => {
     res.json({
         ok: true,
@@ -42,19 +77,8 @@ instanceRouter.get("/healthz", (_req, res) => {
 });
 instanceRouter.get("/connection-check", (req, res) => {
     const connectionKeyMd5 = String(req.header("X-Bridge-Connection-Key-MD5") || "");
-    if (hasMatchingConnectionKeyDigest(connectionKeyMd5)) {
-        res.json({
-            ok: true,
-            runtimeBridge: "healthy",
-            connectionKeyMatched: true,
-        });
-        return;
-    }
-    res.status(401).json({
-        ok: false,
-        error: "connection_key_mismatch",
-        connectionKeyMatched: false,
-    });
+    const result = buildConnectionCheckResponse(connectionKeyMd5);
+    res.status(result.status).json(result.body);
 });
 instanceRouter.get("/ping", validateToken, async (_req, res) => {
     try {

package/dist/routes/instance.test.js

@@ -1,7 +1,13 @@
 /**
  * Instance 路由单元测试
  */
-import { describe, it, expect } from 'vitest';
+import { describe, it, expect, vi, afterEach } from 'vitest';
+vi.mock('../services/auto-register.js', () => ({
+    getConfiguredConnectionKeys: vi.fn(() => []),
+}));
+afterEach(() => {
+    vi.clearAllMocks();
+});
 describe('instance route validation', () => {
     it('builds correct ping response when healthy', () => {
         const buildPingResponse = (schedulerStatus, schedulerBaseUrl) => ({
@@ -61,4 +67,35 @@ describe('instance route validation', () => {
         expect(normalizeInstallableTools(['Codex'])).toEqual(['codex']);
         expect(SUPPORTED_INSTALLABLE_TOOLS).toContain('codex');
     });
+    it('allows connection check when no connection key is configured', async () => {
+        const { getConfiguredConnectionKeys } = await import('../services/auto-register.js');
+        vi.mocked(getConfiguredConnectionKeys).mockReturnValue([]);
+        const { buildConnectionCheckResponse } = await import('./instance.js');
+        expect(buildConnectionCheckResponse('')).toEqual({
+            status: 200,
+            body: {
+                ok: true,
+                runtimeBridge: 'healthy',
+                connectionKeyMatched: true,
+                connectionKeyRequired: false,
+            },
+        });
+    });
+    it('requires matching connection key digest when a connection key is configured', async () => {
+        const { createHash } = await import('node:crypto');
+        const { getConfiguredConnectionKeys } = await import('../services/auto-register.js');
+        vi.mocked(getConfiguredConnectionKeys).mockReturnValue(['secret-key']);
+        const { buildConnectionCheckResponse } = await import('./instance.js');
+        const digest = createHash('md5').update('secret-key', 'utf8').digest('hex');
+        expect(buildConnectionCheckResponse(digest).status).toBe(200);
+        expect(buildConnectionCheckResponse('00000000000000000000000000000000')).toEqual({
+            status: 401,
+            body: {
+                ok: false,
+                error: 'connection_key_mismatch',
+                connectionKeyMatched: false,
+                connectionKeyRequired: true,
+            },
+        });
+    });
 });

package/dist/services/auto-register.d.ts

@@ -41,6 +41,10 @@ interface AutoRegisterConfig {
     retryInterval?: number;
 }
 export declare function getConfiguredConnectionKeys(): string[];
+/**
+ * 配置文件路径
+ */
+export declare function getAutoRegisterConfigFilePath(): string;
 /**
  * 加载自动注册配置
  *

package/dist/services/auto-register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-register.d.ts","sourceRoot":"","sources":["../../src/services/auto-register.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8CH;;GAEG;AACH,UAAU,kBAAkB;IAC1B,eAAe;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwBD,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAEtD;AAsQD;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,kBAAkB,CA2C/C;AAED,wBAAgB,WAAW,IAAI,kBAAkB,EAAE,CA0ClD;AA8LD;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACzC,OAAO,CAAC,OAAO,CAAC,CAalB;AAyHD;;GAEG;AACH,wBAAsB,gCAAgC,IAAI,OAAO,CAAC;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAoED;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAuBnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB;gBA7yBtB,OAAO;iBACN,MAAM;mBACJ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;kBACvB,IAAI;YACV,MAAM;EA2yBf;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA0ED"}
+{"version":3,"file":"auto-register.d.ts","sourceRoot":"","sources":["../../src/services/auto-register.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8CH;;GAEG;AACH,UAAU,kBAAkB;IAC1B,eAAe;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwBD,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAEtD;AA6DD;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAGtD;AAyJD;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,kBAAkB,CA2C/C;AAED,wBAAgB,WAAW,IAAI,kBAAkB,EAAE,CA0ClD;AA8LD;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACzC,OAAO,CAAC,OAAO,CAAC,CAalB;AAyHD;;GAEG;AACH,wBAAsB,gCAAgC,IAAI,OAAO,CAAC;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAoED;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAuBnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB;gBAnwBtB,OAAO;iBACN,MAAM;mBACJ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;kBACvB,IAAI;YACV,MAAM;EAiwBf;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA0ED"}

package/dist/services/auto-register.js

@@ -84,38 +84,10 @@ function normalizeTargetConfig(source) {
 /**
  * 配置文件路径
  */
-function getConfigFilePath() {
+export function getAutoRegisterConfigFilePath() {
     const homeDir = os.homedir();
     return path.join(homeDir, ".aws-bridge", "config.json");
 }
-/**
- * 确保配置文件存在，如果不存在则创建空配置文件
- */
-function ensureConfigFile() {
-    const configPath = getConfigFilePath();
-    const configDir = path.dirname(configPath);
-    try {
-        // 检查配置文件是否已存在
-        if (fs.existsSync(configPath)) {
-            return true;
-        }
-        // 创建配置目录
-        if (!fs.existsSync(configDir)) {
-            fs.mkdirSync(configDir, { recursive: true });
-        }
-        // 创建空配置文件
-        const emptyConfig = {};
-        fs.writeFileSync(configPath, JSON.stringify(emptyConfig, null, 2), "utf-8");
-        logger.info(`[AutoRegister] 已创建配置文件: ${configPath}`);
-        logger.info(`[AutoRegister] 要启用自动注册，请编辑配置文件设置 tenantId 和 userKey`);
-        return true;
-    }
-    catch (error) {
-        const err = error;
-        logger.warn(`[AutoRegister] 创建配置文件失败: ${configPath}, error: ${err.message}`);
-        return false;
-    }
-}
 /**
  * 从配置文件加载配置
  *
@@ -148,9 +120,7 @@ function ensureConfigFile() {
  * }
  */
 function loadConfigFromFile() {
-    // 确保配置文件存在（如果不存在则创建模板）
-    ensureConfigFile();
-    const configPath = getConfigFilePath();
+    const configPath = getAutoRegisterConfigFilePath();
     try {
         if (!fs.existsSync(configPath)) {
             logger.debug(`[AutoRegister] 配置文件不存在: ${configPath}`);
@@ -168,8 +138,7 @@ function loadConfigFromFile() {
     }
 }
 function loadTargetsFromFile() {
-    ensureConfigFile();
-    const configPath = getConfigFilePath();
+    const configPath = getAutoRegisterConfigFilePath();
     try {
         if (!fs.existsSync(configPath)) {
             return [];

package/dist/services/startup-config-wizard.d.ts

@@ -0,0 +1,15 @@
+interface PromptIO {
+    question(prompt: string): Promise<string>;
+    close(): void;
+}
+interface EnsureStartupConfigOptions {
+    configPath?: string;
+    interactive?: boolean;
+    prompt?: PromptIO;
+    env?: NodeJS.ProcessEnv;
+    generateConnectionKey?: () => string;
+}
+export type StartupConfigWizardResult = "exists" | "created" | "skipped" | "non-interactive" | "failed";
+export declare function ensureStartupConfig(options?: EnsureStartupConfigOptions): Promise<StartupConfigWizardResult>;
+export {};
+//# sourceMappingURL=startup-config-wizard.d.ts.map

package/dist/services/startup-config-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-config-wizard.d.ts","sourceRoot":"","sources":["../../src/services/startup-config-wizard.ts"],"names":[],"mappings":"AAqBA,UAAU,QAAQ;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,UAAU,0BAA0B;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,MAAM,CAAC;CACtC;AAED,MAAM,MAAM,yBAAyB,GACjC,QAAQ,GACR,SAAS,GACT,SAAS,GACT,iBAAiB,GACjB,QAAQ,CAAC;AAiGb,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,yBAAyB,CAAC,CAmDpC"}

package/dist/services/startup-config-wizard.js

@@ -0,0 +1,122 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { randomBytes } from "node:crypto";
+import os from "node:os";
+import path from "node:path";
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { getAutoRegisterConfigFilePath } from "./auto-register.js";
+import { logger } from "../utils/logger.js";
+function normalizeAnswer(answer) {
+    return answer.trim().toLowerCase();
+}
+function isYes(answer) {
+    return ["", "y", "yes", "是", "好", "配置"].includes(normalizeAnswer(answer));
+}
+function isNo(answer) {
+    return ["n", "no", "否", "不", "跳过", "skip", "s"].includes(normalizeAnswer(answer));
+}
+function writeConfigFile(configPath, config) {
+    mkdirSync(path.dirname(configPath), { recursive: true });
+    writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
+}
+function generateDefaultConnectionKey() {
+    return `awsb_${randomBytes(24).toString("base64url")}`;
+}
+function writeSkippedConfig(configPath, generateConnectionKey) {
+    const connectionKey = generateConnectionKey();
+    writeConfigFile(configPath, { connectionKey });
+    const message = `[runtime-bridge] 已创建配置文件: ${configPath}\n` +
+        `[runtime-bridge] 自动生成 connectionKey: ${connectionKey}\n` +
+        "[runtime-bridge] 请保存该 connectionKey；server/面板连接此 Bridge 时需要使用它。";
+    logger.info(message);
+    output.write(`${message}\n`);
+}
+async function askOptional(prompt, label, defaultValue) {
+    const answer = await prompt.question(`${label} (${defaultValue}): `);
+    return answer.trim() || defaultValue;
+}
+async function askRequired(prompt, label) {
+    for (;;) {
+        const answer = (await prompt.question(`${label}: `)).trim();
+        if (answer) {
+            return answer;
+        }
+        output.write(`${label} 不能为空，请重新输入。\n`);
+    }
+}
+async function askShouldConfigure(prompt) {
+    for (;;) {
+        const answer = await prompt.question("未检测到 ~/.aws-bridge/config.json，是否现在进入自动注册配置引导？(Y/n): ");
+        if (isYes(answer)) {
+            return true;
+        }
+        if (isNo(answer)) {
+            return false;
+        }
+        output.write("请输入 Y 继续配置，或输入 n 跳过。\n");
+    }
+}
+async function collectStartupConfig(prompt) {
+    const defaultServerUrl = "http://127.0.0.1:8080";
+    const defaultInstanceName = os.hostname() || "AgentsWork Runtime Bridge";
+    const defaultRegisterIp = "127.0.0.1";
+    const connectionKey = await askRequired(prompt, "connectionKey（面板连接 Bridge 的密钥）");
+    const serverUrl = await askOptional(prompt, "serverUrl（调度中心地址）", defaultServerUrl);
+    const instanceName = await askOptional(prompt, "instanceName（实例名称）", defaultInstanceName);
+    const userKey = await askRequired(prompt, "userKey（用户 API Key）");
+    const registerIp = await askOptional(prompt, "registerIp（Bridge 对外访问 IP）", defaultRegisterIp);
+    return {
+        connectionKey,
+        autoRegisterTargets: [
+            {
+                serverUrl,
+                instanceName,
+                userKey,
+                registerIp,
+            },
+        ],
+    };
+}
+export async function ensureStartupConfig(options = {}) {
+    const configPath = options.configPath || getAutoRegisterConfigFilePath();
+    const generateConnectionKey = options.generateConnectionKey || generateDefaultConnectionKey;
+    if (existsSync(configPath)) {
+        return "exists";
+    }
+    const env = options.env || process.env;
+    if (env.AWS_BRIDGE_SKIP_SETUP === "true") {
+        writeSkippedConfig(configPath, generateConnectionKey);
+        logger.info("[runtime-bridge] AWS_BRIDGE_SKIP_SETUP=true，跳过首次配置引导");
+        return "skipped";
+    }
+    const interactive = options.interactive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    if (!interactive) {
+        writeSkippedConfig(configPath, generateConnectionKey);
+        logger.info(`[runtime-bridge] 未检测到配置文件: ${configPath}；当前为非交互环境，跳过首次配置引导`);
+        return "non-interactive";
+    }
+    const prompt = options.prompt || createInterface({ input, output, terminal: true });
+    const shouldClosePrompt = !options.prompt;
+    try {
+        const shouldConfigure = await askShouldConfigure(prompt);
+        if (!shouldConfigure) {
+            writeSkippedConfig(configPath, generateConnectionKey);
+            logger.info("[runtime-bridge] 已跳过首次配置引导");
+            return "skipped";
+        }
+        const config = await collectStartupConfig(prompt);
+        writeConfigFile(configPath, config);
+        logger.info(`[runtime-bridge] 已写入配置文件: ${configPath}`);
+        return "created";
+    }
+    catch (error) {
+        const err = error;
+        logger.warn(`[runtime-bridge] 首次配置引导失败: ${err.message}`);
+        return "failed";
+    }
+    finally {
+        if (shouldClosePrompt) {
+            prompt.close();
+        }
+    }
+}

package/dist/services/startup-config-wizard.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=startup-config-wizard.test.d.ts.map

package/dist/services/startup-config-wizard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-config-wizard.test.d.ts","sourceRoot":"","sources":["../../src/services/startup-config-wizard.test.ts"],"names":[],"mappings":""}

package/dist/services/startup-config-wizard.test.js

@@ -0,0 +1,103 @@
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { ensureStartupConfig } from "./startup-config-wizard.js";
+class FakePrompt {
+    constructor(answers) {
+        this.answers = answers;
+        this.index = 0;
+        this.closed = false;
+    }
+    async question() {
+        return this.answers[this.index++] ?? "";
+    }
+    close() {
+        this.closed = true;
+    }
+}
+const tempRoots = [];
+function createConfigPath() {
+    const root = mkdtempSync(path.join(os.tmpdir(), "aws-bridge-wizard-"));
+    tempRoots.push(root);
+    return path.join(root, ".aws-bridge", "config.json");
+}
+afterEach(() => {
+    for (const root of tempRoots.splice(0)) {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+describe("startup config wizard", () => {
+    it("does not prompt when config file already exists", async () => {
+        const configPath = createConfigPath();
+        mkdirSync(path.dirname(configPath), { recursive: true });
+        writeFileSync(configPath, "{}", "utf-8");
+        const prompt = new FakePrompt([]);
+        const result = await ensureStartupConfig({ configPath, interactive: true, prompt });
+        expect(result).toBe("exists");
+        expect(prompt.closed).toBe(false);
+    });
+    it("writes generated connection key when user chooses no", async () => {
+        const configPath = createConfigPath();
+        const prompt = new FakePrompt(["n"]);
+        const result = await ensureStartupConfig({
+            configPath,
+            interactive: true,
+            prompt,
+            generateConnectionKey: () => "awsb_test_generated_key",
+        });
+        expect(result).toBe("skipped");
+        expect(JSON.parse(readFileSync(configPath, "utf-8"))).toEqual({
+            connectionKey: "awsb_test_generated_key",
+        });
+    });
+    it("writes connection key and auto register target from interactive answers", async () => {
+        const configPath = createConfigPath();
+        const prompt = new FakePrompt([
+            "y",
+            "gkmzjaznX55..",
+            "http://127.0.0.1:8080",
+            "至强主机",
+            "aws_live_crh_g0GGrg5IntODg1sFwnas7qf4yGrcwoisDWPBtd8",
+            "127.0.0.1",
+        ]);
+        const result = await ensureStartupConfig({ configPath, interactive: true, prompt });
+        expect(result).toBe("created");
+        expect(JSON.parse(readFileSync(configPath, "utf-8"))).toEqual({
+            connectionKey: "gkmzjaznX55..",
+            autoRegisterTargets: [
+                {
+                    serverUrl: "http://127.0.0.1:8080",
+                    instanceName: "至强主机",
+                    userKey: "aws_live_crh_g0GGrg5IntODg1sFwnas7qf4yGrcwoisDWPBtd8",
+                    registerIp: "127.0.0.1",
+                },
+            ],
+        });
+    });
+    it("writes generated connection key and does not block startup in non-interactive environments", async () => {
+        const configPath = createConfigPath();
+        const result = await ensureStartupConfig({
+            configPath,
+            interactive: false,
+            generateConnectionKey: () => "awsb_non_interactive_key",
+        });
+        expect(result).toBe("non-interactive");
+        expect(JSON.parse(readFileSync(configPath, "utf-8"))).toEqual({
+            connectionKey: "awsb_non_interactive_key",
+        });
+    });
+    it("supports environment opt-out for unattended startup", async () => {
+        const configPath = createConfigPath();
+        const result = await ensureStartupConfig({
+            configPath,
+            interactive: true,
+            env: { AWS_BRIDGE_SKIP_SETUP: "true" },
+            generateConnectionKey: () => "awsb_env_skip_key",
+        });
+        expect(result).toBe("skipped");
+        expect(JSON.parse(readFileSync(configPath, "utf-8"))).toEqual({
+            connectionKey: "awsb_env_skip_key",
+        });
+    });
+});