codex-slot 0.1.28 → 0.1.29

package/README.md

@@ -10,6 +10,7 @@
 - Manage multiple accounts or workspaces as separate slots
 - Refresh and cache the latest usage from the official usage endpoint
 - Expose a local provider endpoint for Codex
+- Optionally pin model requests to an OpenAI-compatible relay slot
 - Proxy ChatGPT backend plugin requests through the selected cslot account
 - Apply local block rules for temporary, 5-hour, and weekly limits
 - Automatically switch `~/.codex/config.toml` to the `cslot` provider while the local proxy is running (and restore it on stop)
@@ -89,12 +90,21 @@ codex-slot import <name> [HOME]
 codex-slot status
 codex-slot start [--port <port>]
 codex-slot stop
+codex-slot relay add <name> --base-url <url> --api-key <key>
+codex-slot relay list
+codex-slot use relay <name>
+codex-slot use auth
+codex-slot current
 ```
 
 Common patterns:
 
 - `cslot import work ~/workspace-home`
 - `cslot rename work work-main`
+- `cslot relay add third --base-url https://relay.example.com/v1 --api-key sk-...`
+- `cslot status`
+- `cslot use relay third`
+- `cslot use auth`
 - `cslot start`
 
 ## Architecture
@@ -108,6 +118,7 @@ The project is intentionally split by responsibility:
 - `src/status-command.ts`: usage refresh output and interactive toggle UI
 - `src/codex-config.ts`: managed `~/.codex/config.toml` apply/restore logic
 - `src/backend-proxy-service.ts`: ChatGPT backend proxy for Codex plugin/runtime requests
+- `src/relay-proxy-service.ts`, `src/model-proxy-dispatcher.ts`, `src/relay-store.ts`: optional OpenAI-compatible relay slots and `/v1/*` model route dispatch
 - `src/account-store.ts`, `src/usage-sync.ts`, `src/scheduler.ts`, `src/status.ts`: core domain and runtime logic
 - `src/text.ts`: shared bilingual text and locale-independent formatting helpers
 
@@ -146,6 +157,27 @@ Behavior:
 - `requires_openai_auth = true` keeps Codex App treating the local cslot provider as a ChatGPT-authenticated provider, so plugin navigation and trusted plugin runtimes are not disabled as API-key/custom-provider mode
 - `/backend-api/*` requests are forwarded to ChatGPT backend with the current selected account's upstream token; client `Authorization` headers are not forwarded upstream
 
+## OpenAI-compatible Relay Slots
+
+Relay slots are optional model-only exits. They do not replace the official Codex / ChatGPT login state.
+Use `codex-slot relay add` to register a relay slot, then use `codex-slot status` for daily enable/disable and model-route selection.
+
+```bash
+codex-slot relay add third --base-url https://relay.example.com/v1 --api-key sk-...
+codex-slot use relay third
+codex-slot current
+```
+
+Behavior:
+
+- `/v1/*` model requests are fixed to the selected relay slot
+- Relay requests use the relay slot API key; client `Authorization` headers are not forwarded upstream
+- Relay failures are returned directly and do not fall back to official cslot accounts
+- `/backend-api/*` plugin/runtime requests still use the selected official Codex / ChatGPT login state
+- Usage refresh only applies to official accounts, not relay slots
+- In interactive `status`, press `Space` to enable/disable the selected account or relay slot, and press `m` to select the model route
+- Run `codex-slot use auth` to restore `/v1/*` model requests to the official account scheduler
+
 ## Codex App Plugins
 
 `codex-slot start` also switches the main `~/.codex` login state to the selected managed account while cslot is running.

package/dist/app/status-service.js

@@ -3,11 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.refreshStatusSnapshot = refreshStatusSnapshot;
 exports.getStatusSnapshot = getStatusSnapshot;
 exports.persistAccountEnabledState = persistAccountEnabledState;
+exports.persistRelayEnabledState = persistRelayEnabledState;
 const config_1 = require("../config");
 const scheduler_1 = require("../scheduler");
 const status_1 = require("../status");
 const state_1 = require("../state");
+const relay_store_1 = require("../relay-store");
+const state_2 = require("../state");
 const usage_sync_1 = require("../usage-sync");
+function formatModelRouteLabel(route) {
+    if (route.mode === "relay_slot") {
+        return `relay:${route.relay_slot_id}`;
+    }
+    return "auth_pool";
+}
 /**
  * 刷新全部账号额度并返回最新状态快照。
  *
@@ -27,8 +36,12 @@ async function refreshStatusSnapshot() {
 function getStatusSnapshot() {
     const statuses = (0, status_1.collectAccountStatuses)();
     const selected = (0, scheduler_1.pickBestAccount)();
+    const modelRoute = (0, state_2.getSelectedModelRoute)();
     return {
         statuses,
+        relaySlots: (0, relay_store_1.listRelaySlots)(),
+        modelRoute,
+        modelRouteLabel: formatModelRouteLabel(modelRoute),
         selectedName: selected?.account.name ?? null,
         codexAuthAccountId: (0, state_1.getSelectedCodexAuthAccountId)(),
         summary: (0, status_1.summarizeAccountStatuses)(statuses)
@@ -51,3 +64,20 @@ function persistAccountEnabledState(accounts) {
     }
     (0, config_1.saveConfig)(latest);
 }
+/**
+ * 将交互式界面中的 relay 启用状态修改写回配置文件。
+ *
+ * @param slots 用户在交互界面中调整后的 relay slot 数组。
+ * @returns 无返回值。
+ * @throws 当配置写入失败时抛出异常。
+ */
+function persistRelayEnabledState(slots) {
+    const latest = (0, config_1.loadConfig)();
+    for (const slot of slots) {
+        const index = latest.relay_slots.findIndex((item) => item.id === slot.id);
+        if (index >= 0) {
+            latest.relay_slots[index].enabled = slot.enabled;
+        }
+    }
+    (0, config_1.saveConfig)(latest);
+}

package/dist/cli.js

@@ -5,6 +5,7 @@ const commander_1 = require("commander");
 const account_commands_1 = require("./account-commands");
 const cli_helpers_1 = require("./cli-helpers");
 const config_1 = require("./config");
+const relay_commands_1 = require("./relay-commands");
 const service_control_1 = require("./service-control");
 const status_command_1 = require("./status-command");
 const text_1 = require("./text");
@@ -71,6 +72,66 @@ function registerAccountCommands(program) {
         .argument("<newName>", (0, text_1.bi)("新账号或工作空间标识", "New managed slot name"))
         .action(account_commands_1.handleAccountRename);
 }
+/**
+ * 注册 relay 与模型出口选择相关子命令。
+ *
+ * @param program Commander 程序实例。
+ * @returns 无返回值。
+ * @throws 无显式抛出。
+ */
+function registerRelayCommands(program) {
+    const relay = program
+        .command("relay")
+        .description((0, text_1.bi)("管理 OpenAI-compatible 中转槽位", "Manage OpenAI-compatible relay slots"));
+    relay
+        .command("add")
+        .description((0, text_1.bi)("新增一个中转槽位", "Add a relay slot"))
+        .argument("<name>", (0, text_1.bi)("中转槽位名", "Relay slot name"))
+        .requiredOption("--base-url <url>", (0, text_1.bi)("OpenAI-compatible base_url，通常以 /v1 结尾", "OpenAI-compatible base_url, usually ending with /v1"))
+        .requiredOption("--api-key <key>", (0, text_1.bi)("中转 API key", "Relay API key"))
+        .action(relay_commands_1.handleRelayAdd);
+    relay
+        .command("list")
+        .description((0, text_1.bi)("列出中转槽位", "List relay slots"))
+        .action(relay_commands_1.handleRelayList);
+    relay
+        .command("del")
+        .description((0, text_1.bi)("删除一个中转槽位", "Remove a relay slot"))
+        .argument("<name>", (0, text_1.bi)("中转槽位名", "Relay slot name"))
+        .action(relay_commands_1.handleRelayRemove);
+    relay
+        .command("rename")
+        .description((0, text_1.bi)("重命名一个中转槽位", "Rename a relay slot"))
+        .argument("<oldName>", (0, text_1.bi)("原中转槽位名", "Old relay slot name"))
+        .argument("<newName>", (0, text_1.bi)("新中转槽位名", "New relay slot name"))
+        .action(relay_commands_1.handleRelayRename);
+    relay
+        .command("enable")
+        .description((0, text_1.bi)("启用一个中转槽位", "Enable a relay slot"))
+        .argument("<name>", (0, text_1.bi)("中转槽位名", "Relay slot name"))
+        .action(relay_commands_1.handleRelayEnable);
+    relay
+        .command("disable")
+        .description((0, text_1.bi)("禁用一个中转槽位", "Disable a relay slot"))
+        .argument("<name>", (0, text_1.bi)("中转槽位名", "Relay slot name"))
+        .action(relay_commands_1.handleRelayDisable);
+    const use = program
+        .command("use")
+        .description((0, text_1.bi)("切换模型请求出口", "Switch model route"));
+    use
+        .command("relay")
+        .description((0, text_1.bi)("固定模型请求到指定中转槽位", "Fix model route to a relay slot"))
+        .argument("<name>", (0, text_1.bi)("中转槽位名", "Relay slot name"))
+        .action(relay_commands_1.handleUseRelay);
+    use
+        .command("auth")
+        .description((0, text_1.bi)("恢复模型请求到官方账号池", "Restore model route to the official auth pool"))
+        .action(relay_commands_1.handleUseAuthPool);
+    program
+        .command("current")
+        .description((0, text_1.bi)("查看当前模型出口与 Codex App 登录态选择", "Show current model route and Codex App auth selection"))
+        .action(relay_commands_1.handleCurrent);
+}
 /**
  * 注册配置与状态相关子命令。
  *
@@ -117,6 +178,7 @@ async function main() {
     (0, config_1.loadConfig)();
     configureRootProgram(program);
     registerAccountCommands(program);
+    registerRelayCommands(program);
     registerRuntimeCommands(program);
     await program.parseAsync(process.argv);
 }

package/dist/config.js

@@ -26,6 +26,14 @@ const managedAccountSchema = zod_1.z.object({
     enabled: zod_1.z.boolean().default(true),
     imported_at: zod_1.z.string().optional()
 });
+const relaySlotSchema = zod_1.z.object({
+    id: zod_1.z.string().min(1),
+    name: zod_1.z.string().min(1),
+    base_url: zod_1.z.string().url(),
+    api_key: zod_1.z.string().min(1),
+    enabled: zod_1.z.boolean().default(true),
+    imported_at: zod_1.z.string().optional()
+});
 const configSchema = zod_1.z.object({
     version: zod_1.z.number().int().default(1),
     server: zod_1.z
@@ -52,7 +60,8 @@ const configSchema = zod_1.z.object({
         auth_base_url: "https://auth.openai.com",
         oauth_client_id: "app_EMoamEEZ73f0CkXaXp7hrann"
     }),
-    accounts: zod_1.z.array(managedAccountSchema).default([])
+    accounts: zod_1.z.array(managedAccountSchema).default([]),
+    relay_slots: zod_1.z.array(relaySlotSchema).default([])
 });
 /**
  * 解析当前进程应使用的用户 HOME 目录，兼容 Windows 缺少 `HOME` 的场景。
@@ -138,7 +147,8 @@ function loadConfig() {
                 auth_base_url: "https://auth.openai.com",
                 oauth_client_id: "app_EMoamEEZ73f0CkXaXp7hrann"
             },
-            accounts: []
+            accounts: [],
+            relay_slots: []
         };
         saveConfig(defaultConfig);
         return defaultConfig;

package/dist/model-proxy-dispatcher.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.proxyModelWithRoute = void 0;
+exports.createModelProxyDispatcher = createModelProxyDispatcher;
+const proxy_retry_service_1 = require("./proxy-retry-service");
+const relay_proxy_service_1 = require("./relay-proxy-service");
+const relay_store_1 = require("./relay-store");
+const state_1 = require("./state");
+function buildSendResult(statusCode, payload, headers) {
+    return {
+        type: "send",
+        statusCode,
+        payload,
+        headers
+    };
+}
+/**
+ * 创建 `/v1/*` 模型请求分发器。
+ *
+ * 业务含义：
+ * 1. 默认 `auth_pool` 模式保持原有官方账号自动调度行为。
+ * 2. 手动选择 `relay_slot` 后，模型请求固定走该 relay slot。
+ * 3. relay 模式不影响 `/backend-api/*` 插件链路，也不会失败回退官方账号。
+ *
+ * @param overrides 可选依赖覆盖项。
+ * @returns 模型请求分发器实例。
+ * @throws 无显式抛出。
+ */
+function createModelProxyDispatcher(overrides) {
+    const dependencies = {
+        getSelectedModelRoute: state_1.getSelectedModelRoute,
+        findRelaySlot: relay_store_1.findRelaySlot,
+        proxyCodexWithRetry: proxy_retry_service_1.proxyCodexWithRetry,
+        proxyRelaySlot: relay_proxy_service_1.proxyRelaySlot,
+        ...overrides
+    };
+    return {
+        async proxyModelWithRoute(request) {
+            const route = dependencies.getSelectedModelRoute();
+            if (route.mode !== "relay_slot") {
+                return await dependencies.proxyCodexWithRetry(request);
+            }
+            const slot = dependencies.findRelaySlot(route.relay_slot_id);
+            if (!slot) {
+                return buildSendResult(503, {
+                    error: {
+                        message: `Relay slot not found: ${route.relay_slot_id}`,
+                        type: "relay_slot_not_found"
+                    }
+                });
+            }
+            if (!slot.enabled) {
+                return buildSendResult(503, {
+                    error: {
+                        message: `Relay slot is disabled: ${route.relay_slot_id}`,
+                        type: "relay_slot_disabled"
+                    }
+                });
+            }
+            return await dependencies.proxyRelaySlot({
+                slot,
+                request
+            });
+        }
+    };
+}
+exports.proxyModelWithRoute = createModelProxyDispatcher().proxyModelWithRoute;

package/dist/relay-commands.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRelayAdd = handleRelayAdd;
+exports.handleRelayList = handleRelayList;
+exports.handleRelayRemove = handleRelayRemove;
+exports.handleRelayRename = handleRelayRename;
+exports.handleRelayEnable = handleRelayEnable;
+exports.handleRelayDisable = handleRelayDisable;
+exports.handleUseRelay = handleUseRelay;
+exports.handleUseAuthPool = handleUseAuthPool;
+exports.handleCurrent = handleCurrent;
+const relay_store_1 = require("./relay-store");
+const state_1 = require("./state");
+const text_1 = require("./text");
+function maskApiKey(apiKey) {
+    if (apiKey.length <= 8) {
+        return "****";
+    }
+    return `${apiKey.slice(0, 4)}...${apiKey.slice(-4)}`;
+}
+function formatModelRoute() {
+    const route = (0, state_1.getSelectedModelRoute)();
+    if (route.mode === "relay_slot") {
+        return `relay:${route.relay_slot_id}`;
+    }
+    return "auth_pool";
+}
+/**
+ * 新增 OpenAI-compatible relay slot。
+ *
+ * @param name relay slot 名称。
+ * @param options relay 参数，必须包含 baseUrl 与 apiKey。
+ * @returns 无返回值。
+ * @throws 当 slot 已存在、URL 非法或配置写入失败时抛出异常。
+ */
+function handleRelayAdd(name, options) {
+    const slot = (0, relay_store_1.addRelaySlot)({
+        name,
+        baseUrl: options.baseUrl,
+        apiKey: options.apiKey
+    });
+    console.log((0, text_1.bi)(`已添加中转槽位: ${slot.name}`, `Relay slot added: ${slot.name}`));
+}
+/**
+ * 列出 OpenAI-compatible relay slot。
+ *
+ * @returns 无返回值。
+ * @throws 当配置读取失败时抛出异常。
+ */
+function handleRelayList() {
+    const slots = (0, relay_store_1.listRelaySlots)();
+    const route = (0, state_1.getSelectedModelRoute)();
+    if (slots.length === 0) {
+        console.log((0, text_1.bi)("当前没有中转槽位。", "No relay slots found."));
+        return;
+    }
+    for (const slot of slots) {
+        const selected = route.mode === "relay_slot" && route.relay_slot_id === slot.id ? "*" : " ";
+        const enabled = slot.enabled ? "enabled" : "disabled";
+        console.log(`${selected} ${slot.name}  ${enabled}  ${slot.base_url}  key=${maskApiKey(slot.api_key)}`);
+    }
+}
+/**
+ * 删除 OpenAI-compatible relay slot。
+ *
+ * @param name relay slot 名称。
+ * @returns 无返回值。
+ * @throws 当配置写入失败时抛出异常。
+ */
+function handleRelayRemove(name) {
+    const removed = (0, relay_store_1.removeRelaySlot)(name);
+    if (!removed) {
+        console.log((0, text_1.bi)(`未找到中转槽位: ${name}`, `Relay slot not found: ${name}`));
+        return;
+    }
+    console.log((0, text_1.bi)(`已删除中转槽位: ${name}`, `Relay slot removed: ${name}`));
+}
+/**
+ * 重命名 OpenAI-compatible relay slot。
+ *
+ * @param oldName 原 slot 名称。
+ * @param newName 新 slot 名称。
+ * @returns 无返回值。
+ * @throws 当旧 slot 不存在、新 slot 已存在或写入失败时抛出异常。
+ */
+function handleRelayRename(oldName, newName) {
+    const slot = (0, relay_store_1.renameRelaySlot)(oldName, newName);
+    console.log((0, text_1.bi)(`已重命名中转槽位: ${oldName} -> ${slot.name}`, `Relay slot renamed: ${oldName} -> ${slot.name}`));
+}
+/**
+ * 启用或禁用 OpenAI-compatible relay slot。
+ *
+ * @param name relay slot 名称。
+ * @param enabled 是否启用。
+ * @returns 无返回值。
+ * @throws 当 slot 不存在或写入失败时抛出异常。
+ */
+function handleRelayEnabled(name, enabled) {
+    const slot = (0, relay_store_1.setRelaySlotEnabled)(name, enabled);
+    console.log(enabled
+        ? (0, text_1.bi)(`已启用中转槽位: ${slot.name}`, `Relay slot enabled: ${slot.name}`)
+        : (0, text_1.bi)(`已禁用中转槽位: ${slot.name}`, `Relay slot disabled: ${slot.name}`));
+}
+/**
+ * 启用 OpenAI-compatible relay slot。
+ *
+ * @param name relay slot 名称。
+ * @returns 无返回值。
+ * @throws 当 slot 不存在或写入失败时抛出异常。
+ */
+function handleRelayEnable(name) {
+    handleRelayEnabled(name, true);
+}
+/**
+ * 禁用 OpenAI-compatible relay slot。
+ *
+ * @param name relay slot 名称。
+ * @returns 无返回值。
+ * @throws 当 slot 不存在或写入失败时抛出异常。
+ */
+function handleRelayDisable(name) {
+    handleRelayEnabled(name, false);
+}
+/**
+ * 将模型请求固定到指定 relay slot。
+ *
+ * @param name relay slot 名称。
+ * @returns 无返回值。
+ * @throws 当 relay slot 不存在或状态写入失败时抛出异常。
+ */
+function handleUseRelay(name) {
+    const slot = (0, relay_store_1.findRelaySlot)(name);
+    if (!slot) {
+        throw new Error((0, text_1.bi)(`未找到中转槽位 ${name}`, `Relay slot not found: ${name}`));
+    }
+    if (!slot.enabled) {
+        throw new Error((0, text_1.bi)(`中转槽位 ${name} 已禁用`, `Relay slot is disabled: ${name}`));
+    }
+    (0, state_1.setSelectedModelRoute)({
+        mode: "relay_slot",
+        relay_slot_id: slot.id
+    });
+    console.log((0, text_1.bi)(`模型请求已固定到中转槽位: ${slot.name}`, `Model route fixed to relay slot: ${slot.name}`));
+}
+/**
+ * 恢复模型请求到官方账号自动调度池。
+ *
+ * @returns 无返回值。
+ * @throws 当状态写入失败时抛出异常。
+ */
+function handleUseAuthPool() {
+    (0, state_1.setSelectedModelRoute)({
+        mode: "auth_pool"
+    });
+    console.log((0, text_1.bi)("模型请求已恢复官方账号池。", "Model route restored to auth pool."));
+}
+/**
+ * 输出当前模型出口与 Codex App 登录态选择。
+ *
+ * @returns 无返回值。
+ * @throws 当状态读取失败时抛出异常。
+ */
+function handleCurrent() {
+    console.log(`model_route=${formatModelRoute()}`);
+    console.log(`codex_auth=${(0, state_1.getSelectedCodexAuthAccountId)() ?? "none"}`);
+}

package/dist/relay-proxy-service.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.proxyRelaySlot = void 0;
+exports.buildRelayHeaders = buildRelayHeaders;
+exports.sendRelayRequest = sendRelayRequest;
+exports.createRelayProxyService = createRelayProxyService;
+const undici_1 = require("undici");
+/**
+ * 构造 OpenAI-compatible relay 上游请求头。
+ *
+ * 业务含义：
+ * 1. 客户端发给本地 cslot 的 Authorization 不代表 relay 凭据，不能透传。
+ * 2. relay 模式只使用 relay slot 自己的 api_key 鉴权，并保留其余兼容请求头。
+ *
+ * @param requestHeaders 客户端发到本地服务的原始请求头。
+ * @param apiKey relay slot 的 API key。
+ * @param bodyLength 请求体字节长度；无 body 时不写 content-length。
+ * @returns 可发往 relay 上游的请求头。
+ * @throws 无显式抛出。
+ */
+function buildRelayHeaders(requestHeaders, apiKey, bodyLength) {
+    const headers = {};
+    for (const [headerName, headerValue] of Object.entries(requestHeaders)) {
+        const normalizedName = headerName.toLowerCase();
+        if (headerValue == null ||
+            normalizedName === "authorization" ||
+            normalizedName === "host" ||
+            normalizedName === "connection" ||
+            normalizedName === "content-length") {
+            continue;
+        }
+        headers[normalizedName] = Array.isArray(headerValue)
+            ? headerValue.join(", ")
+            : headerValue;
+    }
+    headers.authorization = `Bearer ${apiKey}`;
+    if (typeof bodyLength === "number") {
+        headers["content-length"] = String(bodyLength);
+    }
+    headers["user-agent"] = "codex-slot/0.1.1";
+    return headers;
+}
+/**
+ * 将本地 `/v1/*` 请求解析成 relay base_url 后的相对路径。
+ *
+ * @param url 本地代理收到的 URL。
+ * @returns relay 上游相对 path 与 query；不属于 `/v1/*` 时返回 `null`。
+ * @throws URL 解析失败时透传异常。
+ */
+function resolveRelayPath(url) {
+    const parsedUrl = new URL(url, "http://127.0.0.1");
+    const openAiPrefix = "/v1";
+    if (!parsedUrl.pathname.startsWith(`${openAiPrefix}/`)) {
+        return null;
+    }
+    return `${parsedUrl.pathname.slice(openAiPrefix.length)}${parsedUrl.search}`;
+}
+/**
+ * 提取上游响应中允许透传给客户端的响应头。
+ *
+ * @param headers 上游响应头对象。
+ * @returns 可透传响应头。
+ * @throws 无显式抛出。
+ */
+function pickResponseHeaders(headers) {
+    const picked = {};
+    const contentType = headers["content-type"];
+    const cacheControl = headers["cache-control"];
+    if (typeof contentType === "string") {
+        picked["content-type"] = contentType;
+    }
+    if (typeof cacheControl === "string") {
+        picked["cache-control"] = cacheControl;
+    }
+    return picked;
+}
+function buildSendResult(statusCode, payload, headers) {
+    return {
+        type: "send",
+        statusCode,
+        payload,
+        headers
+    };
+}
+/**
+ * 向 OpenAI-compatible relay 上游发送一次请求。
+ *
+ * @param options relay 请求参数。
+ * @returns undici 上游响应对象。
+ * @throws 当网络层或 undici 请求失败时透传底层异常。
+ */
+async function sendRelayRequest(options) {
+    const baseUrl = options.baseUrl.replace(/\/+$/, "");
+    const pathWithQuery = options.pathWithQuery.startsWith("/")
+        ? options.pathWithQuery
+        : `/${options.pathWithQuery}`;
+    return await (0, undici_1.request)(`${baseUrl}${pathWithQuery}`, {
+        method: options.method,
+        headers: options.headers,
+        body: options.body && options.body.length > 0 ? options.body : undefined
+    });
+}
+/**
+ * 创建 relay 模型代理服务。
+ *
+ * 业务含义：
+ * 1. relay slot 是手动固定的模型出口，不参与官方账号自动调度。
+ * 2. relay 上游返回 401/429/5xx 时原样返回给客户端，不回退到官方账号。
+ *
+ * @param overrides 可选依赖覆盖项。
+ * @returns relay 代理服务实例。
+ * @throws 无显式抛出。
+ */
+function createRelayProxyService(overrides) {
+    const dependencies = {
+        sendRelayRequest,
+        ...overrides
+    };
+    return {
+        async proxyRelaySlot(options) {
+            const pathWithQuery = resolveRelayPath(options.request.url);
+            if (!pathWithQuery) {
+                return buildSendResult(404, {
+                    error: {
+                        message: "Unsupported relay proxy path",
+                        type: "unsupported_relay_proxy_path"
+                    }
+                });
+            }
+            const bodyLength = options.request.body && options.request.body.length > 0
+                ? options.request.body.length
+                : undefined;
+            let upstream;
+            try {
+                upstream = await dependencies.sendRelayRequest({
+                    baseUrl: options.slot.base_url,
+                    method: options.request.method.toUpperCase(),
+                    pathWithQuery,
+                    headers: buildRelayHeaders(options.request.headers, options.slot.api_key, bodyLength),
+                    body: options.request.body
+                });
+            }
+            catch (error) {
+                return buildSendResult(502, {
+                    error: {
+                        message: error instanceof Error ? error.message : String(error),
+                        type: "relay_request_failed"
+                    }
+                });
+            }
+            return {
+                type: "proxy",
+                statusCode: upstream.statusCode,
+                headers: pickResponseHeaders(upstream.headers),
+                body: upstream.body
+            };
+        }
+    };
+}
+exports.proxyRelaySlot = createRelayProxyService().proxyRelaySlot;

package/dist/relay-store.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listRelaySlots = listRelaySlots;
+exports.findRelaySlot = findRelaySlot;
+exports.addRelaySlot = addRelaySlot;
+exports.removeRelaySlot = removeRelaySlot;
+exports.renameRelaySlot = renameRelaySlot;
+exports.setRelaySlotEnabled = setRelaySlotEnabled;
+const config_1 = require("./config");
+const state_1 = require("./state");
+const text_1 = require("./text");
+/**
+ * 列出所有 OpenAI-compatible relay 槽位。
+ *
+ * @returns 当前配置中的 relay slot 列表。
+ * @throws 当配置读取失败时抛出异常。
+ */
+function listRelaySlots() {
+    return (0, config_1.loadConfig)().relay_slots;
+}
+/**
+ * 查找指定 relay slot。
+ *
+ * @param slotId relay slot 标识。
+ * @returns 命中时返回 slot；不存在时返回 `null`。
+ * @throws 当配置读取失败时抛出异常。
+ */
+function findRelaySlot(slotId) {
+    return listRelaySlots().find((item) => item.id === slotId) ?? null;
+}
+/**
+ * 新增一个 OpenAI-compatible relay slot。
+ *
+ * @param input relay slot 配置。
+ * @returns 新增后的 relay slot。
+ * @throws 当同名 slot 已存在或配置写入失败时抛出异常。
+ */
+function addRelaySlot(input) {
+    const config = (0, config_1.loadConfig)();
+    if (config.relay_slots.some((item) => item.id === input.name)) {
+        throw new Error((0, text_1.bi)(`中转槽位 ${input.name} 已存在`, `Relay slot already exists: ${input.name}`));
+    }
+    try {
+        new URL(input.baseUrl);
+    }
+    catch {
+        throw new Error((0, text_1.bi)(`中转 base_url 非法: ${input.baseUrl}`, `Invalid relay base_url: ${input.baseUrl}`));
+    }
+    const slot = {
+        id: input.name,
+        name: input.name,
+        base_url: input.baseUrl,
+        api_key: input.apiKey,
+        enabled: true,
+        imported_at: new Date().toISOString()
+    };
+    config.relay_slots.push(slot);
+    (0, config_1.saveConfig)(config);
+    return slot;
+}
+/**
+ * 删除指定 relay slot，并在当前模型出口指向它时恢复官方账号池。
+ *
+ * @param slotId relay slot 标识。
+ * @returns 被删除的 slot；不存在时返回 `null`。
+ * @throws 当配置或状态写入失败时抛出异常。
+ */
+function removeRelaySlot(slotId) {
+    const config = (0, config_1.loadConfig)();
+    const index = config.relay_slots.findIndex((item) => item.id === slotId);
+    if (index < 0) {
+        return null;
+    }
+    const [removed] = config.relay_slots.splice(index, 1);
+    (0, config_1.saveConfig)(config);
+    const route = (0, state_1.getSelectedModelRoute)();
+    if (route.mode === "relay_slot" && route.relay_slot_id === slotId) {
+        (0, state_1.setSelectedModelRoute)({ mode: "auth_pool" });
+    }
+    return removed;
+}
+/**
+ * 重命名 relay slot，并迁移当前模型出口选择。
+ *
+ * @param oldName 原 slot 标识。
+ * @param newName 新 slot 标识。
+ * @returns 重命名后的 relay slot。
+ * @throws 当旧 slot 不存在、新 slot 已存在或写入失败时抛出异常。
+ */
+function renameRelaySlot(oldName, newName) {
+    const config = (0, config_1.loadConfig)();
+    const index = config.relay_slots.findIndex((item) => item.id === oldName);
+    if (index < 0) {
+        throw new Error((0, text_1.bi)(`未找到中转槽位 ${oldName}`, `Relay slot not found: ${oldName}`));
+    }
+    if (config.relay_slots.some((item) => item.id === newName)) {
+        throw new Error((0, text_1.bi)(`中转槽位 ${newName} 已存在`, `Relay slot already exists: ${newName}`));
+    }
+    const renamed = {
+        ...config.relay_slots[index],
+        id: newName,
+        name: newName
+    };
+    config.relay_slots[index] = renamed;
+    (0, config_1.saveConfig)(config);
+    (0, state_1.updateState)((state) => {
+        if (state.selected_model_route?.mode === "relay_slot" &&
+            state.selected_model_route.relay_slot_id === oldName) {
+            state.selected_model_route = {
+                mode: "relay_slot",
+                relay_slot_id: newName
+            };
+        }
+    });
+    return renamed;
+}
+/**
+ * 更新 relay slot 启用状态。
+ *
+ * @param slotId relay slot 标识。
+ * @param enabled 是否启用。
+ * @returns 更新后的 relay slot。
+ * @throws 当 slot 不存在或配置写入失败时抛出异常。
+ */
+function setRelaySlotEnabled(slotId, enabled) {
+    const config = (0, config_1.loadConfig)();
+    const index = config.relay_slots.findIndex((item) => item.id === slotId);
+    if (index < 0) {
+        throw new Error((0, text_1.bi)(`未找到中转槽位 ${slotId}`, `Relay slot not found: ${slotId}`));
+    }
+    const updated = {
+        ...config.relay_slots[index],
+        enabled
+    };
+    config.relay_slots[index] = updated;
+    (0, config_1.saveConfig)(config);
+    return updated;
+}

package/dist/server.js

@@ -7,7 +7,7 @@ exports.startServer = startServer;
 const fastify_1 = __importDefault(require("fastify"));
 const config_1 = require("./config");
 const backend_proxy_service_1 = require("./backend-proxy-service");
-const proxy_retry_service_1 = require("./proxy-retry-service");
+const model_proxy_dispatcher_1 = require("./model-proxy-dispatcher");
 const status_1 = require("./status");
 const scheduler_1 = require("./scheduler");
 const usage_sync_1 = require("./usage-sync");
@@ -91,7 +91,7 @@ async function startServer(port) {
     });
     const codexProxyHandler = async (request, reply) => {
         const requestBody = await readRawRequestBody(request.body);
-        const result = await (0, proxy_retry_service_1.proxyCodexWithRetry)({
+        const result = await (0, model_proxy_dispatcher_1.proxyModelWithRoute)({
             method: request.method,
             url: request.url,
             headers: request.headers,

package/dist/state.js

@@ -17,6 +17,8 @@ exports.clearUsageRefreshError = clearUsageRefreshError;
 exports.getUsageRefreshError = getUsageRefreshError;
 exports.getSelectedCodexAuthAccountId = getSelectedCodexAuthAccountId;
 exports.setSelectedCodexAuthAccountId = setSelectedCodexAuthAccountId;
+exports.getSelectedModelRoute = getSelectedModelRoute;
+exports.setSelectedModelRoute = setSelectedModelRoute;
 exports.getManagedCodexConfigState = getManagedCodexConfigState;
 exports.getManagedCodexAuthState = getManagedCodexAuthState;
 exports.setManagedCodexConfigState = setManagedCodexConfigState;
@@ -44,6 +46,9 @@ function createDefaultState() {
     return {
         state_version: STATE_SCHEMA_VERSION,
         selected_codex_auth_account_id: null,
+        selected_model_route: {
+            mode: "auth_pool"
+        },
         account_blocks: {},
         usage_cache: {},
         usage_refresh_errors: {},
@@ -64,6 +69,7 @@ function normalizeState(parsed) {
     return {
         state_version: STATE_SCHEMA_VERSION,
         selected_codex_auth_account_id: parsed?.selected_codex_auth_account_id ?? defaults.selected_codex_auth_account_id,
+        selected_model_route: normalizeModelRouteSelection(parsed?.selected_model_route ?? defaults.selected_model_route),
         account_blocks: parsed?.account_blocks ?? defaults.account_blocks,
         usage_cache: parsed?.usage_cache ?? defaults.usage_cache,
         usage_refresh_errors: parsed?.usage_refresh_errors ?? defaults.usage_refresh_errors,
@@ -72,6 +78,24 @@ function normalizeState(parsed) {
         managed_codex_config: parsed?.managed_codex_config ?? defaults.managed_codex_config
     };
 }
+/**
+ * 归一化当前模型出口选择，避免历史 state 或手工编辑内容让代理入口进入未知模式。
+ *
+ * @param value state 文件中记录的模型出口选择。
+ * @returns 可安全使用的模型出口选择；非法内容回退到官方账号池。
+ * @throws 无显式抛出。
+ */
+function normalizeModelRouteSelection(value) {
+    if (value?.mode === "relay_slot" && value.relay_slot_id) {
+        return {
+            mode: "relay_slot",
+            relay_slot_id: value.relay_slot_id
+        };
+    }
+    return {
+        mode: "auth_pool"
+    };
+}
 /**
  * 读取 cslot 的本地运行状态；文件不存在时返回默认空状态。
  *
@@ -261,6 +285,32 @@ function setSelectedCodexAuthAccountId(accountId) {
         state.selected_codex_auth_account_id = accountId;
     });
 }
+/**
+ * 读取当前模型请求出口选择。
+ *
+ * 业务含义：
+ * 1. `auth_pool` 表示 `/v1/*` 继续走官方账号自动调度。
+ * 2. `relay_slot` 表示 `/v1/*` 固定走指定 OpenAI-compatible 中转槽位。
+ * 3. 该选择不影响 Codex App 主登录态与 `/backend-api/*` 插件链路。
+ *
+ * @returns 当前模型出口选择。
+ * @throws 当 state 文件读取或解析失败时透传底层异常。
+ */
+function getSelectedModelRoute() {
+    return normalizeModelRouteSelection(loadState().selected_model_route);
+}
+/**
+ * 保存当前模型请求出口选择。
+ *
+ * @param selection 模型出口选择；`null` 表示恢复官方账号池。
+ * @returns 无返回值。
+ * @throws 当 state 文件写入失败时透传底层异常。
+ */
+function setSelectedModelRoute(selection) {
+    updateState((state) => {
+        state.selected_model_route = normalizeModelRouteSelection(selection);
+    });
+}
 /**
  * 读取当前记录的 Codex `config.toml` 接管快照。
  *

package/dist/status-command.js

@@ -245,6 +245,12 @@ function resolveInitialCursorIndex(accounts, statuses, selectedAuthAccountId) {
     }
     return 0;
 }
+function buildInteractiveItems(accounts, relaySlots) {
+    return [
+        ...accounts.map((account) => ({ type: "account", id: account.id })),
+        ...relaySlots.map((slot) => ({ type: "relay", id: slot.id }))
+    ];
+}
 /**
  * 将状态面板中选中的账号立即应用为 Codex App 主登录态。
  *
@@ -286,15 +292,27 @@ async function handleInteractiveToggle(initialStatuses) {
     node_readline_1.default.emitKeypressEvents(stdin);
     stdin.setRawMode?.(true);
     const accountsFromConfig = (0, account_service_1.listAccounts)();
-    if (accountsFromConfig.length === 0) {
-        console.log((0, text_1.bi)("当前没有已录入账号。", "No managed accounts found."));
+    const latestSnapshotForRelays = (0, status_service_1.getStatusSnapshot)();
+    const relaySlotsFromConfig = latestSnapshotForRelays.relaySlots;
+    if (accountsFromConfig.length === 0 && relaySlotsFromConfig.length === 0) {
+        console.log((0, text_1.bi)("当前没有已录入账号或中转槽位。", "No managed accounts or relay slots found."));
         stdin.setRawMode?.(false);
         return;
     }
     const accounts = [...accountsFromConfig].sort((left, right) => left.name.localeCompare(right.name));
+    const relaySlots = [...relaySlotsFromConfig].sort((left, right) => left.name.localeCompare(right.name));
     let selectedAuthAccountId = (0, state_1.getSelectedCodexAuthAccountId)();
-    let cursor = resolveInitialCursorIndex(accounts, initialStatuses ?? (0, status_1.collectAccountStatuses)(), selectedAuthAccountId);
-    let changed = false;
+    const initialItems = buildInteractiveItems(accounts, relaySlots);
+    const selectedModelRoute = (0, state_1.getSelectedModelRoute)();
+    const initialAccountCursor = resolveInitialCursorIndex(accounts, initialStatuses ?? (0, status_1.collectAccountStatuses)(), selectedAuthAccountId);
+    const selectedRelayIndex = selectedModelRoute.mode === "relay_slot"
+        ? relaySlots.findIndex((slot) => slot.id === selectedModelRoute.relay_slot_id)
+        : -1;
+    let cursor = selectedRelayIndex >= 0
+        ? accounts.length + selectedRelayIndex
+        : Math.min(initialAccountCursor, Math.max(0, initialItems.length - 1));
+    let accountChanged = false;
+    let relayChanged = false;
     enterInteractiveScreen();
     return await new Promise((resolve) => {
         let closed = false;
@@ -304,7 +322,9 @@ async function handleInteractiveToggle(initialStatuses) {
             const screenWidth = process.stdout.columns ?? 80;
             const styled = shouldUseAnsiStyle();
             const latestSnapshot = (0, status_service_1.getStatusSnapshot)();
-            const statusSource = changed ? latestSnapshot.statuses : (initialStatuses ?? latestSnapshot.statuses);
+            const items = buildInteractiveItems(accounts, relaySlots);
+            const currentSelection = items[cursor] ?? null;
+            const statusSource = accountChanged ? latestSnapshot.statuses : (initialStatuses ?? latestSnapshot.statuses);
             const statusById = new Map(statusSource.map((item) => [item.id, item]));
             const autoSelectedId = (0, scheduler_1.pickBestAccount)()?.account.id ?? null;
             const summary = (0, status_1.summarizeAccountStatuses)(statusSource);
@@ -321,7 +341,20 @@ async function handleInteractiveToggle(initialStatuses) {
                 };
             })
                 .filter((item) => item !== null);
-            const currentItem = displayStatuses.find((item) => item.id === accounts[cursor]?.id) ?? null;
+            const displayRelays = relaySlots.map((slot) => {
+                const selected = latestSnapshot.modelRoute.mode === "relay_slot" &&
+                    latestSnapshot.modelRoute.relay_slot_id === slot.id;
+                return {
+                    ...slot,
+                    name: selected ? `${slot.name}*` : slot.name
+                };
+            });
+            const currentAccount = currentSelection?.type === "account"
+                ? displayStatuses.find((item) => item.id === currentSelection.id) ?? null
+                : null;
+            const currentRelay = currentSelection?.type === "relay"
+                ? displayRelays.find((item) => item.id === currentSelection.id) ?? null
+                : null;
             const wideLayout = screenWidth >= 104;
             const leftWidth = wideLayout ? Math.max(68, Math.floor(screenWidth * 0.64)) : screenWidth;
             const rightWidth = wideLayout ? Math.max(28, screenWidth - leftWidth - 3) : screenWidth;
@@ -333,41 +366,71 @@ async function handleInteractiveToggle(initialStatuses) {
                     styled,
                     selectorColumn: {
                         enabledById: Object.fromEntries(accounts.map((account) => [account.id, account.enabled])),
-                        cursorAccountId: accounts[cursor]?.id ?? null
+                        cursorAccountId: currentSelection?.type === "account" ? currentSelection.id : null
                     }
                 }).split("\n")
             ];
+            const relayLines = [
+                renderSectionHeader("relays", leftWidth, styled),
+                ...(displayRelays.length > 0
+                    ? (0, status_1.renderRelayStatusTable)(displayRelays, {
+                        compact: true,
+                        maxWidth: leftWidth,
+                        styled,
+                        selectorColumn: {
+                            enabledById: Object.fromEntries(relaySlots.map((slot) => [slot.id, slot.enabled])),
+                            cursorRelayId: currentSelection?.type === "relay" ? currentSelection.id : null
+                        }
+                    }).split("\n")
+                    : ["-"])
+            ];
+            const currentDetails = currentSelection?.type === "relay"
+                ? (0, status_1.renderRelayStatusDetails)(currentRelay, { maxWidth: rightWidth, header: false }).split("\n")
+                : (0, status_1.renderStatusDetails)(currentAccount, { maxWidth: rightWidth, header: false }).split("\n");
             const sideLines = [
                 renderSectionHeader("current", rightWidth, styled),
-                ...(0, status_1.renderStatusDetails)(currentItem, { maxWidth: rightWidth, header: false }).split("\n"),
+                ...currentDetails,
                 "",
                 renderSectionHeader("summary", rightWidth, styled),
                 renderSummaryLine(summary, rightWidth < 42, styled),
+                `model_route=${latestSnapshot.modelRouteLabel}`,
                 `scheduler=${latestSnapshot.selectedName ?? "none"}`,
                 `codex_auth=${selectedAuthAccountId ?? "none"}`,
+                `relay_slots=${latestSnapshot.relaySlots.length}`,
                 ...(refreshStatusText ? [`refresh=${refreshStatusText}`] : []),
                 "",
                 renderSectionHeader("help", rightWidth, styled),
-                "↑/↓ move    Space toggle    a app-auth    c clear    r refresh    Enter/q exit"
+                "↑/↓ move    Space toggle    a app-auth    m model-route    c clear    r refresh    Enter/q exit"
+            ];
+            const leftLines = [
+                ...accountLines,
+                "",
+                ...relayLines
             ];
             if (wideLayout) {
-                renderInteractiveScreen(renderColumns(accountLines, sideLines, 3));
+                renderInteractiveScreen(renderColumns(leftLines, sideLines, 3));
                 return;
             }
             renderInteractiveScreen([
-                ...accountLines,
+                ...leftLines,
                 "",
                 renderDivider(screenWidth, styled),
                 ...sideLines
             ]);
         };
         const applyChanges = () => {
-            if (!changed) {
+            if (!accountChanged && !relayChanged) {
                 return;
             }
-            (0, status_service_1.persistAccountEnabledState)(accounts);
-            changed = false;
-            initialStatuses = (0, status_1.collectAccountStatuses)();
+            if (accountChanged) {
+                (0, status_service_1.persistAccountEnabledState)(accounts);
+                accountChanged = false;
+                initialStatuses = (0, status_1.collectAccountStatuses)();
+            }
+            if (relayChanged) {
+                (0, status_service_1.persistRelayEnabledState)(relaySlots);
+                relayChanged = false;
+            }
         };
         const exitInteractive = () => {
             if (closed) {
@@ -392,7 +455,7 @@ async function handleInteractiveToggle(initialStatuses) {
                 return;
             }
             if (key.name === "down") {
-                const nextCursor = Math.min(accounts.length - 1, cursor + 1);
+                const nextCursor = Math.min(buildInteractiveItems(accounts, relaySlots).length - 1, cursor + 1);
                 if (nextCursor !== cursor) {
                     cursor = nextCursor;
                     render();
@@ -400,14 +463,33 @@ async function handleInteractiveToggle(initialStatuses) {
                 return;
             }
             if (key.name === "space") {
-                accounts[cursor].enabled = !accounts[cursor].enabled;
-                changed = true;
+                const item = buildInteractiveItems(accounts, relaySlots)[cursor];
+                if (item?.type === "account") {
+                    const account = accounts.find((candidate) => candidate.id === item.id);
+                    if (account) {
+                        account.enabled = !account.enabled;
+                        accountChanged = true;
+                    }
+                }
+                else if (item?.type === "relay") {
+                    const slot = relaySlots.find((candidate) => candidate.id === item.id);
+                    if (slot) {
+                        slot.enabled = !slot.enabled;
+                        relayChanged = true;
+                    }
+                }
                 applyChanges();
                 render();
                 return;
             }
             if (key.name === "a") {
-                const account = accounts[cursor];
+                const item = buildInteractiveItems(accounts, relaySlots)[cursor];
+                if (item?.type !== "account") {
+                    refreshStatusText = "app-auth requires account";
+                    render();
+                    return;
+                }
+                const account = accounts.find((candidate) => candidate.id === item.id);
                 if (!account) {
                     return;
                 }
@@ -422,6 +504,33 @@ async function handleInteractiveToggle(initialStatuses) {
                 render();
                 return;
             }
+            if (key.name === "m") {
+                const item = buildInteractiveItems(accounts, relaySlots)[cursor];
+                if (item?.type === "relay") {
+                    const slot = relaySlots.find((candidate) => candidate.id === item.id);
+                    if (!slot) {
+                        return;
+                    }
+                    if (!slot.enabled) {
+                        refreshStatusText = `relay_disabled=${slot.id}`;
+                        render();
+                        return;
+                    }
+                    (0, state_1.setSelectedModelRoute)({
+                        mode: "relay_slot",
+                        relay_slot_id: slot.id
+                    });
+                    refreshStatusText = `model_route=relay:${slot.id}`;
+                    render();
+                    return;
+                }
+                (0, state_1.setSelectedModelRoute)({
+                    mode: "auth_pool"
+                });
+                refreshStatusText = "model_route=auth_pool";
+                render();
+                return;
+            }
             if (key.name === "c") {
                 selectedAuthAccountId = null;
                 (0, state_1.setSelectedCodexAuthAccountId)(null);
@@ -485,8 +594,21 @@ async function handleStatus(options) {
         name: `${item.name}${item.id === (0, scheduler_1.pickBestAccount)()?.account.id ? "*" : ""}${item.id === snapshot.codexAuthAccountId ? "@" : ""}`
     }));
     console.log((0, status_1.renderStatusTable)(displayStatuses));
+    if (snapshot.relaySlots.length > 0) {
+        const displayRelays = snapshot.relaySlots.map((slot) => ({
+            ...slot,
+            name: snapshot.modelRoute.mode === "relay_slot" &&
+                snapshot.modelRoute.relay_slot_id === slot.id
+                ? `${slot.name}*`
+                : slot.name
+        }));
+        console.log("");
+        console.log((0, status_1.renderRelayStatusTable)(displayRelays));
+    }
     console.log("");
     console.log(`available=${snapshot.summary.available} 5h_limited=${snapshot.summary.fiveHourLimited} weekly_limited=${snapshot.summary.weeklyLimited}`);
+    console.log(`model_route=${snapshot.modelRouteLabel}`);
     console.log(`scheduler=${snapshot.selectedName ?? "none"}`);
     console.log(`codex_auth=${snapshot.codexAuthAccountId ?? "none"}`);
+    console.log(`relay_slots=${snapshot.relaySlots.length}`);
 }

package/dist/status.js

@@ -4,6 +4,8 @@ exports.collectAccountStatuses = collectAccountStatuses;
 exports.summarizeAccountStatuses = summarizeAccountStatuses;
 exports.renderStatusTable = renderStatusTable;
 exports.renderStatusDetails = renderStatusDetails;
+exports.renderRelayStatusTable = renderRelayStatusTable;
+exports.renderRelayStatusDetails = renderRelayStatusDetails;
 const config_1 = require("./config");
 const account_store_1 = require("./account-store");
 const state_1 = require("./state");
@@ -554,3 +556,73 @@ function renderStatusDetails(item, options) {
     }
     return lines.join("\n");
 }
+/**
+ * 将 relay slot 状态渲染为适合终端输出的表格文本。
+ *
+ * @param slots 待展示的 relay slot 列表。
+ * @param options 渲染选项；交互模式下可传入选择列配置。
+ * @returns 可直接打印到终端的表格字符串。
+ * @throws 无显式抛出。
+ */
+function renderRelayStatusTable(slots, options) {
+    const selectorColumn = options?.selectorColumn;
+    const compact = options?.compact ?? false;
+    const maxWidth = options?.maxWidth ?? Number.POSITIVE_INFINITY;
+    const compactHeader = maxWidth < 68;
+    const relayHeader = compactHeader ? "ID" : "RELAY";
+    const statusHeader = compactHeader ? "ST" : "STATUS";
+    const relayWidth = Math.max(getDisplayWidth(relayHeader), ...slots.map((item) => getDisplayWidth(item.name)));
+    const statusWidth = compactHeader ? 8 : 10;
+    const fixedWidth = (selectorColumn ? 4 + 2 : 0) + relayWidth + 2 + statusWidth + 2;
+    const baseUrlWidth = Number.isFinite(maxWidth)
+        ? Math.max(12, Math.floor(maxWidth) - fixedWidth)
+        : Math.max(getDisplayWidth("BASE_URL"), ...slots.map((item) => getDisplayWidth(item.base_url)));
+    const rows = [
+        [
+            ...(selectorColumn ? [" "] : []),
+            relayHeader,
+            statusHeader,
+            "BASE_URL"
+        ]
+    ];
+    for (const slot of slots) {
+        const selectorCell = selectorColumn
+            ? `${selectorColumn.cursorRelayId === slot.id ? ">" : " "}[${selectorColumn.enabledById[slot.id] ? "x" : " "}]`
+            : null;
+        const status = slot.enabled ? "enabled" : "disabled";
+        rows.push([
+            ...(selectorCell ? [selectorCell] : []),
+            styleNameCell(truncateCell(slot.name, relayWidth), options?.styled ?? false),
+            truncateCell(status, statusWidth),
+            truncateCell(slot.base_url, baseUrlWidth)
+        ]);
+    }
+    const widths = rows[0].map((_, columnIndex) => Math.max(...rows.map((row) => getDisplayWidth(row[columnIndex]))));
+    return rows
+        .map((row) => row.map((cell, index) => padCell(cell, widths[index])).join("  "))
+        .join("\n");
+}
+/**
+ * 将当前选中 relay slot 渲染为紧凑详情区。
+ *
+ * @param slot 当前选中的 relay slot；为空时返回占位提示。
+ * @param options 详情区渲染选项。
+ * @returns 适合直接打印的详情区文本。
+ * @throws 无显式抛出。
+ */
+function renderRelayStatusDetails(slot, options) {
+    const includeHeader = options?.header ?? true;
+    if (!slot) {
+        return [includeHeader ? "[ relay ]" : "slot   -", includeHeader ? "slot   -" : ""]
+            .filter((line) => line.length > 0)
+            .join("\n");
+    }
+    const maxWidth = options?.maxWidth ?? Number.POSITIVE_INFINITY;
+    return [
+        ...(includeHeader ? ["[ relay ]"] : []),
+        formatDetailLine("slot", slot.name, maxWidth),
+        formatDetailLine("status", slot.enabled ? "enabled" : "disabled", maxWidth),
+        formatDetailLine("base", slot.base_url, maxWidth),
+        formatDetailLine("key", "********", maxWidth)
+    ].join("\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-slot",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "description": "本地 Codex 多账号切换与状态管理工具",
   "type": "commonjs",
   "main": "dist/cli.js",