@offerpilot/axiomruntime 0.0.1 → 0.0.3

package/README.md

@@ -26,33 +26,34 @@ AI 与维护者使用的英文权威文档位于 `AGENTS.md`、`docs/AI_RUNTIME_
 
 ## 通过 npm 安装
 
-运行环境需要 Node.js `22.19.0` 或更高版本。全局安装后，npm 会把本包注册为 `ai` 命令：
+运行环境需要 Node.js `22.19.0` 或更高版本。先确认版本，再执行全局安装；npm 会把本包注册为 `ai` 命令：
 
 ```bash
+node --version
 npm install --global @offerpilot/axiomruntime
 ai --version
 ai setup
 ```
 
+如果 npm 显示 `EBADENGINE`，说明当前 Node.js 版本不受支持。请先升级到 `22.19.0+`，不要继续使用警告状态下安装的 CLI。
+
 `ai --version` 用于验证 npm 包和命令安装成功；`ai setup` 初始化 Runtime 配置，并可在确认后安装缺失的 Claude Code/Codex。之后可直接运行 `ai`。
 
+可用 root 完成全局安装，但日常执行 `ai` 和常驻服务应使用专用非 root 用户。若仍以 root 启动 Claude，Runtime 会把 `auto`/`bypassPermissions` 安全约束为默认权限、输出告警，并且绝不会传递 Claude Code 禁止 root 使用的 `--dangerously-skip-permissions`。
+
 ## 通过 Homebrew 安装
 
-发布流程会在 npm 发布成功后把 `Formula/axiomruntime.rb` 同步到 `offerpilot/homebrew-tap`。Tap 建立后可使用：
+维护者发布新版本时可直接双击仓库根目录的 `发布.command`，交互选择 npm、Homebrew 或发布条件检查，无需记发布命令。npm 发布成功后，再选择 Homebrew；助手会读取 npm Registry 的真实 tarball 与 SHA256，并把 `Formula/axiomruntime.rb` 同步到 GitLab 项目 `linlangli/axiom`。
+
+用户首次安装需要显式提供 GitLab 地址：
 
 ```bash
-brew tap offerpilot/tap
-brew install axiomruntime
+brew tap linlangli/axiom https://gitlab.com/linlangli/axiom.git
+brew install linlangli/axiom/axiomruntime
 ai --version
 ai setup
 ```
 
-如果 Tap 不托管在 GitHub，需要在首次添加时显式提供公开 Git 地址：
-
-```bash
-brew tap offerpilot/tap <homebrew-tap-public-git-url>
-```
-
 ## 安装开发依赖
 
 运行和开发需要 Node.js `22.19.0` 或更高版本。该下限与锁定依赖的运行时要求一致；Node.js 20 不受支持。
@@ -103,6 +104,8 @@ AI_GATEWAY_SERVER_TOKEN='replace-me' npm run server
 
 默认分支提交通过测试后，GitLab CI 会构建以 commit SHA 标记的镜像，并由锁定当前项目的受保护 Runner（标签 `axiomruntime-prod`）部署到 `154.201.73.41:/opt/AxiomRuntime`。部署只操作 `axiomruntime` Compose 项目；健康检查失败时恢复上一镜像，不清理服务器上的其他容器或镜像。
 
+镜像构建会在一次性 build stage 中编译 `better-sqlite3` 原生 addon，再把裁掉开发依赖后的 production dependency tree 复制到相同 Node.js 版本的最终镜像；最终镜像不包含编译器。
+
 首次部署前，服务器必须已有 `/opt/AxiomRuntime/config/providers.json` 和 `/opt/AxiomRuntime/secrets/server-token`，且容器用户 `10001:10001` 可以读写配置目录。CI 只校验这些文件，不生成或覆盖凭据。
 
 Telegram 容器默认不启动，以免与现有 long polling 进程争抢消息。完成迁移并停止旧 Bot 后，在服务器 `/opt/AxiomRuntime/.env` 中设置：
@@ -130,6 +133,10 @@ ai provider add
 ai provider list
 ai provider edit
 ai provider delete
+ai set codex chatgpt
+ai set codex provider 51talk-cq gpt-5.6-sol
+ai set codex provider 51talk-cq
+ai set codex proxy 127.0.0.1:7890
 ai telegram
 ai telegram list
 ai telegram start --bot ops
@@ -172,7 +179,7 @@ Telegram Bot 集成说明：
 
 - 多 Bot 使用 `ai telegram add <name>` 创建，并以统一的 `--bot <name>` 选择目标；例如 `ai telegram edit --bot ops`、`start|stop|status --bot ops`、`delete --bot ops`。裸 `ai telegram` 会先选操作再选 Bot，删除有二次确认；批量生命周期操作使用 `--all`。
 - `ai telegram config set <key> <value> --bot <name>` 只修改指定 Bot；旧位置参数写法继续兼容。
-- 如果本机不能直连 Telegram API，可设置 `ai telegram config set proxyUrl http://127.0.0.1:7890 --bot <name>`。
+- 如果本机不能直连 Telegram API，可设置 `ai telegram config set proxyUrl http://127.0.0.1:7890 --bot <name>`；代理地址需包含协议，交互式新增或编辑 Bot 时也会显示该完整示例。
 - Bot 首次 `/start` 或 `/reset` 会先选择工作路径，再选择 Claude Code/Codex，并展示当前会话、provider 和模型卡片。
 - Bot 会记录选择过的工作路径；自定义路径会按 `~/输入名称` 创建或复用。
 - Telegram 默认命令菜单只保留 `/claude`、`/codex`、`/reset`、`/cwd` 和 `/help`；选择 CLI 后，会在当前 chat 的 `/` 菜单追加该 CLI 的 slash 命令映射。

package/dist/cli/commands/set.js

@@ -0,0 +1,121 @@
+import { writeLog } from "../../core/logs/log-service.js";
+import { readCache } from "../../core/config/cache-store.js";
+import { listAvailableCodexGptModels, resolveCodexProviderModel, setCodexProvider, setCodexProxy } from "../../core/integrations/codex-provider-config.js";
+import { listProviders } from "../../core/providers/provider-service.js";
+import { promptSelect, promptText } from "../prompts/prompt.js";
+const SET_CODEX_USAGE = "Usage: ai set codex [chatgpt | provider [name] [model-id] | proxy <host:port|url|off>]";
+export async function runSetCommand(args) {
+    const [targetArg, modeArg, providerNameArg, modelArg, ...extra] = args;
+    const target = targetArg ?? "codex";
+    if (target !== "codex") {
+        throw new Error(SET_CODEX_USAGE);
+    }
+    if (extra.length) {
+        throw new Error(SET_CODEX_USAGE);
+    }
+    const mode = await getMode(modeArg);
+    if (mode === "proxy") {
+        if (modelArg)
+            throw new Error(SET_CODEX_USAGE);
+        const proxyValue = providerNameArg ?? await promptText("Codex proxy (host:port, URL, or off)");
+        const result = await setCodexProxy(proxyValue);
+        console.log(result.proxyUrl ? `Codex proxy set to: ${result.proxyUrl}` : "Codex proxy cleared.");
+        console.log(`Updated: ${result.configPath}`);
+        if (!result.environment.applied && result.environment.reason) {
+            console.log(result.environment.reason);
+        }
+        printRestartResult(result.restart);
+        await writeLog({
+            category: "provider",
+            action: "codex_proxy_set",
+            message: result.proxyUrl ? "Codex proxy enabled." : "Codex proxy cleared.",
+            metadata: {
+                enabled: Boolean(result.proxyUrl),
+                desktopEnvironmentApplied: result.environment.applied,
+                restartScheduled: result.restart.scheduled
+            }
+        });
+        return;
+    }
+    if (mode === "chatgpt" && (providerNameArg || modelArg)) {
+        throw new Error("Usage: ai set codex chatgpt");
+    }
+    const selection = mode === "chatgpt"
+        ? { type: "chatgpt" }
+        : { type: "provider", ...await getProviderAndModel(providerNameArg, modelArg) };
+    if (mode === "chatgpt") {
+        console.log("Opening ChatGPT login in your browser...");
+    }
+    const result = await setCodexProvider(selection);
+    console.log(`Codex provider set to: ${result.providerName}`);
+    if (result.model)
+        console.log(`Codex model set to: ${result.model}`);
+    console.log(`Updated: ${result.configPath}`);
+    console.log(`Updated: ${result.authPath}`);
+    printRestartResult(result.restart);
+    await writeLog({
+        category: "provider",
+        action: "codex_provider_set",
+        message: `Codex provider set to ${result.providerName}.`,
+        metadata: {
+            selection: result.selection,
+            provider: result.providerName,
+            providerId: result.providerId,
+            model: result.model,
+            restartScheduled: result.restart.scheduled
+        }
+    });
+}
+async function getMode(value) {
+    if (value === "chatgpt" || value === "provider" || value === "proxy")
+        return value;
+    if (value) {
+        throw new Error(`Unknown Codex setting: ${value}`);
+    }
+    return promptSelect("Set Codex", [
+        { label: "ChatGPT account", value: "chatgpt" },
+        { label: "Configured provider", value: "provider" },
+        { label: "Proxy", value: "proxy" }
+    ]);
+}
+function printRestartResult(restart) {
+    if (restart.scheduled) {
+        console.log(`Restarting ${restart.appPath ?? "Codex app"}...`);
+    }
+    else {
+        console.log(`Restart Codex app manually. ${restart.reason ?? ""}`.trim());
+    }
+}
+async function getProviderAndModel(name, requestedModel) {
+    const [providers, cache] = await Promise.all([listProviders(), readCache()]);
+    return selectCodexProviderAndModel(providers, cache.providers, name, requestedModel);
+}
+export async function selectCodexProviderAndModel(providers, providerCache, name, requestedModel, select = promptSelect) {
+    if (!providers.length) {
+        throw new Error("No providers configured. Run `ai provider add` first.");
+    }
+    if (!name && !providers.some((provider) => providerGptModels(provider.name, providerCache).length)) {
+        throw new Error("No configured provider has available GPT models. Run `ai status` to refresh model lists.");
+    }
+    const providerName = name ?? await select("Select provider for Codex", providers.map((provider) => ({
+        label: `${provider.name} / ${providerGptModels(provider.name, providerCache).length} GPT models`,
+        value: provider.name
+    })));
+    const provider = providers.find((item) => item.name === providerName);
+    if (!provider) {
+        throw new Error(`Provider not found: ${providerName}`);
+    }
+    const availableModels = providerGptModels(provider.name, providerCache);
+    if (!availableModels.length) {
+        resolveCodexProviderModel(provider.name, availableModels);
+    }
+    const model = requestedModel
+        ? resolveCodexProviderModel(provider.name, availableModels, requestedModel)
+        : name
+            ? resolveCodexProviderModel(provider.name, availableModels)
+            : await select(`Select GPT model for ${provider.name}`, availableModels.map((availableModel) => ({ label: availableModel, value: availableModel })));
+    return { provider, model };
+}
+function providerGptModels(providerName, providerCache) {
+    return listAvailableCodexGptModels(providerCache[providerName]?.models ?? []);
+}

package/dist/cli/commands/telegram.js

@@ -8,6 +8,7 @@ import { botExists, isBotRunning, isValidBotName, listBots, migrateLegacyConfig,
 import { ensureTelegramLogFile, readRecentTelegramLogLines } from "../../telegram/log.js";
 import { checkTelegramApi, getTelegramProxyUrl } from "../../telegram/network.js";
 import { promptConfirm, promptSelect, promptText } from "../prompts/prompt.js";
+export const TELEGRAM_PROXY_URL_PROMPT = "Proxy URL (include protocol, e.g. http://127.0.0.1:7890)";
 export async function runTelegramCommand(args) {
     const target = parseTelegramTargetArgs(args);
     const [subcommand, ...rest] = target.args;
@@ -202,7 +203,7 @@ async function addBot(nameArg) {
     if (!token.trim())
         throw new Error("Token is required.");
     const allowedUserIds = await promptText("Allowed user IDs (comma-separated, empty for allowAll)");
-    const proxyUrl = await promptText("Proxy URL (empty to skip)", { defaultValue: "" });
+    const proxyUrl = await promptText(`${TELEGRAM_PROXY_URL_PROMPT} (empty to skip)`, { defaultValue: "" });
     const config = {
         token: token.trim(),
         ...(proxyUrl.trim() ? { proxyUrl: proxyUrl.trim() } : {})
@@ -494,7 +495,7 @@ async function editBotConfigInteractive(name) {
         const current = String(config[field] ?? "");
         const value = field === "token"
             ? await promptText("token (leave empty to keep current)") || current
-            : await promptText(field, { defaultValue: current });
+            : await promptText(field === "proxyUrl" ? TELEGRAM_PROXY_URL_PROMPT : field, { defaultValue: current });
         config = await setBotConfigValue(name, field, value);
     }
 }
@@ -539,7 +540,7 @@ async function editTelegramConfigInteractive() {
         const current = String(config[field] ?? "");
         const value = field === "token"
             ? await promptText("token (leave empty to keep current)") || current
-            : await promptText(field, { defaultValue: current });
+            : await promptText(field === "proxyUrl" ? TELEGRAM_PROXY_URL_PROMPT : field, { defaultValue: current });
         config = await setTelegramConfigValue(field, value);
     }
 }

package/dist/cli/index.js

@@ -10,6 +10,7 @@ import { runMemoryCommand } from "./commands/memory.js";
 import { runReportCommand } from "./commands/report.js";
 import { runLastCommand, runUseCommand } from "./commands/use.js";
 import { runSessionCommand } from "./commands/session.js";
+import { runSetCommand } from "./commands/set.js";
 import { runSetupCommand } from "./commands/setup.js";
 import { runStatusCommand } from "./commands/status.js";
 import { runTelegramCommand } from "./commands/telegram.js";
@@ -17,6 +18,7 @@ import { runVersionCommand } from "./commands/version.js";
 import { writeLog } from "../core/logs/log-service.js";
 import { promptSelect } from "./prompts/prompt.js";
 import { getCliCommand, registerCliCommand } from "./registry.js";
+import { redactCodexProxyCommandArgs } from "./sanitize-args.js";
 registerBuiltInCommands();
 async function main() {
     const [, , command, ...args] = process.argv;
@@ -52,6 +54,9 @@ async function main() {
     process.exitCode = 1;
 }
 function sanitizeArgs(command, args) {
+    const redactedProxyArgs = redactCodexProxyCommandArgs(command, args);
+    if (redactedProxyArgs)
+        return redactedProxyArgs;
     if (command === "add" && args.length >= 3) {
         return [args[0], args[1], maskSecretArg(args[2])];
     }
@@ -131,7 +136,7 @@ function maskSecretArg(value) {
     return `${value.slice(0, 4)}****${value.slice(-4)}`;
 }
 async function runInteractive() {
-    const interactiveCommandNames = ["setup", "use", "add", "memory", "telegram", "status", "session", "report", "doctor", "log", "context", "help", "last"];
+    const interactiveCommandNames = ["setup", "use", "set", "add", "memory", "telegram", "status", "session", "report", "doctor", "log", "context", "help", "last"];
     const command = await promptSelect("AI Gateway", [
         ...interactiveCommandNames
             .flatMap((name) => {
@@ -250,6 +255,11 @@ function registerBuiltInCommands() {
         description: "use",
         run: (args) => runUseCommand(args)
     });
+    registerCliCommand({
+        name: "set",
+        description: "set Codex provider or proxy",
+        run: (args) => runSetCommand(args)
+    });
     registerCliCommand({
         name: "last",
         description: "last",

package/dist/cli/sanitize-args.js

@@ -0,0 +1,6 @@
+export function redactCodexProxyCommandArgs(command, args) {
+    if (command !== "set" || args[0] !== "codex" || args[1] !== "proxy" || args.length < 3) {
+        return null;
+    }
+    return [args[0], args[1], "[proxy-redacted]", ...args.slice(3)];
+}