arona-agent 1.0.6 → 1.0.8

package/README.md

@@ -1,6 +1,6 @@
 # ARONA Agent
 
-[English](README_en.md) | [简体中文](README.md)
+[English](https://github.com/SRC114514/arona-agent/blob/main/README_en.md)
 
 ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
 
@@ -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

@@ -1,6 +1,6 @@
 # ARONA Agent
 
-[中文](README.md) | [English](README_en.md)
+[简体中文](README.md)
 
 ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
 
@@ -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.6",
+  "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/pet/agents.cjs

@@ -250,8 +250,8 @@ const KOHARU = {
   // .json = skel_to_json 导出 + gen_sway 衣摆形变；重新生成顺序：skel_to_json → gen_sway
   skelFile: "koharu_spr.json",
   atlasFile: "koharu_spr.atlas.txt",
-  // bounds 1395×2069（高 96.7%，宽大）→ 1.0 初值，目视后按需调
-  extraScale: 1,
+  // bounds 1395×2069：高≈Arona，但宽(含光环球)超宽 → 取宽为最小边，身高只占 70% → extraScale 放大到 1.3
+  extraScale: 1.3,
   anims: {
     idle: "Idle_01",
     blink: "Eye_Close_01",

package/src/agent.ts

@@ -670,7 +670,7 @@ function buildSubSystemPrompt(id: SubAgentId, memoryContent: string): string {
 - You are one of several desktop-pet characters chatting with Sensei (the user).
 - After the main agent finishes replying, each enabled sub-agent takes a turn. Keep your reply SHORT (one or two sentences), natural, in-character, and add nothing but your own spoken line.
 - Do not repeat or summarize the main agent's reply.
-- In the conversation history, assistant messages carry a \`Name:\` prefix showing who said them (e.g. "Arona:", "Shiroko:", "Hoshino:"); user inputs are Sensei speaking. When you reply, do NOT add any name prefix.
+- In the conversation history, assistant messages carry a \`Name:\` prefix showing who said them (e.g. "Arona:", "Shiroko:", etc.); user inputs are Sensei speaking. When you reply, do NOT add any name prefix.
 - Your reply may be read aloud by TTS; keep each sentence under 50 characters/words when possible.
 - If you have nothing to add, call keep_silent instead of writing filler text.
 

package/src/agent_registry.ts

@@ -1,6 +1,6 @@
 // Agent 注册表：主 Agent + 子 Agent 的桌宠形象与人格。
 // 主 Agent（arona | plana）由 /change-agent 单选，持久化到 settings.json#mainAgent。
-// 子 Agent（shiroko | hoshino 及日后新增）由 /change-agent 多选，持久化到 settings.json#subAgents。
+// 子 Agent（shiroko | hoshino | hanako | koharu）由 /change-agent 多选，持久化到 settings.json#subAgents。
 // 桌宠侧对应 pet/agents.cjs（ARONA_AGENT env 选主、ARONA_SUB_AGENTS env 选子窗口），
 // 人格侧对应 agent.ts 的 buildPrompt* + initSubAgent。
 
@@ -11,7 +11,7 @@ import { t } from "./locale.ts";
 export const MAIN_AGENT_IDS = ["arona", "plana"] as const;
 export type MainAgentId = (typeof MAIN_AGENT_IDS)[number];
 
-export const SUB_AGENT_IDS = ["shiroko", "hoshino"] as const;
+export const SUB_AGENT_IDS = ["shiroko", "hoshino", "hanako", "koharu"] as const;
 export type SubAgentId = (typeof SUB_AGENT_IDS)[number];
 
 export const AGENT_IDS = [...MAIN_AGENT_IDS, ...SUB_AGENT_IDS] as const;

package/src/config.ts

@@ -99,7 +99,7 @@ interface Settings {
   language?: LanguageSetting;
   // 主 Agent（arona | plana）：桌宠形象 + 人格，由 agent_registry.ts 读写
   mainAgent?: string;
-  // 启用的子 Agent 列表（shiroko | hoshino），由 agent_registry.ts 读写
+  // 启用的子 Agent 列表（见 agent_registry.ts），由 agent_registry.ts 读写
   subAgents?: string[];
   ttsEnabled?: boolean;
   sttEnabled?: boolean;
@@ -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/repl.ts

@@ -52,7 +52,7 @@ export class Repl {
   );
   // 回合结束标志：中间段的 play_end 不触发 pet.reset，只有回合结束后才恢复桌宠
   private turnEnded = false;
-  // 子 Agent session 集合（shiroko/hoshino；按 settings 启用）
+  // 子 Agent session 集合（见 agent_registry.ts；按 settings 启用）
   private subSessions = new Map<SubAgentId, AgentSession>();
   // 当前正在发言的 session / agent（中断时 abort 的是它，而不是固定主 session）
   private activeSession: AgentSession;

package/src/setup.ts

@@ -25,7 +25,7 @@ interface Settings {
   language?: "auto" | "zh" | "en";
   /** 主 Agent（arona | plana）：setup 保存时保留，不能覆盖 /change-agent 的选择 */
   mainAgent?: string;
-  /** 子 Agent 列表（shiroko | hoshino）：setup 保存时保留，不能覆盖 /change-agent 的选择 */
+  /** 子 Agent 列表（见 agent_registry.ts）：setup 保存时保留，不能覆盖 /change-agent 的选择 */
   subAgents?: string[];
   ttsEnabled?: boolean;
   sttEnabled?: boolean;
@@ -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();
   }

package/src/voices.ts

@@ -37,6 +37,8 @@ export const VOICE_AUDIO: Record<AgentId, string> = {
   plana: join(PROJECT_ROOT, "assets", "blue-archive", "plana", "voice.mp3"),
   shiroko: join(PROJECT_ROOT, "assets", "blue-archive", "shiroko", "voice.mp3"),
   hoshino: join(PROJECT_ROOT, "assets", "blue-archive", "hoshino", "voice.mp3"),
+  hanako: join(PROJECT_ROOT, "assets", "blue-archive", "hanako", "voice.mp3"),
+  koharu: join(PROJECT_ROOT, "assets", "blue-archive", "koharu", "voice.mp3"),
 };
 
 /**