codex-slot 0.1.29 → 0.1.30

package/dist/cli.js

@@ -9,6 +9,40 @@ 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");
+/**
+ * 生成根 help 中的 relay 与模型出口命令说明。
+ *
+ * 业务含义：
+ * 1. Commander 默认命令列表会按终端宽度折行，中英混排时可读性较差。
+ * 2. 最近新增的 relay/use/current 命令需要用固定双语格式补充业务含义和使用方式。
+ *
+ * @returns 可追加到根 help 的多行说明。
+ * @throws 无显式抛出。
+ */
+function renderRelayCommandHelp() {
+    return [
+        "",
+        "中转命令 / Relay commands:",
+        "  cslot relay add <name> --base-url <url> --api-key <key>",
+        "    中文: 新增 OpenAI-compatible 中转槽位。",
+        "    English: Add an OpenAI-compatible relay slot.",
+        "  cslot relay list",
+        "    中文: 查看全部中转槽位，API key 会脱敏。",
+        "    English: List relay slots with API keys masked.",
+        "  cslot relay enable <name> / cslot relay disable <name>",
+        "    中文: 控制某个中转槽位是否参与模型出口选择。",
+        "    English: Enable or disable a relay slot for model routing.",
+        "  cslot use relay <name>",
+        "    中文: 固定模型请求走指定中转槽位。",
+        "    English: Route model requests through the selected relay slot.",
+        "  cslot use auth",
+        "    中文: 恢复使用官方 Codex 账号池。",
+        "    English: Restore routing through the official Codex auth pool.",
+        "  cslot current",
+        "    中文: 查看当前模型出口和 Codex App 登录态选择。",
+        "    English: Show the active model route and Codex App auth selection."
+    ];
+}
 /**
  * 为 CLI 程序注册根级帮助信息与统一示例。
  *
@@ -29,6 +63,7 @@ function configureRootProgram(program) {
         "  cslot rename work work-main",
         "  cslot start --port 4399",
         "  cslot status --no-interactive",
+        ...renderRelayCommandHelp(),
         "",
         `${(0, text_1.bi)("说明", "Notes")}:`,
         `  ${(0, text_1.bi)("`import current ~` 里的 current 只是示例槽位名，不是内置账号或工作空间。", "`current` in `import current ~` is only an example slot name, not a built-in account or workspace.")}`
@@ -82,10 +117,10 @@ function registerAccountCommands(program) {
 function registerRelayCommands(program) {
     const relay = program
         .command("relay")
-        .description((0, text_1.bi)("管理 OpenAI-compatible 中转槽位", "Manage OpenAI-compatible relay slots"));
+        .description((0, text_1.bi)("管理中转槽位", "Manage relay slots"));
     relay
         .command("add")
-        .description((0, text_1.bi)("新增一个中转槽位", "Add a relay slot"))
+        .description((0, text_1.bi)("新增中转槽位", "Add 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"))
@@ -107,29 +142,29 @@ function registerRelayCommands(program) {
         .action(relay_commands_1.handleRelayRename);
     relay
         .command("enable")
-        .description((0, text_1.bi)("启用一个中转槽位", "Enable a relay slot"))
+        .description((0, text_1.bi)("启用中转槽位", "Enable 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"))
+        .description((0, text_1.bi)("禁用中转槽位", "Disable 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"));
+        .description((0, text_1.bi)("切换模型出口", "Switch model route"));
     use
         .command("relay")
-        .description((0, text_1.bi)("固定模型请求到指定中转槽位", "Fix model route to a relay slot"))
+        .description((0, text_1.bi)("使用指定中转槽位", "Use 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"))
+        .description((0, text_1.bi)("使用官方账号池", "Use 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"))
+        .description((0, text_1.bi)("查看当前出口", "Show current route"))
         .action(relay_commands_1.handleCurrent);
 }
 /**

package/dist/status-command.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderInteractiveHelpLines = renderInteractiveHelpLines;
 exports.handleStatus = handleStatus;
 const node_readline_1 = __importDefault(require("node:readline"));
 const account_store_1 = require("./account-store");
@@ -94,6 +95,32 @@ function renderSummaryLine(summary, narrowScreen, styled) {
     }
     return `available=${available}  5h_limited=${fiveHourLimited}  weekly_limited=${weeklyLimited}`;
 }
+/**
+ * 渲染交互状态面板的快捷键说明，并确保每一行都能放进右侧详情栏。
+ *
+ * 业务含义：
+ * 1. 状态页在宽终端使用双栏布局，右栏宽度可能仍然较窄。
+ * 2. 快捷键说明必须逐行展示，避免单条长 help 在终端自动换行后打乱面板。
+ *
+ * @param maxWidth 右侧详情栏可用显示宽度；小于等于 0 时返回空列表。
+ * @returns 逐行渲染后的快捷键说明。
+ * @throws 无显式抛出。
+ */
+function renderInteractiveHelpLines(maxWidth) {
+    if (maxWidth <= 0) {
+        return [];
+    }
+    const lines = [
+        "↑/↓    move/select",
+        "Space  toggle enabled",
+        "a      app auth",
+        "m      model route",
+        "c      clear app auth",
+        "r      refresh usage",
+        "Enter/q exit"
+    ];
+    return lines.map((line) => truncateVisible(line, maxWidth));
+}
 /**
  * 移除 ANSI 控制序列，避免布局计算把颜色码当成可见字符。
  *
@@ -150,6 +177,37 @@ function getDisplayWidth(value) {
 function padVisible(value, width) {
     return `${value}${" ".repeat(Math.max(0, width - getDisplayWidth(value)))}`;
 }
+/**
+ * 按显示宽度截断文本，保留省略号提示内容被压缩。
+ *
+ * @param value 原始文本。
+ * @param maxWidth 最大显示列宽。
+ * @returns 截断后的文本。
+ * @throws 无显式抛出。
+ */
+function truncateVisible(value, maxWidth) {
+    if (maxWidth <= 0) {
+        return "";
+    }
+    if (getDisplayWidth(value) <= maxWidth) {
+        return value;
+    }
+    if (maxWidth <= 2) {
+        return value.slice(0, maxWidth);
+    }
+    let output = "";
+    let width = 0;
+    const ellipsisWidth = getDisplayWidth("…");
+    for (const char of value) {
+        const charWidth = getDisplayWidth(char);
+        if (width + charWidth + ellipsisWidth > maxWidth) {
+            break;
+        }
+        output += char;
+        width += charWidth;
+    }
+    return `${output}…`;
+}
 /**
  * 将左右两组文本行渲染为双栏布局。
  *
@@ -400,7 +458,7 @@ async function handleInteractiveToggle(initialStatuses) {
                 ...(refreshStatusText ? [`refresh=${refreshStatusText}`] : []),
                 "",
                 renderSectionHeader("help", rightWidth, styled),
-                "↑/↓ move    Space toggle    a app-auth    m model-route    c clear    r refresh    Enter/q exit"
+                ...renderInteractiveHelpLines(rightWidth)
             ];
             const leftLines = [
                 ...accountLines,

package/dist/status.js

@@ -575,7 +575,7 @@ function renderRelayStatusTable(slots, options) {
     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(12, Math.min(72, Math.floor(maxWidth) - fixedWidth))
         : Math.max(getDisplayWidth("BASE_URL"), ...slots.map((item) => getDisplayWidth(item.base_url)));
     const rows = [
         [

package/package.json

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