ARONA Agent

English

谁不想在电脑上养一只 ~~香香软软~~ 可可爱爱的阿洛娜呢？

基于 Pi SDK 构建的终端对话式 AI Agent，集成 Computer Use、TTS / STT、桌面宠物与持久记忆。

安装

npm i -g arona-agent

# 首次运行自动进入初始化向导
arona

# 或着如果想先上手玩玩
npx arona-agent

扩展指令

# 重新初始化（可选）
arona setup

# 更新
npm u -g arona-agent

# 禁用TTS+STT并启动
arona --no-voice

# 以命令行启动
arona --cli

# 补全/重新克隆某角色音色
arona voice add [<角色名>]   # 不带角色名则进入 TUI 选择未补全的角色

# 环境自检
arona doctor

核心特性

• Computer Use：基于 cua 。
• 语音：非流式 TTS + STT。
• 桌宠：透明无边框置顶 Electron 窗口 + 情绪切换 + 瞳孔跟随鼠标 + 头部摇动摸头彩蛋 + 全屏点击/拖尾特效；
• 多角色群聊：主 Agent 单窗口、子 Agent 同屏；每轮主 Agent 回复完后子 Agent 依次接话。

环境要求

• Node.js >= 22.19.0
• Python 3.12 / 3.13

配置

全部配置写在 JSON 文件 ~/.arona/settings.json，大部分由 arona setup 交互式生成，少数高级参数需自行填充。

| 字段 | 说明 | 默认值 | |---|---|---| | apiKey | API Key | — | | apiBaseUrl | API地址 | — | | model | 模型名 | openai/gpt-4o | | thinkingLevel | 思考等级 | medium | | contextWindow | 上下文窗口 | 1000000 | | language | 界面语言（auto/zh/en） | auto | | mainAgent | 主 Agent（arona/plana） | arona | | subAgents | 启用的子 Agent 数组 | [] | | ttsEnabled | 启用 TTS | true | | sttEnabled | 启用 STT | true | | workspaceId | 阿里云百炼业务空间 ID | — | | ttsApiKey | 百炼 API Key | — | | ttsModel | TTS 模型 | qwen-audio-3.0-tts-plus | | ttsProvider | TTS 后端（aliyun/gpt-sovits） | aliyun | | ttsConfig | 各 Provider 配置 | {} | | sttApiKey | 百炼 API Key | — | | sttModel | STT 模型 | qwen-audio-3.0-asr-flash-streaming | | sttFormat | STT 音频格式 | pcm | | sttSampleRate | STT 采样率 | 16000 | | cuaApiKey | Cua API Key | — | | tavilyApiKey | Tavily API Key | — | | pythonPath | Python 路径 | python3 | | autoLoadSkills | 启动时自动从 ~/.agents 补全缺失的Skill | true | | CLIEnabled | 裸 arona 启动时进入命令行 | false | | mcpServers | MCP 服务器 JSON | {} |

模型名前缀自动检测：若 model 不含 /，按模型名前缀或 apiBaseUrl 域名自动补 provider/。

数据路径（~/.arona/）

| 路径 | 说明 | |---|---| | settings.json | 本地总配置文件，字段见 配置 | | voices.json | TTS音色配置文件 | | MEMORY.md | 持久记忆 | | sessions/ | 已保存会话 | | skills/ | 自定义 Skill | | undo/ | undo/redo 快照 | | pet.json | 桌宠窗口位置持久化 |

桌宠与 STT 热键

• 桌宠：透明无边框置顶窗口；拖动窗口可移动，在头部区域左右摇晃可触发"摸头"彩蛋；点击/拖拽还会触发特效
• STT 热键：macOS 为右 Cmd 键，Windows/Linux 为右 Ctrl 键，长按 ≥ 2 秒触发一次性录音。

MacOS下，全局键盘监听需「系统设置 → 隐私与安全性 → 辅助功能」为Python授权；

Computer Use 截图需授予终端「屏幕录制」权限。

斜杠命令

| 分类 | 命令 | |---|---| | 会话 | /new /clear · /resume · /exit · /export · /compact | | 显示 | /thinking · /details | | 语音 | /tts · /stt | | 扩展 | /skill· /mcp | | 其他 | /change-agent· /undo · /redo · /help |

扩展

• 自定义 Skill：在 ~/.arona/skills/<名称>/ 放 SKILL.md，用 /skill <名称> 调用。
• MCP 服务器：在 ~/.arona/settings.json 的 mcpServers 字段配置 JSON，工具自动注册。

都看到这里了

窝不是萝莉控别电我啊啊啊！

绝对不是因为 ~~她是我妈妈~~ 才做这个的

License

本项目基于 MIT License 开源。

版权声明

本项目为独立开发的非官方项目，与Nexon Games Co., Ltd.、YOSTAR LIMITED及《蔚蓝档案》游戏官方团队无任何直接关联、授权关系。

• 项目主体代码采用MIT许可证发布，但本项目未就assets/blue-archive/目录下的所有文件（涉及《蔚蓝档案》游戏知识产权的内容，包括但不限于角色立绘、美术素材、音频文件、文本内容及相关衍生素材）向本项目/任何第三方授予任何许可，也不对其合法性、可用性做任何担保。
• 此类内容的使用、复制、分发需严格遵循Nexon Games Co., Ltd.及YOSTAR LIMITED发布的 《蔚蓝档案官方同人创作守则》 及适用法律法规
• 本项目不附带此类第三方文件的获取渠道，用户需自行从权利方官方渠道获取合法副本，并自行承担使用责任；
• 本项目不得用于影响版权方权益之分发，否则自行承担相关侵权责任。

此类内容的知识产权归Nexon Games Co., Ltd.及YOSTAR LIMITED所有，其使用、复制及分发规则应严格遵循上述权利方的官方条款及适用法律法规。 若相关权利人认为本声明或项目使用方式存在不当，可与我联系，将在核实后第一时间调整或移除相关内容。