@zhiman_innies/innies-codex 0.122.58 → 0.122.59

package/README.md

@@ -61,6 +61,80 @@ innies --version
 
 ---
 
+## First-Run Setup (重要 · N20)
+
+> [!WARNING]
+> **首次跑 `innies` 之前,必须先配置 base_url 和 api key,否则会立即报:**
+>
+> ```
+> ERROR: Missing environment variable: ZHIMAN_BASE_URL (or [model_providers.zhiman_35b].base_url)
+> ```
+>
+> 这是 N20 fresh-install 阻断 — 因为模板里 base_url 是注释占位符,而 Rust provider resolver 会在 env_key 缺失时**静默回退**到 `api.openai.com/v1`(见 [`docs/n20-fresh-install-base-url-fail.md`](docs/n20-fresh-install-base-url-fail.md))。
+
+**三种配置方式任选其一(优先级从高到低):**
+
+### 1. 环境变量 (推荐用于 CI / 无交互场景)
+
+```bash
+# 私有部署 (zhiman_35b / zhiman_27b 共享 ZHIMAN_API_KEY,见模板注释)
+export ZHIMAN_API_KEY="sk-..."
+export ZHIMAN_BASE_URL="http://your-private-deployment/v1"  # 可选,覆盖 config.toml
+
+# 阿里云 dashscope 公网
+export DASHSCOPE_API_KEY="sk-..."
+export DASHSCOPE_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"  # 可选
+```
+
+`export` 到 `~/.zshrc` 或 `~/.bashrc` 后 `source` 一下即持久化。
+
+### 2. 编辑 `~/.inniescoder/config.toml`
+
+```bash
+# 第一次跑会自动创建 config.toml
+innies 2>&1 | head -5   # 看到 [innies-onboarding] 横幅后 Ctrl+C 中断
+# 然后编辑 ~/.inniescoder/config.toml,取消下面这种行的 # 号:
+#   # base_url = "http://your-private-deployment/v1"   # FILL IN: ...
+#   # env_key  = "ZHIMAN_API_KEY"                      # FILL IN: ...
+# 取消注释 + 填值后保存。env_key 是"环境变量名"(不是 key 本身),然后确保那个
+# env var 已经在你的 shell 里 export 过(或写在 rc 文件里)。
+```
+
+### 3. Interactive 引导 (默认首次跑触发)
+
+```bash
+innies   # 不要 pipe,保持 stdin 是 TTY
+```
+
+首次跑会打印:
+
+```
+=============================================================================
+[innies-onboarding] 首次运行检测 (N20 fresh-install 阻断防护)
+config.toml: /Users/you/.inniescoder/config.toml
+
+检测到以下 provider 块的 base_url 仍是占位符(注释状态):
+  - [model_providers.zhiman_35b] base_url = "http://your-private-deployment/v1"
+  - [model_providers.zhiman_27b] base_url = "http://your-private-deployment/v1"
+  - [model_providers.dashscope]   base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
+
+请选择配置方式:
+  1. 现在交互式填入 base_url 和 api key (推荐) — 写回 config.toml
+  2. 跳过,我会自己编辑 /Users/you/.inniescoder/config.toml
+  3. 退出 innies
+> 
+```
+
+- **选项 1**: 逐步输入每个 provider 的 `base_url` 和 env_key 名,自动写回 `config.toml`,然后继续启动 innies。
+- **选项 2**: 跳过(接受 N20 会 fail)。之后自己编辑 `~/.inniescoder/config.toml` 填值。
+- **选项 3**: 退出 innies(`process.exit(0)`),让你先手动配。
+
+**跳过引导**: 设 `export INNIES_SKIP_ONBOARDING=1` 后跑 `innies`,永远不弹引导横幅。CI / smoke 测试用。
+
+**详见 `~/.inniescoder/config.toml` 顶部的 `⚠️ FIRST-RUN SETUP REQUIRED` 横幅注释(模板在 [`codex-cli/bin/innies-config.js`](codex-cli/bin/innies-config.js) 的 `defaultInniesConfig` 里,首次 `innies` 启动时会写入)。**
+
+---
+
 ## Provider 配置
 
 > [!IMPORTANT]

package/bin/innies-config.js

@@ -316,7 +316,50 @@ function defaultInniesConfig(catalogPath, managedDefault) {
     `# model_reasoning_effort = "low"   # thinking toggle: low | medium | high | xhigh (or omit for model default)`,
     `# model_verbosity = "low"           # optional: GPT-5 only (low | medium | high)`,
   ];
+  // N20 (2026-06-15): first-run base_url warning header. Fresh
+  // installs hit `ERROR: Missing environment variable: ZHIMAN_BASE_URL`
+  // on the very first `innies` run because the provider blocks
+  // below emit commented placeholders and the Rust provider resolver
+  // silently falls back to api.openai.com when neither env_key nor
+  // base_url is set. This block is intentionally a COMMENT block at
+  // the very top of the file (before any active `key = ...` lines)
+  // so it is bytewise-equal across re-inits (only the user can
+  // change it; re-init strips active root lines but preserves
+  // comment lines verbatim). The text is short enough that pasting
+  // it back into the TOML parser yields no errors; we verified
+  // TOML 1.0 compliance of the "# ..." prefix lines.
+  const firstRunWarningHeader = [
+    `# ============================================================================`,
+    `# ⚠️  FIRST-RUN SETUP REQUIRED (N20 / 2026-06-15)`,
+    `# ----------------------------------------------------------------------------`,
+    `# 首次跑 innies 之前,必须先配置 base_url 和 api key,否则会立即报错:`,
+    `#   ERROR: Missing environment variable: ZHIMAN_BASE_URL (or [model_providers.zhiman_35b].base_url)`,
+    `#`,
+    `# 三种配置方式任选其一 (优先级从高到低):`,
+    `#`,
+    `#   1. 环境变量 (推荐用于 CI / 无交互场景):`,
+    `#        export ZHIMAN_API_KEY="sk-..."     # 私有 7380 + 7382 共享 ZHIMAN_API_KEY`,
+    `#        export DASHSCOPE_API_KEY="sk-..." # 阿里云 dashscope 公网`,
+    `#        export ZHIMAN_BASE_URL="http://your-private-deployment/v1"  # 可选,优于 config.toml`,
+    `#        export DASHSCOPE_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"  # 可选`,
+    `#`,
+    `#   2. 编辑本文件:`,
+    `#        取消下面 [model_providers.*] 块里 base_url 和 env_key 行首的 # 号,`,
+    `#        填入你的实际部署地址和 api key 环境变量名(不是 key 本身)。`,
+    `#        env_key 是"环境变量名"(例如 "ZHIMAN_API_KEY"),不是 api key 的值。`,
+    `#`,
+    `#   3. Interactive 引导 (首次跑自动触发):`,
+    `#        跑 \`innies\` 时会问:"检测到未填的 base_url,选 1 交互式填入"。`,
+    `#        选项 1: 逐步输入 base_url 和 api key,自动写回本文件;`,
+    `#        选项 2: 跳过,自己编辑本文件(接受 N20 会 fail);`,
+    `#        选项 3: 退出。`,
+    `#`,
+    `# 详见 README.md 的 "First-Run Setup" 节。`,
+    `# ============================================================================`,
+  ];
   return [
+    ...firstRunWarningHeader,
+    "",
     ...lines,
     "",
     ...rootDocumentation,
@@ -723,8 +766,8 @@ function defaultZhiman35bProviderBlock() {
   return [
     ZHIMAN_35B_PROVIDER_HEADER,
     'name = "zhiman_35b"',
-    `# base_url = "http://your-private-deployment/v1"   # FILL IN: private vLLM / OpenAI-compatible endpoint`,
-    `# env_key  = "ZHIMAN_API_KEY"                      # FILL IN: name of the env var holding your API key`,
+    `# base_url = "http://your-private-deployment/v1"   # FILL IN: your private vLLM / OpenAI-compatible endpoint — do NOT keep this placeholder`,
+    `# env_key  = "ZHIMAN_API_KEY"                      # FILL IN: the env var NAME holding your API key (NOT the key itself) — see file header`,
     `wire_api = "${DEFAULT_PROVIDER_WIRE_API}"`,
     `# http_headers = { "X-Custom" = "value" }          # optional: literal per-request headers`,
     `# env_http_headers = { "X-Tenant" = "TENANT_ID_ENV" }  # optional: headers from env-var indirection`,
@@ -750,8 +793,8 @@ function defaultZhiman27bProviderBlock() {
   return [
     ZHIMAN_27B_PROVIDER_HEADER,
     'name = "zhiman_27b"',
-    `# base_url = "http://your-private-deployment/v1"   # FILL IN: private vLLM / OpenAI-compatible endpoint`,
-    `# env_key  = "ZHIMAN_API_KEY"                      # FILL IN: name of the env var holding your API key`,
+    `# base_url = "http://your-private-deployment/v1"   # FILL IN: your private vLLM / OpenAI-compatible endpoint — do NOT keep this placeholder`,
+    `# env_key  = "ZHIMAN_API_KEY"                      # FILL IN: the env var NAME holding your API key (NOT the key itself) — see file header`,
     `wire_api = "${DEFAULT_PROVIDER_WIRE_API}"`,
     `# http_headers = { "X-Custom" = "value" }          # optional: literal per-request headers`,
     `# env_http_headers = { "X-Tenant" = "TENANT_ID_ENV" }  # optional: headers from env-var indirection`,
@@ -794,8 +837,8 @@ function defaultDashscopeProviderBlock() {
   return [
     DASHSCOPE_PROVIDER_HEADER,
     'name = "bailian"',
-    `# base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"   # FILL IN: DashScope OpenAI-compatible endpoint`,
-    `# env_key  = "DASHSCOPE_API_KEY"                                   # FILL IN: name of the env var holding your DashScope API key`,
+    `# base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"   # FILL IN: DashScope OpenAI-compatible endpoint — keep this default if you use the public cloud`,
+    `# env_key  = "DASHSCOPE_API_KEY"                                   # FILL IN: the env var NAME holding your DashScope API key (NOT the key itself) — see file header`,
     `wire_api = "${DEFAULT_PROVIDER_WIRE_API}"`,
     `# http_headers = { "X-Custom" = "value" }          # optional: literal per-request headers`,
     `# env_http_headers = { "X-Tenant" = "TENANT_ID_ENV" }  # optional: headers from env-var indirection`,

package/bin/innies.js

@@ -2,11 +2,38 @@
 
 import fs from "node:fs";
 import path from "node:path";
+import readline from "node:readline";
 
 import { maybeRunInniesCodingRuntime } from "./innies-coding-runtime.js";
 import { ensureInniesHomeDefaults, resolveInniesHome } from "./innies-config.js";
 
 const INNIES_HOME_ENV_VAR = "INNIES_HOME";
+// N20 (2026-06-15): onboarding flow skip knob. CI / smoke tests can
+// set this to "1" to suppress the interactive first-run prompt. The
+// default behaviour (unset or "0") is to prompt the user. We treat
+// "1" / "true" / "yes" as "skip" (case-insensitive), matching the
+// convention used by `shouldInstallInniesSuperpowers` in
+// `innies-config.js`.
+const ONBOARDING_SKIP_ENV_VAR = "INNIES_SKIP_ONBOARDING";
+
+// N20 (2026-06-15): known base_url placeholder values that signal
+// an unfilled provider block. Declared at the top of the file so it
+// is initialised BEFORE the top-level `await` at line ~40 runs (the
+// `await` triggers `maybeRunOnboardingFlow` which calls
+// `detectPlaceholders` which references this const — TDZ would
+// throw if it were declared further down).
+const KNOWN_BASE_URL_PLACEHOLDERS = Object.freeze({
+  "http://your-private-deployment/v1": {
+    providerLabel: "zhiman private deployment",
+    defaultEnvKey: "ZHIMAN_API_KEY",
+    defaultBaseUrlHint: "http://your-host:port/v1",
+  },
+  "https://dashscope.aliyuncs.com/compatible-mode/v1": {
+    providerLabel: "dashscope public cloud",
+    defaultEnvKey: "DASHSCOPE_API_KEY",
+    defaultBaseUrlHint: "https://dashscope.aliyuncs.com/compatible-mode/v1",
+  },
+});
 
 function isVersionRequest(args) {
   return args.length === 1 && (args[0] === "--version" || args[0] === "-V");
@@ -29,6 +56,8 @@ fs.mkdirSync(codexHome, { recursive: true });
 
 ensureInniesHomeDefaults(codexHome);
 
+await maybeRunOnboardingFlow(codexHome);
+
 if (await maybeRunInniesCodingRuntime()) {
   process.exit(0);
 }
@@ -75,3 +104,283 @@ function writeExternalRuntimeSmokeResult(runtimeVersion) {
     "utf8",
   );
 }
+
+// N20 (2026-06-15): interactive first-run onboarding flow.
+//
+// On a fresh install, `innies-config.js` writes a config.toml whose
+// provider blocks contain commented `# base_url = "<placeholder>"`
+// lines (zhiman_35b, zhiman_27b, dashscope). If the user then runs
+// `innies` without configuring those placeholders, the Rust binary
+// emits:
+//   ERROR: Missing environment variable: ZHIMAN_BASE_URL (or [model_providers.zhiman_35b].base_url)
+// because the provider resolver silently falls back to api.openai.com
+// when env_key is unset. The user reads this as a confusing "config
+// broken" failure.
+//
+// This flow detects unfilled placeholders and offers a 3-option
+// interactive prompt BEFORE the binary starts, so the user can
+// either (1) fill them in via prompts, (2) skip and edit the file
+// by hand, or (3) bail out. We deliberately do NOT touch any Rust
+// code path here — A+C+D's whole purpose is to make the user never
+// trigger the N20 path.
+//
+// Detection: scan the just-written config.toml for lines matching
+// `/^\s*#\s*base_url\s*=\s*"<known-placeholder>"`. The placeholder
+// strings are the literal values emitted by
+// `defaultZhiman35bProviderBlock`, `defaultZhiman27bProviderBlock`,
+// and `defaultDashscopeProviderBlock` in `innies-config.js`. We
+// detect by placeholder VALUE (not by provider name) because the
+// user might delete the whole block and re-add a custom one — the
+// placeholder detection must remain robust to block re-ordering.
+//
+// Flow:
+//   - detectPlaceholders(configPath) -> [{providerHeader, lineNo,
+//     placeholder, envKeyLine, envKeyPlaceholder}]  (sorted by lineNo)
+//   - If empty: no-op return (already configured)
+//   - Print banner + 3-option prompt
+//   - 1 (interactive fill): for each placeholder, prompt for
+//     base_url and api-key env-var NAME; rewrite lines in place
+//   - 2 (skip): print warning, return; binary will then N20-fail
+//     (this is the documented behaviour; user accepts it)
+//   - 3 (quit): process.exit(0)
+//
+// Re-entrancy: this flow runs on EVERY `innies` invocation but is
+// effectively a no-op when no placeholders are present (the user
+// already configured things, or removed the placeholder block, or
+// is on a run where every provider was already filled). Re-detect
+// every time is idempotent and cheap (one read of config.toml).
+//
+// Skipping: setting `INNIES_SKIP_ONBOARDING=1` (or "true" / "yes")
+// suppresses the prompt entirely. CI / smoke tests rely on this.
+//
+// Failure modes: if stdin is not a TTY (e.g. running under
+// `echo ... | innies`), we fall back to option 2 (skip) with a
+// warning — otherwise we'd block on readline forever. The
+// detection itself is purely synchronous and never throws.
+
+function detectPlaceholders(configPath) {
+  if (!fs.existsSync(configPath)) {
+    return [];
+  }
+  const lines = fs.readFileSync(configPath, "utf8").split(/\r?\n/);
+  const placeholders = [];
+  let currentProviderHeader = null;
+  // Each placeholder record tracks both the commented `base_url` line
+  // and the matching commented `env_key` line (if any) so we can
+  // rewrite them in one pass.
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmed = line.trim();
+    const headerMatch = trimmed.match(/^\[model_providers\.([^\]]+)\]$/);
+    if (headerMatch) {
+      currentProviderHeader = headerMatch[1];
+      continue;
+    }
+    const commentedBaseUrl = line.match(/^(\s*)#\s*base_url\s*=\s*"([^"]+)"\s*(#.*)?$/);
+    if (commentedBaseUrl) {
+      const [, indent, value, trailingComment] = commentedBaseUrl;
+      if (Object.prototype.hasOwnProperty.call(KNOWN_BASE_URL_PLACEHOLDERS, value)) {
+        placeholders.push({
+          lineNo: i,
+          providerKey: currentProviderHeader,
+          placeholderValue: value,
+          meta: KNOWN_BASE_URL_PLACEHOLDERS[value],
+          baseUrlIndent: indent,
+          baseUrlTrailingComment: trailingComment ?? "",
+        });
+      }
+    }
+  }
+  return placeholders;
+}
+
+function shouldSkipOnboarding() {
+  const v = process.env[ONBOARDING_SKIP_ENV_VAR]?.trim().toLowerCase();
+  return v === "1" || v === "true" || v === "yes";
+}
+
+async function promptOnce(rl, question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => resolve(answer ?? ""));
+  });
+}
+
+async function maybeRunOnboardingFlow(codexHome) {
+  const configPath = path.join(codexHome, "config.toml");
+  const placeholders = detectPlaceholders(configPath);
+
+  if (placeholders.length === 0) {
+    // No unfilled placeholders — user already configured (or is on a
+    // fresh install with env vars set). Nothing to do.
+    return { prompted: false, filled: 0 };
+  }
+
+  // Non-TTY stdin (CI, piped input, smoke tests): fall back to skip
+  // with a loud warning rather than blocking on readline forever.
+  if (!process.stdin.isTTY) {
+    if (shouldSkipOnboarding()) {
+      // Honour INNIES_SKIP_ONBOARDING — silent skip.
+      return { prompted: false, filled: 0 };
+    }
+    console.warn(
+      "[innies-onboarding] 检测到 config.toml 有未填的 base_url 占位符 " +
+        "(N20 fresh-install 阻断)。" +
+        " stdin 不是 TTY,无法交互式引导 — 继续执行(可能 N20 fail)。" +
+        " 三种解决方式: (1) 设置 INNIES_SKIP_ONBOARDING=1 显式跳过;" +
+        " (2) 编辑 " + configPath + " 填值;" +
+        " (3) 跑交互式 `innies` (无 pipe)。"
+    );
+    return { prompted: false, filled: 0 };
+  }
+
+  if (shouldSkipOnboarding()) {
+    return { prompted: false, filled: 0 };
+  }
+
+  console.log("");
+  console.log("=============================================================================");
+  console.log("[innies-onboarding] 首次运行检测 (N20 fresh-install 阻断防护)");
+  console.log("-----------------------------------------------------------------------------");
+  console.log(`config.toml: ${configPath}`);
+  console.log("");
+  console.log("检测到以下 provider 块的 base_url 仍是占位符(注释状态):");
+  for (const p of placeholders) {
+    console.log(`  - [model_providers.${p.providerKey}] base_url = "${p.placeholderValue}"`);
+  }
+  console.log("");
+  console.log("如果直接继续执行,innies 会立即报:");
+  console.log('  ERROR: Missing environment variable: ZHIMAN_BASE_URL (or [model_providers.zhiman_35b].base_url)');
+  console.log("");
+  console.log("请选择配置方式:");
+  console.log("  1. 现在交互式填入 base_url 和 api key (推荐) — 写回 config.toml");
+  console.log("  2. 跳过,我会自己编辑 " + configPath);
+  console.log("  3. 退出 innies");
+  console.log("");
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  let choice = "";
+  while (choice !== "1" && choice !== "2" && choice !== "3") {
+    choice = (await promptOnce(rl, "> ")).trim();
+    if (choice !== "1" && choice !== "2" && choice !== "3") {
+      console.log('  请输入 1、2 或 3。');
+    }
+  }
+
+  if (choice === "3") {
+    rl.close();
+    console.log("[innies-onboarding] 用户选择退出,不再继续 innies。");
+    process.exit(0);
+  }
+
+  if (choice === "2") {
+    rl.close();
+    console.log("[innies-onboarding] 用户选择跳过 — 继续执行 innies (可能 N20 fail)。");
+    return { prompted: true, filled: 0 };
+  }
+
+  // choice === "1": interactively fill each placeholder.
+  console.log("");
+  console.log("[innies-onboarding] 开始交互式填入。输入 'skip' 保留占位符,空行重新提示。");
+  console.log("");
+
+  const rewrites = [];
+  for (const p of placeholders) {
+    const label = p.meta.providerLabel;
+    console.log(`--- [model_providers.${p.providerKey}] (${label}) ---`);
+    console.log(`  提示: ${label} 默认 base_url = ${p.meta.defaultBaseUrlHint}`);
+    console.log(`  提示: ${label} 默认 env_key 名 = ${p.meta.defaultEnvKey}`);
+    console.log(`  (输入 'skip' 跳过本块,留空会重新提示)`);
+
+    const baseUrl = await promptUntilFilledOrSkip(
+      rl,
+      `  Enter base_url: `,
+      { allowSkip: true }
+    );
+    if (baseUrl === "__SKIP__") {
+      console.log(`  -> 保留占位符 (${p.placeholderValue})`);
+      continue;
+    }
+
+    const envKeyName = await promptUntilFilledOrSkip(
+      rl,
+      `  Enter env var name holding API key: `,
+      { allowSkip: true }
+    );
+    if (envKeyName === "__SKIP__") {
+      console.log(`  -> 保留 base_url 占位符`);
+      continue;
+    }
+
+    rewrites.push({
+      lineNo: p.lineNo,
+      indent: p.baseUrlIndent,
+      baseUrl,
+      envKey: envKeyName,
+      trailingComment: p.baseUrlTrailingComment,
+    });
+    console.log(`  -> base_url = "${baseUrl}", env_key = "${envKeyName}"`);
+  }
+
+  rl.close();
+
+  if (rewrites.length === 0) {
+    console.log("");
+    console.log("[innies-onboarding] 全部跳过 — 继续执行 innies (可能 N20 fail)。");
+    return { prompted: true, filled: 0 };
+  }
+
+  // Atomic write: rewrite the file in one fs.writeFileSync call. We
+  // re-read the file (the placeholders are line-anchored so concurrent
+  // edits are vanishingly unlikely in a single-user onboarding flow)
+  // and replace each commented base_url line with an active `key = "..."`
+  // line + an active env_key line immediately after.
+  const original = fs.readFileSync(configPath, "utf8");
+  const originalLines = original.split(/\r?\n/);
+  // Sort rewrites in DESCENDING lineNo so splice() doesn't shift the
+  // remaining indexes.
+  rewrites.sort((a, b) => b.lineNo - a.lineNo);
+  for (const r of rewrites) {
+    // The detection regex captures `# FILL IN: ...` WITHOUT the
+    // leading space (the regex is `^(\s*)#\s*base_url\s*=...` and the
+    // trailing-comment group `(#.*)?$` matches from the `#` itself).
+    // Re-insert the separator so we don't produce lines like
+    // `base_url = "x"# FILL IN: ...` — always exactly one space.
+    const trailingSep = r.trailingComment && !r.trailingComment.startsWith(" ") ? " " : "";
+    const baseUrlLine = `${r.indent}base_url = ${JSON.stringify(r.baseUrl)}${trailingSep}${r.trailingComment}`;
+    const envKeyLine = `${r.indent}env_key  = ${JSON.stringify(r.envKey)}${trailingSep}${r.trailingComment}`;
+    originalLines.splice(r.lineNo, 1, baseUrlLine, envKeyLine);
+  }
+  const updated = originalLines.join("\n");
+  // Atomic write: write to a temp file then rename. `rename` is
+  // atomic on POSIX when src and dst are on the same filesystem,
+  // which they are here (both inside `codexHome`).
+  const tmpPath = `${configPath}.tmp-${process.pid}`;
+  fs.writeFileSync(tmpPath, updated, "utf8");
+  fs.renameSync(tmpPath, configPath);
+
+  console.log("");
+  console.log(`[innies-onboarding] 已写回 ${rewrites.length} 个 provider 配置到 ${configPath}`);
+  console.log("[innies-onboarding] 继续启动 innies...");
+  return { prompted: true, filled: rewrites.length };
+}
+
+async function promptUntilFilledOrSkip(rl, question, { allowSkip, defaultValue }) {
+  while (true) {
+    const answer = (await promptOnce(rl, question)).trim();
+    if (allowSkip && answer.toLowerCase() === "skip") {
+      return "__SKIP__";
+    }
+    if (answer === "" && defaultValue) {
+      return defaultValue;
+    }
+    if (answer === "") {
+      console.log("  (不允许空,重新输入,或 'skip' 跳过)");
+      continue;
+    }
+    return answer;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhiman_innies/innies-codex",
-  "version": "0.122.58",
+  "version": "0.122.59",
   "license": "Apache-2.0",
   "bin": {
     "innies": "bin/innies.js"
@@ -21,5 +21,11 @@
   "packageManager": "pnpm@10.29.3+sha512.498e1fb4cca5aa06c1dcf2611e6fafc50972ffe7189998c409e90de74566444298ffe43e6cd2acdc775ba1aa7cc5e092a8b7054c811ba8c5770f84693d33d2dc",
   "scripts": {
     "postinstall": "node bin/innies-init.js"
+  },
+  "optionalDependencies": {
+    "@zhiman_innies/innies-codex-darwin-x64": "0.122.59-darwin-x64",
+    "@zhiman_innies/innies-codex-darwin-arm64": "0.122.59-darwin-arm64",
+    "@zhiman_innies/innies-codex-win32-x64": "0.122.59-win32-x64",
+    "@zhiman_innies/innies-codex-win32-arm64": "0.122.59-win32-arm64"
   }
-}
+}