arona-agent 1.0.7 → 1.0.8

package/README.md

@@ -17,11 +17,17 @@
 ```bash
 npm i -g arona-agent
 
-# 初始化配置文件
-arona setup
-
-# 初始化后可直接启动
+# 首次运行自动进入初始化向导
 arona
+```
+
+---
+
+## 扩展指令
+
+```bash
+# 重新初始化（可选）
+arona setup
 
 # 更新
 npm u -g arona-agent

package/README_en.md

@@ -15,11 +15,17 @@ A terminal-based conversational AI Agent built on the [Pi SDK](https://www.npmjs
 ```bash
 npm i -g arona-agent
 
-# Initialize configuration
-arona setup
-
-# Launch after setup
+# First run auto-starts the setup wizard, then launches ARONA
 arona
+```
+
+---
+
+## Optional commands
+
+```bash
+# Re-run setup manually (optional)
+arona setup
 
 # Upgrade
 npm u -g arona-agent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arona-agent",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Terminal AI Agent with desktop pet Arona — eye-tracking pupils, voice cloning, Computer Use, TTS/STT, MCP.",
   "license": "MIT",
   "type": "module",

package/src/config.ts

@@ -277,6 +277,16 @@ function loadConfig(): AronaConfig {
 
 export const config = loadConfig();
 
+/**
+ * 重新加载 settings.json 并就地更新 config 单例（首次运行引导 setup 完成后调用）。
+ * ESM 模块缓存无法重建模块级 const，只能改对象字段；所有消费方均通过 config.xxx
+ * 运行时引用属性，就地覆盖即全局生效（无顶层解构，见 index.ts 引导注释）。
+ */
+export function reloadConfig(): AronaConfig {
+  Object.assign(config, loadConfig());
+  return config;
+}
+
 /**
  * STT 全局热键键名（pynput 命名，供 repl.ts 注入 ARONA_HOTKEY_KEY）：
  * macOS 右 Cmd（pynput 有 Key.cmd_r），Windows/Linux 右 Ctrl（pynput Key.ctrl_r 三平台皆有效）。

package/src/index.ts

@@ -1,17 +1,51 @@
+import { spawn } from "node:child_process";
+import { join } from "node:path";
 import { initAgent } from "./agent.ts";
 import { Repl } from "./repl.ts";
 import { resetConversationFlag, loadSession } from "./memory.ts";
 import { startPet } from "./pet.ts";
-import { config, settingsExist } from "./config.ts";
+import { config, settingsExist, reloadConfig, PROJECT_ROOT } from "./config.ts";
 import { preloadGptSovitsLocal } from "./tts_provider.ts";
 import { syncSkillsFromAgentsDir } from "./skills.ts";
-import { t } from "./locale.ts";
+import { t, refreshLanguage } from "./locale.ts";
 import chalk from "chalk";
 
+/**
+ * 首次运行引导：以子进程拉起 setup 向导（stdio inherit 复用当前终端交互）。
+ * 传 ARONA_AUTO_SETUP=1 让向导末尾提示"正在启动"而非"运行 arona"。setup 在
+ * 独立进程写 settings.json，主进程随后 reloadConfig 即可（ESM 缓存无法重建单例）。
+ */
+function runSetupWizard(): Promise<number> {
+  const tsxBin = process.platform === "win32"
+    ? join(PROJECT_ROOT, "node_modules", ".bin", "tsx.cmd")
+    : join(PROJECT_ROOT, "node_modules", ".bin", "tsx");
+  return new Promise((resolve) => {
+    const child = spawn(tsxBin, [join(PROJECT_ROOT, "src", "setup.ts"), ...process.argv.slice(2)], {
+      cwd: process.cwd(),
+      stdio: "inherit",
+      shell: process.platform === "win32",
+      env: { ...process.env, ARONA_AUTO_SETUP: "1" },
+    });
+    child.on("exit", (code) => resolve(code ?? 0));
+  });
+}
+
 async function main() {
+  // 首次运行引导：无 settings.json 时直接进入 setup 向导，配置完成后继续 REPL
   if (!settingsExist()) {
-    console.log(chalk.yellow(t("未找到配置文件，请运行 arona setup 初始化。", "Config file not found. Run `arona setup` to initialize.")));
-    process.exit(1);
+    console.log(chalk.yellow(t("未找到配置文件，正在进入初始化向导…", "Config file not found. Starting the setup wizard…")));
+    const setupCode = await runSetupWizard();
+    if (setupCode !== 0) {
+      console.log(chalk.yellow(t("初始化已中止，配置未保存。", "Setup aborted, configuration not saved.")));
+      process.exit(setupCode);
+    }
+    if (!settingsExist()) {
+      console.log(chalk.yellow(t("配置未保存，无法启动。请重新运行 arona 完成初始化。", "Configuration was not saved. Re-run arona to initialize.")));
+      process.exit(1);
+    }
+    // setup 在子进程内写配置：就地刷新 config 单例与 UI 语言后继续
+    reloadConfig();
+    refreshLanguage();
   }
 
   if (!config.apiKey) {

package/src/locale.ts

@@ -129,3 +129,13 @@ export function getLang(): Language {
 export function setLang(l: Language): void {
   lang = l;
 }
+
+/**
+ * 按 settings.json 的 language 字段重新定型语言（首次运行引导 setup 完成后调用；
+ * 不重新探测系统/环境，仅尊重向导写入的显式配置）。auto/缺失保持现状返回当前值。
+ */
+export function refreshLanguage(): Language {
+  const setting = readSettingsLanguage();
+  if (setting === "zh" || setting === "en") lang = setting;
+  return lang;
+}

package/src/setup.ts

@@ -694,7 +694,12 @@ async function main() {
 
       console.log(chalk.green(t(`\n✓ 配置已保存到 ${SETTINGS_FILE}`, `\n✓ Configuration saved to ${SETTINGS_FILE}`)));
     }
-    console.log(chalk.cyan(t("  运行 arona 启动 Agent。\n", "  Run arona to start the Agent.\n")));
+    if (process.env.ARONA_AUTO_SETUP === "1") {
+      // 首次运行自动引导（index.ts spawn 传入）：配置完成后主进程直接续跑 REPL
+      console.log(chalk.cyan(t("  配置完成，正在启动 ARONA...\n", "  Configuration saved. Starting ARONA...\n")));
+    } else {
+      console.log(chalk.cyan(t("  运行 arona 启动 Agent。\n", "  Run arona to start the Agent.\n")));
+    }
   } finally {
     rl.close();
   }