codex-slot 0.1.19 → 0.1.21

package/dist/state-repository.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSchedulerStatsSnapshot = loadSchedulerStatsSnapshot;
+exports.recordAccountScheduleSuccess = recordAccountScheduleSuccess;
+const state_1 = require("./state");
+/**
+ * 读取全部账号的调度统计快照。
+ *
+ * 业务含义：
+ * 1. 调度器一次调度只读取一次统计，避免评分过程中反复触碰 state 文件。
+ * 2. 返回值是普通对象快照，调用方不得把它当作可自动持久化的引用。
+ *
+ * @returns 账号调度统计表；key 为账号 id。
+ * @throws 当 state 文件读取或 JSON 解析失败时透传底层异常。
+ */
+function loadSchedulerStatsSnapshot() {
+    return (0, state_1.loadState)().scheduler_stats;
+}
+/**
+ * 记录指定账号完成一次成功代理请求。
+ *
+ * 业务含义：
+ * 1. 该统计只服务于调度均匀分摊，不参与额度判断。
+ * 2. 每次成功上游响应后递增成功次数并刷新最近成功时间。
+ *
+ * @param accountId 账号标识；必须是当前配置中的受管账号 id。
+ * @returns 无返回值。
+ * @throws 当 state 文件写入失败时透传底层异常。
+ */
+function recordAccountScheduleSuccess(accountId) {
+    (0, state_1.updateState)((state) => {
+        const current = state.scheduler_stats[accountId] ?? {
+            success_count: 0,
+            last_success_at: null
+        };
+        state.scheduler_stats[accountId] = {
+            success_count: current.success_count + 1,
+            last_success_at: new Date().toISOString()
+        };
+    });
+}

package/dist/state.js

@@ -5,7 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadState = loadState;
 exports.saveState = saveState;
+exports.updateState = updateState;
 exports.setAccountBlock = setAccountBlock;
+exports.clearAccountBlock = clearAccountBlock;
 exports.pruneExpiredBlocks = pruneExpiredBlocks;
 exports.getAccountBlock = getAccountBlock;
 exports.setUsageCache = setUsageCache;
@@ -13,8 +15,6 @@ exports.getUsageCache = getUsageCache;
 exports.setUsageRefreshError = setUsageRefreshError;
 exports.clearUsageRefreshError = clearUsageRefreshError;
 exports.getUsageRefreshError = getUsageRefreshError;
-exports.getSchedulerStats = getSchedulerStats;
-exports.recordAccountScheduleSuccess = recordAccountScheduleSuccess;
 exports.getManagedCodexConfigState = getManagedCodexConfigState;
 exports.getManagedCodexAuthState = getManagedCodexAuthState;
 exports.setManagedCodexConfigState = setManagedCodexConfigState;
@@ -24,9 +24,50 @@ exports.clearManagedCodexAuthState = clearManagedCodexAuthState;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const config_1 = require("./config");
+const STATE_SCHEMA_VERSION = 1;
 function getStatePath() {
     return node_path_1.default.join((0, config_1.getCslotHome)(), "state.json");
 }
+/**
+ * 构造当前版本的默认本地状态对象。
+ *
+ * 业务含义：
+ * 1. 所有缺失或空 state 文件统一走这里补齐字段。
+ * 2. 新增状态字段时只需要在默认状态与归一化逻辑中集中维护。
+ *
+ * @returns 当前 schema 版本的默认状态。
+ * @throws 无显式抛出。
+ */
+function createDefaultState() {
+    return {
+        state_version: STATE_SCHEMA_VERSION,
+        account_blocks: {},
+        usage_cache: {},
+        usage_refresh_errors: {},
+        scheduler_stats: {},
+        managed_codex_auth: null,
+        managed_codex_config: null
+    };
+}
+/**
+ * 将历史版本或字段缺失的 state 归一化为当前 schema。
+ *
+ * @param parsed 从 state 文件解析出的原始对象。
+ * @returns 补齐默认字段后的当前版本状态。
+ * @throws 无显式抛出。
+ */
+function normalizeState(parsed) {
+    const defaults = createDefaultState();
+    return {
+        state_version: STATE_SCHEMA_VERSION,
+        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,
+        scheduler_stats: parsed?.scheduler_stats ?? defaults.scheduler_stats,
+        managed_codex_auth: parsed?.managed_codex_auth ?? defaults.managed_codex_auth,
+        managed_codex_config: parsed?.managed_codex_config ?? defaults.managed_codex_config
+    };
+}
 /**
  * 读取 cslot 的本地运行状态；文件不存在时返回默认空状态。
  *
@@ -35,34 +76,10 @@ function getStatePath() {
 function loadState() {
     const statePath = getStatePath();
     if (!node_fs_1.default.existsSync(statePath)) {
-        return {
-            account_blocks: {},
-            usage_cache: {},
-            usage_refresh_errors: {},
-            scheduler_stats: {},
-            managed_codex_auth: null,
-            managed_codex_config: null
-        };
+        return createDefaultState();
     }
     const raw = node_fs_1.default.readFileSync(statePath, "utf8");
-    const parsed = raw.trim()
-        ? JSON.parse(raw)
-        : {
-            account_blocks: {},
-            usage_cache: {},
-            usage_refresh_errors: {},
-            scheduler_stats: {},
-            managed_codex_auth: null,
-            managed_codex_config: null
-        };
-    return {
-        account_blocks: parsed.account_blocks ?? {},
-        usage_cache: parsed.usage_cache ?? {},
-        usage_refresh_errors: parsed.usage_refresh_errors ?? {},
-        scheduler_stats: parsed.scheduler_stats ?? {},
-        managed_codex_auth: parsed.managed_codex_auth ?? null,
-        managed_codex_config: parsed.managed_codex_config ?? null
-    };
+    return normalizeState(raw.trim() ? JSON.parse(raw) : null);
 }
 /**
  * 持久化 cslot 的本地运行状态。
@@ -72,7 +89,27 @@ function loadState() {
  */
 function saveState(state) {
     const statePath = getStatePath();
-    node_fs_1.default.writeFileSync(statePath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+    const normalizedState = normalizeState(state);
+    const tempPath = `${statePath}.${process.pid}.${Date.now()}.tmp`;
+    node_fs_1.default.writeFileSync(tempPath, `${JSON.stringify(normalizedState, null, 2)}\n`, "utf8");
+    node_fs_1.default.renameSync(tempPath, statePath);
+}
+/**
+ * 在单一边界内读取、修改并保存本地状态。
+ *
+ * 业务含义：
+ * 1. 所有状态写入都统一经过当前函数，避免各模块散落 load/mutate/save 流程。
+ * 2. 保存阶段复用原子替换写入，降低半写入状态文件风险。
+ *
+ * @param mutator 状态修改函数；接收当前状态对象并可原地修改。
+ * @returns 修改后已保存的状态对象。
+ * @throws 当读取、修改或写入失败时透传底层异常。
+ */
+function updateState(mutator) {
+    const state = loadState();
+    mutator(state);
+    saveState(state);
+    return state;
 }
 /**
  * 为指定账号设置本地禁用窗口，用于临时熔断或周限制冷却。
@@ -83,13 +120,24 @@ function saveState(state) {
  * @returns 无返回值。
  */
 function setAccountBlock(accountId, until, reason) {
-    const state = loadState();
-    state.account_blocks[accountId] = {
-        until,
-        reason,
-        updated_at: new Date().toISOString()
-    };
-    saveState(state);
+    updateState((state) => {
+        state.account_blocks[accountId] = {
+            until,
+            reason,
+            updated_at: new Date().toISOString()
+        };
+    });
+}
+/**
+ * 清理指定账号当前记录的本地禁用状态。
+ *
+ * @param accountId 账号标识。
+ * @returns 无返回值。
+ */
+function clearAccountBlock(accountId) {
+    updateState((state) => {
+        delete state.account_blocks[accountId];
+    });
 }
 /**
  * 清理已过期的账号禁用记录，并返回最新状态。
@@ -107,7 +155,16 @@ function pruneExpiredBlocks() {
         }
     }
     if (changed) {
-        saveState(state);
+        updateState((latest) => {
+            for (const accountId of Object.keys(state.account_blocks)) {
+                latest.account_blocks[accountId] = state.account_blocks[accountId];
+            }
+            for (const accountId of Object.keys(latest.account_blocks)) {
+                if (!(accountId in state.account_blocks)) {
+                    delete latest.account_blocks[accountId];
+                }
+            }
+        });
     }
     return state;
 }
@@ -128,9 +185,9 @@ function getAccountBlock(accountId) {
  * @returns 无返回值。
  */
 function setUsageCache(usage) {
-    const state = loadState();
-    state.usage_cache[usage.accountId] = usage;
-    saveState(state);
+    updateState((state) => {
+        state.usage_cache[usage.accountId] = usage;
+    });
 }
 /**
  * 读取指定账号最近一次成功刷新的额度缓存。
@@ -149,9 +206,9 @@ function getUsageCache(accountId) {
  * @returns 无返回值。
  */
 function setUsageRefreshError(usageError) {
-    const state = loadState();
-    state.usage_refresh_errors[usageError.accountId] = usageError;
-    saveState(state);
+    updateState((state) => {
+        state.usage_refresh_errors[usageError.accountId] = usageError;
+    });
 }
 /**
  * 清理指定账号最近一次记录的额度刷新失败状态，避免后续成功刷新后继续展示旧错误。
@@ -160,12 +217,9 @@ function setUsageRefreshError(usageError) {
  * @returns 无返回值。
  */
 function clearUsageRefreshError(accountId) {
-    const state = loadState();
-    if (!(accountId in state.usage_refresh_errors)) {
-        return;
-    }
-    delete state.usage_refresh_errors[accountId];
-    saveState(state);
+    updateState((state) => {
+        delete state.usage_refresh_errors[accountId];
+    });
 }
 /**
  * 读取指定账号最近一次记录的额度刷新失败状态。
@@ -177,37 +231,6 @@ function getUsageRefreshError(accountId) {
     const state = loadState();
     return state.usage_refresh_errors[accountId] ?? null;
 }
-/**
- * 读取指定账号的调度使用统计，用于在多账号可用时做均匀分摊。
- *
- * @param accountId 账号标识。
- * @returns 调度统计；不存在时返回默认零值。
- */
-function getSchedulerStats(accountId) {
-    const state = loadState();
-    return state.scheduler_stats[accountId] ?? {
-        success_count: 0,
-        last_success_at: null
-    };
-}
-/**
- * 记录指定账号完成一次成功代理请求，供后续调度降低连续命中同一账号的概率。
- *
- * @param accountId 账号标识。
- * @returns 无返回值。
- */
-function recordAccountScheduleSuccess(accountId) {
-    const state = loadState();
-    const current = state.scheduler_stats[accountId] ?? {
-        success_count: 0,
-        last_success_at: null
-    };
-    state.scheduler_stats[accountId] = {
-        success_count: current.success_count + 1,
-        last_success_at: new Date().toISOString()
-    };
-    saveState(state);
-}
 /**
  * 读取当前记录的 Codex `config.toml` 接管快照。
  *
@@ -233,9 +256,9 @@ function getManagedCodexAuthState() {
  * @returns 无返回值。
  */
 function setManagedCodexConfigState(managedState) {
-    const state = loadState();
-    state.managed_codex_config = managedState;
-    saveState(state);
+    updateState((state) => {
+        state.managed_codex_config = managedState;
+    });
 }
 /**
  * 保存 Codex 主 HOME 登录态接管快照，用于 stop 时恢复原始登录态文件。
@@ -244,9 +267,9 @@ function setManagedCodexConfigState(managedState) {
  * @returns 无返回值。
  */
 function setManagedCodexAuthState(managedState) {
-    const state = loadState();
-    state.managed_codex_auth = managedState;
-    saveState(state);
+    updateState((state) => {
+        state.managed_codex_auth = managedState;
+    });
 }
 /**
  * 清理 Codex `config.toml` 接管快照。
@@ -254,9 +277,9 @@ function setManagedCodexAuthState(managedState) {
  * @returns 无返回值。
  */
 function clearManagedCodexConfigState() {
-    const state = loadState();
-    state.managed_codex_config = null;
-    saveState(state);
+    updateState((state) => {
+        state.managed_codex_config = null;
+    });
 }
 /**
  * 清理 Codex 主 HOME 登录态接管快照。
@@ -264,7 +287,7 @@ function clearManagedCodexConfigState() {
  * @returns 无返回值。
  */
 function clearManagedCodexAuthState() {
-    const state = loadState();
-    state.managed_codex_auth = null;
-    saveState(state);
+    updateState((state) => {
+        state.managed_codex_auth = null;
+    });
 }

package/dist/status-command.js

@@ -91,6 +91,84 @@ function renderSummaryLine(summary, narrowScreen, styled) {
     }
     return `available=${available}  5h_limited=${fiveHourLimited}  weekly_limited=${weeklyLimited}`;
 }
+/**
+ * 移除 ANSI 控制序列，避免布局计算把颜色码当成可见字符。
+ *
+ * @param value 可能包含 ANSI 样式的文本。
+ * @returns 去除 ANSI 控制符后的文本。
+ * @throws 无显式抛出。
+ */
+function stripAnsi(value) {
+    return value.replace(/\x1b\[[0-9;]*m/g, "");
+}
+/**
+ * 判断字符是否应按双列宽展示。
+ *
+ * @param codePoint Unicode code point；必须来自单个字符迭代结果。
+ * @returns 中文、全角符号等宽字符返回 `true`，其他字符返回 `false`。
+ * @throws 无显式抛出。
+ */
+function isWideCodePoint(codePoint) {
+    return (codePoint >= 0x1100 &&
+        (codePoint <= 0x115f ||
+            codePoint === 0x2329 ||
+            codePoint === 0x232a ||
+            (codePoint >= 0x2e80 && codePoint <= 0xa4cf && codePoint !== 0x303f) ||
+            (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||
+            (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
+            (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||
+            (codePoint >= 0xfe30 && codePoint <= 0xfe6f) ||
+            (codePoint >= 0xff00 && codePoint <= 0xff60) ||
+            (codePoint >= 0xffe0 && codePoint <= 0xffe6)));
+}
+/**
+ * 计算文本在常见等宽终端中的显示列宽。
+ *
+ * @param value 待计算的文本；允许包含 ANSI 样式。
+ * @returns 文本实际占用的显示列数。
+ * @throws 无显式抛出。
+ */
+function getDisplayWidth(value) {
+    let width = 0;
+    for (const char of stripAnsi(value)) {
+        const codePoint = char.codePointAt(0) ?? 0;
+        width += isWideCodePoint(codePoint) ? 2 : 1;
+    }
+    return width;
+}
+/**
+ * 按显示宽度补齐右侧空格。
+ *
+ * @param value 原始文本；允许包含 ANSI 样式。
+ * @param width 目标显示列宽。
+ * @returns 右侧补齐后的文本。
+ * @throws 无显式抛出。
+ */
+function padVisible(value, width) {
+    return `${value}${" ".repeat(Math.max(0, width - getDisplayWidth(value)))}`;
+}
+/**
+ * 将左右两组文本行渲染为双栏布局。
+ *
+ * 业务含义：
+ * 1. 宽屏状态页左侧展示账号列表，右侧展示当前账号与摘要。
+ * 2. 左栏高度通常更高，右栏缺失行需要自动补空，避免右侧内容把左表挤乱。
+ *
+ * @param leftLines 左栏文本行。
+ * @param rightLines 右栏文本行。
+ * @param gap 两栏之间的空格数量。
+ * @returns 合并后的双栏文本行。
+ * @throws 无显式抛出。
+ */
+function renderColumns(leftLines, rightLines, gap) {
+    const 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());
+    }
+    return rows;
+}
 /**
  * 进入交互式全屏缓冲区，并隐藏光标，确保后续重绘始终基于固定画布。
  *
@@ -185,7 +263,6 @@ async function handleInteractiveToggle(initialStatuses) {
         let closed = false;
         const render = () => {
             const screenWidth = process.stdout.columns ?? 80;
-            const narrowScreen = screenWidth < 72;
             const styled = shouldUseAnsiStyle();
             const latestSnapshot = (0, status_service_1.getStatusSnapshot)();
             const statusSource = changed ? latestSnapshot.statuses : (initialStatuses ?? latestSnapshot.statuses);
@@ -205,27 +282,41 @@ async function handleInteractiveToggle(initialStatuses) {
             })
                 .filter((item) => item !== null);
             const currentItem = displayStatuses.find((item) => item.id === accounts[cursor]?.id) ?? null;
-            renderInteractiveScreen([
-                renderSectionHeader("accounts", screenWidth, styled),
-                (0, status_1.renderStatusTable)(displayStatuses, {
+            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;
+            const accountLines = [
+                renderSectionHeader("accounts", leftWidth, styled),
+                ...(0, status_1.renderStatusTable)(displayStatuses, {
                     compact: true,
-                    maxWidth: screenWidth,
+                    maxWidth: leftWidth,
+                    styled,
                     selectorColumn: {
                         enabledById: Object.fromEntries(accounts.map((account) => [account.id, account.enabled])),
                         cursorAccountId: accounts[cursor]?.id ?? null
                     }
-                }),
+                }).split("\n")
+            ];
+            const sideLines = [
+                renderSectionHeader("current", rightWidth, styled),
+                ...(0, status_1.renderStatusDetails)(currentItem, { maxWidth: rightWidth, header: false }).split("\n"),
                 "",
-                renderDivider(screenWidth, styled),
-                renderSectionHeader("current", screenWidth, styled),
-                (0, status_1.renderStatusDetails)(currentItem, { maxWidth: screenWidth, header: false }),
-                "",
-                renderSectionHeader("summary", screenWidth, styled),
-                renderSummaryLine(summary, narrowScreen, styled),
+                renderSectionHeader("summary", rightWidth, styled),
+                renderSummaryLine(summary, rightWidth < 42, styled),
                 `selected=${latestSnapshot.selectedName ?? "none"}`,
                 "",
-                renderSectionHeader("help", screenWidth, styled),
-                (0, text_1.bi)(narrowScreen ? "Space 切换，Enter / q 退出。" : "Space 切换启用状态，Enter / q 退出。", narrowScreen ? "Space toggles, Enter or q exits." : "Space toggles enabled state, Enter or q exits.")
+                renderSectionHeader("help", rightWidth, styled),
+                (0, text_1.bi)(rightWidth < 42 ? "Space 切换，Enter/q 退出。" : "Space 切换启用状态，Enter / q 退出。", rightWidth < 42 ? "Space toggles, Enter/q exits." : "Space toggles enabled state, Enter / q exits.")
+            ];
+            if (wideLayout) {
+                renderInteractiveScreen(renderColumns(accountLines, sideLines, 3));
+                return;
+            }
+            renderInteractiveScreen([
+                ...accountLines,
+                "",
+                renderDivider(screenWidth, styled),
+                ...sideLines
             ]);
         };
         const applyChanges = () => {