arona-agent 1.0.0

package/bin/arona.mjs

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+// ARONA CLI entry point. Node 22's --experimental-strip-types refuses to load
+// .ts files inside node_modules/, so we use `tsx` (shipped as a regular dep) as
+// a child-process runner. `tsx` is a self-contained .ts loader that handles
+// ESM, CJS, and node_modules code paths.
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = join(__dirname, '..');
+const args = process.argv.slice(2);
+
+const isSetup = args[0] === 'setup';
+const isVoice = args[0] === 'voice';
+const target = isSetup ? 'src/setup.ts' : isVoice ? 'src/voice_cli.ts' : 'src/index.ts';
+const passArgs = (isSetup || isVoice) ? args.slice(1) : args;
+
+// tsx ships a CLI binary alongside the package. We prefer the local install.
+const tsxBin = process.platform === 'win32'
+  ? join(root, 'node_modules', '.bin', 'tsx.cmd')
+  : join(root, 'node_modules', '.bin', 'tsx');
+
+if (!existsSync(tsxBin)) {
+  // 此文件无法 import TS，内联判定语言（仅环境变量）
+  const isEn = /^en/i.test(process.env.LANG ?? "");
+  console.error(
+    isEn
+      ? `Error: tsx not found at ${tsxBin}.\nRun \`npm install\` in ${root} (or run \`arona setup\` to install dependencies).`
+      : `错误：未找到 tsx（${tsxBin}）。\n请在 ${root} 运行 \`npm install\`（或运行 \`arona setup\` 安装依赖）。`,
+  );
+  process.exit(1);
+}
+
+const child = spawn(tsxBin, [join(root, target), ...passArgs], {
+  stdio: 'inherit',
+  cwd: root,
+  // Windows: tsxBin 是 .cmd 批处理文件。Node >=20.12.2/18.20.2（CVE-2024-27980 修复，2024-04-10）
+  // 起，spawn .bat/.cmd 且不设 shell 会直接抛 EINVAL，导致 `arona setup` 在 Windows 上无法启动。
+  shell: process.platform === 'win32',
+});
+child.on('exit', (code) => process.exit(code ?? 0));

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "arona-agent",
+  "version": "1.0.0",
+  "description": "Terminal AI Agent with desktop pet Arona — eye-tracking pupils, voice cloning, Computer Use, TTS/STT, MCP.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "arona": "bin/arona.mjs"
+  },
+  "files": [
+    "src/",
+    "python/",
+    "pet/",
+    "assets/blue-archive/",
+    "bin/",
+    "requirements.txt"
+  ],
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "dev": "tsx watch src/index.ts"
+  },
+  "dependencies": {
+    "@earendil-works/pi-ai": "^0.84.1",
+    "@earendil-works/pi-coding-agent": "^0.84.1",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@types/figlet": "^1.7.0",
+    "ba-click-fx": "^1.2.29",
+    "chalk": "^5.3.0",
+    "electron": "^43.3.0",
+    "figlet": "^1.11.4",
+    "tsx": "^4.20.0",
+    "typebox": "^1.3.0"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  }
+}

package/pet/agents.cjs

@@ -0,0 +1,197 @@
+// 桌宠角色配置（pet 侧单一事实源，替代旧 emotions.cjs）。
+// 每个 Agent 独立定义：spine 资源路径、动画/骨名、情绪映射、闭眼/禁跟随预设集合。
+// main.cjs 按 ARONA_AGENT 环境变量（默认 arona）选择；renderer 经 pet:get-agent-config 获取。
+// 情绪键 = main.cjs 的情绪白名单（17 个，与 change_emotion 工具一致，勿改键）；
+// 值 = 数字预设动画名，renderer 构建 EMOTION_PRESET。
+// 映射为用户对照目视图库逐项选定，以图库实际渲染效果为准。
+
+const ARONA = {
+  id: "arona",
+  spineBase: "../../assets/blue-archive/arona/spine/",
+  skelFile: "arona_spr.skel",
+  atlasFile: "arona_spr.atlas.txt",
+  // 构图放大系数（fitCamera 用）：Arona bounds 1:2.105 填满 320×674 窗口，保持 1.0
+  extraScale: 1,
+  anims: {
+    idle: "Idle_01",           // 3.333s 全身循环。setup pose 是瘫开的折叠姿势，绝不能裸显
+    blink: "Eye_Close_01",     // 闭眼（只 key 眼部 cover + 眉毛 translate，可安全叠加）
+    pat: "Pat_01_A",           // 摸头静态 pose：闭眼 cover + 嘴（attachment 版）
+    patPose: "Pat_01_M",       // 摸头静态 pose：眉毛 translate（M 版）
+    look: "Look_01_M",         // 注视姿态（单帧 pose，含嘴部微动）
+    lookEnd: "LookEnd_01_M",   // 回中
+  },
+  bones: {
+    head: "Head_Rot",
+    eyeL: "L_Eye_01",
+    eyeR: "R_Eye_01",
+  },
+  emotions: {
+    angry: "05",
+    assured: "22",
+    curious: "02",
+    delighted: "12",
+    desire: "21",
+    dizzy: "30",
+    doubt: "27",
+    dreaming: "23",
+    enjoy: "13",
+    excited: "12",
+    jealous: "07",
+    love: "11",
+    saying: "20",
+    scared: "04",
+    shame: "18",
+    smile: "99",
+    tired: "24",
+  },
+  // 闭眼预设：该预设 key 了 L/R_Eye_Cover → 情绪期间禁止眨眼
+  // （Eye_Close_01 播完末帧会把 cover 置 null，闭眼预设上眨眼会闪出"睁眼"）
+  closedEyePresets: [
+    "03", "10", "11", "12", "13", "14", "18", "23", "24", "26", "27", "28", "29", "30", "32", "99",
+  ],
+  // 睁眼预设默认保留瞳孔跟随；以下预设禁跟随：jealous(07) 自带固定斜视（跟随会覆盖）、
+  // angry(05) 眼神固定不跟光标、doubt(27) 闭眼本就关闭（显式列出以便理解）
+  noGazePresets: ["05", "07", "27"],
+};
+
+const PLANA = {
+  id: "plana",
+  spineBase: "../../assets/blue-archive/plana/spine/",
+  skelFile: "plana_spr.skel",
+  atlasFile: "plana_spr.atlas.txt",
+  // 构图放大系数：Plana bounds 1154×2216（1:1.92，比例偏宽）→ 宽度先顶格，身高只占窗口 91%，
+  // 比 Arona（满窗 99.9%）矮 ~9%；1.10 使其身高 ≈ Arona（两侧各裁 ~16px，一般只裁到光环/发梢边缘）
+  extraScale: 1.1,
+  anims: {
+    idle: "Idle_01",           // 6.667s 全身循环（与 Arona 的 3.333s 不同，勿改）
+    blink: "Eye_Close_01",     // 0.333s 闭眼
+    pat: "Pat_01_A",           // 摸头静态 pose：闭眼 cover + 嘴（attachment 版）
+    patPose: "Pat_01_M",       // 摸头静态 pose：眉毛 translate（M 版）
+    look: "Look_01_M",         // 注视姿态（单帧 pose）
+    lookEnd: "LookEnd_01_M",   // 回中（0.433s）
+  },
+  bones: {
+    head: "Head_Rot",
+    eyeL: "L_Eye_01",
+    // ⚠️ Plana 右眼骨是 R_Eye_1（无前导零），Arona 是 R_Eye_01——勿"修正"
+    eyeR: "R_Eye_1",
+  },
+  emotions: {
+    // 用户 2026-08-15 对照重绑版图库（plana_emotions_rebind_*.html，无水印防错位版）重新指定；
+    // 共用预设：jealous/doubt=20；love/smile=17；delighted/excited=09（合并，与 Arona 12 同语义）；
+    // dreaming/enjoy/scared/shame=14；desire/saying=18
+    angry: "05",
+    assured: "03",
+    curious: "07",
+    delighted: "09",
+    desire: "18",
+    dizzy: "13",
+    doubt: "20",
+    dreaming: "14",
+    enjoy: "14",
+    excited: "09",
+    jealous: "20",
+    love: "17",
+    saying: "18",
+    scared: "14",
+    shame: "14",
+    smile: "17",
+    tired: "06",
+  },
+  // 闭眼预设（客观普查：cover slot 非空，probe_cover 转储）：闭眼预设期间禁止眨眼、关闭瞳孔跟随
+  closedEyePresets: ["04", "05", "06", "10", "11", "12", "13", "14", "16", "17", "99"],
+  // 禁跟随预设：05 闭眼冗余无害；07（curious）按 Arona 同源保留固定斜视，待用户目视确认跟随是否别扭
+  noGazePresets: ["05", "07"],
+};
+
+// ---- 精灵图切换式角色（Shiroko / Hoshino）----
+// 与 Arona/Plana 的骨脸完全不同：仅 root / PC_Layer / halo 三骨，无 Head_Rot、无眼骨；
+// 表情 = 数字预设整张 sprite 切换（Shiroko 切 00_default slot，Hoshino 切全 11 slot）。
+// 仅 Idle_01（身体摆动）+ Eye_Close_01（眨眼），无 Look/Pat 动画。
+// 闭眼/禁跟随集合为空：没有骨脸瞳孔跟随，自然不需要这些集合。
+
+const SHIROKO = {
+  id: "shiroko",
+  // ⚠️ 资源直接放在 assets/blue-archive/shiroko/（无 spine/ 子目录，与 arona/plana 不同）
+  spineBase: "../../assets/blue-archive/shiroko/",
+  // .json = skel_to_json.cjs 导出 + gen_sway.cjs 注入衣摆微动（Idle_01 deform）；
+  // 重新生成顺序：先 skel_to_json 再 gen_sway（只跑 skel_to_json 会覆盖掉形变）
+  skelFile: "shiroko_spr.json",
+  atlasFile: "shiroko_spr.atlas.txt",
+  // bounds 1133×2287（高 95.8%）→ 保持 1.0
+  extraScale: 1,
+  anims: {
+    idle: "Idle_01",
+    blink: "Eye_Close_01",
+    // 无 pat/look 动画：摸头走 emotion 预设 + PC_Layer 微倾斜
+  },
+  bones: {},
+  // 用户 2026-08-18 对照图库重绑：数字预设 00~17+99（19 个）
+  emotions: {
+    angry: "06",
+    assured: "05",
+    curious: "02",
+    delighted: "03",
+    desire: "09",
+    dizzy: "08",
+    doubt: "10",
+    dreaming: "03",
+    enjoy: "03",
+    excited: "03",
+    jealous: "02",
+    love: "04",
+    saying: "02",
+    scared: "07",
+    shame: "08",
+    smile: "03",
+    tired: "16",
+  },
+  closedEyePresets: [],
+  noGazePresets: [],
+  // 摸头：emotion 预设 + 仅旋转脸部/头发 Mesh（tiltSlots），避免 PC_Layer 整身晃动
+  pat: { type: "emotion", emotion: "enjoy", tiltSlots: ["00_default", "Hair_Cover", "eyeclose"] },
+};
+
+const HOSHINO = {
+  id: "hoshino",
+  spineBase: "../../assets/blue-archive/hoshino/",
+  // .json = skel_to_json 导出 + meshify_region 身体网格化(6×10) + gen_sway 衣摆形变；
+  // 重新生成顺序：skel_to_json → meshify_region → gen_sway（任何前一步都会覆盖后一步产物）
+  skelFile: "hoshino_spr.json",
+  atlasFile: "hoshino_spr.atlas.txt",
+  // bounds 1161×2074（高 84.8%）→ 1.1 使身高接近 Arona
+  extraScale: 1.1,
+  anims: {
+    idle: "Idle_01",
+    blink: "Eye_Close_01",
+  },
+  bones: {},
+  // 用户 2026-08-18 对照图库重绑：数字预设 00~17+99（19 个）
+  emotions: {
+    angry: "06",
+    assured: "01",
+    curious: "04",
+    delighted: "03",
+    desire: "17",
+    dizzy: "12",
+    doubt: "17",
+    dreaming: "11",
+    enjoy: "11",
+    excited: "03",
+    jealous: "07",
+    love: "12",
+    saying: "17",
+    scared: "12",
+    shame: "12",
+    smile: "14",
+    tired: "99",
+  },
+  closedEyePresets: [],
+  noGazePresets: [],
+  // 用户需求：星野不做摸头适配
+  pat: { type: "none" },
+};
+
+const AGENTS = { arona: ARONA, plana: PLANA, shiroko: SHIROKO, hoshino: HOSHINO };
+
+module.exports = { AGENTS };