codex-slot 0.1.30 → 0.1.32

package/dist/cli.js

@@ -10,37 +10,22 @@ const service_control_1 = require("./service-control");
 const status_command_1 = require("./status-command");
 const text_1 = require("./text");
 /**
- * 生成根 help 中的 relay 与模型出口命令说明。
+ * 生成根 help 中 relay 与模型出口相关的示例命令。
  *
  * 业务含义：
- * 1. Commander 默认命令列表会按终端宽度折行，中英混排时可读性较差。
- * 2. 最近新增的 relay/use/current 命令需要用固定双语格式补充业务含义和使用方式。
+ * 1. 根 help 的主命令列表保持 Commander 默认风格。
+ * 2. relay/use/current 的常见用法只补充到示例区，避免额外文档块打断整体格式。
  *
  * @returns 可追加到根 help 的多行说明。
  * @throws 无显式抛出。
  */
-function renderRelayCommandHelp() {
+function renderRelayCommandExamples() {
     return [
-        "",
-        "中转命令 / Relay commands:",
-        "  cslot relay add <name> --base-url <url> --api-key <key>",
-        "    中文: 新增 OpenAI-compatible 中转槽位。",
-        "    English: Add an OpenAI-compatible relay slot.",
+        "  cslot relay add third --base-url https://relay.example.com/v1 --api-key <key>",
         "  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 relay third",
         "  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."
+        "  cslot current"
     ];
 }
 /**
@@ -63,7 +48,7 @@ function configureRootProgram(program) {
         "  cslot rename work work-main",
         "  cslot start --port 4399",
         "  cslot status --no-interactive",
-        ...renderRelayCommandHelp(),
+        ...renderRelayCommandExamples(),
         "",
         `${(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.")}`

package/dist/status-command.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderInteractiveHelpLines = renderInteractiveHelpLines;
+exports.renderInteractiveStatusLayout = renderInteractiveStatusLayout;
 exports.handleStatus = handleStatus;
 const node_readline_1 = __importDefault(require("node:readline"));
 const account_store_1 = require("./account-store");
@@ -218,18 +219,64 @@ function truncateVisible(value, maxWidth) {
  * @param leftLines 左栏文本行。
  * @param rightLines 右栏文本行。
  * @param gap 两栏之间的空格数量。
+ * @param leftWidth 左栏固定显示宽度；未传入时按左栏最长行自适应。
  * @returns 合并后的双栏文本行。
  * @throws 无显式抛出。
  */
-function renderColumns(leftLines, rightLines, gap) {
-    const leftWidth = Math.max(0, ...leftLines.map((line) => getDisplayWidth(line)));
+function renderColumns(leftLines, rightLines, gap, leftWidth) {
+    const resolvedLeftWidth = leftWidth ?? Math.max(0, ...leftLines.map((line) => getDisplayWidth(line)));
     const rowCount = Math.max(leftLines.length, rightLines.length);
     const rows = [];
     for (let index = 0; index < rowCount; index += 1) {
-        rows.push(`${padVisible(leftLines[index] ?? "", leftWidth)}${" ".repeat(gap)}${rightLines[index] ?? ""}`.trimEnd());
+        rows.push(`${padVisible(leftLines[index] ?? "", resolvedLeftWidth)}${" ".repeat(gap)}${rightLines[index] ?? ""}`.trimEnd());
     }
     return rows;
 }
+/**
+ * 按终端高度裁剪交互式面板输出行，避免写到最后一行后继续换行触发滚屏。
+ *
+ * 业务含义：
+ * 1. 交互面板每次都从左上角整屏重绘。
+ * 2. 当输出行数超过当前终端高度时，终端会滚动备用屏缓冲区，后续重绘会出现残影或错位。
+ * 3. 保留最后一行作为安全缓冲，兼容不同终端对末行写入与换行的处理差异。
+ *
+ * @param lines 已完成布局的面板行。
+ * @param screenHeight 当前终端行数；为空或非法时不裁剪。
+ * @returns 可安全输出到当前终端的面板行。
+ * @throws 无显式抛出。
+ */
+function clipInteractiveLines(lines, screenHeight) {
+    if (screenHeight === undefined || !Number.isFinite(screenHeight) || screenHeight <= 1) {
+        return lines;
+    }
+    return lines.slice(0, Math.max(1, Math.floor(screenHeight) - 1));
+}
+/**
+ * 构建交互式状态面板的最终屏幕行。
+ *
+ * 业务含义：
+ * 1. 该方法只负责布局，不读取或写入 cslot 状态，便于用纯测试覆盖终端尺寸边界。
+ * 2. 宽屏时使用固定左栏宽度，让右侧详情栏在账号/relay 选择切换时保持稳定锚点。
+ * 3. 窄屏时改为上下布局，并按终端高度裁剪，避免上下移动触发重绘后滚屏。
+ *
+ * @param options 布局参数；`leftLines` 为账号与 relay 主列表，`sideLines` 为当前项、摘要与 help，`screenWidth`/`screenHeight` 来自当前终端尺寸，`styled` 控制分隔线样式。
+ * @returns 可直接传给终端输出函数的屏幕行。
+ * @throws 无显式抛出。
+ */
+function renderInteractiveStatusLayout(options) {
+    const screenWidth = Math.max(1, Math.floor(options.screenWidth));
+    const wideLayout = screenWidth >= 104;
+    const leftWidth = wideLayout ? Math.max(68, Math.floor(screenWidth * 0.64)) : screenWidth;
+    const lines = wideLayout
+        ? renderColumns(options.leftLines, options.sideLines, 3, leftWidth)
+        : [
+            ...options.leftLines,
+            "",
+            renderDivider(screenWidth, options.styled),
+            ...options.sideLines
+        ];
+    return clipInteractiveLines(lines, options.screenHeight);
+}
 /**
  * 进入交互式全屏缓冲区，并隐藏光标，确保后续重绘始终基于固定画布。
  *
@@ -261,7 +308,6 @@ function renderInteractiveScreen(lines) {
     node_readline_1.default.cursorTo(process.stdout, 0, 0);
     node_readline_1.default.clearScreenDown(process.stdout);
     process.stdout.write(lines.join("\n"));
-    process.stdout.write("\n");
 }
 /**
  * 计算交互式状态面板的初始光标位置。
@@ -378,6 +424,7 @@ async function handleInteractiveToggle(initialStatuses) {
         let refreshStatusText = null;
         const render = () => {
             const screenWidth = process.stdout.columns ?? 80;
+            const screenHeight = process.stdout.rows;
             const styled = shouldUseAnsiStyle();
             const latestSnapshot = (0, status_service_1.getStatusSnapshot)();
             const items = buildInteractiveItems(accounts, relaySlots);
@@ -465,16 +512,13 @@ async function handleInteractiveToggle(initialStatuses) {
                 "",
                 ...relayLines
             ];
-            if (wideLayout) {
-                renderInteractiveScreen(renderColumns(leftLines, sideLines, 3));
-                return;
-            }
-            renderInteractiveScreen([
-                ...leftLines,
-                "",
-                renderDivider(screenWidth, styled),
-                ...sideLines
-            ]);
+            renderInteractiveScreen(renderInteractiveStatusLayout({
+                leftLines,
+                sideLines,
+                screenWidth,
+                screenHeight,
+                styled
+            }));
         };
         const applyChanges = () => {
             if (!accountChanged && !relayChanged) {
@@ -497,6 +541,7 @@ async function handleInteractiveToggle(initialStatuses) {
             closed = true;
             applyChanges();
             stdin.off("keypress", onKeypress);
+            process.stdout.off("resize", onResize);
             stdin.setRawMode?.(false);
             stdin.pause();
             leaveInteractiveScreen();
@@ -629,8 +674,14 @@ async function handleInteractiveToggle(initialStatuses) {
                 exitInteractive();
             }
         };
+        const onResize = () => {
+            if (!closed) {
+                render();
+            }
+        };
         render();
         stdin.on("keypress", onKeypress);
+        process.stdout.on("resize", onResize);
     });
 }
 /**

package/package.json

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