codex-slot 0.1.1 → 0.1.3

package/dist/codex-config.js

@@ -0,0 +1,354 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultCodexConfigPath = getDefaultCodexConfigPath;
+exports.generateServerApiKey = generateServerApiKey;
+exports.applyManagedCodexConfig = applyManagedCodexConfig;
+exports.deactivateManagedCodexConfig = deactivateManagedCodexConfig;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const config_1 = require("./config");
+const state_1 = require("./state");
+const text_1 = require("./text");
+const MODEL_PROVIDER_START_MARKER = "# >>> cslot model_provider >>>";
+const MODEL_PROVIDER_END_MARKER = "# <<< cslot model_provider <<<";
+const PROVIDER_BLOCK_START_MARKER = "# >>> cslot provider:cslot >>>";
+const PROVIDER_BLOCK_END_MARKER = "# <<< cslot provider:cslot <<<";
+/**
+ * 返回默认的 `codex config.toml` 路径。
+ *
+ * @returns 默认 `config.toml` 绝对路径。
+ */
+function getDefaultCodexConfigPath() {
+    return node_path_1.default.join(process.env.HOME ?? "", ".codex", "config.toml");
+}
+/**
+ * 生成随机本地 API Key，避免继续使用固定默认值。
+ *
+ * @returns 新的 API Key 字符串，仅包含十六进制字符。
+ */
+function generateServerApiKey() {
+    return `cslot-${node_crypto_1.default.randomBytes(18).toString("hex")}`;
+}
+/**
+ * 原子方式写入目标文件，避免写入过程中留下半截配置。
+ *
+ * @param targetFile 目标文件绝对路径。
+ * @param content 完整文件内容。
+ * @returns 无返回值。
+ * @throws 当目录创建、临时文件写入或重命名失败时抛出文件系统错误。
+ */
+function writeFileAtomic(targetFile, content) {
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(targetFile), { recursive: true });
+    const tmpFile = `${targetFile}.tmp-${process.pid}-${Date.now()}`;
+    node_fs_1.default.writeFileSync(tmpFile, content, "utf8");
+    node_fs_1.default.renameSync(tmpFile, targetFile);
+}
+/**
+ * 根据当前文件内容推断换行符风格，尽量保持用户原文件格式不变。
+ *
+ * @param content 原始文件内容。
+ * @returns 当前文件使用的换行符；未命中时默认返回 `\n`。
+ */
+function detectEol(content) {
+    return content.includes("\r\n") ? "\r\n" : "\n";
+}
+/**
+ * 生成受 cslot 接管的 `model_provider` 配置块。
+ *
+ * @param eol 目标文件当前使用的换行符。
+ * @returns 带标记的配置块文本。
+ */
+function buildManagedModelProviderBlock(eol) {
+    return [
+        MODEL_PROVIDER_START_MARKER,
+        'model_provider = "cslot"',
+        MODEL_PROVIDER_END_MARKER
+    ].join(eol);
+}
+/**
+ * 生成受 cslot 接管的 provider 配置块。
+ *
+ * @param eol 目标文件当前使用的换行符。
+ * @returns 带标记的 provider 配置块文本。
+ */
+function buildManagedProviderBlock(eol) {
+    const config = (0, config_1.loadConfig)();
+    return [
+        PROVIDER_BLOCK_START_MARKER,
+        "[model_providers.cslot]",
+        'name = "cslot"',
+        `base_url = "http://${config.server.host}:${config.server.port}/v1"`,
+        `http_headers = { Authorization = "Bearer ${config.server.api_key}" }`,
+        'wire_api = "responses"',
+        PROVIDER_BLOCK_END_MARKER
+    ].join(eol);
+}
+/**
+ * 在文本中定位受 cslot 接管的块范围。
+ *
+ * @param content 原始文件内容。
+ * @param startMarker 块起始标记。
+ * @param endMarker 块结束标记。
+ * @returns 命中时返回起止偏移；未命中返回 `null`。
+ */
+function findMarkedBlockRange(content, startMarker, endMarker) {
+    const start = content.indexOf(startMarker);
+    if (start < 0) {
+        return null;
+    }
+    const endMarkerIndex = content.indexOf(endMarker, start);
+    if (endMarkerIndex < 0) {
+        return null;
+    }
+    let end = endMarkerIndex + endMarker.length;
+    if (content.slice(end, end + 2) === "\r\n") {
+        end += 2;
+    }
+    else if (content.slice(end, end + 1) === "\n") {
+        end += 1;
+    }
+    return { start, end };
+}
+/**
+ * 恢复文本中由 cslot 管理的配置块，得到接管前的原始内容基线。
+ *
+ * @param content 当前 `config.toml` 内容。
+ * @param managedState 上一次接管时保存的原始片段快照。
+ * @returns 恢复后的文本内容。
+ */
+function restoreManagedContent(content, managedState) {
+    let restored = content;
+    const providerRange = findMarkedBlockRange(restored, PROVIDER_BLOCK_START_MARKER, PROVIDER_BLOCK_END_MARKER);
+    if (providerRange) {
+        restored =
+            restored.slice(0, providerRange.start) +
+                (managedState.original_cslot_provider_block ?? "") +
+                restored.slice(providerRange.end);
+    }
+    const modelProviderRange = findMarkedBlockRange(restored, MODEL_PROVIDER_START_MARKER, MODEL_PROVIDER_END_MARKER);
+    if (modelProviderRange) {
+        restored =
+            restored.slice(0, modelProviderRange.start) +
+                (managedState.original_model_provider_block ?? "") +
+                restored.slice(modelProviderRange.end);
+    }
+    return restored;
+}
+/**
+ * 查找首个 `model_provider` 配置块，兼容已启用与注释掉的场景。
+ *
+ * @param content 当前 `config.toml` 内容。
+ * @returns 命中时返回完整块及其偏移；未命中返回 `null`。
+ */
+function findModelProviderLine(content) {
+    const lines = content.split(/\r?\n/);
+    let offset = 0;
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        const lineStart = offset;
+        const lineEnd = offset + line.length;
+        if (/^model_provider\s*=/.test(trimmed) ||
+            /^#\s*model_provider\s*=/.test(trimmed)) {
+            let blockEnd = lineEnd;
+            let nextOffset = lineEnd;
+            if (content.slice(lineEnd, lineEnd + 2) === "\r\n") {
+                blockEnd += 2;
+                nextOffset += 2;
+            }
+            else if (content.slice(lineEnd, lineEnd + 1) === "\n") {
+                blockEnd += 1;
+                nextOffset += 1;
+            }
+            for (let j = i + 1; j < lines.length; j += 1) {
+                const nextLine = lines[j];
+                const nextLineEnd = nextOffset + nextLine.length;
+                if (nextLine.trim() !== "") {
+                    break;
+                }
+                blockEnd = nextLineEnd;
+                if (content.slice(nextLineEnd, nextLineEnd + 2) === "\r\n") {
+                    blockEnd += 2;
+                    nextOffset = nextLineEnd + 2;
+                }
+                else if (content.slice(nextLineEnd, nextLineEnd + 1) === "\n") {
+                    blockEnd += 1;
+                    nextOffset = nextLineEnd + 1;
+                }
+                else {
+                    nextOffset = nextLineEnd;
+                }
+            }
+            return {
+                start: lineStart,
+                end: blockEnd,
+                value: content.slice(lineStart, blockEnd)
+            };
+        }
+        offset = lineEnd + (content.slice(lineEnd, lineEnd + 2) === "\r\n" ? 2 : 1);
+    }
+    return null;
+}
+/**
+ * 查找 `[model_providers.cslot]` 表块的文本范围。
+ *
+ * @param content 当前 `config.toml` 内容。
+ * @returns 命中时返回完整表块范围；未命中返回 `null`。
+ */
+function findProviderSectionRange(content) {
+    const lines = content.split(/\r?\n/);
+    let offset = 0;
+    let startLineIndex = -1;
+    let startOffset = -1;
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i];
+        const lineEnd = offset + line.length;
+        if (line.trim() === "[model_providers.cslot]") {
+            startLineIndex = i;
+            startOffset = offset;
+            break;
+        }
+        offset = lineEnd + (content.slice(lineEnd, lineEnd + 2) === "\r\n" ? 2 : 1);
+    }
+    if (startLineIndex < 0 || startOffset < 0) {
+        return null;
+    }
+    let endOffset = startOffset;
+    offset = startOffset;
+    for (let i = startLineIndex; i < lines.length; i += 1) {
+        const line = lines[i];
+        const lineEnd = offset + line.length;
+        const trimmed = line.trim();
+        if (i > startLineIndex && trimmed.startsWith("[") && !trimmed.startsWith("[[")) {
+            break;
+        }
+        endOffset = lineEnd;
+        if (content.slice(lineEnd, lineEnd + 2) === "\r\n") {
+            endOffset += 2;
+            offset = lineEnd + 2;
+        }
+        else if (content.slice(lineEnd, lineEnd + 1) === "\n") {
+            endOffset += 1;
+            offset = lineEnd + 1;
+        }
+        else {
+            offset = lineEnd + 1;
+        }
+    }
+    return {
+        start: startOffset,
+        end: endOffset,
+        value: content.slice(startOffset, endOffset)
+    };
+}
+/**
+ * 将指定文本规范为单个块插入形式，避免在块两侧不断叠加多余空行。
+ *
+ * @param before 插入点前的文本。
+ * @param block 待插入块。
+ * @param after 插入点后的文本。
+ * @param eol 目标换行符。
+ * @returns 插入后的完整文本。
+ */
+function insertBlockBetween(before, block, after, eol) {
+    const normalizedBefore = before.endsWith(eol) || before.length === 0 ? before : `${before}${eol}`;
+    const normalizedAfter = after.startsWith(eol) || after.length === 0 ? after : `${eol}${after}`;
+    return `${normalizedBefore}${block}${normalizedAfter}`;
+}
+/**
+ * 将 cslot 需要的 provider 配置写入指定 `config.toml`，并保存恢复快照。
+ *
+ * @param targetPathOrDir 可选的 codex 配置目录或 `config.toml` 文件路径。
+ * @param options 可选控制项；`silent=true` 时不输出终端提示。
+ * @returns 实际写入的 `config.toml` 文件路径。
+ * @throws 当目标文件无法读取、写入或恢复快照保存失败时抛出异常。
+ */
+function applyManagedCodexConfig(targetPathOrDir, options) {
+    const rawTarget = targetPathOrDir ? (0, config_1.expandHome)(targetPathOrDir) : getDefaultCodexConfigPath();
+    const targetFile = rawTarget.endsWith(".toml") ? rawTarget : node_path_1.default.join(rawTarget, "config.toml");
+    const current = node_fs_1.default.existsSync(targetFile) ? node_fs_1.default.readFileSync(targetFile, "utf8") : "";
+    const previousManagedState = (0, state_1.getManagedCodexConfigState)();
+    const baseContent = previousManagedState && previousManagedState.target_file === targetFile
+        ? restoreManagedContent(current, previousManagedState)
+        : current;
+    const eol = detectEol(baseContent);
+    const originalModelProviderLine = findModelProviderLine(baseContent);
+    const originalProviderSection = findProviderSectionRange(baseContent);
+    const snapshot = {
+        target_file: targetFile,
+        original_model_provider_block: originalModelProviderLine?.value ?? null,
+        original_cslot_provider_block: originalProviderSection?.value ?? null
+    };
+    let nextContent = baseContent;
+    const managedModelProviderBlock = buildManagedModelProviderBlock(eol);
+    const managedProviderBlock = buildManagedProviderBlock(eol);
+    // 先处理 provider 表块，再处理 model_provider 行，避免前面的插入导致后续偏移失效。
+    if (originalProviderSection) {
+        nextContent =
+            nextContent.slice(0, originalProviderSection.start) +
+                managedProviderBlock +
+                nextContent.slice(originalProviderSection.end);
+    }
+    else if (nextContent.length > 0) {
+        nextContent = insertBlockBetween(nextContent, managedProviderBlock, "", eol);
+    }
+    else {
+        nextContent = `${managedProviderBlock}${eol}`;
+    }
+    const modelProviderLine = findModelProviderLine(nextContent);
+    if (modelProviderLine) {
+        nextContent =
+            nextContent.slice(0, modelProviderLine.start) +
+                managedModelProviderBlock +
+                nextContent.slice(modelProviderLine.end);
+    }
+    else {
+        const firstNonWhitespaceMatch = nextContent.match(/\S/);
+        if (firstNonWhitespaceMatch && firstNonWhitespaceMatch.index !== undefined) {
+            nextContent = insertBlockBetween(nextContent.slice(0, firstNonWhitespaceMatch.index), managedModelProviderBlock, nextContent.slice(firstNonWhitespaceMatch.index), eol);
+        }
+        else {
+            nextContent = `${managedModelProviderBlock}${eol}`;
+        }
+    }
+    if (!nextContent.endsWith(eol)) {
+        nextContent = `${nextContent}${eol}`;
+    }
+    writeFileAtomic(targetFile, nextContent);
+    (0, state_1.setManagedCodexConfigState)(snapshot);
+    if (!options?.silent) {
+        const config = (0, config_1.loadConfig)();
+        console.log((0, text_1.bi)(`已写入: ${targetFile}`, `Written to: ${targetFile}`));
+        console.log(`base_url=http://${config.server.host}:${config.server.port}/v1`);
+        console.log(`api_key=${config.server.api_key}`);
+        console.log((0, text_1.bi)("提示: start 会自动接管 codex provider，stop 会精确恢复接管前内容。", "Note: start will manage the Codex provider automatically, and stop will restore the exact previous content."));
+    }
+    return targetFile;
+}
+/**
+ * 解除 cslot 对 `config.toml` 的接管，并恢复接管前的原始片段。
+ *
+ * @returns 实际恢复的 `config.toml` 文件路径；若当前没有接管快照则返回 `null`。
+ * @throws 当目标文件读取或写入失败时抛出异常。
+ */
+function deactivateManagedCodexConfig() {
+    const managedState = (0, state_1.getManagedCodexConfigState)();
+    if (!managedState) {
+        return null;
+    }
+    const targetFile = managedState.target_file;
+    if (!node_fs_1.default.existsSync(targetFile)) {
+        (0, state_1.clearManagedCodexConfigState)();
+        return null;
+    }
+    const current = node_fs_1.default.readFileSync(targetFile, "utf8");
+    const restored = restoreManagedContent(current, managedState);
+    writeFileAtomic(targetFile, restored);
+    (0, state_1.clearManagedCodexConfigState)();
+    console.log((0, text_1.bi)(`已恢复: ${targetFile}`, `Restored: ${targetFile}`));
+    return targetFile;
+}

package/dist/config.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCodexSwHome = getCodexSwHome;
+exports.getCslotHome = getCslotHome;
 exports.getConfigPath = getConfigPath;
 exports.getPidPath = getPidPath;
 exports.getServiceLogPath = getServiceLogPath;
@@ -13,6 +13,7 @@ exports.saveConfig = saveConfig;
 exports.getManagedHome = getManagedHome;
 exports.upsertAccount = upsertAccount;
 const node_fs_1 = __importDefault(require("node:fs"));
+const node_crypto_1 = __importDefault(require("node:crypto"));
 const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
 const yaml_1 = __importDefault(require("yaml"));
@@ -53,18 +54,22 @@ const configSchema = zod_1.z.object({
     }),
     accounts: zod_1.z.array(managedAccountSchema).default([])
 });
+/**
+ * 生成默认的本地 API Key，用于首次初始化配置时避免使用固定常量。
+ *
+ * @returns 随机生成的本地 API Key。
+ */
+function generateDefaultLocalApiKey() {
+    return `cslot-${node_crypto_1.default.randomBytes(18).toString("hex")}`;
+}
 /**
  * 返回 cslot 的根目录，并确保基础目录结构存在。
  *
  * @returns cslot 根目录绝对路径。
  * @throws 当目录无法创建时抛出文件系统错误。
  */
-function getCodexSwHome() {
+function getCslotHome() {
     const home = node_path_1.default.join(node_os_1.default.homedir(), ".cslot");
-    const legacyHome = node_path_1.default.join(node_os_1.default.homedir(), ".codexsw");
-    if (!node_fs_1.default.existsSync(home) && node_fs_1.default.existsSync(legacyHome)) {
-        node_fs_1.default.cpSync(legacyHome, home, { recursive: true });
-    }
     // 先创建 cslot 根目录，后续命令统一基于该目录读写状态。
     node_fs_1.default.mkdirSync(home, { recursive: true });
     node_fs_1.default.mkdirSync(node_path_1.default.join(home, "homes"), { recursive: true });
@@ -77,7 +82,7 @@ function getCodexSwHome() {
  * @returns 配置文件绝对路径。
  */
 function getConfigPath() {
-    return node_path_1.default.join(getCodexSwHome(), "config.yaml");
+    return node_path_1.default.join(getCslotHome(), "config.yaml");
 }
 /**
  * 返回后台服务 PID 文件路径。
@@ -85,7 +90,7 @@ function getConfigPath() {
  * @returns PID 文件绝对路径。
  */
 function getPidPath() {
-    return node_path_1.default.join(getCodexSwHome(), "cslot.pid");
+    return node_path_1.default.join(getCslotHome(), "cslot.pid");
 }
 /**
  * 返回后台服务日志文件路径。
@@ -93,7 +98,7 @@ function getPidPath() {
  * @returns 日志文件绝对路径。
  */
 function getServiceLogPath() {
-    return node_path_1.default.join(getCodexSwHome(), "logs", "service.log");
+    return node_path_1.default.join(getCslotHome(), "logs", "service.log");
 }
 /**
  * 将路径中的 `~` 展开为当前用户家目录。
@@ -118,14 +123,14 @@ function expandHome(input) {
  */
 function loadConfig() {
     const configPath = getConfigPath();
-    const legacyConfigPath = node_path_1.default.join(node_os_1.default.homedir(), ".codexsw", "config.yaml");
     if (!node_fs_1.default.existsSync(configPath)) {
+        const defaultApiKey = generateDefaultLocalApiKey();
         const defaultConfig = {
             version: 1,
             server: {
                 host: "127.0.0.1",
                 port: 4389,
-                api_key: "cslot-defaultkey",
+                api_key: defaultApiKey,
                 body_limit_mb: 512
             },
             upstream: {
@@ -142,19 +147,13 @@ function loadConfig() {
     const parsed = raw.trim() ? yaml_1.default.parse(raw) : {};
     const normalized = configSchema.parse(parsed);
     let changed = JSON.stringify(parsed) !== JSON.stringify(normalized);
-    if (normalized.accounts.length === 0 &&
-        node_fs_1.default.existsSync(legacyConfigPath)) {
-        const legacyRaw = node_fs_1.default.readFileSync(legacyConfigPath, "utf8");
-        const legacyParsed = legacyRaw.trim() ? yaml_1.default.parse(legacyRaw) : {};
-        const legacyConfig = configSchema.parse(legacyParsed);
-        if (legacyConfig.accounts.length > 0) {
-            normalized.accounts = legacyConfig.accounts;
-            changed = true;
-        }
+    if ((!parsed || typeof parsed !== "object" || !("server" in parsed)) ||
+        !(parsed.server && typeof parsed.server === "object" && "api_key" in parsed.server)) {
+        normalized.server.api_key = generateDefaultLocalApiKey();
+        changed = true;
     }
     // 兼容历史默认值，统一迁移到新的简短本地 key。
-    if (normalized.server.api_key === "local-only-key" ||
-        normalized.server.api_key === "codexsw-defaultkey") {
+    if (normalized.server.api_key === "local-only-key") {
         normalized.server.api_key = "cslot-defaultkey";
         changed = true;
     }
@@ -183,7 +182,7 @@ function saveConfig(config) {
  * @returns 该账号对应的 HOME 目录绝对路径。
  */
 function getManagedHome(accountId) {
-    return node_path_1.default.join(getCodexSwHome(), "homes", accountId);
+    return node_path_1.default.join(getCslotHome(), "homes", accountId);
 }
 /**
  * 将账号追加到配置中；若已存在相同 id 则覆盖更新。

package/dist/login.js

@@ -8,6 +8,7 @@ const node_child_process_1 = require("node:child_process");
 const node_fs_1 = __importDefault(require("node:fs"));
 const account_store_1 = require("./account-store");
 const config_1 = require("./config");
+const text_1 = require("./text");
 /**
  * 使用独立 HOME 目录拉起官方 `codex login`，完成单账号录入。
  *
@@ -29,14 +30,14 @@ async function loginManagedAccount(accountId) {
         child.on("exit", (code) => {
             if (code === 0) {
                 if (!(0, account_store_1.hasCompleteCodexAuthState)(managedHome)) {
-                    reject(new Error("codex login 已退出，但未检测到完整登录态，请重新登录"));
+                    reject(new Error((0, text_1.bi)("codex login 已退出，但未检测到完整登录态，请重新登录", "codex login exited, but no complete auth state was detected. Please log in again.")));
                     return;
                 }
                 (0, account_store_1.registerManagedAccount)(accountId, managedHome);
                 resolve(managedHome);
                 return;
             }
-            reject(new Error(`codex login 失败，退出码: ${code ?? "unknown"}`));
+            reject(new Error((0, text_1.bi)(`codex login 失败，退出码: ${code ?? "unknown"}`, `codex login failed with exit code: ${code ?? "unknown"}`)));
         });
         child.on("error", (error) => {
             reject(error);

package/dist/serve.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const config_1 = require("./config");
 const server_1 = require("./server");
+const text_1 = require("./text");
 /**
  * 后台服务进程入口。
  *
@@ -19,6 +20,6 @@ async function main() {
 }
 void main().catch((error) => {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(`cslot service 启动失败: ${message}`);
+    console.error((0, text_1.bi)(`cslot service 启动失败: ${message}`, `cslot service failed to start: ${message}`));
     process.exit(1);
 });

package/dist/server.js

@@ -11,6 +11,7 @@ const config_1 = require("./config");
 const status_1 = require("./status");
 const scheduler_1 = require("./scheduler");
 const state_1 = require("./state");
+const text_1 = require("./text");
 const usage_sync_1 = require("./usage-sync");
 function getBearerToken(headerValue) {
     if (!headerValue) {
@@ -117,7 +118,7 @@ function buildNetworkUnavailablePayload(accountId, error) {
     const message = error instanceof Error ? error.message : String(error);
     return {
         error: {
-            message: `网络不可用，账号 ${accountId} 无法连接上游: ${message}`,
+            message: (0, text_1.bi)(`网络不可用，账号 ${accountId} 无法连接上游: ${message}`, `Network unavailable. Account ${accountId} cannot reach upstream: ${message}`),
             type: "network_unavailable"
         }
     };
@@ -199,7 +200,7 @@ async function startServer(port) {
         const bearer = getBearerToken(request.headers.authorization);
         if (bearer !== config.server.api_key) {
             reply.code(401);
-            throw new Error("invalid local api key");
+            throw new Error((0, text_1.bi)("本地 API Key 无效", "Invalid local API key"));
         }
     });
     app.get("/health", async () => {
@@ -222,7 +223,7 @@ async function startServer(port) {
             reply.code(503);
             reply.send({
                 error: {
-                    message: "当前没有可用账号",
+                    message: (0, text_1.bi)("当前没有可用账号", "No available account"),
                     type: "no_available_account"
                 }
             });
@@ -230,7 +231,7 @@ async function startServer(port) {
         }
         let lastErrorPayload = {
             error: {
-                message: "所有账号都请求失败",
+                message: (0, text_1.bi)("所有账号都请求失败", "All accounts failed"),
                 type: "all_accounts_failed"
             }
         };
@@ -244,7 +245,7 @@ async function startServer(port) {
                 markAccountFailure(picked.account.id, "invalid_account_auth", 10 * 60);
                 lastErrorPayload = {
                     error: {
-                        message: `账号 ${picked.account.id} 缺少 access_token`,
+                        message: (0, text_1.bi)(`账号 ${picked.account.id} 缺少 access_token`, `Account ${picked.account.id} is missing access_token`),
                         type: "invalid_account_auth"
                     }
                 };

package/dist/service-control.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleStart = handleStart;
+exports.handleStop = handleStop;
+const service_lifecycle_service_1 = require("./app/service-lifecycle-service");
+const config_1 = require("./config");
+const text_1 = require("./text");
+/**
+ * 后台启动 cslot 服务并写入 PID 文件。
+ *
+ * @param portOverride 可选的端口文本；传入时会先校验并落盘到本地配置。
+ * @returns Promise，无返回值。
+ * @throws 当服务已在运行、端口非法或子进程启动失败时抛出异常。
+ */
+async function handleStart(portOverride) {
+    const config = (0, config_1.loadConfig)();
+    const result = (0, service_lifecycle_service_1.startManagedService)(portOverride);
+    if (result.alreadyRunning) {
+        console.log((0, text_1.bi)(`服务已在运行，PID=${result.pid}`, `Service is already running. PID=${result.pid}`));
+        if (portOverride) {
+            console.log((0, text_1.bi)(`已将新端口写入配置: ${result.port}`, `The new port has been saved to config: ${result.port}`));
+            console.log((0, text_1.bi)("请先执行 cslot stop，再执行 cslot start 使新端口生效。", "Run cslot stop first, then cslot start to apply the new port."));
+        }
+        return;
+    }
+    console.log((0, text_1.bi)(`服务已启动: http://${config.server.host}:${result.port}`, `Service started: http://${config.server.host}:${result.port}`));
+    console.log(`PID: ${result.pid}`);
+    console.log((0, text_1.bi)(`日志: ${result.logPath}`, `Log: ${result.logPath}`));
+}
+/**
+ * 停止后台运行的 cslot 服务，并恢复被接管的 Codex 配置。
+ *
+ * @returns 无返回值。
+ * @throws 当进程终止失败时透传底层异常。
+ */
+function handleStop() {
+    const result = (0, service_lifecycle_service_1.stopManagedService)();
+    if (!result.stoppedPid) {
+        console.log((0, text_1.bi)("服务未运行", "Service is not running."));
+        return;
+    }
+    console.log((0, text_1.bi)(`服务已停止，PID=${result.stoppedPid}`, `Service stopped. PID=${result.stoppedPid}`));
+}